Admin-UI 功能状态跟踪文档
本文档用于记录 admin-ui 前端功能实现状态,避免每次重复分析。
规则:每次修改 admin-ui 功能后,必须同步更新此文档。
一、项目概览
- 技术栈: Vue 3 + Element Plus + Pinia + Vue Router + Axios
- 构建工具: Vite + TypeScript + UnoCSS
- 布局类型: 侧边栏 / 顶栏 / 混合 / 双栏(4种布局支持)
- 国际化: 支持 zh-CN / en-US
二、功能模块清单
1. 系统框架功能
| 功能 |
状态 |
说明 |
| 登录页 |
✅ 完成 |
支持账号密码登录、记住密码 |
| 布局切换 |
✅ 完成 |
4种布局(侧边栏/顶栏/混合/双栏) |
| 主题配置 |
✅ 完成 |
暗黑/明亮模式、主题色、字号 |
| 多标签页 |
✅ 完成 |
TagsBar 支持右键菜单(关闭/刷新/全屏/关闭其他/关闭所有) |
| 个人中心 |
✅ 完成 |
个人信息修改、密码修改 |
| 全屏功能 |
✅ 完成 |
支持页面全屏 |
| 国际化 |
✅ 完成 |
中文/英文切换 |
| 路由守卫 |
✅ 完成 |
未登录自动跳转、已登录禁止访问登录页 |
2. 用户管理模块
| 功能 |
页面 |
状态 |
说明 |
| 用户信息 |
user/info/Index.vue |
✅ 完成 |
增删改查、批量删除、状态切换、导出、角色分配、详情查看 |
| 用户详情 |
user/detail/Index.vue |
✅ 完成 |
增删改查、批量删除、导出 |
| 等级管理 |
user/level/Index.vue |
✅ 完成 |
增删改查、批量删除、状态切换、导出 |
| 等级日志 |
user/level-log/Index.vue |
✅ 完成 |
增删改查、批量删除、状态切换、导出 |
| 收货地址 |
user/address/Index.vue |
⚠️ 待检查 |
页面存在,需确认功能完整性 |
| 账户流水 |
user/account/Index.vue |
⚠️ 待检查 |
页面存在,需确认功能完整性 |
缺失功能:
- ❌ 用户管理页面缺少导入功能(后端
/user/admin/user/import 已提供)
- ❌ 缺少用户详情管理页面(后端
/user/admin/detail/** 已提供)
3. 系统管理模块
| 功能 |
页面 |
状态 |
说明 |
| 菜单管理 |
system/menu/Index.vue |
✅ 完成 |
树形展示、图标选择、平台切换、修复图标 |
| 角色管理 |
system/role/Index.vue |
✅ 完成 |
增删改查、菜单权限分配、状态切换、导出 |
| 部门管理 |
system/dept/Index.vue |
✅ 完成 |
树形展示、增删改查、状态切换 |
| 字典管理 |
system/dict/Index.vue |
✅ 完成 |
字典项管理、增删改查、状态切换、导出 |
| 参数配置 |
system/config/Index.vue |
⚠️ 待检查 |
页面存在,需确认功能完整性 |
| 操作日志 |
system/log/Index.vue |
✅ 完成 |
查看详情、清空日志、删除、导出 |
| 登录日志 |
system/login-log/Index.vue |
✅ 完成 |
清空日志、删除、导出 |
| 租户管理 |
system/tenant/Index.vue |
✅ 完成 |
初始化租户、修改密码、模块编辑、增删改查、导出 |
| OAuth2客户端 |
system/oauth2-client/Index.vue |
⚠️ 待检查 |
页面存在,需确认功能完整性 |
缺失功能:
- ❌ 部门管理页面缺少导出功能(后端
/system/admin/dept/export 已提供)
- ❌ 菜单管理页面缺少导出功能(后端
/system/admin/menu/export 已提供)
4. 订单管理模块
| 功能 |
页面 |
状态 |
说明 |
| 订单列表 |
order/list/Index.vue |
⚠️ 待检查 |
页面存在,需确认功能完整性 |
| 退款记录 |
order/refund/Index.vue |
⚠️ 待检查 |
页面存在,需确认功能完整性 |
5. 内容管理模块 (CMS)
| 功能 |
页面 |
状态 |
说明 |
| 文章管理 |
cms/article/Index.vue |
⚠️ 待检查 |
页面存在,需确认功能完整性 |
| 分类管理 |
cms/category/Index.vue |
⚠️ 待检查 |
页面存在,需确认功能完整性 |
| 轮播图 |
cms/banner/Index.vue |
⚠️ 待检查 |
页面存在,需确认功能完整性 |
6. 营销中心模块
| 功能 |
页面 |
状态 |
说明 |
| 优惠券 |
marketing/coupon/Index.vue |
⚠️ 待检查 |
页面存在,需确认功能完整性 |
| 活动管理 |
marketing/activity/Index.vue |
⚠️ 待检查 |
页面存在,需确认功能完整性 |
7. 演示模块
| 功能 |
页面 |
状态 |
说明 |
| 图标演示 |
demo/Icons.vue |
✅ 完成 |
Tabler 图标库展示 |
| 列表演示 |
demo/list/Index.vue |
✅ 完成 |
标准 CRUD 示例 |
三、前后端 API 对照表
已对接的后端 API
| 后端 Controller |
前端 Service |
对接状态 |
| UserController |
userService.ts |
✅ 已对接(缺少 import) |
| UserDetailController |
❌ 无 |
❌ 未对接 |
| UserLevelController |
levelService.ts |
✅ 已对接 |
| UserLevelLogController |
levelLogService.ts |
✅ 已对接 |
| SysMenuController |
menuService.ts |
✅ 已对接 |
| SysRoleController |
roleService.ts |
✅ 已对接 |
| SysDeptController |
deptService.ts |
✅ 已对接 |
| SysDictTypeController |
dictService.ts |
✅ 已对接 |
| SysDictItemController |
dictItemService.ts |
✅ 已对接 |
| SysConfigController |
configService.ts |
✅ 已对接 |
| SysOperLogController |
operLogService.ts |
✅ 已对接 |
| SysLoginLogController |
loginLogService.ts |
✅ 已对接 |
| SysTenantController |
tenantService.ts |
✅ 已对接 |
| SystemOAuth2ClientController |
oauth2ClientService.ts |
✅ 已对接 |
后端有但前端未对接的 API
| 后端接口 |
说明 |
优先级 |
GET/POST /user/admin/user/import |
用户导入 |
低 |
GET /system/admin/dept/export |
部门导出 |
低 |
GET /system/admin/menu/export |
菜单导出 |
低 |
POST /system/admin/menu/fix-icons |
修复菜单图标 |
中(已在前端调用) |
POST /system/admin/tenant/{tenantId}/init |
初始化租户 |
已对接 |
POST /system/admin/tenant/{tenantId}/admin/password |
修改租户管理员密码 |
已对接 |
GET /user/admin/detail/** |
用户详情管理 |
高(完整页面缺失) |
四、待办事项 (TODO)
高优先级
中优先级
低优先级
五、更新记录
| 日期 |
更新内容 |
更新人 |
| 2025-06-01 |
初始版本,完成系统框架、用户管理、系统管理模块的详细分析 |
AI Assistant |
| 2025-06-01 |
新增用户详情管理页面(Index.vue + UserDetailFormDialog.vue),完善路由、国际化、Service 导出 |
AI Assistant |
| 2025-06-01 |
菜单配置改为 config/menus/ 目录按模块拆分;增加模块管理功能(Nacos配置 + 后端API + 前端模块编辑) |
AI Assistant |
六、使用说明
维护规范
- 新增功能时:在对应模块表格中添加一行,标记状态
- 修改功能时:更新对应行的状态和说明
- 发现问题时:添加到「待办事项」章节
- 完成事项时:将 TODO 项标记为完成,并记录到「更新记录」
提示词模板(复制即用)
场景 1:查看 admin-ui 当前功能状态
场景 2:基于文档开发新功能
场景 3:检查某个模块是否完整
场景 4:完成修改后更新文档
场景 5:对比前后端接口
场景 6:新对话快速上手
提示:本文档位于 /docs/admin-ui-status.md,请确保与代码同步更新。