2ba4250165
- monorepo: pnpm workspace + go.work + pyproject.toml + commitlint/husky - infra: docker-compose (minimal + full profiles) + init-sql + prometheus - arch-scan: multi-language scanner skeleton (TS/Go/Python/Proto) - shared-proto: buf v2 + classes.proto (ClassService CRUD contract) - api-gateway: Go/Gin + JWT HS256 auth + reverse proxy + request ID - classes: NestJS golden template (error system + observability + middleware + CRUD + tests) - teacher-portal: Next.js + paper-feel UI design system - CI/CD: 4 workflows (go/ts/py/proto) - docs: migration guide + project_rules + coding-standards + git-workflow + ui-design-system + 004 + 9 module READMEs + known-issues + spec/plan migration + roadmap
1.5 KiB
1.5 KiB
技术债清单
记录已知的架构问题和技术债，按优先级排序。 新项目从空白起步，随各阶段实施过程中发现的技术债记录于此。
P0 - 高优先级（影响安全/性能/可维护性）
暂无。P1 实施过程中识别的高优先级技术债记录于此。
P1 - 中优先级（影响开发效率/代码质量）
暂无。各阶段实施过程中识别的中优先级技术债记录于此。
P2 - 低优先级（改进项）
暂无。各阶段实施过程中识别的低优先级改进项记录于此。
已解决项
暂无。已解决的技术债记录于此，含解决时间、方案、验证方式。
维护规则
优先级定义
| 优先级 | 含义 | 处理时机 |
|---|---|---|
| P0 | 影响安全/性能/可维护性 | 当前阶段必须解决，或立即修复 |
| P1 | 影响开发效率/代码质量 | 计划在下一阶段或独立迭代解决 |
| P2 | 改进项 | 时间允许时解决，不阻塞阶段推进 |
记录格式
每条技术债包含：
- 编号:
TD-{P0|P1|P2}-{序号}，如TD-P0-001 - 状态: 已识别 / 短期方案已实施 / 计划在某阶段实施 / 已解决
- 影响: 简述对系统的影响
- 方案: 短期方案 + 长期方案
- 关联文件/模块: 便于定位
同步规则
- 发现技术债时立即记录，不在当前阶段实现（YAGNI 原则）
- 解决后移至"已解决项"分区，含解决时间与验证方式
- 每阶段末回顾技术债清单，调整优先级