4.0 KiB
4.0 KiB
WonderQ Admin 业务功能矩阵
本文档是 A+B 并行重构的第一阶段基线。矩阵以当前后端路由、契约文档、React 页面和 MiniAPP 公共接口为准；“已接入”只表示代码已具备，不代表已经完成人工验收。
端与路径
| 端 | 目录 | 当前路径 | 迁移策略 |
|---|---|---|---|
| 后端 | WonderQ-Admin |
/api |
保持 Docker Compose、PostgreSQL、Redis、JWT 和 {code,msg,data} 契约 |
| Vue 管理端 | WonderQ-Admin-UI-Vue |
本地 /admin/，生产 /admin |
新权限壳和业务切片逐项迁移 |
| React 管理端 | WonderQ-Admin-UI |
本地 5602，生产 /admin-legacy |
过渡运行，已接入 Refresh Token 自动刷新 |
| 前台 | WonderQ-MiniAPP |
H5/微信小程序 | 不整体重写，只验证 Public API 兼容 |
业务覆盖矩阵
| 业务切片 | 后端接口/数据 | React 过渡端 | Vue 迁移端 | MiniAPP 依赖 | 当前验收状态 |
|---|---|---|---|---|---|
| 登录、刷新、退出 | /api/admin/auth/login、refresh、logout、/api/admin/me |
兼容旧 token/user 字段，401 自动刷新 |
登录页、内存 Access Token、HttpOnly Refresh Cookie | 无 | 自动化通过，待浏览器人工验收 |
| 仪表盘 | /api/admin/dashboard |
已有 | DashboardPage 已接入 |
无 | 读流程已接入 |
| 首页与站点配置 | /api/admin/site-config 及模块 CRUD、排序 |
已有 | HomePage 已读取全量配置；编辑/排序待迁移 |
/api/public/home、/api/public/site-config |
读契约保持，编辑待验收 |
| 玩法分类与路线 | /api/admin/wanfa/categories 及分类/路线 CRUD |
已有 | WanfaPage 已读取分类和路线；写操作待迁移 |
/api/public/wanfa/categories |
读流程已接入，写流程待迁移 |
| 路线详情 | /api/admin/details 及详情 CRUD |
React 现有玩法流程依赖 | Vue API 类型和页面待补齐 | /api/public/details/{key} |
待迁移 |
| 管家 | /api/admin/concierge/advisors 及 CRUD |
已有 | ConciergePage 已读取顾问；写操作待迁移 |
/api/public/concierge/advisors、详情顾问信息 |
读流程已接入，写流程待迁移 |
| 需求线索 | /api/admin/leads、状态更新 |
已有筛选和状态流转 | LeadsPage 已读取；状态更新/筛选待迁移 |
/api/public/leads |
读流程已接入，写流程待迁移 |
| 媒体 | /api/admin/media-assets、上传 |
React 已有上传 | Vue 页面和上传流程待迁移 | 通过站点配置间接依赖 | 待迁移 |
| 发布、重置 | /api/admin/publish、reset-guizhou-content |
React 现有入口/能力 | Vue 按权限增加二次确认后迁移 | 发布结果影响 Public API | 待迁移，执行前需要人工确认 |
| RBAC 用户 | /api/admin/system/users |
旧角色字段继续兼容 | 系统资源入口已接入读取 | 无 | 后端/读页面已接入，编辑待迁移 |
| RBAC 角色、菜单、部门 | /api/admin/system/roles、menus、depts |
旧端不删除 | Vue 动态菜单、组件白名单和系统资源读取已接入 | 无 | 后端/读页面已接入，完整按钮授权待验收 |
隐藏和横向能力清单
- Admin API 还包括模块新增、更新、删除、排序，以及详情、玩法、管家、首页内容的审计日志。
- 迁移不能只检查可见菜单；
media-assets、publish、reset-guizhou-content、仪表盘统计和所有排序接口必须在验收记录中逐项确认。 - Public API 的首页、玩法、详情、管家、线索和用车需求依赖继续由 MiniAPP 访问；Admin API 不向 MiniAPP 暴露。
- 新 RBAC 迁移为
0025_admin_rbac，资源归属迁移为0026_admin_ownership。两者只提交迁移文件，不在本阶段自动升级数据库。
删除 React 的闸门
只有当矩阵中 Vue 列全部变为“已接入并人工验收”，并且登录刷新、权限、数据范围、Redis 故障、Public API 回归和 Docker 验证记录齐全后，才可以征求确认切换 /admin 与删除 /admin-legacy。