FastAPI 路由规范

问题背景

在 FastAPI 项目里，每新增一个资源（如 projects、users）往往要重复写路由文件、挂载、Depends 认证、Pydantic 响应模型和 404/422 等状态码。团队若没有统一约定，容易出现 async def 里调阻塞 I/O、资源生命周期乱建乱关、前后端路径不一致等问题。

技能如何工作

本技能以 assets/template.py 为起点：把 {{ResourceName}}、{{resource_name}}、{{resource_plural}} 换成实际资源名，即可得到一套与项目既有模式对齐的路由骨架。文档中单独说明认证模式、响应模型与 HTTP 状态码的写法，并给出固定集成顺序：

1. 在 src/backend/app/routers/ 新建路由
2. 在 src/backend/app/main.py 挂载
3. 补充对应 Pydantic 模型
4. 按需加服务层
5. 在前端补 API 调用函数

最佳实践强调：按端点是否涉及异步 I/O 选 def 或 async def；数据库连接池、HTTP 客户端等长生命周期对象放在 lifespan 里，经 Depends 注入；单次请求资源用 with / async with 管理。

适用边界

这是路由结构与约定脚手架，不会替你实现具体业务逻辑或 ORM 查询。更细的非核心能力、操作组覆盖与上线检查项见 references/capabilities.md，需自行对照项目安全与部署策略。