refactor: 清理废弃模块并重构管理端与全端代码
- 移除所有废弃的旧首页配置模块，包括destinationHero、demand相关、HomeExperience、vehicleService等表结构与代码，新增数据库迁移删除遗留表 - 重构管理端后台布局为标准RuoYi风格，新增Sidebar、Navbar、SettingsDrawer等组件，替换旧的过渡菜单实现 - 调整移动端响应断点为768px，更新布局相关测试用例，新增布局组件测试 - 删除OperationsTools发布/重置页面，移除/tools菜单入口，清理对应的API调用与测试代码 - 重构玩法模块编辑器：替换旧的图片手动输入框为图片上传组件，移除冗余的取消按钮 - 新增线索查询offset参数支持，完善查询参数处理逻辑 - 优化rbac菜单构建逻辑，新增可见性控制参数 - 修正管家编辑器提示文案，优化系统资源编辑器表单初始化逻辑 - 清理小程序端废弃的体验推荐组件与相关测试代码 - 更新文档与种子脚本，匹配新的API契约与使用说明
This commit is contained in:
duanshuwen
@@ -1,6 +1,6 @@
|
||||
# WonderQ Admin API 接口需求
|
||||
|
||||
本文档描述 `WonderQ-Admin-UI-Vue` 当前使用的 Admin API。接口负责站点内容维护、素材、发布、权限和需求线索管理。
|
||||
本文档描述 `WonderQ-Admin-UI-Vue` 当前使用的 Admin API。接口负责站点内容维护、素材、权限和需求线索管理。
|
||||
|
||||
玩法分类和路线管理的字段、嵌套路由、排序与删除约束见 [wanfa-api.md](./wanfa-api.md)。该文档是本主契约的玩法领域补充，适用端为 `WonderQ-Admin` 和 `WonderQ-Admin-UI-Vue`。
|
||||
|
||||
@@ -49,12 +49,25 @@
|
||||
| `PATCH` | `/api/admin/site-config/{module}/{id}` | 更新模块项 |
|
||||
| `DELETE` | `/api/admin/site-config/{module}/{id}` | 删除模块项 |
|
||||
| `PATCH` | `/api/admin/site-config/{module}/reorder` | 调整排序 |
|
||||
| `GET` | `/api/admin/home/play-recommendations` | 查询首页玩法推荐 |
|
||||
| `POST` | `/api/admin/home/play-recommendations` | 新增首页玩法推荐 |
|
||||
| `PATCH` | `/api/admin/home/play-recommendations/{id}` | 更新首页玩法推荐 |
|
||||
| `DELETE` | `/api/admin/home/play-recommendations/{id}` | 删除首页玩法推荐 |
|
||||
| `PATCH` | `/api/admin/home/play-recommendations/reorder` | 排序首页玩法推荐 |
|
||||
| `GET` | `/api/admin/home/team-buildings` | 查询首页团队共创 |
|
||||
| `POST` | `/api/admin/home/team-buildings` | 新增首页团队共创 |
|
||||
| `PATCH` | `/api/admin/home/team-buildings/{id}` | 更新首页团队共创 |
|
||||
| `DELETE` | `/api/admin/home/team-buildings/{id}` | 删除首页团队共创 |
|
||||
| `PATCH` | `/api/admin/home/team-buildings/reorder` | 排序首页团队共创 |
|
||||
| `GET` | `/api/admin/home/wild-archives` | 查询首页极境视界 |
|
||||
| `POST` | `/api/admin/home/wild-archives` | 新增首页极境视界 |
|
||||
| `PATCH` | `/api/admin/home/wild-archives/{id}` | 更新首页极境视界 |
|
||||
| `DELETE` | `/api/admin/home/wild-archives/{id}` | 删除首页极境视界 |
|
||||
| `PATCH` | `/api/admin/home/wild-archives/reorder` | 排序首页极境视界 |
|
||||
| `GET` | `/api/admin/leads` | 线索列表 |
|
||||
| `PATCH` | `/api/admin/leads/{id}/status` | 更新线索状态 |
|
||||
| `GET` | `/api/admin/media-assets` | 素材列表 |
|
||||
| `POST` | `/api/admin/media-assets/upload` | 上传图片 |
|
||||
| `POST` | `/api/admin/reset-guizhou-content` | 重置站点内容 |
|
||||
| `POST` | `/api/admin/publish` | 发布站点快照 |
|
||||
|
||||
## 站点模块
|
||||
|
||||
@@ -63,33 +76,21 @@
|
||||
```ts
|
||||
type SiteModule =
|
||||
| "heroSlides"
|
||||
| "destinationHero"
|
||||
| "demandHero"
|
||||
| "demandFeatureCards"
|
||||
| "demandForm"
|
||||
| "vehicleOptions"
|
||||
| "vehicleService";
|
||||
| "vehicleOptions";
|
||||
```
|
||||
|
||||
模块职责：
|
||||
|
||||
| 模块 | 主要字段 | 约束 |
|
||||
| -------------------- | ------------------------------------------------------------------ | ------------------------ |
|
||||
| `heroSlides` | `title`、`kicker`、`image`、`isActive`、`sortOrder` | 可新增、编辑、删除、排序 |
|
||||
| `destinationHero` | `title`、`kicker`、`image`、`isActive`、`sortOrder` | 可新增、编辑、删除、排序 |
|
||||
| `demandHero` | `title`、`kicker`、`description`、`steps`、`isActive`、`sortOrder` | 可新增、编辑、删除、排序 |
|
||||
| `demandFeatureCards` | `title`、`description`、`isActive`、`sortOrder` | 可新增、编辑、删除、排序 |
|
||||
| `demandForm` | 表单标签、占位文案、`chips`、`isActive` | 单例，不支持排序 |
|
||||
| `vehicleOptions` | `title`、`description`、`image`、`isActive`、`sortOrder` | 可新增、编辑、删除、排序 |
|
||||
| `vehicleService` | `introTitle`、`intro`、`serviceSections`、`advantages`、`processSteps`、`isActive` | 单例，维护用车需求页说明 |
|
||||
| 模块 | 主要字段 | 约束 |
|
||||
| -------------------- | ---------------------------------------------------- | ------------------------ |
|
||||
| `heroSlides` | `title`、`kicker`、`image`、`isActive`、`sortOrder` | 可新增、编辑、删除、排序 |
|
||||
| `vehicleOptions` | `title`、`description`、`image`、`isActive`、`sortOrder` | 可新增、编辑、删除、排序 |
|
||||
|
||||
`GET /api/admin/site-config` 返回以上全部模块，包含停用内容，空模块返回 `[]`。
|
||||
|
||||
`vehicleService` 为单例配置，`serviceSections` 和 `processSteps` 的每项为 `{ title, description }`，`advantages` 为字符串数组。Admin UI 以每行一项编辑并在保存前去除空行。
|
||||
`GET /api/admin/site-config` 只返回以上两个模块，包含停用内容，空模块返回 `[]`。首页工作台的玩法推荐、万趣用车、团队共创和极境视界由对应领域接口维护；旧需求页主视觉、特色卡片、需求表单、独立体验推荐和旧用车服务配置不再提供接口。
|
||||
|
||||
## 用车需求线索
|
||||
|
||||
`GET /api/admin/leads?leadType=vehicle` 只返回用车线索，可叠加 `status`、`keyword` 和 `take` 筛选。用车线索的 `vehicleDemand` 保留服务类型、日期、地点、人数、行李和车型快照，运营端只负责查看和跟进，不提供车辆库存、排班、计价或订单操作。
|
||||
`GET /api/admin/leads?leadType=vehicle` 只返回用车线索，可叠加 `status`、`keyword`、`offset` 和 `take` 筛选。返回 `data: { items, total, offset, take }`，其中 `take` 最大为 `200`。用车线索的 `vehicleDemand` 保留服务类型、日期、地点、人数、行李和车型快照，运营端只负责查看和跟进，不提供车辆库存、排班、计价或订单操作。
|
||||
|
||||
`PATCH /api/admin/leads/{id}/status` 使用现有状态：`new`、`assigned`、`contacted`、`planning`、`won`、`invalid`。状态变更写入审计日志并返回更新后的线索对象。
|
||||
|
||||
|
||||
Reference in New Issue
Block a user