feat(api): 实现三端统一的JSON API响应契约

- 新增`api_response.py`统一响应封装工具类，提供标准成功/错误响应构造方法
- 重构WonderQ-Admin全局异常处理器，将所有异常转换为标准响应格式
- 修改所有公共和管理端接口的返回逻辑，统一使用`code`（与HTTP状态码一致）、`msg`和`data`的三层结构
- 新增`api-response-contract.md`文档，定义完整的三端统一JSON响应规范
- 更新所有领域API文档，明确业务数据需位于`data`字段内，补充响应格式说明
- 为WonderQ-MiniAPP和WonderQ-Admin-UI新增响应解析逻辑和类型定义，自动完成协议校验和错误处理
- 更新所有测试用例，适配新的响应结构确保接口符合契约要求
- 新增`module-config-api.md`模块配置API文档，补充站点模块配置的接口约定
- 更新项目README文档，调整文档分类顺序将响应契约置于首位

docs/home-api.md

@@ -23,6 +23,8 @@
 
 当前首页通过 `GET /api/public/home` 消费四类内容；三个卡片 mock 数组仍作为接口失败、空响应或字段缺失时的前台 fallback，玩法推荐无本地模拟数据时保持空态。Admin UI 通过本文件列出的 Admin API 维护正式数据。
 
+本文件所有 JSON 示例的业务对象均位于统一响应的 `data` 字段内，完整包裹格式见 [api-response-contract.md](./api-response-contract.md)。
+
 ## 接口清单
 
 API 前缀为 `/api/admin`，除登录接口外均需要后台 JWT。
@@ -69,7 +71,7 @@ MiniAPP Public API：
 - ID 由后端生成并作为非空字符串返回。初始化迁移时应优先保留三个 mock 文件中的稳定 ID。
 - 空集合返回 `[]`，不能返回 `null` 或省略字段。
 - 所有资源的 `sortOrder` 从 `0` 开始，数值越小越靠前；新增未传排序时追加到末尾。
-- 失败响应沿用 Admin API 主契约，包含 `message`、`code` 和可选的 `details`。
+- 成功结果放入 `data`；失败返回数字 `code`、`msg`、`data: null`，可选 `errorCode` 和 `details`。
 
 ## 数据类型
 
@@ -227,25 +229,29 @@ Authorization: Bearer <admin-jwt>
 
 团队共创和极境视界分别使用 `/api/admin/home/team-buildings`、`/api/admin/home/wild-archives`。
 
-成功响应示例：
+成功响应示例（统一响应包裹）：
 
 ```json
 {
-  "items": [
-    {
-      "id": "waterfall-descent",
-      "badge": "玩过推荐",
-      "category": "瀑降体验",
-      "title": "悬崖瀑降",
-      "englishTitle": "WATERFALL DESCENT",
-      "image": "https://example.test/assets/waterfall-descent.jpg",
-      "demandKeyword": "悬崖瀑降",
-      "isActive": true,
-      "sortOrder": 0,
-      "createdAt": "2026-01-01T00:00:00Z",
-      "updatedAt": "2026-01-01T00:00:00Z"
-    }
-  ]
+  "code": 200,
+  "msg": "success",
+  "data": {
+    "items": [
+      {
+        "id": "waterfall-descent",
+        "badge": "玩过推荐",
+        "category": "瀑降体验",
+        "title": "悬崖瀑降",
+        "englishTitle": "WATERFALL DESCENT",
+        "image": "https://example.test/assets/waterfall-descent.jpg",
+        "demandKeyword": "悬崖瀑降",
+        "isActive": true,
+        "sortOrder": 0,
+        "createdAt": "2026-01-01T00:00:00Z",
+        "updatedAt": "2026-01-01T00:00:00Z"
+      }
+    ]
+  }
 }
 ```
 
@@ -253,9 +259,9 @@ Authorization: Bearer <admin-jwt>
 
 ### 新增、编辑与删除
 
-- `POST /api/admin/home/{resource}`：请求体为对应资源的 `Create` 类型，成功返回 `201` 和新建记录；未传 `sortOrder` 时追加到末尾。
-- `PATCH /api/admin/home/{resource}/{id}`：请求体为对应资源的 `Patch` 类型，只更新提交字段；成功返回更新后的记录，不存在返回 `404`。
-- `DELETE /api/admin/home/{resource}/{id}`：成功返回 `{ "id": "..." }`，删除后重新规范化同一资源剩余记录的 `sortOrder`。
+- `POST /api/admin/home/{resource}`：请求体为对应资源的 `Create` 类型，成功返回 `201` 和 `data` 内的新建记录；未传 `sortOrder` 时追加到末尾。
+- `PATCH /api/admin/home/{resource}/{id}`：请求体为对应资源的 `Patch` 类型，只更新提交字段；成功返回 `data` 内的更新记录，不存在返回 `404`。
+- `DELETE /api/admin/home/{resource}/{id}`：成功返回 `data: { "id": "..." }`，删除后重新规范化同一资源剩余记录的 `sortOrder`。
 
 其中 `{resource}` 只能是 `experiences`、`team-buildings` 或 `wild-archives`；对应路径参数分别为 `experienceId`、`teamBuildingId`、`archiveId`。删除不触发商品、订单、预订或线索级联操作。
 
@@ -273,7 +279,7 @@ Content-Type: application/json
 { "itemIds": ["cave-exploration", "waterfall-descent"] }
 ```
 
-成功响应为 `{ "items": [] }`，其中 `items` 是更新 `sortOrder` 后的完整记录列表。缺少 ID、包含未知 ID 或出现重复 ID 时返回 `400 HOME_REORDER_INVALID`。
+成功响应为 `data: { "items": [] }`，其中 `items` 是更新 `sortOrder` 后的完整记录列表。缺少 ID、包含未知 ID 或出现重复 ID 时返回 `400`，业务码为 `HOME_REORDER_INVALID`。
 
 ### MiniAPP Public API