## [ERR-20260429-005] db:seed 不创建 itadmin，CLAUDE.md 说反了

**日期**: 2026-04-29
**类别**: 文档与实现不一致

### 现象
新 worktree 跑 `npm run db:seed` 看到 "✅ All seeding completed successfully!"，但访问前端登录 itadmin / Admin@2024 报 401 Invalid credentials。SQL 查 `platform_iam.users` 表没有 itadmin。

### 根因
CLAUDE.md「本地启动约定」段写：
> `cd backend && npm run db:seed` ← 首次/空库必须：种入权限/角色/组织/测试用户（含 itadmin）。

但实际 `backend/prisma/seed.ts` 只种角色/权限/AI tool grants，**不创建 itadmin**。itadmin 由独立脚本 `scripts/backend/init/init-itadmin.ts` 创建（CLAUDE.md 同段又把它标为「已废弃」）。

### 正确操作
新 worktree 创建 itadmin：
```bash
cd backend && npm run init:itadmin
```

注意 `init:itadmin` 这个 npm script 需要 `cd ..` + `dotenv` + `NODE_PATH` 拼装环境，直接 `npx ts-node init-itadmin.ts` 会因模块解析失败报 MODULE_NOT_FOUND / bcrypt 类型缺失。**只能走 `npm run init:itadmin`**。

### 修复方向
两个选项二选一（需用户决策，不在本次 PR 范围）：
1. 修改 `seed.ts` 在 force-reset 模式下调用 init-itadmin 逻辑
2. 修改 CLAUDE.md，明确 db:seed 后还需手工跑 `npm run init:itadmin`

### Metadata
- Reproducible: yes（任何全新 worktree / 全新数据库）
- Related Files: backend/prisma/seed.ts, scripts/backend/init/init-itadmin.ts, CLAUDE.md（"本地启动约定"段第 4 步）

---