升鲜宝生鲜配送供应链管理系统-----仓库作业任务模块开发文档

📦 仓库作业任务模块开发文档

一、模块概述

本模块涵盖三类核心作业任务：

• 🟩 上架任务（Putaway）
• 🟦 下架任务（Pickdown）
• 🟥 移库任务（Move）

每类任务均包括：

• 主表（Task）—— 用于存储任务基本信息；
• 明细表（Task Detail）—— 用于记录任务涉及的具体SKU、库位、数量等。

所有表字段遵循统一规范：

• 主键字段均为 BIGINT；
• 时间字段采用 BIGINT 时间戳；
• 通用字段（enabled、del_flag、sort_code、creator、create_date、updater、update_date、remark、dept_id）保持一致。

---

二、数据字典

模块	表名	表用途	主键	明细从属字段
上架任务	wms_putaway_task	上架任务主表	id	-
上架任务明细	wms_putaway_task_detail	上架任务明细表	id	task_id
下架任务	wms_pickdown_task	下架任务主表	id	-
下架任务明细	wms_pickdown_task_detail	下架任务明细表	id	task_id
移库任务	wms_move_task	移库任务主表	id	-
移库任务明细	wms_move_task_detail	移库任务明细表	id	task_id

---

三、上架任务

1️⃣ 上架任务主表 wms_putaway_task

CREATE TABLE `wms_putaway_task` (`id` bigint NOT NULL COMMENT '主键id',`task_code` varchar(100) NOT NULL COMMENT '上架任务编号',`warehouse_id` bigint DEFAULT NULL COMMENT '仓库ID',`source_type` tinyint DEFAULT NULL COMMENT '来源类型(1收货单 2退货 3其他)',`source_id` bigint DEFAULT NULL COMMENT '来源单据ID',`task_status` tinyint DEFAULT 0 COMMENT '任务状态(0待上架 1上架中 2完成 3作废)',`operator_id` bigint DEFAULT 0 COMMENT '操作人ID',`finish_time` bigint DEFAULT NULL COMMENT '完成时间',`enabled` tinyint DEFAULT 1 COMMENT '启用状态',`del_flag` tinyint DEFAULT 0 COMMENT '删除标志',`sort_code` int DEFAULT 1 COMMENT '排序码',`creator` bigint DEFAULT 0 COMMENT '创建人ID',`create_date` bigint DEFAULT NULL COMMENT '创建时间',`updater` bigint DEFAULT 0 COMMENT '修改人ID',`update_date` bigint DEFAULT NULL COMMENT '修改时间',`remark` varchar(250) DEFAULT NULL COMMENT '备注',`dept_id` bigint DEFAULT 0 COMMENT '机构ID',PRIMARY KEY (`id`),UNIQUE KEY `uk_putaway_task_code` (`task_code`)
) ENGINE=InnoDB DEFAULT CHARSET=utf8mb4 COMMENT='上架任务主表';

2️⃣ 上架任务明细表 wms_putaway_task_detail

CREATE TABLE `wms_putaway_task_detail` (`id` bigint NOT NULL COMMENT '主键id',`task_id` bigint NOT NULL COMMENT '上架任务ID',`sku_unit_id` bigint NOT NULL COMMENT 'SKU单位ID',`batch_id` bigint DEFAULT NULL COMMENT '批次ID',`from_location_id` bigint DEFAULT NULL COMMENT '来源库位ID',`to_location_id` bigint DEFAULT NULL COMMENT '目标库位ID',`quantity` decimal(18,4) DEFAULT 0 COMMENT '上架数量',`status` tinyint DEFAULT 0 COMMENT '状态(0待上架 1完成)',`operator_id` bigint DEFAULT 0 COMMENT '操作人ID',`operate_time` bigint DEFAULT NULL COMMENT '操作时间',`enabled` tinyint DEFAULT 1 COMMENT '启用状态',`del_flag` tinyint DEFAULT 0 COMMENT '删除标志',`sort_code` int DEFAULT 1 COMMENT '排序码',`creator` bigint DEFAULT 0 COMMENT '创建人ID',`create_date` bigint DEFAULT NULL COMMENT '创建时间',`updater` bigint DEFAULT 0 COMMENT '修改人ID',`update_date` bigint DEFAULT NULL COMMENT '修改时间',`remark` varchar(250) DEFAULT NULL COMMENT '备注',`dept_id` bigint DEFAULT 0 COMMENT '机构ID',PRIMARY KEY (`id`),KEY `idx_putaway_task_id` (`task_id`)
) ENGINE=InnoDB DEFAULT CHARSET=utf8mb4 COMMENT='上架任务明细表';

---

四、下架任务

1️⃣ 下架任务主表 wms_pickdown_task

