# 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`。