主题
03 · 开发栈与依赖规范
这一模块解决"未来股东第一个月就能在公司主流栈里写代码"的问题：后端 FastAPI、数据库 PostgreSQL、前端 React + Vite、设计系统 DESIGN.md，外加一份"如何按需装依赖"的硬规范。
选这套栈不是因为它最酷，而是因为它在 AI 协同 上的成熟度最高 —— Cascade / Claude Code / Codex 对它的理解都最好，社区 MCP / Skills 也最齐全。
一、公司默认栈一览
┌──────────────────────────────────────────────────────┐
│ 前端：React 19 + Vite + TypeScript + Tailwind v4 │
│ + shadcn/ui + TanStack Query + react-hook-form │
├──────────────────────────────────────────────────────┤
│ 后端：FastAPI + Pydantic v2 + SQLAlchemy 2.x async │
│ + uv（包管理）+ Alembic（migration） │
├──────────────────────────────────────────────────────┤
│ 数据库：PostgreSQL 16+ （主）/ Redis（缓存与队列） │
├──────────────────────────────────────────────────────┤
│ 设计：DESIGN.md（公司版） + Lucide + Framer Motion │
├──────────────────────────────────────────────────────┤
│ AI 集成：MCP servers + Skills + Vault │
└──────────────────────────────────────────────────────┘二、本模块文档
| 顺序 | 文档 | 重点 |
|---|---|---|
| 1 | 01 · 后端 · FastAPI | 项目结构、Pydantic、异步 SQLAlchemy、Alembic、测试、部署 |
| 2 | 02 · 数据库 · PostgreSQL | 安装、Docker、连接池、迁移、备份、AI 协作 |
| 3 | 03 · 前端 · React + Vite | Vite 脚手架、shadcn/ui、TanStack Query、表单与状态 |
| 4 | 04 · 设计系统 · DESIGN.md | awesome-design-md + 公司专属 DESIGN.md |
| 5 | 05 · 依赖管理与版本规范 | "按需装、按项目锁、按公司清单"三原则 |
| 6 | 06 · 部署到腾讯云 | Lighthouse / CVM、Docker Compose、备案、HTTPS、CI/CD、备份 |
| 7 | 07 · Cloudflare 全球加速 | DNS、CDN、Pages、R2、Workers、Tunnel —— 白嫖到飞起 |
三、核心观点
1. 栈要统一，但不要僵化
- 公司默认栈 = 你的"开箱即用"
- 如果你有更适合的方案 → 写一份 RFC（≤ 1 页）→ 在 #ai-tools 频道讨论 → 确认后写进公司 starters
2. 依赖按需装，按项目锁
- 不在你这台机器全局装一堆 Python / Node 工具
- 每个项目独立 venv / node_modules
- 不要
pip install -g xxx，更不要一行npm install -g 5 个东西 - 详见 05 · 依赖管理与版本规范
3. AI 优先，手敲兜底
- 起新项目 → 用公司 starter + Cascade 一句话生成脚手架
- 加新功能 → 让 Cascade / Claude Code 写第一版，你 review 改 30%
- 遇到深 bug → Codex 推理深度调到 high
- 手敲只是 fallback
4. AI 看得懂的代码 = 好代码
- 强类型（TypeScript strict、Pydantic v2、SQLAlchemy 2.x typed）
- 短函数（≤ 60 行）
- 命名清晰（不要缩写）
- 模块边界明确
这条原则同时利好 AI 协作 和 真人协作。
四、未来股东 · 第一个月在本模块的任务
- [ ] Day 8：05 依赖管理 —— 装好 uv / pnpm / Docker
- [ ] Day 9-10：01 FastAPI —— 起一个 FastAPI + PG 后端，跑通 CRUD + Alembic
- [ ] Day 11：02 PostgreSQL —— 本地 PG + pgvector + 只读 MCP
- [ ] Day 12-13：03 React + Vite —— 起前端 + 对接后端
- [ ] Day 14：04 DESIGN.md —— 套品牌设计系统
- [ ] Day 15：06 部署到腾讯云 —— 把 demo 项目部署到一台轻量服务器
- [ ] Day 16：07 Cloudflare 全球加速 —— 给 demo 项目接上 CF DNS / CDN / 免费 SSL
完成以上 = 你已经具备公司主流栈的 端到端开发 + 上线能力。
继续 → 01 · 后端 · FastAPI