SuperAPI AI 工具集

building-python-web-apps

编程与开发

查看项目

更新于 10-16 01:50

技能介绍

用途:为中小型 SaaS 应用提供一套有主见的、开箱即用的参考架构,让新项目在数小时内完成“认证+计费+部署”,而非数周。默认技术栈固定为 FastAPI(异步)+ uvicorn、uv + pyproject.toml + uv.lock、Postgres 16 + asyncpg + SQLAlchemy 2.0 异步 + Alembic、pydantic-settings、Stripe ≥15、bcrypt 认证、Jinja2 + Tailwind + Alpine.js 或解耦 SPA、cron-as-worker 后台任务、Sentry + PostHog 可观测性、Docker 部署到托管平台(Terraform 管理)、ruff + pytest 测试。

主要能力:提供分层包结构(routes → services → models),业务逻辑不写在路由中;模块级 app 与循环注册路由、中间件、健康检查;懒加载异步引擎与 get_session 依赖;统一 Settings 配置与密钥校验;Stripe 单一签名 webhook 与幂等表;四种认证方案(cookie-JWT、bearer-JWT/API-key、magic-link、OAuth);后台任务三种模式;Docker 单镜像运行 web/worker/migrate;Terraform 基础设施即代码;以及结构、数据、配置、计费安全、发布等审查清单。

使用方式:按默认栈逐行采用,参考文件(STACK.md、PAYMENTS.md、AUTH.md、BACKGROUND_JOBS.md、FRONTEND.md、DEPLOYMENT.md)提供可复制模板。仅在前端、认证方案、后台任务、LLM 功能等少数决策点按需选择。

适用场景:个人或小团队快速交付中小型 SaaS。限制:资料未提供具体收费、价格、平台效果或完整代码示例;部分细节需查阅对应参考文件。