2.1 KiB
2.1 KiB
Association Fix Plan
更新时间: 2026-03-23 适用阶段: Model 重构阶段 4(关联关系规范化)
1. 目标
- 统一 alias 命名规则(belongsTo/hasOne 用单数,hasMany/belongsToMany 用复数)。
- 清理重复或冲突关联定义,避免 include 歧义。
- 保持 system/qimen 输出结构不变,通过 baseline/compare 门禁验证。
2. 已完成修复
2.1 幽灵模型收敛(已完成)
- 将 AccountStoreRole 相关调用链迁移到 AccountStoreEmployee + EmployeeRole + Role + Store。
- 覆盖主链路:
- app/service/systems/store.js
- app/service/systems/account_platform.js
- app/service/systems/auth/user.js
2.2 alias 标准化(已完成)
- 新标准 alias:
- accountStoreEmployees
- employeeRoles
- 已完成调用迁移:
- account_platform 服务 include 与读取逻辑统一为 employeeRoles
- auth/user 服务 include 统一为 employeeRoles
2.3 重复关联清理(已完成)
- 已移除以下重复兼容 alias 定义:
- Account.accountStoreRoles
- AccountStoreEmployee.employeeRole
- Role.employeeRole
- Store.accountStoreEmployee
- 保留必要单数 alias(belongsTo 语义):
- AccountPlatformActive.accountStoreEmployee
3. 验证策略
每批改动执行以下门禁:
- node .\script\method-output-regression.cjs baseline 8
- node .\script\method-output-regression.cjs compare
- node .\script\tmp-generate-method-regression-test.cjs
- npx egg-bin test temp/generated-tests/system.method-output.generated.test.js
- npx egg-bin test test/app/controller/system.user.login.test.js test/app/controller/system.user.info.test.js test/app/controller/home.test.js
4. 当前状态
- 输出一致性门禁:通过(mismatch=0)。
- 关键冒烟测试:通过。
- 对外 API 参数/返回:无结构变更。
5. 剩余工作
- 全量扫描其余模型类方法中的 include alias 一致性(已完成,差集扫描异常项 0 个)。
- 评估并落地 permission.parent_id 自关联约束策略(已完成:root 语义归一为 NULL + 自关联 FK)。
- 进入阶段 5:Model 内部能力清理与边界固化。