04 第4周D18 项目开发第1天
D18 项目开发 · 第 1 天：开工
D18 项目开发 · 第 1 天：开工
项目期。今日目标：四个模块骨架全部立起来，各自的"最小可用路径"能跑通。全天用 Claude Code 开发，遵守 D16 方法论。
今日目标（对应作业.md 检查点）
- A：代理服务能启动，
/v1/chat/completions路由存在（转发可先用 mock/本地）。 - B：计费引擎能启动，三张表建好，verify/deduct 接口有响应（幂等逻辑写出来）。
- C：面板能启动，路由配好，能调到 B 的 admin 接口（哪怕数据没接全）。
- D：三服务目录结构 + compose 草稿，
docker compose build至少能过。 - 全员：
docs/training/项目/下有各人模块目录与 README 首版。
开发建议（各模块）
A 代理服务
- 顺序：FastAPI 骨架 → 请求模型（OpenAI 兼容）→ 鉴权依赖（Bearer 读 key）→ 调 B 的 verify → 转发（先 mock 上游）→ 调 B 的 deduct。
- 用 Claude Code 拆步：让 AI 先出 plan，再逐步实现。
B 计费引擎
- 顺序：三张表 SQL → asyncpg 连接封装 → verify → deduct（含幂等：request_id 存在则返回原结果）→ admin 接口。
- 幂等是今天的重点：deduct 里先按 request_id 查，有则返回已记的 cost/balance，不重复扣。
C 管理面板
- 顺序：Vite 项目 → 路由 → 用户列表页（调 GET /admin/users）→ 充值/流水页骨架。
- 调不通 B 就先 mock 数据，但字段要与契约一致。
D 部署
- 顺序：三服务 Dockerfile → compose（web=billing, proxy, panel）→ 环境变量占位 → 联调脚本初稿。
- 今天只求
compose build通过。
站会（早上 5 分钟）
- 每人一句：昨天（D17）设计是否定了 / 今天第一个要干的是什么 / 卡在哪。
讲解节奏建议（非授课，改成站点指导）
| 时段 | 安排 |
|---|---|
| 09:00-09:20 | 站会 + 今日目标对齐 |
| 09:20-12:00 | 各人开发（讲师巡回答疑） |
| 13:30-16:30 | 继续开发 |
| 16:30-17:00 | 每人 2 分钟演示"今天跑通了什么" + 明日计划 |
常见误区（第 1 天高频）
| 误区 | 正确理解 |
|---|---|
| 一上来就写转发 | 先骨架 + mock 打通，再逐步替换真实现 |
| deduct 忘了幂等 | request_id 去重是契约要求，今天必须落地 |
| 各自调不通就互相等 | 用 mock 数据先跑通自己的，契约字段一致即可 |
| 让 AI 一把梭写完 | 拆小步，每步"看懂+验证"再前进 |
| 契约临场改 | 今天改契约必须@全员 + 更新文档 |