f9-web-ai-test/工作进度/工作进度-17.md

工作进度-17：仓储模块（WMS）五模块移植

一、任务目标

把 D:\AntaiProject - 副本\trunk\WinClient\F9.Business.WMS 下的五个子模块按原业务逻辑一模一样移植到本系统，UI 做适度美化：

模块	原 F9 目录	本系统菜单
原料	F9.Business.WMS\Yuanliao	仓储 / 原料
副产品	F9.Business.WMS\Fuchanpin	仓储 / 副产品
中间品	F9.Business.WMS\ZJP	仓储 / 中间品
生丝	F9.Business.WMS\SS	仓储 / 生丝
物资	F9.Business.WMS\WJ	仓储 / 物资

二、建模方案（统一模型 + 模块/口径区分）

五个模块的单据结构高度一致，因此没有建 5 套重复表，而是一套表 + 两个维度：

• Wms_Module_Enum：原料=1 / 副产品=2 / 中间品=3 / 生丝=4 / 物资=5
• Kind：0=库存台账，1=笼筒架台账（中间品专用）

新增实体（Domain/Entities/Wms/Wms.cs）

实体	表	说明
WmsRuku / WmsRukuDetail / WmsBangmadan	WmsRukus / WmsRukuDetails / WmsBangmadans	入库单、入库明细、磅码单
WmsChuku / WmsChukuDetail	WmsChukus / WmsChukuDetails	出库单、出库明细
WmsKcTzDate / WmsKcTzItem	WmsKcTzDates / WmsKcTzItems	库存台账（日期 + 明细）
WmsPici / WmsPiciBaojian	WmsPicis / WmsPiciBaojians	生丝批次、包件
WmsKucun	WmsKucuns	物资库存（按物资目录）
WmsCaigou	WmsCaigous	原料采购
WmsFbplan / WmsFbjl	WmsFbplans / WmsFbjls	原料翻包计划 / 翻包记录
WmsCgplan / WmsCgplanItem	WmsCgplans / WmsCgplanItems	物资采购计划 / 明细

台账项目口径（与 F9 一致）

• 原料：按原料庄口；中间品笼筒架台账：按工艺庄口（且只统计「联统茧」物资）
• 其余：按物资目录；生丝额外按 SubKey（基地 / 外购）分组

两列数值口径

• 原料 / 副产品 / 中间品 / 生丝：件数 / 净重（生丝件数列取「批数」）
• 物资：数量 / 金额

三、对齐 F9 的业务规则

1. 单据类型枚举（完整照搬 F9）

模块	入库类型	出库类型
原料	采购1 / 调拨2 / 其他3	领料1 / 销售2 / 样茧3 / 其他4
副产品	生产1 / 试缫2 / 其他5	销售1 / 调拨2 / 其他3
中间品	选茧0 / 试缫2 / 退料3 / 其他5	领料0 / 销售1 / 其他2
生丝	生产0 / 退货1 / 其他2	销售1 / 其他5
物资	采购1 / 冲账2 / 盘盈3 / 其他4	领料1 / 销售2 / 调拨3 / 报废4 / 其他5

2. 重量 / 金额计算

• 磅码单：净重 = 毛重 − 皮重；明细件数 / 毛重 / 皮重 / 净重由磅码单汇总
• 明细净重 = 毛重 − 皮重 − 包装重量 − 运损（未使用的项为 0）
• 物资：金额 = 数量 × 单价；库存单价 = 库存金额 ÷ 库存数量（4 位小数）
• 物资出库金额（WJ_Chuku_Detail.CalJine）：
  • 出库数量 = 库存数量 → 金额 = 库存金额，单价 = 金额 ÷ 数量
  • 否则 → 单价 = 库存单价，金额 = 数量 × 单价
• 物资出入库实时更新库存（加权平均单价）；删除 / 修改单据时回滚，保证严格对称

3. 库存台账生成（YL_Kucun_Taizhang_Edit.GenerateTaizhang / CalTdayJiecun）

• 上日结存：取上一台账中「件数或净重不为 0」的行
• 汇总区间：LastDate + 1天 ~ TzDate（笼筒架台账为 LastDate ~ TzDate，与 F9 的 Yesterday~Date 一致）
• 无上一台账时 LastDate = 1970-01-01（与 F9 Page_YL_Kucun_Taizhang.cs 一致，首份台账汇总全部历史）
• 今日结存件数 = 上日 + 入库 − 出库
• 今日结存重量 = Round(上日 + 入库 − 出库 + 盈亏, 2, AwayFromZero)
• 全部出库 = 上日结存 ≠ 0 且今日结存 = 0；勾选后把结存转入盈亏（取消则转回）
• 只能生成晚于最新台账日期的台账

