Full Stack FastAPI Template

技术栈与特性

• ⚡ 用于 Python 后端 API 的 FastAPI。
  • 🧰 用于 Python SQL 数据库交互（ORM）的 SQLModel。
  • 🔍 由 FastAPI 使用，用于数据验证与配置管理的 Pydantic。
  • 💾 作为 SQL 数据库的 PostgreSQL。
• 🚀 用于前端的 React。
  • 🧩 构建到后端应用中，并由 FastAPI 与 API 在同一域名下提供服务。
  • 💃 使用 TypeScript、hooks、Vite 以及现代前端技术栈的其他组件。
  • 🎨 用于前端组件的 Tailwind CSS 和 shadcn/ui。
  • 🤖 自动生成的前端客户端。
  • 🧪 用于端到端测试的 Playwright。
  • 🦇 深色模式支持。
• ☁️ 用于部署的 FastAPI Cloud。
• 🐋 用于本地服务和自托管部署的 Docker Compose。
  • 📞 作为带有自动 HTTPS 的反向代理的 Traefik。
• 🔒 默认启用安全的密码哈希。
• 🔑 JWT（JSON Web Token）认证。
• 📫 基于邮件的密码找回。
• ✉️ 用于邮件模板的 React Email。
• 📬 用于开发期间本地邮件测试的 Mailpit。
• ✅ 使用 Pytest 的测试。
• 🏭 基于 GitHub Actions 的 CI（持续集成）和 CD（持续部署）。

仪表盘登录

仪表盘 - 管理员

仪表盘 - Items

仪表盘 - 深色模式

React Email 模板

Mailpit - 本地邮件测试

交互式 API 文档

如何使用

点击本页面顶部的 Use this template 按钮，即可创建一个新的仓库。

后端开发

后端文档：backend/README.md。

前端开发

前端文档：frontend/README.md。

部署

FastAPI Cloud 部署：deployment.md。

使用 Docker Compose 进行自托管部署：deployment-docker-compose.md。

开发

通用开发文档：development.md。

这包括本地 FastAPI 与 Vite 工作流、Docker Compose 服务、.env 配置等内容。

发布说明

查看文件 release-notes.md。

许可

Full Stack FastAPI Template 根据 MIT 许可证条款进行授权。