105 lines
2.9 KiB
Markdown
105 lines
2.9 KiB
Markdown
# 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
|