214 lines
7.1 KiB
Markdown
214 lines
7.1 KiB
Markdown
# 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,模型层仅保留实例行为与关联映射。
|