WMS_MAIN/stock.todo
2026-03-25 18:12:04 +08:00

113 lines
3.6 KiB
Plaintext
Raw Blame History

This file contains ambiguous Unicode characters

This file contains Unicode characters that might be confused with other characters. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.

# stock.todo
## 任务目标
- 提取 `app/service/systemMethods/stock/warehouse.js` 迁移前 method 的历史测试请求记录。
- 精简并保留新接口(`stock.warehouse.*`)的测试入口。
- 根据输入/输出补全 `warehouse.js` 方法头注释和 API 文档 `description`。
## 迁移方法映射(旧 -> 新)
- `stock.stockWarehouse` -> `stock.warehouse.list`
- `stock.getProhibitedType` -> `stock.warehouse.getProhibitedType`
- `stock.getInfo` -> `stock.warehouse.getInfo`
- `stock.saveWarehouseStock` -> `stock.warehouse.saveWarehouseStock`
- `stock.createWarehouseStock` -> `stock.warehouse.createWarehouseStock`
- `stock.getBarcodes` -> `stock.warehouse.getBarcodes`
- `stock.saveWarehouseStockBarcode` -> `stock.warehouse.saveWarehouseStockBarcode`
- `stock.getStoreStocks` -> `stock.warehouse.getStoreStocks`
- `stock.bindItem` -> `stock.warehouse.bindItem`
- `stock.unbindItem` -> `stock.warehouse.unbindItem`
- `stock.checkItemCodeUnique` -> `stock.warehouse.checkItemCodeUnique`
- `stock.queryStockLogs` -> `stock.warehouse.queryStockLogs`
- `stock.handleBatchDelete` -> `stock.warehouse.handleBatchDelete`
- `stock.deleteUnit` -> `stock.warehouse.deleteUnit`
- `stock.deleteProhibited` -> `stock.warehouse.deleteProhibited`
- `stock.handleBatchChange` -> `stock.warehouse.handleBatchChange`
- `stock.getStockUnits` -> `stock.warehouse.getStockUnits`
- `stock.getUnitList` -> `stock.warehouse.getUnitList`
- `stock.createProhibited` -> `stock.warehouse.createProhibited`
- `stock.createUnit` -> `stock.warehouse.createUnit`
- `stock.search` -> `stock.warehouse.search`
## 历史测试请求记录提取(迁移前/过渡期)
来源:`node_modules/.mochawesome-reports/mochawesome.json`(2026-03-25)
### 记录1:新列表接口请求
- case: `system.stock.warehouse.namespaced.test.js`
- method: `stock.warehouse.list`
- request:
```json
{
"pagination": { "page": 1, "pageSize": 5 },
"where": {}
}
```
- expected:
```json
{
"httpStatus": 200,
"flag": "success",
"code": 200,
"data": {
"list": "Array",
"pagination": "Object"
}
}
```
### 记录2:旧入口退场验证请求(历史)
- case: `system.stock.warehouse.namespaced.test.js`(精简前)
- method: `stock.stockWarehouse`
- request:
```json
{
"pagination": { "page": 1, "pageSize": 5 },
"where": {}
}
```
- expected:
```json
{
"httpStatus": 500,
"flag": "failure",
"code": 500,
"message": "方法 stockWarehouse 不存在"
}
```
### 记录3:where 条件解析服务级样本
来源:`test/app/service/systems/stock_store.stockWarehouse.conditions.test.js`
- input:
```json
{
"where": {
"item_code": { "operator": "like", "value": "SKU" },
"barcode": { "operator": "like", "value": "BC" },
"prohibited_type": { "operator": "eq", "value": 2 },
"quantity": { "operator": "ge", "type": "number", "value": "2" }
},
"pagination": { "page": 1, "pageSize": 10 },
"sort": { "sortField": "quantity", "sortOrder": "ASC" }
}
```
- expected:
```json
{
"code": 200,
"message": "查询成功",
"data.pagination.page": 1,
"data.pagination.pageSize": 10,
"data.queryInfo.hasBarcodeSearch": true
}
```
## 新接口精简测试方案
- 保留:`test/app/controller/system.stock.warehouse.namespaced.test.js`
- 用例:只验证 `stock.warehouse.list` 请求成功与核心返回结构。
- 下沉:复杂 where/operator 组合继续由 service 级测试覆盖。
## 执行结果
- [x] `warehouse.js` 方法头注释补充(输入/输出声明)
- [x] 新接口测试用例精简
- [x] `methods/system.json` 的 `stock.warehouse.*` description 语义化更新(21项)
- [x] 回归测试复跑并记录结果(`8 passing`)