61 lines
2.1 KiB
Markdown
61 lines
2.1 KiB
Markdown
# 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. 验证策略
|
||
|
||
每批改动执行以下门禁:
|
||
|
||
1. node .\\script\\method-output-regression.cjs baseline 8
|
||
2. node .\\script\\method-output-regression.cjs compare
|
||
3. node .\\script\\tmp-generate-method-regression-test.cjs
|
||
4. npx egg-bin test temp/generated-tests/system.method-output.generated.test.js
|
||
5. 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 内部能力清理与边界固化。 |