113 lines
3.6 KiB
Plaintext
113 lines
3.6 KiB
Plaintext
# 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`)
|