伪三层架构

mvc 架构作为常规设计模式，在 python web 中很常见，但是三层架构更令人着迷

在 python web 开发中，三层架构的概念并没有通用标准，所以这里我们称之为伪三层架构

但请注意，我们并没有传统的多 app 结构（django、springBoot...），而是自以为是的 app 结构

如果您不喜欢这种模式，可以使用模板对其进行任意改造！

工作流程	java	fastapi_best_architecture
视图	controller	api
数据传输	dto	schema
业务逻辑	service + impl	service
数据访问	dao / mapper	crud
模型	model / entity	model

特性

• 全局 FastAPI PEP 593 Annotated 参数风格
• 全面 async/await + asgiref 异步设计
• 遵循 RESTful API 规范
• 使用 SQLAlchemy 2.0 全新语法
• 使用 Pydantic v2 版本
• 实现角色菜单 RBAC 访问控制
• 集成 Casbin RBAC 访问控制
• 支持 Celery 异步任务
• 自研 JWT 认证中间件
• 支持全局自定义时间时区
• 支持 Docker / Docker-compose 部署
• 集成 Pytest 单元测试

内置功能

• 用户管理：分配角色和权限
• 部门管理：配置组织架构（公司、部门、小组等）
• 菜单管理：设置菜单及按钮级权限
• 角色管理：配置角色、分配菜单和权限
• 字典管理：维护常用参数和配置
• 参数管理：系统常用参数动态配置
• 通知公告：发布和维护系统通知公告信息
• 令牌管理：检测在线状态，支持强制下线
• 多端登录：支持一键切换多端登录模式
• OAuth 2.0：内置自研 OAuth 2.0 授权登录
• 插件系统：热插拔插件设计，降低耦合
• 定时任务：支持定时，异步任务及函数调用
• 代码生成：自动生成代码，支持预览、写入和下载
• 操作日志：记录和查询正常和异常操作
• 登录日志：记录和查询正常和异常登录
• 缓存监控：查询系统缓存信息和命令统计
• 服务监控：查看服务器硬件信息和状态
• 接口文档：自动生成在线交互式 API 文档

项目结构

• backend后端
  • alembic数据库迁移
    • …
  • app应用
    • admin系统后台
      • api接口
        • …
      • crudCRUD
        • …
      • model模型
        • __init__.py必须在此文件内导入所有模型类
        • …
      • schema数据传输
        • …
      • service服务
        • …
      • tests单元测试
        • …
    • generator代码生成
      • …
    • task任务
      • …
    • …
  • common公共资源
    • …
  • core核心配置
    • …
  • database数据库连接
    • …
  • log日志
    • …
  • middleware中间件
    • …
  • plugin插件
    • …
  • scripts脚本
    • …
  • sqlSQL 文件
    • …
  • static静态文件
    • …
  • templates模版文件
    • …
  • utils工具包
    • …
• deploy服务器部署
  • …
• …

贡献者

许可证

本项目由 MIT 许可证的条款进行许可

相关

重要

特此感谢 无名 为此架构无偿设计的 LOGO

版权所有

本文链接：https://fastapi-practices.github.io/fastapi_best_architecture_docs/backend/summary/intro.html

许可证：MIT