新增入库单据管理页面

.trae/documents/创建并接入 in_stockin_detail_n 明细存储.md

@@ -0,0 +1,104 @@
+## 目标
+
+* 在 SQL Server 新增表 `in_stockin_detail_n`，用于存储 ERP 返回的入库产品明细（Cols/Rows）。
+
+* 以实体、Mapper、Service 的方式接入到现有 WMS 代码，并在 `ToErpServiceImpl#getInStock` 中解析 JSON 后落库。
+
+* 字段覆盖现有 ERP 索引映射，支持来源、创建/更新时间等审计信息。
+
+## 数据表设计（SQL Server）
+
+* 表名：`in_stockin_detail_n`
+
+* 关键字段：
+
+  * stockin\_detail\_id (入库单主键，插入时，主单对应有几条子单，在主单ID后拼接“-”子单条数)
+  * stockin\_id 主单ID 与主单ID保持一致
+  * `erp_detail_id`（ERP入库明细ID，对应 Rows\[0]）
+  * `product_name` nvarchar(200)（Rows\[1]）
+  * `product_model` nvarchar(200)（Rows\[2]，型号）
+  * `unit` nvarchar(50)（Rows\[3]）
+  * `unit_price` decimal(18,6)（Rows\[4]）
+  * `aux_unit` nvarchar(50) 或 int（Rows\[5]，与现有实现保持兼容；建议 nvarchar 以避免字典耦合）
+  * `attr1` nvarchar(100)（Rows\[6]）
+  * `attr2` nvarchar(100)（Rows\[7]）
+  * `quantity` decimal(18,6)（Rows\[9]）
+  * `in_quantity` decimal(18,6)（Rows\[10]）
+  * `aux_quantity` decimal(18,6)（Rows\[11]）
+  * `total_price` decimal(18,6)（Rows\[12]）
+  * `cost_unit_price` decimal(18,6)（Rows\[13]）
+  * `cost_total_price` decimal(18,6)（Rows\[14]）
+  * `accounting_cost_total` decimal(18,6)（Rows\[15]）
+  * `accounting_quantity` decimal(18,6)（Rows\[16]）
+  * `accounting_status` int（Rows\[17]）
+  * `batch_no` nvarchar(100)（Rows\[18]）
+  * `serial_no` nvarchar(100)（Rows\[19]）
+  * `production_date` datetime2(3)（Rows\[20]）
+  * `expiry_date` datetime2(3)（Rows\[21]）
+  * `arrival_date` datetime2(3)（Rows\[22]）
+  * `remark` nvarchar(255)（Rows\[23]）
+  * `custom1`..`custom6` nvarchar(255)（Rows\[24]..Rows\[29]）
+  * `stevedore` nvarchar(100)（Rows\[30]，装卸工）
+  * `create_time` datetime2(3) 默认 `SYSDATETIME()`
+  * `update_time` datetime2(3) 可在更新时写入 `SYSDATETIME()`
+
+* 约束：`detail_id` 主键；如需防重复插入，可使用 `detail_id + production_date` 唯一索引（按您确认）。
+
+## Java 代码接入
+
+* 新增实体 `com.ruoyi.system.domain.InStockinDetailN`
+
+  * 字段与表结构一一对应，类型与上面一致；保留必要的 `@Excel` 注解，遵循现有风格。
+
+  * 继承 `BaseEntity`，复用 `createTime`、`updateTime` 字段。
+
+* 新增 Mapper 接口 `com.ruoyi.system.mapper.InStockinDetailNMapper`
+
+  * 方法：`insertInStockinDetailN`、`updateInStockinDetailN`、`selectByDetailId`、`batchInsert(List<...>)`、`selectByDetailIdAndDate`（防重复）。
+
+* 新增 XML `mapper/system/InStockinDetailNMapper.xml`
+
+  * 定义 `resultMap` 与列映射；提供 `insert`、`update`、`select`、`batchInsert`（`foreach`）语句，时间字段默认使用 `SYSDATETIME()`。
+
+* 新增 Service `IInStockinDetailNService` 与实现 `InStockinDetailNServiceImpl`
+
+  * 封装批量写入与防重复逻辑（按 `detail_id` 或当天 `create_time` 过滤）。
+
+## 解析与入库逻辑
+
+* 在 `ToErpServiceImpl#getInStock` 中：
+
+  * 从 `row.get(15)`（产品明细 JSON）解析出 `Rows` 列表。
+
+  * 按上面索引映射生成 `InStockinDetailN` 对象，填充 `order_src='ERP'`、`create_time=当前时间`。
+
+  * 通过 `selectByDetailIdAndDate(detail_id, today)` 判断是否已存在，未存在则插入，已存在忽略。
+
+  * 将 `stockin_guid` 关联为当前主单 `newStockin.getStockinGuid()`（若可获得）。
+
+## 索引映射校验
+
+* 结合已有 `ErpInStockinDetail` 的使用位置（`ToErpServiceImpl#AddStockinDetailByErpStockinDetail`），确保以下关键位一致：
+
+  * `id`→Rows\[0]、`spare1`(产品名称)→Rows\[1]、`spare2`(产品编号/型号)→Rows\[2]
+
+  * 数量→Rows\[9]、批号→Rows\[17]、序列号→Rows\[18]、生产/有效/到货日期→Rows\[19]/\[20]/\[21]
+
+* 如您确认 `Clos` 与 `Rows` 存在偏移或后续附加列，我们将按您提供的最终结构调整表与映射。
+
+## 验证与回归
+
+* 本地运行 `getInStock`，抓取一次 ERP 返回；在控制台输出解析计数与首条样例，以确认列位。
+
+* 手工查询：`SELECT TOP 10 * FROM in_stockin_detail_n ORDER BY create_time DESC;`
+
+* 回归检查：对 `in_stockin_n` 与新表之间的 `stockin_guid` 关联是否正确。
+
+## 提交约定
+
+* 在实现时，所有 Java 代码将补充详细中文注释，解释每一步改动原因与映射关系。
+
+* 不自动创建 `.md` 或 `.sql` 文件；如您需要，我们可生成对应 SQL 文件并在您确认后执行。
+
+* 仅在您确认后进行代码与数据库变更，并按您要求的 Git 提交规范执行提交。
+