4. 台账保存校验（与 F9 一致）

• 结存重量恒等式：上日 + 入库 − 出库 + 盈亏 = 今日结存
• 结存重量不能小于 0
• 原料：全部出库时样茧件数必须为 0

5. 生丝批次包件

• 净重 = 毛重 − 皮重；公量 = 净重 × (1 + 11%) ÷ (1 + 实测回潮率%)
• 批次库存状态：待入库1 / 已入库2 / 部分出库3 / 已出库4；生丝出库后按批次号更新为「已出库」

6. 物资扩展

• 采购计划（草稿 / 已确认 / 已完成）+ 计划明细
• 采购报销：入库单 BxStatus 无0 / 待报销1 / 已报销2，支持批量报销
• 库存查询、出入库流水（入库为正、出库为负）

四、后端实现

文件	说明
Domain/Entities/Wms/Wms.cs	全部 WMS 实体与 Wms_Module_Enum
Application/Dtos/Wms/WmsDtos.cs	出入库 / 明细 / 磅码单 / 台账 / 批次 / 采购 DTO
Application/Services/Wms/WmsService.cs	统一服务：五模块出入库、台账、库存、流水、批次、采购
Api/Controllers/Wms/WmsController.cs	api/wms/* 接口
Application/DependencyInjection.cs	注册 IWmsService
Infrastructure/Data/DbSeeder.cs	一级菜单「仓储」+ 5 个子菜单；清理软删残留

接口清单（/api/wms）

GET    /options?module=                     类型 / 物资 / 原料庄口 / 工艺庄口 / 部门 / 往来单位
GET    /ruku?module=&start=&end=&type=&like=
GET    /ruku/{id}     POST /ruku     DELETE /ruku/{id}
POST   /ruku/baoxiao                       采购报销（物资）
GET    /chuku?...     GET /chuku/{id}  POST /chuku   DELETE /chuku/{id}
GET    /taizhang/dates?module=&kind=
GET    /taizhang?module=&kind=&date=&regenerate=
POST   /taizhang      DELETE /taizhang/{id}
GET    /kucun?module=          GET /crk?module=&start=&end=&wzmlId=
GET    /pici   GET /pici/{id}  POST /pici   DELETE /pici/{id}
GET    /caigou  POST /caigou   DELETE /caigou/{id}
GET    /fbplan  POST /fbplan   DELETE /fbplan/{id}
GET    /cgplan  GET /cgplan/{id}  POST /cgplan  DELETE /cgplan/{id}

设计要点

• 单据编号（模块 + 日期 + 单号）唯一，重复时返回友好提示
• 出入库单、批次采用物理删除：避免软删残留撞唯一索引而无法重建同号单据
• 启动时清理历史软删残留（WmsRukus / WmsChukus / WmsPicis）

五、前端实现

文件	说明
views/wms/moduleConfig.js	五模块差异化配置（项目口径、字段显示、数值口径、枚举选项）
views/wms/components/RukuPanel.vue	通用入库（含磅码单弹窗、明细合计）
views/wms/components/ChukuPanel.vue	通用出库（物资显示库存数、自动算金额）
views/wms/components/TaizhangPanel.vue	通用台账（生成 / 编辑 / 盈亏 / 全部出库 / 保存 / 删除）
views/wms/components/WjKucun.vue	物资库存
views/wms/components/WjCrk.vue	物资出入库流水
views/wms/components/WjCgplan.vue	物资采购计划
views/wms/components/WjCgbx.vue	物资采购报销
views/wms/components/SsPici.vue	生丝批次 + 包件（公量自动计算）
views/wms/components/YlCaigou.vue	原料采购
views/wms/components/YlFbplan.vue	原料翻包计划 + 翻包记录
views/wms/{yuanliao,fuchanpin,zjp,ss,wj}/index.vue	五个模块页面（Tab 组织）
router/index.js	注册 5 个页面组件

UI 优化点

• 统一卡片式布局 + Tab 分区，顶部带模块说明
• 查询栏（日期区间 / 类型 / 关键字）与操作按钮分离，右侧对齐
• 单据编辑弹窗：表头 4 列栅格表单，明细用可编辑表格（下拉 + 数字框），底部实时合计
• 磅码单独立弹窗，自动算净重并汇总
• 台账：结存列加粗高亮，盈亏 / 全部出库可交互，底部合计条
• 状态用 el-tag 着色（库存状态、报销状态、翻包状态、采购计划状态）

六、菜单

一级菜单「仓储」(/wms，排序 9，位于「薪资」之后)，五个子菜单：

名称	路径	组件
原料	/wms/yuanliao	wms/yuanliao/index（入库 / 出库 / 库存台账 / 原料采购 / 翻包计划）
副产品	/wms/fuchanpin	wms/fuchanpin/index（入库 / 出库 / 库存台账）
中间品	/wms/zjp	wms/zjp/index（入库 / 出库 / 库存台账 / 笼筒架台账）
生丝	/wms/ss	wms/ss/index（入库 / 出库 / 库存台账 / 批次包件）
物资	/wms/wj	wms/wj/index（入库 / 出库 / 库存台账 / 库存 / 出入库流水 / 采购计划 / 采购报销）

七、验证结果（全流程脚本自动执行，已清理测试数据）

[1] 登录 OK
[2] 菜单：仓储 children=5（原料 / 副产品 / 中间品 / 生丝 / 物资）
[3] 选项：原料模块 入库类型3 / 出库类型4 / 原料庄口347 / 物资1000
[4] 原料入库：件数10 净重945（1000−50−5）✓
[5] 原料出库：件数4 净重380 ✓
[6] 台账生成：上日0 + 入库10/945 − 出库4/380 = 结存6/565 ✓
[7] 台账保存 ✓
[8] 次日台账：上日结存6/565 正确结转 ✓
[9] 物资入库：库存 100 / 1000 / 单价10 ✓
[10] 物资出库40：库存 60 / 600 / 单价10（CalJine 规则）✓
[11] 生丝批次：净重120 公量119.46（59 + 60.46）✓
[12] 原料采购 ✓  [13] 翻包计划 ✓  [14] 采购计划 ✓  [15] 批量报销 count=1 ✓
[16] 清理完成，物资库存归零 ✓

第二批（副产品 / 中间品 / 生丝 + 笼筒架台账）：

[2 副产品] 入库6/570 出库2/190 结存4/380 ✓
[3 中间品] 入库6/570 出库2/190 结存4/380 ✓
[4 生丝]   入库2批/570 出库1批/190 结存1批/380（按基地分组）✓
[3 笼筒架台账] 按工艺庄口统计 结存4/380 ✓

• 后端 dotnet build：0 错误
• 前端 npm run build：构建成功
• 服务运行中：后端 http://localhost:3000、前端 http://localhost:5173

八、后续修正（2026-10-26）

1. 「在制品」更名为「中间品」

   • 枚举 Wms_Module_Enum.在制品 → 中间品（数据库存值仍为 3，不影响历史数据）
   • 菜单「仓储 / 中间品」、页面标题、模块配置同步更名

2. 按仓储区分物资分组

   • 物资分组 WuziGroup.BusinessType：原料1 / 中间品2 / 生丝3 / 副产品4 / 五金5

   • /api/wms/options?module= 只返回本模块所属分组的物资：

     仓储模块	分组业务类型	物资数（现有数据）	示例
     原料	原料(1)	2	0101 优茧、0102 普茧
     副产品	副产品(4)	39	040101 好五级茧 …
     中间品	中间品(2)	1	0301 联统
     生丝	生丝(3)	6	070101 正品丝20/22 …
     物资	五金(5)	952	02010063 轴承盒 …

   • 笼筒架台账的物资过滤同步改为匹配名称含「联统」的物资（原为「联统茧」）

3. 修复「新增页面点击确认保存报错」

   • 原因：下拉框清空后前端提交 null，而后端 DTO 的 long/int/decimal 不接受 null， System.Text.Json 直接返回 400（The JSON value could not be converted to System.Int64）
   • 修复：新增 cleanPayload()（views/wms/moduleConfig.js），提交前把 null/undefined 统一转成 0 （scDate、guobangShijian、ckTime 等日期型保持 null），所有 WMS 保存接口统一走该函数
   • 验证：中间品入库（件数3 净重285=300−15）、物资入库（10×5=50）均保存成功，测试数据已清理

九、说明与后续可选项

• 笼筒架台账只统计名称含「联统茧」的物资（与 F9 一致；未配置该物资时不过滤）
• 生丝公量按 11% 公定回潮率计算（F9 标准值）
• 已对齐 F9 的五个模块核心逻辑；如后续需要，可再补充：
  • 生丝混装（SS_Pici_Hunzhuang）
  • 物资调拨单、报废单的独立审批流
  • 各模块台账的报表打印模板