feat(p1): complete P1 foundation stage
Some checks failed
CI Go / test (push) Has been cancelled
CI Proto / lint (push) Has been cancelled
CI Python / test (push) Has been cancelled
CI TypeScript / test (push) Has been cancelled

- 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
This commit is contained in:
SpecialX
2026-07-07 23:39:37 +08:00
commit 2ba4250165
100 changed files with 15242 additions and 0 deletions

View File

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