2.2 KiB
2.2 KiB
| title | created | updated | type | tags | sources | ||||
|---|---|---|---|---|---|---|---|---|---|
| Base 模块 | 2026-04-13 | 2026-05-15 | entity |
|
|
Base 模块
系统基础设施模块，提供用户认证、RBAC 权限、菜单管理、部门管理等核心能力。
数据模型（11个表）
| 表名 | 用途 |
|---|---|
base_sys_user |
后台管理员 |
base_sys_role |
角色 |
base_sys_menu |
菜单和权限配置（树形） |
base_sys_department |
部门（树形） |
base_sys_param |
系统参数 |
base_sys_log |
操作日志 |
base_sys_conf |
系统配置 |
base_sys_user_role |
用户-角色关联 |
base_sys_role_menu |
角色-菜单关联 |
base_sys_role_department |
角色-部门关联 |
认证流程
JWT Token 认证：
- 登录 → 返回
token+refreshToken - 请求头
Authorization: Bearer {token} - Token 过期 → 用 refreshToken 刷新
- 前端拦截器自动处理刷新逻辑
菜单驱动路由
前端路由由 base_sys_menu 表动态生成：
type=0：目录type=1：菜单页面（viewPath指向 Vue 组件）type=2：按钮权限（perms标识如project:info:add）
数据源管理菜单
2026-05-15 后，mysql-data-source 的管理入口放在“系统管理 -> 数据源管理”，路径为 /sys/data-source，视图为 modules/base/views/data-source.vue。
这个入口不是硬编码在前端静态路由里，而是依赖 Base 模块菜单表：
packages/backend/src/modules/base/menu.json保存“数据源管理”种子菜单。packages/backend/src/modules/base/event/menu.ts在后端启动时同步/sys/data-source到base_sys_menu，并给 admin 角色补齐菜单权限。- 前端通过
/admin/base/comm/permmenu获取菜单后动态生成路由；packages/frontend/src/modules/base/config.ts不再重复声明该静态页面。
因此如果页面看不到，优先检查 base_sys_menu 和角色菜单关系，而不是只看 Vue 文件是否存在。
相关页面
- project-overview — 项目总览
- cool-admin-framework — 框架提供自动 CRUD
- frontend-architecture — 前端动态路由
- mysql-data-source — 数据源管理菜单和配置页