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
48 lines
1.5 KiB
Markdown
48 lines
1.5 KiB
Markdown
# 技术债清单
|
||
|
||
> 记录已知的架构问题和技术债，按优先级排序。
|
||
> 新项目从空白起步，随各阶段实施过程中发现的技术债记录于此。
|
||
|
||
## P0 - 高优先级（影响安全/性能/可维护性）
|
||
|
||
> 暂无。P1 实施过程中识别的高优先级技术债记录于此。
|
||
|
||
## P1 - 中优先级（影响开发效率/代码质量）
|
||
|
||
> 暂无。各阶段实施过程中识别的中优先级技术债记录于此。
|
||
|
||
## P2 - 低优先级（改进项）
|
||
|
||
> 暂无。各阶段实施过程中识别的低优先级改进项记录于此。
|
||
|
||
## 已解决项
|
||
|
||
> 暂无。已解决的技术债记录于此，含解决时间、方案、验证方式。
|
||
|
||
---
|
||
|
||
## 维护规则
|
||
|
||
### 优先级定义
|
||
|
||
| 优先级 | 含义 | 处理时机 |
|
||
|--------|------|----------|
|
||
| P0 | 影响安全/性能/可维护性 | 当前阶段必须解决，或立即修复 |
|
||
| P1 | 影响开发效率/代码质量 | 计划在下一阶段或独立迭代解决 |
|
||
| P2 | 改进项 | 时间允许时解决，不阻塞阶段推进 |
|
||
|
||
### 记录格式
|
||
|
||
每条技术债包含：
|
||
- **编号**: `TD-{P0|P1|P2}-{序号}`，如 `TD-P0-001`
|
||
- **状态**: 已识别 / 短期方案已实施 / 计划在某阶段实施 / 已解决
|
||
- **影响**: 简述对系统的影响
|
||
- **方案**: 短期方案 + 长期方案
|
||
- **关联文件/模块**: 便于定位
|
||
|
||
### 同步规则
|
||
|
||
- 发现技术债时立即记录，不在当前阶段实现（YAGNI 原则）
|
||
- 解决后移至"已解决项"分区，含解决时间与验证方式
|
||
- 每阶段末回顾技术债清单，调整优先级
|