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

105 lines
2.9 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.

# 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 孤儿行
```sql
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 孤儿行
```sql
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 哨兵值
```sql
UPDATE wms_role
SET store_id = NULL
WHERE store_id = 0;
```
### 3.4 复核
```sql
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. 回滚思路
- 若删除孤儿行后需要回滚,可从备份表恢复:
```sql
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