feat: add empty filters to ERP inventory search

This commit is contained in:
mtf 2026-07-17 16:03:31 +08:00
parent eda824cea7
commit 66a1f60428
5 changed files with 138 additions and 0 deletions

View File

@ -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,

View File

@ -29,6 +29,17 @@ namespace HHWMS.Web
public int? UploadFlag { get; set; }
public string NextBatch { get; set; }
/// <summary>
/// 公司是否为空:不传不筛选,true为空,false非空
/// </summary>
public bool? CompanyIsEmpty { get; set; }
/// <summary>
/// 订单号(SourceCode)是否为空:不传不筛选,true为空,false非空
/// </summary>
public bool? OrderIsEmpty { get; set; }
protected override void InitVM()
{
}

View File

@ -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),用于预览空/非空数据分布。
回退只需恢复上述两个代码文件,不需要数据库回退。

View File

@ -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只需按需增加可选参数,不改也不受影响。

View File

@ -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`;