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

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

docs/wanfa-api.md

@@ -2,7 +2,9 @@
 
 > 适用端：`WonderQ-Admin`、`WonderQ-Admin-UI`。
 >
-> 状态：待实现契约。本文件参考 `WonderQ-MiniAPP/src/pages/play/components/playData.ts` 定义玩法分类和路线的数据结构，以及管理端需要的查询、维护和排序接口。它不是 MiniAPP Public API 文档。
+> 状态：已实现契约。本文件参考 `WonderQ-MiniAPP/src/pages/play/components/playData.ts` 定义玩法分类和路线的数据结构，以及管理端需要的查询、维护和排序接口。它不是 MiniAPP Public API 文档。
+
+当前实现：`WonderQ-Admin` 通过迁移 `0015_wanfa` 创建 `WanfaCategory`、`WanfaRoute` 表并导入稳定初始 ID；`WonderQ-Admin-UI` 已接入分类和路线的查询、新增、编辑、删除及排序操作。
 
 ## 领域边界
 
@@ -11,6 +13,7 @@
 - 分类名称和展示顺序。
 - 路线标题、副标题、封面、路线数量和需求关键词。
 - 分类与路线的新增、编辑、删除和排序。
+- 首页玩法推荐与分类的关联由首页内容域维护，本域只提供可被关联的分类和路线数据。
 
 玩法领域不负责：
 
@@ -47,6 +50,7 @@ API 前缀为 `/api/admin`，除登录接口外均需要后台 JWT。
 - 分类和路线的数组顺序就是管理端和前台的展示顺序，接口不要求前端依赖 `sortOrder` 字段。
 - 空集合返回 `[]`，不能返回 `null` 或省略字段。
 - 失败响应沿用 Admin API 约定，包含 `message`、`code` 和可选的 `details`。
+- 被首页玩法推荐关联的分类不能直接删除；需先调用首页内容域的移除关联接口，否则返回 `409 WANFA_CATEGORY_RECOMMENDED`。
 
 ## 数据类型
 
@@ -316,7 +320,7 @@ reorderWanfaRoutes(categoryId: string, itemIds: string[]);
 
 ## 后端落地边界
 
-本契约落地时需要由 `WonderQ-Admin` 补充对应 ORM 模型、迁移、schema、路由、序列化和审计日志；由 `WonderQ-Admin-UI` 补充 API 类型、请求封装、表单和排序交互。接口实现前不要把 `playData.ts` 的静态数据误认为已存在的数据库或 API 数据。
+玩法数据由 `WonderQ-Admin` 的 `WanfaCategory`、`WanfaRoute` ORM 模型和 Admin API 负责持久化；`WonderQ-Admin-UI` 负责 API 类型、请求封装、表单、删除确认和排序交互。`playData.ts` 仅作为迁移初始数据来源，不能视为数据库或 API 数据。
 
 相关文档：