# 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`)