用途:按既定模式创建 FastAPI 路由,包含认证、响应模型与 HTTP 状态码,适用于构建 REST API 端点。
主要能力:提供路由模板,支持可选认证(Depends(get_current_user),未认证返回 None)与必需认证(Depends(get_current_user_required),未认证抛 401);支持 response_model 声明单个或列表响应;支持通过 status_code 指定 201、204 等状态码。
使用方式:从 assets/template.py 复制模板并替换占位符:{{ResourceName}} 改为 PascalCase 名称(如 Project),{{resource_name}} 改为 snake_case 名称(如 project),{{resource_plural}} 改为复数形式(如 projects)。集成步骤:在 src/backend/app/routers/ 创建路由,在 src/backend/app/main.py 挂载,创建对应 Pydantic 模型,必要时创建服务层,并添加前端 API 函数。
最佳实践:按端点是否调用异步 I/O 选择 def 或 async def,不要在 async def 处理器中调用阻塞 I/O;长生命周期资源(数据库连接池、HTTP 客户端)在 lifespan 中管理并通过 Depends 注入,每请求资源使用 with/async with。
限制:资料未提供具体安装命令、收费信息、支持平台及效果数据;参考文件 references/capabilities.md 含额外非核心能力、操作组覆盖与生产检查清单。