功能模块清单
7 大功能模块覆盖企业级应用常见场景，开箱即用，可按需扩展
👥
用户管理
完整的用户生命周期管理
- 用户 CRUD（新增/编辑/删除/列表）
- 状态切换（启用/禁用）
- 重置密码
- 分配角色（部门-角色二维树）
- 直接授权（绕过角色单独授权）
- 批量附加部门角色（修复 N+1）
- 敏感字段过滤（password/salt/open_id 等）
后端
app/system/controller/UserController.php前端
admin-frontend/src/views/system/UserManage.vue🎖️
角色管理
角色 CRUD + 权限分配 + 角色层级
- 角色 CRUD（code 自动生成）
- 分配权限（el-tree + check-strictly）
- 默认角色标记（is_default）
- 角色层级（system_role_hierarchy，预留）
- 删除前检查用户占用
- 内置 super_admin / normal_user 两个角色
后端
app/system/controller/RoleController.php前端
admin-frontend/src/views/system/RoleManage.vue🔑
权限管理
树形权限 + 4 种类型 + 可单独授权标记
- 权限 CRUD（树形结构）
- 4 种类型：1 菜单 / 2 按钮 / 3 接口 / 4 隐藏路由
- can_direct_assign 标记是否可单独授权
- 状态切换（启用/禁用）
- 排序调整
- 24 个初始权限码
后端
app/system/controller/PermissionController.php前端
admin-frontend/src/views/system/PermissionManage.vue🏢
部门管理
树形部门 + 负责人/分管领导 + 部门角色
- 部门 CRUD（树形结构，循环引用检测）
- 负责人（leader_id）与分管领导（deputy_director_id）
- 部门角色分配
- 新部门自动分配默认角色
- 删除前检查子部门与关联用户
- 工作类型配置（DepartmentList 版）
后端
app/system/controller/DepartmentController.php前端
admin-frontend/src/views/system/DepartmentList.vue🤖
AI 配置
多供应商 AI 服务配置 + 连接测试
- 支持 OpenAI / 智谱 / DeepSeek / 火山引擎 / 百度千帆
- API Key AES-256-CBC 加密存储
- 连接测试（按 provider 分发）
- 默认配置标记（is_default）
- SSRF 防护（过滤私有/保留 IP）
- 实际生成调用（generate 方法）
后端
app/system/controller/AiConfigController.php前端
admin-frontend/src/views/system/AiConfig.vue💬
反馈管理
用户反馈 + 管理员回复 + Web 公开展示
- 提交反馈（content + contact）
- 我的反馈列表（分页）
- 管理员全量列表（含用户信息）
- 回复反馈（status 0→1）
- 删除反馈
- Web 端公开展示已回复反馈（/public/feedback/published）
- 权限驱动回复表单（feedback:reply）
后端
app/feedback/controller/FeedbackController.php前端
admin-frontend/src/views/system/FeedbackManage.vue⚙️
系统设置
KV 结构 + 分组管理 + 公开接口
- 站点信息（site_name / site_version / site_last_update）
- 客服配置（service_phone / service_wechat / working_hours）
- 公告设置（announcement / show_announcement）
- 公开接口 /common/setting/public（无需登录）
- 版本号与最后更新时间从数据库动态读取（不写死）
- 三端（管理后台/小程序/Web）共享同一设置源
后端
app/system/controller/SettingController.php前端
admin-frontend/src/views/system/SystemSettings.vue权限码清单
24 个初始权限码，覆盖菜单/按钮/接口/隐藏路由四种类型
| 权限码 | 名称 | 类型 | 可单独授权 |
|---|---|---|---|
system | 系统管理 | 菜单 | 否 |
system:user | 用户管理 | 菜单 | 否 |
system:user:view | 查看用户 | 按钮 | 否 |
system:user:create | 创建用户 | 按钮 | 否 |
system:user:update | 编辑用户 | 按钮 | 否 |
system:user:delete | 删除用户 | 按钮 | 否 |
system:role | 角色管理 | 菜单 | 否 |
system:role:create | 创建角色 | 按钮 | 否 |
system:role:update | 编辑角色 | 按钮 | 否 |
system:role:delete | 删除角色 | 按钮 | 否 |
system:permission | 权限管理 | 菜单 | 否 |
system:department | 部门管理 | 菜单 | 否 |
system:department:operate | 部门操作 | 按钮 | 否 |
system:config | 系统配置 | 按钮 | 否 |
feedback | 反馈管理 | 菜单 | 否 |
feedback:view | 查看反馈 | 按钮 | 是 |
feedback:reply | 回复反馈 | 按钮 | 否 |
feedback:delete | 删除反馈 | 按钮 | 是 |
system:ai:config | AI 配置管理 | 菜单 | 否 |
system:setting | 系统设置 | 菜单 | 否 |
默认角色
脚手架预置两个角色，可按需扩展
👑
超级管理员（super_admin）
拥有所有权限，可管理用户、角色、权限、部门、系统配置。
初始账号：手机号 13800000000
👤
普通用户（normal_user）
默认角色（is_default=1），新用户自动分配。
仅有基础查看权限，可通过直接授权扩展。