程序汪接的8万智慧取餐柜项目
共 6594字,需浏览 14分钟
·
2022-06-08 07:13
本文章来自程序汪背后的私活小团队,开发智慧取餐柜的项目,本项目非常类似快递柜项目,本项目的完整解决方案跟大家分享一下,希望给大家一些参考
B站 我是程序汪 点最下方原文链接进入
这是取餐柜成品的样子,硬件厂家提供的不用程序汪去开发硬件哦,我们只开发的软件部分(小程序,PC端,APP)
下面是厂家快递过来的测试机器4口,别问我为什么跟上面的不一样,上面的那个实在太大了啊,测试联调只要接口OK就行
流程图先晒下,画的很简单
B站【我是程序汪】
现在开发项目都喜欢前面加个智慧,程序汪的这个项目也是智慧XXX
说白了就是一个外卖项目的升级版本
这图是用processon画的
开发人员情况(1人)
uniapp 前端 技术栈 vue 主要任务 小程序及PC端页面,APP (存取 餐)
后端 技术栈 springboot
开发周期40天(设计+开发)
开发人数 1人
整体费用是8万(不含硬件部分),这是一期的开发费用
付款模式 5:4:1 首付:验收:尾款
走的正规公司合同
云服务器1台 4核8G,经费有限先就安排1台,不够后面升级
维护费用 项目总款项10%
售后维护
域名
服务器
日常运维
技术选型
核心框架:Spring Boot
数据库连接池:Druid
缓存:redis
前端:Vue
APP 小程序 Uniapp
数据库:mysql
服务器配置 4核8G
硬件接口开发联调(云打印机 取餐柜)
项目背景
大城市里公司上班族,经常交通通勤都1个多小时,购买早餐也经常需要排很长的队,很浪费时间,本系统就是为了解决上班族购买早餐难的痛点而诞生的。程序汪上海上班时,吃早餐就很头疼,办公大厦楼下早餐店排队很夸张的,浪费了我很多写代码的时间呀。
小程序
程序汪把核心页面截图出来
本小程序主要功能就这些
用户下订单
骑手存餐
下面是我们的测试体验版小程序,初始数据有点随意
跟普通下单外卖不同的地方就是可以选择取餐时间和机柜
骑手进入本页面点击【存餐】触发 取餐柜
下单成功会短信通知用户 取餐码
PC端
目前主要功能,说白了在外卖系统二开的,分系统管理员和商家角色
商品管理 -分系统和商家
订单管理 -分系统和商家
店铺管理 -分系统和商家
会员权限管理
售后管理
统计报表
订单物流
财务管理
骑手管理
下面截图就是开源系统上面二开的,别问我为啥管理系统页面都长了差不多,前端是Vue
系统管理员角色
商家角色
硬件部分(取餐柜)
主要硬件是取餐柜,这个是找的第三方现成的硬件厂家,对方会提供接口文档具体的SDK包,我们的工作量就是接口开发然后联调一波。
取餐接口(取餐柜)
下面我把核心的存餐接口给大家列出来下
创建存餐订单
使用场景
创建存餐订单
操作名称
createOrder
请求字段
{
"deviceId":"xxxxxxxxxxx", // 必传,设备ID
"shopOrderId":"00000000000000", // 必传,商户订单号,最多32位字符
"type":1, //非必传,请求的格子类型,普通小格1、普通大格2,不传递默认为1
"isWarm":"1", // 非必传,是否开始加热(1-加热【取餐时自动关闭加热】、不传递或传递0为不加热)
"isLight":"1", // 非必传,是否开灯(1-开灯【取餐时自动关灯】、不传递或传递0为不开灯)
"isDisinfect":"1", // 非必传,是否开始消毒(1-加热【取餐时自动关闭消毒】、不传递或传递0为不消毒)
"takeCode":"1234",// 非必传,支持自定义取餐码,不传递 则AUV会默认自动生成4位取餐码
"cellId":"12",// 非必传,支持自定义格口号,不传递 则AUV会随机分配格口
}
返回数据
存餐成功:
{
"deviceId":"xxxxxxxxxxx", //设备ID
"shopOrderId":"00000000000000", //商户订单号,最多32位字符
"orderId":"11111111", //存取订单ID
"cellId":"22", // 占用的格子号
"code":"1234", // 系统生成的取餐码,可以通过该值请求 takeByCode 接口进行取餐操作
"cellAlias":"22", // 占用的格子号别名
}
存餐失败(外层code和msg返回错误信息):
复制{}
订单打印机
小程序端下订单后,会同步通知 XX云打印机,这部分硬件市面上也是有现成的,购买就行然后给云打印机系统进行接口对接即可。
硬件设备如下,也不贵 300元左右
打印小票样例如下
文本打印接口
请求地址:https://open-api.XXX.net/print/index
请求方式:POST
所需参数
名 称 | 类 型 | 描 述 | 是否必传 |
---|---|---|---|
client_id | string | 开发者的应用ID,在开放平台创建应用时获得 | 是 |
access_token | string | 授权的token 必要参数 | 是 |
machine_code | string | X联云打印机终端号 | 是 |
content | string | 打印内容(需要urlencode),排版指令详见打印机指令 | 是 |
idempotence | int | 为 1 时,origin_id 进行幂等处理,请确定 origin_id 的唯一性 | 否 |
origin_id | string | 商户系统内部订单号,要求32个字符内,只能是数字、大小写字母 ,且在同一个client_id下唯一。详见商户订单号 | 是 |
sign | string | 签名 详见API文档列表-接口签名 | 是 |
id | string | UUID4 详见API文档列表-uuid4 | 是 |
timestamp | int | 当前服务器时间戳(10位) | 是 |
返回详情
{"error":"0","error_description":"success",
"body":{"id":"订单号","origin_id":""}}
{"error":"8","error_description":"打印机信息错误,参数有误"}
{"error":"9","error_description":"连接打印机失败,参数有误"}
{"error":"10","error_description":"权限不足"}
{"error":"12","error_description":"缺少必要参数"}
{"error":"13","error_description":"打印失败,参数有误"}
{'error':'33', 'error_description':'Uuid不合法'
}
核心表
如订单表
-- ----------------------------
DROP TABLE IF EXISTS `tp_order`;
CREATE TABLE `tp_order` (
`order_id` mediumint(8) unsigned NOT NULL AUTO_INCREMENT COMMENT '订单id',
`order_sn` varchar(20) NOT NULL DEFAULT '' COMMENT '订单编号',
`master_order_sn` varchar(20) DEFAULT '' COMMENT '主订单号',
`user_id` mediumint(8) unsigned NOT NULL DEFAULT '0' COMMENT '用户id',
`order_status` tinyint(1) unsigned NOT NULL DEFAULT '0' COMMENT '订单状态',
`shipping_status` tinyint(1) unsigned NOT NULL DEFAULT '0' COMMENT '发货状态',
`pay_status` tinyint(1) unsigned NOT NULL DEFAULT '0' COMMENT '支付状态',
`consignee` varchar(60) NOT NULL DEFAULT '' COMMENT '收货人',
`country` int(11) unsigned NOT NULL DEFAULT '0' COMMENT '国家',
`province` int(11) unsigned NOT NULL DEFAULT '0' COMMENT '省份',
`city` int(11) unsigned NOT NULL DEFAULT '0' COMMENT '城市',
`district` int(11) unsigned NOT NULL DEFAULT '0' COMMENT '县区',
`twon` int(11) DEFAULT '0' COMMENT '乡镇',
`address` varchar(255) NOT NULL DEFAULT '' COMMENT '地址',
`zipcode` varchar(60) NOT NULL DEFAULT '' COMMENT '邮政编码',
`mobile` varchar(60) NOT NULL DEFAULT '' COMMENT '手机',
`email` varchar(60) NOT NULL DEFAULT '' COMMENT '邮件',
`shipping_code` varchar(32) NOT NULL DEFAULT '0' COMMENT '物流code',
`shipping_name` varchar(120) NOT NULL DEFAULT '' COMMENT '物流名称',
`pay_code` varchar(32) NOT NULL DEFAULT '' COMMENT '支付code',
`pay_name` varchar(120) NOT NULL DEFAULT '' COMMENT '支付方式名称',
`invoice_title` varchar(256) DEFAULT '' COMMENT '发票抬头',
`goods_price` decimal(10,2) NOT NULL DEFAULT '0.00' COMMENT '商品总价',
`shipping_price` decimal(10,2) NOT NULL DEFAULT '0.00' COMMENT '邮费',
`user_money` decimal(10,2) NOT NULL DEFAULT '0.00' COMMENT '使用余额',
`coupon_price` decimal(10,2) DEFAULT '0.00' COMMENT '优惠了多少',
`integral` int(10) unsigned NOT NULL DEFAULT '0' COMMENT '使用积分',
`integral_money` decimal(10,2) NOT NULL DEFAULT '0.00' COMMENT '使用积分抵多少钱',
`order_amount` decimal(10,2) NOT NULL DEFAULT '0.00' COMMENT '应付款金额',
`total_amount` decimal(10,2) DEFAULT '0.00' COMMENT '订单总价',
`add_time` int(10) unsigned NOT NULL DEFAULT '0' COMMENT '下单时间',
`confirm_time` int(10) DEFAULT '0' COMMENT '收货确认时间',
`pay_time` int(10) unsigned NOT NULL DEFAULT '0' COMMENT '支付时间',
`shipping_time` int(11) DEFAULT '0' COMMENT '最新发货时间',
`order_prom_id` smallint(6) NOT NULL DEFAULT '0' COMMENT '订单活动id',
`order_prom_amount` decimal(8,2) NOT NULL DEFAULT '0.00' COMMENT '订单活动优惠金额',
`discount` decimal(10,2) NOT NULL DEFAULT '0.00' COMMENT '价格调整',
`user_note` varchar(255) NOT NULL DEFAULT '' COMMENT '用户备注',
`admin_note` varchar(255) DEFAULT '' COMMENT '管理员备注',
`parent_sn` varchar(100) DEFAULT NULL COMMENT '父单单号',
`store_id` int(10) DEFAULT '0' COMMENT '店铺ID',
`is_comment` tinyint(1) NOT NULL DEFAULT '0' COMMENT '是否评价(0:未评价;1:已评价)',
`deleted` tinyint(1) unsigned zerofill NOT NULL,
`is_checkout` tinyint(1) DEFAULT '0' COMMENT '0未结算1已结算',
`qishouid` int(11) DEFAULT '0',
`jiedantime` varchar(255) DEFAULT NULL,
`youhuiid` int(11) DEFAULT NULL,
`qucantime` varchar(255) DEFAULT NULL,
`shebeiid` varchar(255) DEFAULT NULL,
`qucanshebeiid` int(11) DEFAULT NULL,
`baozhuangfei` varchar(255) DEFAULT NULL,
`qucancode` varchar(255) DEFAULT NULL,
PRIMARY KEY (`order_id`),
UNIQUE KEY `order_sn` (`order_sn`) USING BTREE,
KEY `user_id` (`user_id`) USING BTREE,
KEY `order_status` (`order_status`) USING BTREE,
KEY `shipping_status` (`shipping_status`) USING BTREE,
KEY `pay_status` (`pay_status`) USING BTREE,
KEY `shipping_id` (`shipping_code`) USING BTREE,
KEY `pay_id` (`pay_code`) USING BTREE
) ENGINE=MyISAM AUTO_INCREMENT=485 DEFAULT CHARSET=utf8;
总结
其实本系统技术难度不高,只要把整个解决方案确定出来了,后面的也就写业务代码而已,各种硬件接口开发联调比较费时间,程序汪可以预测这种项目以后估计会越来越多,会大大提高大家的工作生活效率。
获取外卖项目源码点击下方链接
Spring Boot vue完整的外卖系统,手机端和后台管理api 源码赠送
另外需要取餐柜详细开发功能资料的,直接扫描下方公众号回复关键字「743」,即可获取!
▲回复「743」▲
点下方原文链接观看B站视频版本