用途:为 FastAPI + SQLModel + Neon PostgreSQL 后端开发提供规范,适用于 Render 部署的 API 服务、RESTful API 设计与 MES/ERP 后端。
主要能力:给出分层项目结构(app 下含 main、config、database、dependencies、models、schemas、routers、services、utils);config.py 用 pydantic-settings 管理数据库、API 前缀、JWT 与 CORS 配置;database.py 用 create_engine 连接 Neon,含 pool_pre_ping 与 pool_recycle,并提供 get_session 依赖注入;main.py 用 lifespan 初始化数据库、注册 CORS 与路由、提供 /health 健康检查。
数据与接口:SQLModel 定义基础模型与工单模型,Pydantic 定义请求/响应 schema,统一 ApiResponse 与 PaginatedResponse 格式;路由示例覆盖工单列表、单条查询、新增、更新、删除,含分页、筛选与稽核记录。
认证与错误:dependencies.py 用 HTTPBearer 与 JWT 校验当前用户,并提供 require_role 角色检查;全局异常处理覆盖 HTTPException、IntegrityError 与通用异常。
部署:render.yaml 定义 web 服务与数据库,启动命令为 uvicorn app.main:app --host 0.0.0.0 --port $PORT,requirements.txt 列出 fastapi、uvicorn、sqlmodel、pydantic-settings、python-jose、psycopg2-binary。
限制与规范:禁止 Fallback Mock 数据(数据库失败应回 503)、禁止 Emoji、错误信息使用正体中文、禁止硬编码机敏数据;性能目标为 API 响应 <500ms、数据库查询 <100ms、启动 <30s。具体收费与平台细节暂未提供。