升鲜宝分拣系统 功能与开发文档

升鲜宝分拣系统 功能与开发文档

 

 

升鲜宝分拣系统 功能与开发文档（v1-完整版）
版本：v1
技术栈：Spring Boot 2.7 + MyBatis + Sa-Token + MySQL 8.0 + JDK 1.8

一、系统概述
升鲜宝分拣系统（Pick Sorting System）用于仓储配送企业的分拣业务管理，支持按商品与按客户两种分拣模式，支持计重/计件统计、批量操作、日志追踪及打印输出。
二、技术架构
组件 说明
Spring Boot 后端主框架（2.7.18，JDK 1.8）
MyBatis ORM 映射框架
Sa-Token 登录与权限控制
MySQL 8.0 关系型数据库
Swagger 接口在线调试
Lombok 简化实体类开发
三、数据库设计
本系统共涉及 9 张核心表，涵盖商品、分类、客户、订单、分拣日志等业务数据。
表名 说明
pms_goods_unit 商品单位表
pms_goods_category 商品类别表
pms_goods 商品表
pms_goods_sku 商品规格表
pms_goods_sku_unit 商品销售方式表
mall_shop 门店(客户)表
oms_order_bill 订单主表
oms_order_bill_info 订单明细表
pms_sorting_log 商品分拣日志表

四、核心表字段明细
pms_goods_unit（商品单位表）
字段名 类型 默认值 主键 说明
id bigint Y 主键ID
unit_name varchar(100) 单位名称
unit_code varchar(100) 单位编码
meter_type tinyint(1) 0 单位属性 0=计重 1=计件
sort_code int 1 排序码
enabled int 1 状态 1=正常 0=禁用
create_date bigint 创建时间
updater bigint 修改人id
oms_order_bill_info（订单明细表）
字段名 类型 默认值 主键 说明
id bigint Y 主键id
order_code varchar(50) 订单号
sku_unit_id bigint 商品规格单位id
pre_num decimal(10,3) 0.000 订货数量
sendout_num decimal(10,3) 0.000 已分拣数量
sort_state int 0 分拣状态 0=待分拣 1=已分拣
stockout_type int 0 缺货标记
sorting_personnel_id bigint 分拣人id
sorting_date bigint 分拣时间
pms_sorting_log（分拣日志表）
字段名 类型 默认值 主键 说明
id bigint Y 主键id
order_info_id bigint 订单详情id
sku_unit_id bigint 商品销售方式id
sendout_num decimal(10,3) 0.000 分拣数量
oper_type tinyint 1 操作类型 0=缺货 1=分拣 2=撤销
creator bigint 操作人id
create_date bigint 创建时间

五、接口功能说明
以下接口均在登录后携带 Token 使用，支持 Swagger 调试。
模块 方法 URL 说明
Auth POST /auth/login 登录获取 Token
GoodsSort POST /sort/goods/summary 商品分拣汇总
GoodsSort POST /sort/goods/detailPage 商品分拣明细
CustomerSort POST /sort/customer/summary 客户分拣汇总
CustomerSort POST /sort/customer/detailPage 客户分拣明细
Operate POST /operate/sortOne 分拣一条明细
Operate POST /operate/revoke 撤销分拣
Print POST /print/goods 打印商品分拣标签