CREATE TABLE `wms_pickdown_task` (`id` bigint NOT NULL COMMENT '主键id',`task_code` varchar(100) NOT NULL COMMENT '下架任务编号',`warehouse_id` bigint DEFAULT NULL COMMENT '仓库ID',`source_type` tinyint DEFAULT NULL COMMENT '来源类型(1出库单 2调拨单 3其他)',`source_id` bigint DEFAULT NULL COMMENT '来源单据ID',`task_status` tinyint DEFAULT 0 COMMENT '任务状态(0待下架 1下架中 2完成 3作废)',`operator_id` bigint DEFAULT 0 COMMENT '操作人ID',`finish_time` bigint DEFAULT NULL COMMENT '完成时间',`enabled` tinyint DEFAULT 1,`del_flag` tinyint DEFAULT 0,`sort_code` int DEFAULT 1,`creator` bigint DEFAULT 0,`create_date` bigint DEFAULT NULL,`updater` bigint DEFAULT 0,`update_date` bigint DEFAULT NULL,`remark` varchar(250) DEFAULT NULL,`dept_id` bigint DEFAULT 0,PRIMARY KEY (`id`),UNIQUE KEY `uk_pickdown_task_code` (`task_code`)
) ENGINE=InnoDB DEFAULT CHARSET=utf8mb4 COMMENT='下架任务主表';

2️⃣ 下架任务明细表 wms_pickdown_task_detail

CREATE TABLE `wms_pickdown_task_detail` (`id` bigint NOT NULL COMMENT '主键id',`task_id` bigint NOT NULL COMMENT '下架任务ID',`sku_unit_id` bigint NOT NULL COMMENT 'SKU单位ID',`batch_id` bigint DEFAULT NULL COMMENT '批次ID',`from_location_id` bigint DEFAULT NULL COMMENT '来源库位ID',`to_location_id` bigint DEFAULT NULL COMMENT '目标库位ID',`quantity` decimal(18,4) DEFAULT 0 COMMENT '下架数量',`status` tinyint DEFAULT 0 COMMENT '状态(0待下架 1完成)',`operator_id` bigint DEFAULT 0 COMMENT '操作人ID',`operate_time` bigint DEFAULT NULL COMMENT '操作时间',`enabled` tinyint DEFAULT 1,`del_flag` tinyint DEFAULT 0,`sort_code` int DEFAULT 1,`creator` bigint DEFAULT 0,`create_date` bigint DEFAULT NULL,`updater` bigint DEFAULT 0,`update_date` bigint DEFAULT NULL,`remark` varchar(250) DEFAULT NULL,`dept_id` bigint DEFAULT 0,PRIMARY KEY (`id`),KEY `idx_pickdown_task_id` (`task_id`)
) ENGINE=InnoDB DEFAULT CHARSET=utf8mb4 COMMENT='下架任务明细表';

---

五、移库任务

1️⃣ 移库任务主表 wms_move_task

CREATE TABLE `wms_move_task` (`id` bigint NOT NULL COMMENT '主键id',`task_code` varchar(100) NOT NULL COMMENT '移库任务编号',`warehouse_id` bigint DEFAULT NULL COMMENT '仓库ID',`task_type` tinyint DEFAULT 1 COMMENT '任务类型(1整托 2分批)',`task_status` tinyint DEFAULT 0 COMMENT '任务状态(0待执行 1执行中 2完成 3作废)',`operator_id` bigint DEFAULT 0 COMMENT '操作人ID',`finish_time` bigint DEFAULT NULL COMMENT '完成时间',`enabled` tinyint DEFAULT 1,`del_flag` tinyint DEFAULT 0,`sort_code` int DEFAULT 1,`creator` bigint DEFAULT 0,`create_date` bigint DEFAULT NULL,`updater` bigint DEFAULT 0,`update_date` bigint DEFAULT NULL,`remark` varchar(250) DEFAULT NULL,`dept_id` bigint DEFAULT 0,PRIMARY KEY (`id`),UNIQUE KEY `uk_move_task_code` (`task_code`)
) ENGINE=InnoDB DEFAULT CHARSET=utf8mb4 COMMENT='移库任务主表';

2️⃣ 移库任务明细表 wms_move_task_detail

CREATE TABLE `wms_move_task_detail` (`id` bigint NOT NULL COMMENT '主键id',`task_id` bigint NOT NULL COMMENT '移库任务ID',`sku_unit_id` bigint NOT NULL COMMENT 'SKU单位ID',`batch_id` bigint DEFAULT NULL COMMENT '批次ID',`from_location_id` bigint DEFAULT NULL COMMENT '来源库位ID',`to_location_id` bigint DEFAULT NULL COMMENT '目标库位ID',`quantity` decimal(18,4) DEFAULT 0 COMMENT '移库数量',`status` tinyint DEFAULT 0 COMMENT '状态(0待执行 1完成)',`operator_id` bigint DEFAULT 0 COMMENT '操作人ID',`operate_time` bigint DEFAULT NULL COMMENT '操作时间',`enabled` tinyint DEFAULT 1,`del_flag` tinyint DEFAULT 0,`sort_code` int DEFAULT 1,`creator` bigint DEFAULT 0,`create_date` bigint DEFAULT NULL,`updater` bigint DEFAULT 0,`update_date` bigint DEFAULT NULL,`remark` varchar(250) DEFAULT NULL,`dept_id` bigint DEFAULT 0,PRIMARY KEY (`id`),KEY `idx_move_task_id` (`task_id`)
) ENGINE=InnoDB DEFAULT CHARSET=utf8mb4 COMMENT='移库任务明细表';

---

六、通用字段定义

字段	类型	含义
enabled	tinyint	启用状态：1启用，0禁用
del_flag	tinyint	删除标志：1删除，0正常
sort_code	int	排序号
creator	bigint	创建人ID
create_date	bigint	创建时间（时间戳）
updater	bigint	修改人ID
update_date	bigint	修改时间（时间戳）
remark	varchar(250)	备注
dept_id	bigint	机构ID