1. 文档目的
本文档用于说明当前阶段的技术栈推荐结论，以及中后期可选路线。
2. 当前判断前提
技术栈必须服从以下前提：
- 15、16 为最高设计基线
- 当前阶段优先
模块化单体 - 当前阶段优先稳定生成课程主干
- 技术栈不是当前第一层决策
3. 当前推荐路线
3.1 第一阶段推荐组合
- Web：
Next.js + React + TypeScript - API：
Node.js + TypeScript - Workspace：
pnpm workspace - DB：
PostgreSQL - Queue：
Redis + BullMQ - Object Storage：
MinIO / S3 - Streaming：
SSE
3.2 推荐原因
- 与当前仓库上下文连续
- 最适合先搭模块化单体
- 先保住迁移成本和认知成本
- 足以支撑 P0 正向主链
4. 当前不建议前置的路线
当前不建议把以下事项提前为前置决策：
- 先切 NestJS
- 先切 FastAPI
- 先切 Go
- 先上 Temporal
- 先做微服务拆分
原因不是这些路线不好，而是当前主目标不是平台化扩张，而是先让课程主干稳定生成。
5. 环境与基础设施基线
建议当前统一基线：
- Node
>= 20.9 - pnpm
>= 10 - PostgreSQL
- Redis
- MinIO
6. Adapter 边界要求
无论选哪套技术栈，以下边界都必须成立：
- LLM adapter
- Image / Video adapter
- TTS / ASR adapter
- PDF adapter
- Search adapter
- Storage / Queue adapter
provider SDK 不得直写进课程内核。
7. 中后期可选路线
7.1 稳健升级
- 继续 TS 生态
- API 从当前实现逐步演进为更独立服务
7.2 平台化升级
- 在协议和模块边界稳定后，再评估 NestJS / FastAPI / Go
7.3 工作流升级
- 当生成链足够复杂后，再评估 Temporal 或更强工作流系统
8. 结论
当前技术栈结论不是“永远不换”，而是：
- 当前先在 TS / Next 生态下完成模块化单体重构
- 先支撑
forward_design主链 - 等协议、骨架和任务模型稳定后，再做更大技术替换