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/wild-archives-api.md

@@ -4,6 +4,8 @@
 >
 > 目标：维护“极境视界”首页卡片，并提供客片案例更多列表和案例详情页面。
 
+所有 JSON 响应遵循 [三端统一 API 响应契约](./api-response-contract.md)，成功业务对象位于 `data`，失败时 `data` 为 `null`。
+
 ## 领域边界
 
 客片案例是首页内容领域的一类展示内容，不属于商品、Product、ProductImage、订单或预订领域。
@@ -95,15 +97,19 @@ GET /api/public/home/wild-archives
 
 ```json
 {
-  "items": [
-    {
-      "id": "shilong-cave",
-      "title": "石龙洞——客片案例",
-      "image": "https://example.test/cover.jpg",
-      "demandKeyword": "地心探险",
-      "photoCount": 5
-    }
-  ]
+  "code": 200,
+  "msg": "success",
+  "data": {
+    "items": [
+      {
+        "id": "shilong-cave",
+        "title": "石龙洞——客片案例",
+        "image": "https://example.test/cover.jpg",
+        "demandKeyword": "地心探险",
+        "photoCount": 5
+      }
+    ]
+  }
 }
 ```
 
@@ -117,15 +123,19 @@ GET /api/public/home/wild-archives/{archiveId}
 
 ```json
 {
-  "id": "shilong-cave",
-  "title": "石龙洞——客片案例",
-  "image": "https://example.test/cover.jpg",
-  "demandKeyword": "地心探险",
-  "photoCount": 5,
-  "images": [
-    "https://example.test/cover.jpg",
-    "https://example.test/cave-1.jpg"
-  ]
+  "code": 200,
+  "msg": "success",
+  "data": {
+    "id": "shilong-cave",
+    "title": "石龙洞——客片案例",
+    "image": "https://example.test/cover.jpg",
+    "demandKeyword": "地心探险",
+    "photoCount": 5,
+    "images": [
+      "https://example.test/cover.jpg",
+      "https://example.test/cave-1.jpg"
+    ]
+  }
 }
 ```