SuperAPI AI 工具集

scaffolding-fastapi-dapr

编程与开发

查看项目

更新于 10-16 06:48

技能介绍

用途:按资料所述,该技能用于搭建生产级 FastAPI 后端,结合 SQLModel 做数据库与 API 模型,集成 Dapr 提供发布订阅与定时作业,并使用 JWT/JWKS 做鉴权,适用于以 Neon PostgreSQL 为数据库构建 REST API 的场景。

主要能力:包含 SQLModel 的数据库与 API 模型定义、异步数据库引擎与会话、CRUD 端点、基于 JWKS 的 JWT 鉴权、Dapr 发布订阅订阅与事件发布、Dapr Jobs 定时作业、结构化日志、Repository 与 Service 分层、异步测试,以及项目结构与验证脚本。

使用方式:项目初始化可用 uv init backend && cd backend,并以 uv add fastapi sqlmodel pydantic httpx python-jose uvicorn 添加依赖;开发运行 uv run uvicorn main:app --reload --port 8000,带 Dapr sidecar 运行 dapr run --app-id myapp --app-port 8000 -- uvicorn main:app;认证依赖环境变量 DATABASE_URL 与 SSO_URL,将 postgresql:// 替换为 postgresql+asyncpg://;验证可运行 python3 scripts/verify.py,预期输出 ✓ scaffolding-fastapi-dapr skill ready,若失败需确认 references/ 目录包含两个模式文件,仍失败则停止并报告。

适用场景:需要异步 FastAPI API、SQLModel 数据访问、Dapr 事件驱动与定时任务、JWKS 鉴权和分层测试的后端工程。参考文件包括 references/fastapi-patterns.md、references/dapr-patterns.md、references/sqlmodel-patterns.md、references/production-testing.md。相关技能为 configuring-better-auth 与 fetching-library-docs。

限制:资料未提供具体版本、收费标准、支持平台或性能效果;部分 Dapr Jobs API 标注为 alpha,使用前需自行确认兼容性。