diff --git a/HHWMS.Web/Areas/Inventory/ViewModels/InventoryVMs/InventoryApiListVM.cs b/HHWMS.Web/Areas/Inventory/ViewModels/InventoryVMs/InventoryApiListVM.cs index 6a3d6de..424cde0 100644 --- a/HHWMS.Web/Areas/Inventory/ViewModels/InventoryVMs/InventoryApiListVM.cs +++ b/HHWMS.Web/Areas/Inventory/ViewModels/InventoryVMs/InventoryApiListVM.cs @@ -51,6 +51,10 @@ namespace HHWMS.Web .CheckContain(Searcher.NextBatch, x=>x.Lot) .CheckContain(Searcher.SuFigureNo, x=>x.SupplierCode) .WhereIf(Searcher.UploadFlag != null,x => x.UploadErpFlag == Searcher.UploadFlag) + .WhereIf(Searcher.CompanyIsEmpty == true, x => x.CompanyCode == null || x.CompanyCode == "") + .WhereIf(Searcher.CompanyIsEmpty == false, x => x.CompanyCode != null && x.CompanyCode != "") + .WhereIf(Searcher.OrderIsEmpty == true, x => x.SourceCode == null || x.SourceCode == "") + .WhereIf(Searcher.OrderIsEmpty == false, x => x.SourceCode != null && x.SourceCode != "") .Select(x => new InventoryApi_View { ID = x.ID, diff --git a/HHWMS.Web/Areas/Inventory/ViewModels/InventoryVMs/InventoryApiSearcher.cs b/HHWMS.Web/Areas/Inventory/ViewModels/InventoryVMs/InventoryApiSearcher.cs index 0a8f468..0862da6 100644 --- a/HHWMS.Web/Areas/Inventory/ViewModels/InventoryVMs/InventoryApiSearcher.cs +++ b/HHWMS.Web/Areas/Inventory/ViewModels/InventoryVMs/InventoryApiSearcher.cs @@ -29,6 +29,17 @@ namespace HHWMS.Web public int? UploadFlag { get; set; } public string NextBatch { get; set; } + + /// + /// 公司是否为空:不传不筛选,true为空,false非空 + /// + public bool? CompanyIsEmpty { get; set; } + + /// + /// 订单号(SourceCode)是否为空:不传不筛选,true为空,false非空 + /// + public bool? OrderIsEmpty { get; set; } + protected override void InitVM() { } diff --git a/docs/ERP事项三-ERP查看库存接口优化-方案记录.md b/docs/ERP事项三-ERP查看库存接口优化-方案记录.md new file mode 100644 index 0000000..051996f --- /dev/null +++ b/docs/ERP事项三-ERP查看库存接口优化-方案记录.md @@ -0,0 +1,67 @@ +# ERP事项三:ERP查看库存接口优化——实施方案 + +## 1. 范围与确认结果 + +- 接口:`POST /api/Inventory/Search` +- 订单号字段:已确认使用 `Inventory.SourceCode`。 +- 新参数:已确认使用 `CompanyIsEmpty`、`OrderIsEmpty`。 +- 兼容要求:两个参数都不传或传 `null` 时,不增加任何筛选条件,旧ERP调用结果不受影响。 + +## 2. 最小修改方案 + +只修改请求模型和原查询链: + +1. `InventoryApiSearcher` 增加两个 `bool?` 参数。 +2. `InventoryApiListVM` 在参数有明确值时追加空/非空条件。 +3. 不修改Controller、接口地址、请求方式、分页、响应模型和数据库结构。 +4. 不修改 `default` / `cp` 数据连接选择逻辑。 + +| 参数 | 值 | 行为 | +| --- | --- | --- | +| `CompanyIsEmpty` | 不传/`null` | 不筛选公司 | +| | `true` | `CompanyCode` 为 `NULL` 或空字符串 | +| | `false` | `CompanyCode` 非 `NULL` 且非空字符串 | +| `OrderIsEmpty` | 不传/`null` | 不筛选订单号 | +| | `true` | `SourceCode` 为 `NULL` 或空字符串 | +| | `false` | `SourceCode` 非 `NULL` 且非空字符串 | + +仅包含空格的值按非空处理,本次没有增加 `Trim` 或数据清洗,避免扩大影响。 + +## 3. 请求示例 + +旧请求保持不变: + +```json +{"WareHouse":"xb","Page":1,"Limit":20} +``` + +查询公司为空且订单号非空: + +```json +{ + "WareHouse": "xb", + "CompanyIsEmpty": true, + "OrderIsEmpty": false, + "Page": 1, + "Limit": 20 +} +``` + +## 4. 双数据库说明 + +该接口仍使用当前实例的 `default` 数据连接;`WareHouse` 只参与库区筛选,不负责把连接切换到 `cp`。因此: + +- 线边库实例的 `default` 指向线边库数据库; +- 成品库实例的 `default` 指向成品库数据库; +- 本事项不做跨库查询或动态连接改造。 + +## 5. 代码、SQL与回退 + +代码只涉及: + +- `InventoryApiSearcher.cs` +- `InventoryApiListVM.cs` + +本事项没有DDL和数据更新。上线前可分别在两库执行只读脚本 [20260717_inventory_empty_filters_verify.sql](../sql/20260717_inventory_empty_filters_verify.sql),用于预览空/非空数据分布。 + +回退只需恢复上述两个代码文件,不需要数据库回退。 diff --git a/docs/ERP事项三-ERP查看库存接口优化-测试报告.md b/docs/ERP事项三-ERP查看库存接口优化-测试报告.md new file mode 100644 index 0000000..e4552cd --- /dev/null +++ b/docs/ERP事项三-ERP查看库存接口优化-测试报告.md @@ -0,0 +1,45 @@ +# ERP事项三:ERP查看库存接口优化——测试报告 + +## 1. 测试信息 + +- 日期:2026-07-17 +- 接口:`POST /api/Inventory/Search` +- 方式:分别以线边库和成品库作为当前实例的 `default` 连接进行只读HTTP测试 +- 测试数据:现有本地库存;未新增、修改或删除业务数据 + +## 2. 线边库结果 + +| 场景 | Count | 结果 | +| --- | ---: | --- | +| 旧请求,不传新参数 | 853 | 通过 | +| 两参数显式为 `null` | 853 | 通过,与旧请求一致 | +| `CompanyIsEmpty=true` | 853 | 通过,逐行公司为空 | +| `CompanyIsEmpty=false` | 0 | 通过 | +| `OrderIsEmpty=true` | 845 | 通过,逐行 `SourceCode` 为空 | +| `OrderIsEmpty=false` | 8 | 通过,逐行 `SourceCode` 非空 | +| 两个空值条件同时为 `true` | 845 | 通过 | +| `OrderIsEmpty=true` 第2页、每页20条 | 总数845,返回20 | 通过,分页正确 | + +## 3. 成品库结果 + +| 场景 | Count | 结果 | +| --- | ---: | --- | +| 旧请求,不传新参数 | 1635 | 通过 | +| 两参数显式为 `null` | 1635 | 通过,与旧请求一致 | +| `CompanyIsEmpty=true` | 1543 | 通过,逐行公司为空 | +| `CompanyIsEmpty=false` | 92 | 通过,逐行公司非空 | +| `OrderIsEmpty=true` | 1523 | 通过,逐行 `SourceCode` 为空 | +| `OrderIsEmpty=false` | 112 | 通过,逐行 `SourceCode` 非空 | + +所有请求均为HTTP 200、业务 `Code=200`,原响应字段 `Code`、`Count`、`Data`、`Msg`、`Page`、`PageCount` 均未改变。 + +## 4. 其他验证 + +- 最终项目构建:通过,0错误;15个现有编译警告(含.NET 6停止支持提示)。 +- 两个参数不传与显式 `null` 的数量完全一致,旧调用兼容成立。 +- 两参数可独立使用、同时使用,并可与原分页条件组合。 +- [20260717_inventory_empty_filters_verify.sql](../sql/20260717_inventory_empty_filters_verify.sql) 仅包含 `SELECT`,无DDL/DML。 + +## 5. 测试结论 + +线边库和成品库实例均通过空/非空、兼容和分页验证。本事项没有数据库变更及操作流程变化,可随代码直接发布;ERP只需按需增加可选参数,不改也不受影响。 diff --git a/sql/20260717_inventory_empty_filters_verify.sql b/sql/20260717_inventory_empty_filters_verify.sql new file mode 100644 index 0000000..3c751b0 --- /dev/null +++ b/sql/20260717_inventory_empty_filters_verify.sql @@ -0,0 +1,11 @@ +-- ERP事项三:ERP查看库存接口空值筛选 +-- 本事项没有数据库结构和数据变更,本脚本仅用于上线前只读核对基准数量。 +-- 可在 default、cp 数据库分别执行;不会修改任何数据。 + +SELECT + COUNT(*) AS TotalCount, + SUM(CASE WHEN `CompanyCode` IS NULL OR `CompanyCode` = '' THEN 1 ELSE 0 END) AS CompanyEmptyCount, + SUM(CASE WHEN `CompanyCode` IS NOT NULL AND `CompanyCode` <> '' THEN 1 ELSE 0 END) AS CompanyNotEmptyCount, + SUM(CASE WHEN `SourceCode` IS NULL OR `SourceCode` = '' THEN 1 ELSE 0 END) AS OrderEmptyCount, + SUM(CASE WHEN `SourceCode` IS NOT NULL AND `SourceCode` <> '' THEN 1 ELSE 0 END) AS OrderNotEmptyCount +FROM `Inventory`;