From 4630a448ed4392a6181f70bd583ecacaf26350b0 Mon Sep 17 00:00:00 2001 From: btobab Date: Mon, 9 Mar 2026 10:29:38 +0800 Subject: [PATCH] =?UTF-8?q?=E6=9B=B4=E6=96=B0README?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit --- .gitignore | 2 ++ README.md | 72 +++++++++++++++++++++++++++++++----------------------- 2 files changed, 43 insertions(+), 31 deletions(-) diff --git a/.gitignore b/.gitignore index ed8368a..2ca1daf 100644 --- a/.gitignore +++ b/.gitignore @@ -45,3 +45,5 @@ nbdist/ !*/build/*.java !*/build/*.html !*/build/*.xml + +./AGENTS.md diff --git a/README.md b/README.md index 8995eba..e16e705 100644 --- a/README.md +++ b/README.md @@ -1,42 +1,52 @@ -# rz_wms +### 详细入库全流程解析 -#### 介绍 -日照港仓储管理系统 +#### 单据创建阶段 (Creation) -#### 软件架构 -软件架构说明 + * 动作: 用户通过 add 接口新增，或 importData 导入 Excel。 + * 数据变更: + * 插入 TRkWareNotice，状态 ReceivingStatus = "0"。 + * 插入 TRkWareNoticeTab，状态 ReceivingStatus = "0", InStatus = "0"。 +#### 收货确认阶段 (Receiving / Task Generation) -#### 安装教程 + 此阶段是“实物清点与任务生成”，并非流程的终点。 -1. xxxx -2. xxxx -3. xxxx + * 接口: confirmNoticeTab + * 业务逻辑: + 1. 校验: 检查托盘状态、是否冻结（InStatus=="1"）。 + 2. 更新收货量: 累加 RecNum (累计收货数量)。 + 3. 判定冻结: 如果 RecNum (累计收货) == ReceivingNum (应收总数)，将明细 InStatus 更新为 "1"。这标志着该物料收货动作结束，不能再收了。 + 4. 生成任务: 创建 TOngoodsshelf (入库任务)，状态 InStatus = "0"。 + 5. 发送通知: 生成 TCallNotice，通知下游（如AGV或搬运工）执行上架任务。 + * 关键点: 此时单据状态 `ReceivingStatus` 依然是 `"0"`，库存表尚未增加库存。 -#### 使用说明 +#### 上架确认阶段 (Putaway / Completion) -1. xxxx -2. xxxx -3. xxxx + 此阶段是“任务执行与库存生成”，驱动状态流转。 -#### 参与贡献 + * 接口: shelvesConfirm + * 业务逻辑: + 1. 校验: 检查库位 (LocationId) 有效性。 + 2. 更新上架量: 累加 AcceNum (累计上架数量)。 + 3. 更新明细状态: + * 若 AcceNum < RecNum: 设置 ReceivingStatus = "1" (部分上架)。 + * 若 AcceNum >= RecNum: 设置 ReceivingStatus = "2" (全部上架)。 + 4. 完成任务: 将 TOngoodsshelf 移入历史表 TOngoodsshelfBak，并从原表删除。 + 5. 生成库存: + * 普通模式: 插入 TMiStock (真实库存)。 + * 虚拟模式 (Fictitious="1"): 插入 TMiStockF (虚拟库存)。 + 6. 判断主单完结: + * 遍历该单据下所有明细。 + * 如果所有明细的状态都为 `"2"` (已上架)，则触发归档流程。 -1. Fork 本仓库 -2. 新建 Feat_xxx 分支 -3. 提交代码 -4. 新建 Pull Request +#### 归档流程 (Archiving) + 当上架确认检测到主单完结时自动触发。 -#### 特技 - -1. 使用 Readme\_XXX.md 来支持不同的语言，例如 Readme\_en.md, Readme\_zh.md -2. Gitee 官方博客 [blog.gitee.com](https://blog.gitee.com) -3. 你可以 [https://gitee.com/explore](https://gitee.com/explore) 这个地址来了解 Gitee 上的优秀开源项目 -4. [GVP](https://gitee.com/gvp) 全称是 Gitee 最有价值开源项目，是综合评定出的优秀开源项目 -5. Gitee 官方提供的使用手册 [https://gitee.com/help](https://gitee.com/help) -6. Gitee 封面人物是一档用来展示 Gitee 会员风采的栏目 [https://gitee.com/gitee-stars/](https://gitee.com/gitee-stars/) - - -# nohup java -jar rzg.jar > /dev/null 2 > out.log & - -# nginx 启动配置文件需全路径 \ No newline at end of file + * 更新主单: 将 TRkWareNotice 的 ReceivingStatus 设为 "2"。 + * 同步收货表: 更新或插入 TRkReceivingGoods (收货记录表)。 + * 历史迁移: + * 将主单数据移入 TRkWareNoticeBak。 + * 将明细数据移入 TRkWareNoticeTabBak。 + * 数据清理: 物理删除 TRkWareNotice 和 TRkWareNoticeTab 中的原数据。 + * 关闭通知: 关闭关联的 TCallNoticeOrder 任务。 \ No newline at end of file