40天,搞定8万块的智慧取餐柜项目

沉默王二

共 6515字,需浏览 14分钟

 ·

2022-06-09 08:19

二哥编程知识星球 (戳链接加入)正式上线了,来和 220 多名 小伙伴一起打怪升级吧!这是一个 Java 学习指南 + 编程实战的私密圈子,你可以向二哥提问、帮你制定学习计划、跟着二哥一起做实战项目,冲冲冲。Java 程序员进阶之路网址:
https://tobebetterjavaer.com/

今天给大家分享一位程序员老哥 40 天接的一个 8 万的智慧取餐柜项目,非常类似快递柜项目,完整解决方案也跟大家分享一下,希望给大家一些参考。

这是取餐柜成品的样子,硬件厂家提供的不用去开发硬件哦,我们只开发的软件部分(小程序,PC 端,APP)

下面是厂家快递过来的测试机器 4 口,别问我为什么跟上面的不一样,上面的那个实在太大了啊,测试联调只要接口 OK 就行

流程图先晒下,画的很简单

现在开发项目都喜欢前面加个智慧,这个项目也是智慧 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", // 占用的格子号别名

}

订单打印机

小程序端下订单后,会同步通知 XX云打印机,这部分硬件市面上也是有现成的,购买就行然后给云打印机系统进行接口对接即可。

硬件设备如下,也不贵 300元左右

打印小票样例如下

文本打印接口

请求地址:https://open-api.XXX.net/print/index

请求方式:POST

所需参数

名 称类 型描 述是否必传
client_idstring开发者的应用ID,在开放平台创建应用时获得
access_tokenstring授权的token 必要参数
machine_codestringX联云打印机终端号
contentstring打印内容(需要urlencode),排版指令详见打印机指令
idempotenceint为 1 时,origin_id 进行幂等处理,请确定 origin_id 的唯一性
origin_idstring商户系统内部订单号,要求32个字符内,只能是数字、大小写字母 ,且在同一个client_id下唯一。详见商户订单号
signstring签名 详见API文档列表-接口签名
idstringUUID4 详见API文档列表-uuid4
timestampint当前服务器时间戳(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;

总结

其实本系统技术难度不高,只要把整个解决方案确定出来了,后面的也就写业务代码而已,各种硬件接口开发联调比较费时间,可以预测这种项目以后估计会越来越多,会大大提高大家的工作生活效率。

复制粘贴,修修改改,联机调试,几万块落袋,搞搞副业也是不错的,毕竟打工仔挣不了几个钱。


没有什么使我停留——除了目的,纵然岸旁有玫瑰、有绿荫、有宁静的港湾,我是不系之舟

推荐阅读

浏览 10
点赞
评论
收藏
分享

手机扫一扫分享

分享
举报
评论
图片
表情
推荐
点赞
评论
收藏
分享

手机扫一扫分享

分享
举报