蜡笔猫导航
full-stack-fastapi-template
一套 FastAPI 加 React 的全栈项目脚手架，已配好用户认证、数据库模型、OpenAPI 文档与容器化启动，用来快速搭起前后端分离的 Web 应用。
它能做什么
- FastAPI + SQLModel 后端，自带 OpenAPI 文档
- React、Vite、Tailwind CSS、shadcn/ui 前端结构
- 内置 JWT 用户认证与 PostgreSQL 数据模型
- Docker Compose 编排本地开发环境
- pytest 与 Playwright 测试配置已就位
适合谁
- 想快速启动前后端分离项目的 Python/React 开发者
- 需要现成登录鉴权与数据库模型的全栈原型
- 团队内部作为统一的项目初始化脚手架
详细介绍
适合用 Python 写后端、React 与 TypeScript 写前端的开发者，尤其是希望项目一开始就具备登录鉴权、数据模型和容器化运行方式，而不想从空目录手动搭环境的人。
后端基于 FastAPI 与 SQLModel 组织数据模型和接口，并自动产出 OpenAPI 文档；前端使用 Vite、React、Tailwind CSS 与 shadcn/ui 构建界面。仓库还包含基于 JWT 的认证流程、GitHub Actions 配置，以及用 Docker Compose 启动本地环境的编排文件，测试方面引入了 pytest 与 Playwright。
它本身是一套完整的应用模板，并非可复用的界面组件集合；使用方式是克隆仓库后按自己的业务替换其中的模型与页面。项目采用 MIT 许可证，可自由修改和自部署。
