FastAPI 项目模板

要解决什么问题

新建 FastAPI 服务时，常见痛点是目录随意、同步/异步混用、缺少统一的依赖注入与中间件约定，以及测试与数据库接入没有固定套路。结果是后期改路由、换存储或加鉴权时，改动面大、回归成本高。

技能如何帮你落地

本技能围绕生产可用的 FastAPI 工程结构展开，强调：

• 异步优先：REST 与 I/O 密集路径按异步模式组织，便于支撑 Web 服务与微服务形态。
• 依赖注入与中间件：用 FastAPI 原生 Depends 与中间件链表达横切逻辑（鉴权、日志、错误处理等），避免业务代码里散落重复样板。
• 数据层方向：说明如何对接 PostgreSQL、MongoDB 等常见存储的异步用法，使 API 层与持久化边界清晰。
• 可验证的交付：从目标与约束出发，给出可执行步骤与验收方式；更完整的模式与示例见 resources/implementation-playbook.md。

适用边界

适合从零搭新项目或需要统一团队 FastAPI 脚手架的场景。若任务与 FastAPI 模板无关，或必须依赖本技能未覆盖的其他栈/工具，应改用对应领域的技能或文档，而不是硬套本模板。