# 工程待办（TODOs）

> 集中存放**已知但暂不处理**的工程债 / 待办事项。
> 不放具体功能开发的实施计划（那类应该在模块文档或 PR 描述里）。

## 适合放在这里的

- 历史债务（migration drift / orphan 代码 / 旧设计妥协）
- 跨模块的小工程项（基础设施改进 / 工具链优化）
- 规则层定义但实施层暂未做的项（如 IAM "PermissionsGuard 接 admin 审计"）
- 调研出来但优先级不够立刻做的事

## 不适合放这里的

- 业务功能 PRD（→ `docs/modules/{module}/`）
- 具体 PR 的剩余工作（→ PR 描述里的 checklist）
- 单次 session 内的步骤追踪（→ TodoWrite 工具或临时计划文档）

## 文件命名

`<主题简短描述>.md`，例如 `migration-history-debt.md`。

## 每个 TODO 文件应包含

- **状态**：⏳ 待处理 / 🚧 进行中 / ✅ 已完成（完成后归档不删）
- **发现于**：哪次会话/PR/事故
- **优先级**：高 / 中 / 低
- **问题摘要**：1~2 段
- **根因**：为什么会出现
- **影响清单**：会卡什么、不卡什么
- **推荐方案**：步骤 + 工作量估算 + 风险
- **临时缓解**（如有）

## 当前列表

| 文件 | 状态 | 优先级 | 简述 |
|---|---|---|---|
| [migration-history-debt.md](./migration-history-debt.md) | ⏳ 待处理 | 中 | Prisma 迁移历史 fresh replay 卡断点链，需 squash 基线 |
| [dev-script-cleanup.md](./dev-script-cleanup.md) | ⏳ 待处理 | 中（worktree 隔离单项为高） | dev.sh 已知问题清单 + 抽共享配置 + worktree 隔离（解锁 AI 自动启停） |
| [it-operations-merge.md](./it-operations-merge.md) | ⏳ 待处理 | 低 | it-operations 仅文档未开工；待 ops-center v1 上线后决定是否归并 |