📦 仓库作业任务模块开发文档
一、模块概述
本模块涵盖三类核心作业任务:
- 🟩 上架任务(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 |