Skip to content

数据模型

所有 ORM 模型基于 Tortoise ORM,定义在 app/models/system/admin.py

User(用户)

字段类型说明
user_namestr用户名(唯一)
passwordstr密码(Argon2 哈希)
nick_namestr昵称
genderGenderType性别
emailstr邮箱
phonestr手机号
last_logindatetime最后登录时间
status_typeStatusType状态(启用/禁用)

关联:by_user_roles — 用户 ↔ 角色(多对多)

Role(角色)

字段类型说明
role_namestr角色名称
role_codestr角色编码(唯一,如 R_SUPER)
descriptionstr描述
status_typeStatusType状态

关联:

  • by_role_menus — 角色 ↔ 菜单
  • by_role_apis — 角色 ↔ API
  • by_role_buttons — 角色 ↔ 按钮
  • by_role_home — 角色默认首页
字段类型说明
menu_namestr菜单名称
route_pathstr前端路由路径
componentstr前端组件路径
parent_idint父级 ID
iconstr图标
i18n_keystr国际化 Key
constantbool常量路由
hide_in_menubool菜单中隐藏
keep_alivebool缓存

Api(接口)

字段类型说明
api_pathstr接口路径
api_methodstrHTTP 方法
summarystr接口描述
status_typeStatusType状态

启动时自动从 FastAPI 路由注册到数据库。

Button(按钮)

字段类型说明
button_codestr按钮编码
button_descstr按钮描述
status_typeStatusType状态

数据库

  • 默认:SQLite (app_system.sqlite3)
  • ORM:Tortoise ORM
  • 迁移:Aerich
  • 缓存:Redis (fastapi-cache2)

基于 MIT 协议发布