feat(wanfa): 新增路线详情参考价格配置及展示功能

- 新增数据库迁移脚本，为详情表添加四个价格相关字段
- 完善后端schema校验、序列化逻辑，增加价格相关的数据清理与验证规则
- 新增价格配置校验逻辑，设置起售价时必须选择对应的计价单位
- 在Admin UI详情编辑器中新增价格配置模块，支持配置起售价、计价单位、适用人数范围和价格说明
- 更新小程序端详情页面，支持展示配置的参考价格信息
- 补充相关测试用例，更新API文档与类型定义

docs/admin-api-requirements.md

@@ -6,7 +6,7 @@
 
 管家顾问资料管理的字段、图片、排序与删除约束见 [concierge-api.md](./concierge-api.md)。该文档是本主契约的管家领域补充，适用端为 `WonderQ-Admin` 和 `WonderQ-Admin-UI-Vue`。
 
-详情展示内容的字段、图片、排序与商品领域隔离约束见 [detail-api.md](./detail-api.md)。该文档是本主契约的详情领域补充，适用端为 `WonderQ-Admin` 和 `WonderQ-Admin-UI-Vue`。
+详情展示内容及路线参考价格字段、图片、排序与商品领域隔离约束见 [detail-api.md](./detail-api.md)。该文档是本主契约的详情领域补充，适用端为 `WonderQ-Admin` 和 `WonderQ-Admin-UI-Vue`。
 
 首页和用车站点模块的字段、单例、排序与删除约束见 [module-config-api.md](./module-config-api.md)。
 

docs/detail-api.md

@@ -11,12 +11,14 @@
 - 详情页识别键、标题眉标、出行时长和标题文案。
 - 详情介绍、行程亮点、费用包含、费用不含和注意事项。
 - 详情页图片画廊及图片顺序。
+- 详情页参考价格：价格起始值、单位、适用人数范围和价格说明。
 - 详情页可选的联系管家顾问 ID；顾问资料仍由管家领域维护。
 - 启用状态和详情列表顺序。
 
 本接口不负责：
 
 - 商品、商品价格、商品库存或商品详情表。
+- 订单或预订价格计算；本接口中的价格仅用于路线详情展示。
 - Product、ProductImage 或任何商品外键。
 - 订单、预订、收藏、评价或线索。
 - 管家顾问的头像、二维码、服务详情和管家 CRUD；详情只保存顾问 ID。
@@ -30,6 +32,7 @@
 `detailPresentation.ts` 是前台展示适配器，不是持久化模型：
 
 - `eyebrow`、`duration`、`title`、`subtitle`、`intro`、`highlights`、`included`、`excluded`、`notes`、`gallery` 组成最终展示对象。
+- `priceStartingValue`、`priceUnit`、`pricePeopleRange`、`priceDescription` 组成可选的参考价格展示对象。
 - 当前实现优先消费 Public API 返回的最终展示字段。
 - 接口失败、字段不完整或详情未配置时，MiniAPP 按路线 ID 使用本地网络图片和模拟文案兜底。
 
