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

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

一、模块概述

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

  • 🟩 上架任务(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
posted @ 2025-10-18 01:04  升鲜宝供应链管理系统  阅读(17)  评论(0)    收藏  举报