Python · Web 后端阶段 45 项必做
AI 问答 API（接入大模型 + 对话历史存储）
能独立上线一个 Web 服务
难度
建议投入 32–56 小时· 5 条需求验收权重
服务可公网访问；有接口文档；能处理并发与超时40%
核心功能可独立跑通，无阻断性 bug25%
关键路径有测试或可复现的验收脚本15%
README 写清运行方式、架构与踩坑10%
能在 5 分钟内讲清设计与取舍10%
总分 100。低于 60 分说明这个阶段还没过，回去补知识点，不丢人。
项目背景
这是「Python」路径第 4 阶段（阶段四 · Web 后端）的验收项目。本阶段目标是：能独立上线一个 Web 服务。项目不是练习题的堆砌，而是把这一阶段的知识点压缩成一个能演示、能讲清楚取舍的成品。
MVP 目标
- 能独立上线一个 Web 服务
- 做出可运行、可演示的「AI 问答 API」
- 把 FastAPI 路由与依赖注入、SQLAlchemy + PostgreSQL、JWT 鉴权 真正用进项目，而不是停在笔记里
功能需求清单
5 项必做 · 0 项建议- 1对话接口必做
支持流式输出，前端可逐字看到结果。
- 2历史存储必做
按会话 ID 存储多轮对话，支持读取与清空。
- 3鉴权必做
API Key 或 JWT 鉴权，密钥不硬编码。
- 4超时与降级必做
上游超时/失败有重试与友好降级，不阻塞 worker。
- 5容器部署必做
Dockerfile + 环境变量配置，一条命令启动。
技术约束
FastAPI 路由与依赖注入SQLAlchemy + PostgreSQLJWT 鉴权Redis 缓存Docker 部署
交付物
- Git 仓库（含分阶段提交记录，不是最后一次性上传）
- README：项目简介、架构/流程图、运行方式、已知限制
- 演示材料：截图，或 1–2 分钟录屏
- 复盘：做错的 3 个决定与改进方案
加分项
- 多模型路由
- 成本统计
- 限流与配额
最容易翻车的地方
- 同步阻塞导致并发差
- 没有超时设置
- 密钥写进代码提交到仓库
做完之后，简历怎么写
「AI 问答 API」：独立完成 接入大模型、对话历史存储，使用 FastAPI 路由与依赖注入、SQLAlchemy + PostgreSQL、JWT 鉴权；通过「服务可公网访问」验收。
写「做了什么 + 用了什么 + 结果如何」，不要写「参与了 XX 系统」。