更新README

.gitignore

@@ -45,3 +45,5 @@ nbdist/
 !*/build/*.java
 !*/build/*.html
 !*/build/*.xml
+
+./AGENTS.md

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 启动配置文件需全路径
+   * 更新主单: 将 TRkWareNotice 的 ReceivingStatus 设为 "2"。
+   * 同步收货表: 更新或插入 TRkReceivingGoods (收货记录表)。
+   * 历史迁移:
+     * 将主单数据移入 TRkWareNoticeBak。
+     * 将明细数据移入 TRkWareNoticeTabBak。
+   * 数据清理: 物理删除 TRkWareNotice 和 TRkWareNoticeTab 中的原数据。
+   * 关闭通知: 关闭关联的 TCallNoticeOrder 任务。