WMS_MAIN/temp/docs/role_permission_fk_data_cleanup_plan.md

2.9 KiB
Raw Blame History

role_permission_fk_data_cleanup_plan

更新时间: 2026-03-23 目标: 清理 role/permission 相关孤儿数据,解除 20260323103000-align-role-permission-fk.js 执行阻塞。

1. 审计现状

  • wms_role_permission.permission_id 孤儿记录: 4 条(id: 2, 3, 6, 10)
  • wms_role.store_id 非法哨兵值: 3 条(store_id = 0)
  • 字段类型差异:
    • wms_permission.id: int(11)
    • wms_role_permission.permission_id: bigint(20) unsigned(迁移已处理为对齐)

2. 执行顺序

  1. 备份孤儿数据
  2. 删除 wms_role_permission 孤儿行
  3. 规范 wms_role.store_id = 0 为 NULL(仅对可空字段)
  4. 复核计数
  5. 执行迁移 20260323103000-align-role-permission-fk.js

3. 推荐 SQL(先在测试环境执行)

3.1 备份 role_permission 孤儿行

CREATE TABLE IF NOT EXISTS wms_role_permission_orphan_backup_20260323 AS
SELECT rp.*
FROM wms_role_permission rp
LEFT JOIN wms_permission p ON p.id = rp.permission_id
WHERE p.id IS NULL;

3.2 删除 role_permission 孤儿行

DELETE rp
FROM wms_role_permission rp
LEFT JOIN wms_permission p ON p.id = rp.permission_id
WHERE p.id IS NULL;

3.3 规范 role.store_id 哨兵值

UPDATE wms_role
SET store_id = NULL
WHERE store_id = 0;

3.4 复核

SELECT 'rp_perm_orphan' AS metric, COUNT(*) AS cnt
FROM wms_role_permission rp
LEFT JOIN wms_permission p ON p.id = rp.permission_id
WHERE p.id IS NULL
UNION ALL
SELECT 'role_store_zero' AS metric, COUNT(*) AS cnt
FROM wms_role
WHERE store_id = 0;

4. 回滚思路

  • 若删除孤儿行后需要回滚,可从备份表恢复:
INSERT INTO wms_role_permission (id, role_id, permission_id, created_at)
SELECT id, role_id, permission_id, created_at
FROM wms_role_permission_orphan_backup_20260323;
  • wms_role.store_id 从 0 -> NULL 回滚需结合业务语义,不建议盲目全量回写 0。

5. 交付门禁

清洗和迁移完成后,执行:

  1. node .\\script\\method-output-regression.cjs compare
  2. node .\\script\\tmp-generate-method-regression-test.cjs
  3. npx egg-bin test temp/generated-tests/system.method-output.generated.test.js
  4. 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

通过标准:

  • compare: mismatch=0
  • 回归测试: 全部通过

6. 执行记录(2026-03-23)

  • 备份执行结果:
    • wms_role_permission_orphan_backup_20260323: 4 行
    • wms_role_store_zero_backup_20260323: 3 行
  • 清洗执行结果:
    • role_permission 孤儿删除: 4 行
    • role.store_id=0 -> NULL: 3 行
  • 迁移执行结果:
    • wms_role_permission.permission_id 已对齐为 int(11)
    • 外键 fk_wms_role_permission_permission 已生效
    • SequelizeMeta 已登记 20260323103000-align-role-permission-fk.js
  • 门禁结果:
    • method-output compare: mismatch=0
    • generated regression + smoke: 14 passing