用途:按既定规范生成 FastAPI 路由代码,覆盖认证、响应模型与 HTTP 状态码等常见约定,并附带模板与集成步骤,帮助在项目中保持路由写法一致。\n\n主要能力:提供 assets/template.py 模板,复制后替换占位符即可生成资源路由,包括 {{ResourceName}}(PascalCase,如 Project)、{{resource_name}}(snake_case,如 project)、{{resource_plural}}(复数,如 projects)。认证方面支持两种依赖写法:可选认证 current_user: Optional[User] = Depends(get_current_user),未认证返回 None;强制认证 current_user: User = Depends(get_current_user_required),未认证抛出 401。响应模型通过 response_model 声明单个模型 Item 或列表 list[Item],并配合返回类型标注。HTTP 状态码使用 status 常量,例如创建用 status.HTTP_201_CREATED,删除用 status.HTTP_204_NO_CONTENT。\n\n使用方式:先在 src/backend/app/routers/ 下创建路由,再在 src/backend/app/main.py 中挂载,随后创建对应的 Pydantic 模型,必要时补充 service 层,最后添加前端 API 函数。实际编写时按 Quick Start 复制模板并替换三处占位符。\n\n适用场景:需要在 FastAPI 后端中新增符合既有模式的路由模块,或在项目内统一认证、响应结构与状态码写法时使用。\n\n限制:仅当任务明确匹配上述范围时使用;输出不能替代针对具体环境的验证、测试或专家审查;若缺少必要输入、权限、安全边界或成功标准,应停止并请求澄清。资料未提供收费、价格、支持平台、性能效果等更多信息。
fastapi-router-py
编程与开发
更新于 10-15 23:57