feat: 新增客片案例与团队共创模块，重构玩法与配置

- 新增客片案例全流程功能，包含前台页面、管理端配置、后端API、数据库迁移与文档
- 新增团队共创详情页面与对应接口
- 重构玩法模块：将静态playData替换为动态API获取，拆分类型定义到playTypes.ts
- 优化vite构建配置与环境变量处理，调整详情页操作栏文案
- 更新全量相关文档与配图，新增客片案例、团队共创API文档
- 新增测试用例，完善数据归一化逻辑
- 调整路由配置与环境变量示例文件

docs/concierge-api.md

@@ -2,7 +2,7 @@
 
 > 适用端：`WonderQ-Admin`、`WonderQ-Admin-UI`。
 >
-> 状态：待实现契约。本文件参考 `WonderQ-MiniAPP/src/pages/concierge/components/conciergeTypes.ts` 定义管家顾问资料，以及管理端需要的查询、维护和排序接口。它不是 MiniAPP Public API 文档。
+> 状态：已实现。本文档约定 `WonderQ-Admin`、`WonderQ-Admin-UI` 的管家管理接口，并记录 MiniAPP 使用的对应 Public API。
 
 ## 领域边界
 
@@ -19,7 +19,7 @@
 - 订单、预订、商品和商品图片关联。
 - 管家页面 Hero 文案和服务原则内容。
 
-当前 `WonderQ-MiniAPP/src/pages/concierge/index.vue` 中的 Hero、原则和顾问数据仍是本地静态内容；本契约落地后，Admin UI 维护顾问数据，MiniAPP 再通过独立的 Public API 消费已发布内容。
+当前 `WonderQ-MiniAPP/src/pages/concierge/index.vue` 中的 Hero 和服务原则仍是本地内容；顾问卡片由 Admin UI 维护，MiniAPP 通过独立的 Public API 消费已启用顾问。
 
 ## 接口清单
 
@@ -33,6 +33,12 @@ API 前缀为 `/api/admin`，除登录接口外均需要后台 JWT。
 | `DELETE` | `/api/admin/concierge/advisors/{advisorId}` | 删除管家顾问 |
 | `PATCH` | `/api/admin/concierge/advisors/reorder` | 调整管家顾问展示顺序 |
 
+MiniAPP Public API：
+
+| 方法 | 路径 | 用途 |
+| --- | --- | --- |
+| `GET` | `/api/public/concierge/advisors` | 获取已启用的管家顾问展示数据 |
+
 ## 通用约定
 
 - 请求和响应使用 JSON，字段使用 camelCase。
@@ -227,6 +233,22 @@ Content-Type: application/json
 
 其中 `items` 为更新 `sortOrder` 后的 `ConciergeAdvisorRecord[]`。缺少 ID、包含未知 ID 或出现重复 ID 时返回 `400 CONCIERGE_REORDER_INVALID`。
 
+### MiniAPP Public API
+
+```http
+GET /api/public/concierge/advisors
+```
+
+无需鉴权。接口只返回 `isActive === true` 的顾问，按 `sortOrder` 升序排列，并移除 `id`、`sortOrder`、时间和其他管理字段：
+
+```ts
+type PublicConciergeResponse = {
+  advisors: ConciergeAdvisorContent[];
+};
+```
+
+顾问列表为空时返回 `{ "advisors": [] }`。MiniAPP 应在请求期间展示 loading，失败时展示错误和重试入口，响应字段缺失时通过归一化函数过滤无效顾问。
+
 ## 图片与素材
 
 Admin UI 使用现有素材上传接口获取图片 URL：
@@ -292,7 +314,7 @@ const advisor: ConciergeAdvisor = {
 
 ## 后端落地边界
 
-本契约落地时需要由 `WonderQ-Admin` 补充对应 ORM 模型、迁移、schema、路由、序列化和审计日志；由 `WonderQ-Admin-UI` 补充 API 类型、请求封装、管家列表、表单和排序交互。当前后端没有 `/api/admin/concierge/*` 路由，Admin UI 的管家入口仍是空态，MiniAPP 顾问数据仍在 `index.vue` 中静态定义。
+当前实现由 `WonderQ-Admin` 提供 ORM 模型、`0016_concierge_advisors` 迁移、schema、Admin/Public 路由、序列化和审计日志；由 `WonderQ-Admin-UI` 提供 API 类型、请求封装、管家列表、表单、图片上传、启停、排序和删除确认；由 `WonderQ-MiniAPP` 调用 Public API 并归一化顾问数据。Hero 和服务原则仍不在管家表中维护。
 
 相关文档：