@@ -76,6 +79,10 @@ type DetailPresentation = {
   excluded: string[];
   notes: string[];
   gallery: string[];
+  priceStartingValue: number | null;
+  priceUnit: "person" | "day" | "group" | null;
+  pricePeopleRange: string;
+  priceDescription: string;
 };
 
 type DetailRecord = DetailPresentation & {
@@ -101,8 +108,12 @@ type PublicConciergeAdvisor = {
   qrImage: string;
 };
 
-type DetailCreate = DetailPresentation & {
+type DetailCreate = Omit<DetailPresentation, "priceStartingValue" | "priceUnit" | "pricePeopleRange" | "priceDescription"> & {
   key: string;
+  priceStartingValue?: number | null;
+  priceUnit?: "person" | "day" | "group" | null;
+  pricePeopleRange?: string | null;
+  priceDescription?: string | null;
   conciergeAdvisorId?: string | null;
   isActive?: boolean;
   sortOrder?: number;
@@ -135,6 +146,10 @@ type DetailReorderRequest = {
 | `excluded` | `string[]` | 是 | “费用不含”列表，保留数组顺序。 |
 | `notes` | `string[]` | 是 | “注意事项”列表，保留数组顺序。 |
 | `gallery` | `string[]` | 是 | 详情图片 URL 列表，按展示顺序返回；建议最多 6 张以匹配当前前台逻辑。 |
+| `priceStartingValue` | `number \| null` | 否 | 参考起始值，单位为万元；未配置时为 `null`，不参与订单或报价计算。 |
+| `priceUnit` | `"person" \| "day" \| "group" \| null` | 否 | 价格展示单位，分别对应“人”“天”“团”；未配置价格时为 `null`。 |
+| `pricePeopleRange` | `string` | 否 | 适用人数范围，例如“2-4人”；仅用于展示。 |
+| `priceDescription` | `string` | 否 | 价格补充说明，例如“价格以最终确认方案为准”。 |
 | `conciergeAdvisorId` | `string \| null` | 否 | 关联的管家顾问 ID；不建立数据库外键，空字符串保存为 `null`。 |
 | `isActive` | `boolean` | 响应必填 | 是否进入已发布前台内容，创建默认 `true`。 |
 | `sortOrder` | `number` | 响应必填 | 非负整数，数值越小越靠前；创建时未传则追加到末尾。 |
@@ -173,6 +188,10 @@ Authorization: Bearer <admin-jwt>
         "excluded": ["往返大交通及个人消费"],
         "notes": ["贵州多山多雨，请准备防滑鞋和轻便雨具。"],
         "gallery": ["https://example.test/assets/detail-01.jpg"],
+        "priceStartingValue": 1.68,
+        "priceUnit": "person",
+        "pricePeopleRange": "2-4人",
+        "priceDescription": "价格以最终确认方案为准。",
         "isActive": true,
         "sortOrder": 0,
         "createdAt": "2026-01-01T00:00:00Z",
@@ -303,13 +322,14 @@ POST /api/admin/media-assets/upload
 Admin UI 应按以下方式调用：
 
 1. 玩法页加载时同时调用玩法分类、`GET /api/admin/details` 和 `GET /api/admin/concierge/advisors`；详情编辑器嵌入现有路线编辑抽屉，不新增侧边菜单。
-2. 新增和编辑表单维护眉标、时长、标题、副标题、介绍和四组列表文案；保存路线时以已保存的路线 ID 作为详情 `key`。
+2. 新增和编辑表单维护眉标、时长、标题、副标题、介绍、价格配置和四组列表文案；保存路线时以已保存的路线 ID 作为详情 `key`。
 3. `highlights`、`included`、`excluded`、`notes` 使用可增删的重复字段编辑器，提交时保留数组顺序，不拼接成换行字符串。
 4. 使用图片上传接口维护 `gallery`，支持新增、删除和调整图片顺序。
-5. 上移或下移详情时提交完整详情 ID 列表，不直接修改本地 `sortOrder` 后假设保存成功。
-6. 删除前要求二次确认；删除成功后以接口返回或重新查询的数据更新列表。
-7. 处理 `401`、`404`、`409`、`422` 和 `5xx`，保存、上传或排序进行中禁用重复提交。
-8. 详情编辑器不得出现 Product ID、ProductImage ID、库存、订单、价格或预订字段；联系管家使用顾问 ID 选择器；详情保存失败时明确提示路线摘要已保存、详情需要重试。
+5. 在详情图片后维护价格起始值、价格单位、适用人数范围和价格说明；价格未配置时提交空值，不能写入前台固定价格。
+6. 上移或下移详情时提交完整详情 ID 列表，不直接修改本地 `sortOrder` 后假设保存成功。
+7. 删除前要求二次确认；删除成功后以接口返回或重新查询的数据更新列表。
+8. 处理 `401`、`404`、`409`、`422` 和 `5xx`，保存、上传或排序进行中禁用重复提交。
+9. 详情编辑器不得出现 Product ID、ProductImage ID、库存、订单或预订字段；联系管家使用顾问 ID 选择器；详情保存失败时明确提示路线摘要已保存、详情需要重试。
 
 建议的 Admin UI API 封装函数：
 
@@ -339,6 +359,10 @@ const presentation: DetailPresentation = {
   excluded: record.excluded,
   notes: record.notes,
   gallery: record.gallery,
+  priceStartingValue: publicDetail.priceStartingValue,
+  priceUnit: publicDetail.priceUnit,
+  pricePeopleRange: publicDetail.pricePeopleRange,
+  priceDescription: publicDetail.priceDescription,
   conciergeAdvisor: publicDetail.conciergeAdvisor ?? null,
 };
 ```

docs/public-api.md

@@ -182,6 +182,10 @@ type PublicDetail = {
   excluded: string[];
   notes: string[];
   gallery: string[];
+  priceStartingValue: number | null;
+  priceUnit: "person" | "day" | "group" | null;
+  pricePeopleRange: string;
+  priceDescription: string;
   conciergeAdvisor: {
     avatar: string;
     name: string;