程序汪接的8万智慧取餐柜项目

我是程序汪

共 6594字，需浏览 14分钟

· 2022-06-08

本文章来自程序汪背后的私活小团队，开发智慧取餐柜的项目，本项目非常类似快递柜项目，本项目的完整解决方案跟大家分享一下，希望给大家一些参考

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;