# FastSoyAdmin [](./LICENSE) [](https://github.com/sleep1223/fast-soy-admin) [](https://github.com/sleep1223/fast-soy-admin)     [](https://github.com/psf/black) [](https://github.com/Microsoft/pyright) [](https://github.com/astral-sh/ruff) English | 中文

[!NOTE] 如果您觉得 FastSoyAdmin 对您有所帮助，或者您喜欢我们的项目，请在 GitHub 上给我们一个 ⭐️。您的支持是我们持续改进和增加新功能的动力！感谢您的支持！

简介

FastSoyAdmin 是一个现代且功能强大的后台管理模板，采用最新的技术栈，前端使用 Vue3、Vite5、TypeScript、Pinia 和 UnoCSS。后端采用 FastAPI、Pydantic 和 Tortoise ORM，并提供完善的 ApiFox 在线文档。它内置丰富的主题配置和组件，代码规范严谨，实现了自动化的文件路由系统。FastSoyAdmin 为您提供一站式的后台管理解决方案，开箱即用，同时也是快速学习前沿技术的最佳实践。

特性

• 前沿技术应用：后端采用 FastAPI, Pydantic, Tortoise ORM, 前端采用 Vue3, Vite5, TypeScript, Pinia 和 UnoCSS 等最新流行的技术栈。
• 独特的权限控制：后端实现了独特的权限控制，前后端用户角色权限严格分离。
• 详细的日志管理：基于SoybeanAdmin，结合实际业务需求，新增了日志管理和API权限控制功能，实现了后端权限的二次验证。
• 后端集成大量实用工具：代码耦合度低，并重写了部分实用函数。
• 清晰的项目架构：采用 pnpm monorepo 架构，结构清晰，优雅易懂。
• 严格的代码规范：前端遵循 SoybeanJS 规范，集成了eslint, prettier 和 simple-git-hooks，后端使用 Ruff 和 Pyright, 保证代码的规范性。
• TypeScript： 支持严格的类型检查，提高代码的可维护性。
• 丰富的主题配置：内置多样的主题配置，与 UnoCSS 完美结合。
• 内置国际化方案：轻松实现多语言支持。
• 丰富的页面组件：内置多样页面和组件，包括403、404、500页面，以及布局组件、标签组件、主题配置组件等。
• 命令行工具：内置高效的命令行工具，git提交、删除文件、发布等。
• 移动端适配：完美支持移动端，实现自适应布局。

相关

• 预览地址
• 项目文档
• Apifox文档
• Github 仓库
• SoybeanAdmin
• FastAPI
• Tortoise ORM

示例图片

使用

方法一

克隆项目

$ git clone https://github.com/sleep1223/fast-soy-admin

Docker Compose部署

$ sudo docker compose up -d

查看日志

$ sudo docker compose logs -f # 查看所有日志
$ sudo docker compose logs -f app # 单独查看 FastAPI 日志
$ sudo docker compose logs -f nginx # 单独查看 Nginx 日志
$ sudo docker compose logs -f web # 单独查看 pnpm build 日志

改动重新部署

$ sudo docker compose down && sudo docker compose up -d

方法二

环境准备

确保你的环境满足以下要求：

• git: 你需要使用 git 来克隆和管理项目版本。
• python: >= 3.10
• NodeJS: >=18.0.0，推荐 18.19.0 或更高。
• pnpm: >= 8.0.0，推荐最新版本。

克隆项目

$ git clone https://github.com/sleep1223/fast-soy-admin

安装依赖

$ pdm install 或者 pip install -r requirements.txt
$ cd web && pnpm i

由于本项目采用了 pnpm monorepo 的管理方式，因此请不要使用 npm 或 yarn 来安装依赖。

启动项目

前端

$ cd web && pnpm dev

后端

$ pdm run run.py 或者 python run.py

构建项目

$ cd web && pnpm build

TODO

• [ ] 使用 Redis 优化响应速度
• [x] 使用 Docker 部署
• [ ] 集成 FastCURD

如何贡献

我们热烈欢迎并感谢所有形式的贡献。如果您有任何想法或建议，欢迎通过提交 pull requests 或创建 GitHub issue 来分享。

贡献者

感谢以下贡献者的贡献。如果您想为本项目做出贡献，请参考 如何贡献。

Star 趋势

开源协议

项目基于 MIT © 2024 协议，仅供学习参考，商业使用请保留作者版权信息，作者不保证也不承担任何软件的使用风险。