Files

duanshuwen 548f91c37f refactor: 清理废弃业务模块并更新全栈配置

- 移除后端产品、目的地、活动专题等废弃模块的数据库表与业务代码，删除冗余API接口
- 删除小程序端详情页、线路组件等冗余代码，移除搜索工具与测试用例，调整导航逻辑
- 清理管理端废弃的类型定义、编辑器与测试代码
- 更新项目文档，修正模块维护说明与接口文档内容

2026-08-17 22:43:49 +08:00

WonderQ Admin API 接口需求

本文档描述 WonderQ-Admin-UI 当前使用的 Admin API。接口负责站点内容维护、素材、发布和需求线索管理。

通用约定

方法	路径	用途
`POST`	`/api/admin/auth/login`	后台登录
`GET`	`/api/admin/me`	当前后台用户
`GET`	`/api/admin/dashboard`	工作台统计和最近线索
`GET`	`/api/admin/site-config`	获取全部站点配置
`POST`	`/api/admin/site-config/{module}`	新增模块项
`PATCH`	`/api/admin/site-config/{module}/{id}`	更新模块项
`DELETE`	`/api/admin/site-config/{module}/{id}`	删除模块项
`PATCH`	`/api/admin/site-config/{module}/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`	发布站点快照

SiteModule 只允许以下值：

type SiteModule =
  | "heroSlides"
  | "destinationHero"
  | "demandHero"
  | "demandFeatureCards"
  | "demandForm"
  | "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`	可新增、编辑、删除、排序

GET /api/admin/site-config 返回以上全部模块，包含停用内容，空模块返回 []。

GET /api/admin/dashboard 返回：

{
  stats: {
    newLeadCount: number;
    leadCount: number;
  };
  recentLeads: Lead[];
}

Query 参数：status、sourcePage、keyword、createdFrom、createdTo、take。take 范围为 1-200，默认 100。关键词只搜索联系方式、目的地和备注。

请求：

{ "status": "contacted" }

状态值：new、assigned、contacted、planning、won、invalid。