refactor: 推进后端分层架构治理

app/api/endpoints/anilist.py

@@ -2,7 +2,9 @@ from typing import Annotated, Optional
 
 from fastapi import Depends, Query
 
-from app import schemas
+from app.schemas.context import MediaPerson as _SchemaMediaPerson
+from app.schemas.token import TokenPayload as _SchemaTokenPayload
+from app.schemas.workflow import MediaInfo as _SchemaMediaInfo
 from app.api.response import ResponseAPIRouter
 from app.chain.anilist import AniListChain
 from app.domain.context import MediaInfo
@@ -14,26 +16,26 @@ PageParam = Annotated[int, Query(ge=1)]
 CountParam = Annotated[int, Query(ge=1, le=50)]
 
 
-def _serialize_medias(medias: list[MediaInfo]) -> list[schemas.MediaInfo]:
+def _serialize_medias(medias: list[MediaInfo]) -> list[_SchemaMediaInfo]:
     """
     将内部媒体对象转换为 REST 响应模型。
 
     :param medias: 统一媒体信息列表
     :return: REST 媒体响应列表
     """
-    return [schemas.MediaInfo(**media.to_dict()) for media in medias]
+    return [_SchemaMediaInfo(**media.to_dict()) for media in medias]
 
 
 @router.get(
     "/trending",
     summary="查询 AniList 当前趋势榜",
-    response_model=list[schemas.MediaInfo],
+    response_model=list[_SchemaMediaInfo],
 )
 async def anilist_trending(
     page: PageParam = 1,
     count: CountParam = 20,
-    _: schemas.TokenPayload = Depends(verify_token),
-) -> list[schemas.MediaInfo]:
+    _: _SchemaTokenPayload = Depends(verify_token),
+) -> list[_SchemaMediaInfo]:
     """查询 AniList TRENDING NOW 榜单"""
     medias = await AniListChain().async_trending(page=page, count=count)
     return _serialize_medias(medias)
@@ -42,13 +44,13 @@ async def anilist_trending(
 @router.get(
     "/popular-this-season",
     summary="查询 AniList 本季热门榜",
-    response_model=list[schemas.MediaInfo],
+    response_model=list[_SchemaMediaInfo],
 )
 async def anilist_popular_this_season(
     page: PageParam = 1,
     count: CountParam = 20,
-    _: schemas.TokenPayload = Depends(verify_token),
-) -> list[schemas.MediaInfo]:
+    _: _SchemaTokenPayload = Depends(verify_token),
+) -> list[_SchemaMediaInfo]:
     """查询 AniList POPULAR THIS SEASON 榜单"""
     medias = await AniListChain().async_popular_this_season(page=page, count=count)
     return _serialize_medias(medias)
@@ -57,7 +59,7 @@ async def anilist_popular_this_season(
 @router.get(
     "/discover",
     summary="探索 AniList 动画",
-    response_model=list[schemas.MediaInfo],
+    response_model=list[_SchemaMediaInfo],
 )
 async def anilist_discover(
     page: PageParam = 1,
@@ -70,8 +72,8 @@ async def anilist_discover(
     status: Optional[str] = None,
     country: Optional[str] = None,
     sort: Optional[str] = None,
-    _: schemas.TokenPayload = Depends(verify_token),
-) -> list[schemas.MediaInfo]:
+    _: _SchemaTokenPayload = Depends(verify_token),
+) -> list[_SchemaMediaInfo]:
     """按标题、类型、风格、季度、年份、状态、地区和排序探索 AniList 动画"""
     medias = await AniListChain().async_discover(
         page=page,
@@ -91,14 +93,14 @@ async def anilist_discover(
 @router.get(
     "/credits/{anilist_id}",
     summary="查询 AniList 配音演员",
-    response_model=list[schemas.MediaPerson],
+    response_model=list[_SchemaMediaPerson],
 )
 async def anilist_credits(
     anilist_id: int,
     page: PageParam = 1,
     count: CountParam = 20,
-    _: schemas.TokenPayload = Depends(verify_token),
-) -> list[schemas.MediaPerson]:
+    _: _SchemaTokenPayload = Depends(verify_token),
+) -> list[_SchemaMediaPerson]:
     """查询 AniList 动画的日语配音演员"""
     return await AniListChain().async_credits(
         anilist_id=anilist_id, page=page, count=count
@@ -108,14 +110,14 @@ async def anilist_credits(
 @router.get(
     "/recommend/{anilist_id}",
     summary="查询 AniList 相关推荐",
-    response_model=list[schemas.MediaInfo],
+    response_model=list[_SchemaMediaInfo],
 )
 async def anilist_recommendations(
     anilist_id: int,
     page: PageParam = 1,
     count: CountParam = 20,
-    _: schemas.TokenPayload = Depends(verify_token),
-) -> list[schemas.MediaInfo]:
+    _: _SchemaTokenPayload = Depends(verify_token),
+) -> list[_SchemaMediaInfo]:
     """查询 AniList 动画相关推荐"""
     medias = await AniListChain().async_recommendations(
         anilist_id=anilist_id, page=page, count=count
@@ -126,12 +128,12 @@ async def anilist_recommendations(
 @router.get(
     "/person/{person_id}",
     summary="查询 AniList 人物详情",
-    response_model=schemas.MediaPerson,
+    response_model=_SchemaMediaPerson,
 )
 async def anilist_person(
     person_id: int,
-    _: schemas.TokenPayload = Depends(verify_token),
-) -> Optional[schemas.MediaPerson]:
+    _: _SchemaTokenPayload = Depends(verify_token),
+) -> Optional[_SchemaMediaPerson]:
     """根据 AniList 人物 ID 查询详情"""
     return await AniListChain().async_person_detail(person_id=person_id)
 
@@ -139,14 +141,14 @@ async def anilist_person(
 @router.get(
     "/person/credits/{person_id}",
     summary="查询 AniList 人物作品",
-    response_model=list[schemas.MediaInfo],
+    response_model=list[_SchemaMediaInfo],
 )
 async def anilist_person_credits(
     person_id: int,
     page: PageParam = 1,
     count: CountParam = 20,
-    _: schemas.TokenPayload = Depends(verify_token),
-) -> list[schemas.MediaInfo]:
+    _: _SchemaTokenPayload = Depends(verify_token),
+) -> list[_SchemaMediaInfo]:
     """查询 AniList 人物参与的动画作品"""
     medias = await AniListChain().async_person_credits(
         person_id=person_id, page=page, count=count
@@ -157,14 +159,14 @@ async def anilist_person_credits(
 @router.get(
     "/{anilist_id}",
     summary="查询 AniList 动画详情",
-    response_model=schemas.MediaInfo,
+    response_model=_SchemaMediaInfo,
 )
 async def anilist_info(
     anilist_id: int,
-    _: schemas.TokenPayload = Depends(verify_token),
-) -> schemas.MediaInfo:
+    _: _SchemaTokenPayload = Depends(verify_token),
+) -> _SchemaMediaInfo:
     """根据 AniList 媒体 ID 查询动画详情"""
     info = await AniListChain().async_info(anilist_id)
     if not info:
-        return schemas.MediaInfo()
-    return schemas.MediaInfo(**MediaInfo(anilist_info=info).to_dict())
+        return _SchemaMediaInfo()
+    return _SchemaMediaInfo(**MediaInfo(anilist_info=info).to_dict())