WMS_MAIN/model_cleanup_list.md
2026-03-23 17:10:07 +08:00

214 lines
7.1 KiB
Markdown
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.

# model_cleanup_list
更新时间: 2026-03-23
阶段: 5.1 识别应迁移到 service 层的方法能力(第一批)
## 1. 盘点结论
- 扫描范围: app/model/**/*.js
- 检出方法总数: 102(实例 + 静态)
- 高优先候选(应迁移到 service): 24
- 低风险可移除候选(当前未发现业务调用): 18
- 保留在模型层(轻量领域判断/展示映射): 22
说明:
- 本次调用扫描采用“静态方法名精确匹配”策略(Model.method(...))。
- 对“应迁移”项,目标是把跨表编排、状态机、批量事务、库存分配等逻辑从 model 剥离到 systems service。
## 2. 第一批应迁移(P1)
### 2.1 入库单聚合与状态流转
- 文件: app/model/entry_order.js
- 候选方法:
- findByOrderCode
- findByStatus
- getStatsByWarehouse
- updateSyncStatus
- updateOrderStatus
- calculateReceivedQuantities
- 迁移目标:
- app/service/systems/entry_order.js
- 原因:
- 含分页查询、跨表 include、状态流转约束、聚合统计,属于业务编排而非数据映射。
### 2.2 入库明细批量更新与进度汇总
- 文件: app/model/entry_items.js
- 候选方法:
- batchUpdateReceived
- getOrderProgress
- 迁移目标:
- app/service/systems/entry_order.js(或 app/service/systems/storage/receiving.js)
- 原因:
- 含事务控制、批量更新和跨记录校验,属于服务层职责。
### 2.3 库存分配/锁定编排
- 文件: app/model/storage.js
- 候选方法:
- updateQuantity
- lockQuantity
- unlockQuantity
- allocateQuantity
- getStockSummary
- getSpaceUsage
- findByStockAndBatch
- findBySpace
- findAvailableByWarehouse
- findExpiringSoon
- 迁移目标:
- app/service/systems/stock_store.js
- app/service/systems/storage/receiving.js
- 原因:
- 涉及库存扣减/锁定语义、聚合统计和业务筛选,属于库存域服务。
### 2.4 角色权限写入与查询编排
- 文件: app/model/role.js
- 候选方法:
- assignPermissions
- getPermissionTree
- getPermissionIds
- 文件: app/model/role_permission.js
- 候选方法:
- bulkAssign
- clearRolePermissions
- getRolePermissions
- hasPermission
- 迁移目标:
- app/service/systems/auth/user.js
- 新增 app/service/systems/auth/role_permission.js(推荐)
- 原因:
- 包含权限关系写操作、树构建和权限判定,应集中在鉴权服务边界。
### 2.5 商家数据校验与查询助手
- 文件: app/model/store.js
- 候选方法:
- validateStoreData
- checkCompanyNameExists
- findByAccountId
- findAllEnabled
- findAllWarehouses
- 迁移目标:
- app/service/systems/store.js
- 原因:
- 请求参数校验和查询策略属于服务层,不应下沉到 model。
## 3. 可移除候选(P2,先验证后删)
- 已执行(第一批):
- app/model/api_app.js: `findByAppKey`、`findByQimenConfig`(已删除)
- app/model/interface_type.js: `findByCode`、`findEnabled`(已删除)
- app/model/print_item.js: `getGroupFields`、`getTableConfigs`(已删除)
- 门禁结果: compare mismatch=0,generated regression + smoke=14 passing
- 已执行(第二批):
- app/model/i18n_translation.js: `getTranslation`、`batchGetTranslations`、`getProjectTranslations`、`upsertTranslation`、`getUntranslated`(已删除)
- app/model/stock_store.js: `findByItemCode`、`findByStore`(已删除)
- 门禁结果: compare mismatch=0,generated regression=8 passing,smoke=6 passing(合计 14 passing)
- app/model/i18n_translation.js:
- getTranslation
- batchGetTranslations
- getProjectTranslations
- upsertTranslation
- getUntranslated
- app/model/interface_type.js:
- findByCode
- findEnabled
- app/model/print_item.js:
- getGroupFields
- getTableConfigs
- app/model/api_app.js:
- findByAppKey
- findByQimenConfig
- app/model/stock_store.js:
- findByItemCode
- findByStore
说明:
- 上述方法本轮未检出业务层调用,建议先完成一次“删除前引用复核”再执行清理。
### 3.1 删除前引用复核(第二批)
- 复核时间: 2026-03-23
- 复核范围:
- app/model/i18n_translation.js
- app/model/stock_store.js
- app/service/**/*.js
- app/controller/**/*.js
- test/**/*.js
- script/**/*.js
- 复核方式:
- 方法名精确检索: getTranslation / batchGetTranslations / getProjectTranslations / upsertTranslation / getUntranslated / findByItemCode / findByStore
- 模型调用链检索: I18nTranslation.<method>、ctx.model.I18nTranslation.<method>、StockStore.<method>、ctx.model.StockStore.<method>
- 动态调用兜底检索: ['methodName'] 形式
- 复核结论:
- 未检出 I18nTranslation 5 个候选静态方法的业务调用。
- 未检出 StockStore 2 个候选静态方法的业务调用。
- 检出 I18n 相关业务仍直接使用了模型基础能力(findAll/findOne/create/count),不受本次候选方法删除影响。
- 可执行动作:
- 已执行清理并通过门禁,第二批可删除候选已关闭。
## 4. 保留在模型层(P3)
建议保留:
- 轻量实例判断(isEnabled/isHidden/isExpired 等)。
- 纯格式/展示映射(getTypeName/getRoleTypeName/getScopeName)。
- 与关联语义绑定的 include 构造器(StoreWarehouse.buildStoreStockInclude)。
## 5. 下一步(5.2 输入)
1. 已完成 P1 第一组迁移:EntryOrder / EntryItems 的 8 个静态方法已迁移到 app/service/systems/entry_order.js,并从 model 删除。
2. 已完成 P1 第二组迁移:Storage 的 10 个静态方法已迁移到 app/service/systems/storage/index.js,并从 model 删除。
3. 下一步继续迁移 P1 剩余项:RolePermission / Store。
4. 最后补 model_boundary_rules.md,固化模型层边界。
## 6. 已执行(P1 第一组)
- 执行时间: 2026-03-23
- 迁移范围:
- app/model/entry_order.js
- app/model/entry_items.js
- app/service/systems/entry_order.js
- 迁移方法:
- EntryOrder.findByOrderCode
- EntryOrder.findByStatus
- EntryOrder.getStatsByWarehouse
- EntryOrder.updateSyncStatus
- EntryOrder.updateOrderStatus
- EntryOrder.calculateReceivedQuantities
- EntryItems.batchUpdateReceived
- EntryItems.getOrderProgress
- 说明:
- 对外 system/qimen method 未新增接口,属于内部职责收敛。
- `calculateReceivedQuantities` 在 service 中改为显式查询 Storage 聚合,避免原 model 版本的相关子查询别名漂移风险。
- 门禁结果:
- compare mismatch=0
- generated regression=8 passing
- smoke=6 passing
- tests=14 passing
## 7. 已执行(P1 第二组)
- 执行时间: 2026-03-23
- 迁移范围:
- app/model/storage.js
- app/service/systems/storage/index.js
- 迁移方法:
- Storage.findByStockAndBatch
- Storage.findBySpace
- Storage.findAvailableByWarehouse
- Storage.findExpiringSoon
- Storage.updateQuantity
- Storage.lockQuantity
- Storage.unlockQuantity
- Storage.allocateQuantity
- Storage.getStockSummary
- Storage.getSpaceUsage
- 说明:
- 对外 system/qimen method 未新增接口,属于内部职责收敛。
- 更新类方法统一进入 service,模型层仅保留实例行为与关联映射。