e082bd2d98
- 新增`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文档，调整文档分类顺序将响应契约置于首位
81 lines
2.2 KiB
Python
81 lines
2.2 KiB
Python
from datetime import datetime
|
|
|
|
from fastapi.testclient import TestClient
|
|
|
|
from app.database import get_db
|
|
from app.main import create_app
|
|
from app.models import WanfaCategory, WanfaRoute
|
|
|
|
|
|
class FakeScalarResult:
|
|
def __init__(self, items):
|
|
self.items = items
|
|
|
|
def all(self):
|
|
return self.items
|
|
|
|
|
|
class FakeDb:
|
|
def __init__(self, items):
|
|
self.items = items
|
|
|
|
def scalars(self, _statement):
|
|
return FakeScalarResult(self.items)
|
|
|
|
|
|
def make_route():
|
|
return WanfaRoute(
|
|
id="family-water",
|
|
categoryId="family-route",
|
|
title="亲子玩水",
|
|
subtitle="贵州·轻松节奏与自然课堂",
|
|
image="https://example.test/family-water.jpg",
|
|
routeCount=4,
|
|
demandKeyword="亲子玩水",
|
|
sortOrder=0,
|
|
createdAt=datetime(2026, 1, 1),
|
|
updatedAt=datetime(2026, 1, 2),
|
|
)
|
|
|
|
|
|
def test_public_wanfa_categories_returns_frontend_display_contract_without_auth():
|
|
category = WanfaCategory(
|
|
id="family-route",
|
|
label="亲子路线",
|
|
sortOrder=0,
|
|
createdAt=datetime(2026, 1, 1),
|
|
updatedAt=datetime(2026, 1, 2),
|
|
routes=[make_route()],
|
|
)
|
|
app = create_app()
|
|
app.dependency_overrides[get_db] = lambda: FakeDb([category])
|
|
|
|
try:
|
|
response = TestClient(app).get("/api/public/wanfa/categories")
|
|
finally:
|
|
app.dependency_overrides.clear()
|
|
|
|
assert response.status_code == 200
|
|
assert response.json() == {
|
|
"code": 200,
|
|
"msg": "success",
|
|
"data": {
|
|
"categories": [
|
|
{
|
|
"id": "family-route",
|
|
"label": "亲子路线",
|
|
"routes": [
|
|
{
|
|
"id": "family-water",
|
|
"title": "亲子玩水",
|
|
"subtitle": "贵州·轻松节奏与自然课堂",
|
|
"image": "https://example.test/family-water.jpg",
|
|
"routeCount": 4,
|
|
"demandKeyword": "亲子玩水",
|
|
}
|
|
],
|
|
}
|
|
]
|
|
},
|
|
}
|