refactor(api): TOML 配置 SSOT、统一错误契约、Auth/事务加固与可观测性 (#33)

配置 SSOT（TOML + .env）
统一错误契约
Auth 与事务边界
Redis / Celery 可靠性:业务 Redis（DB/0）与 Celery broker/backend（DB/1）显式拆分；连接池、sync client
可观测性（OpenTelemetry + LGTM）

api/app/features/memoir/router.py

@@ -2,29 +2,34 @@
 回忆录 feature — books / chapters / memoir-state 合并路由
 """
 
-from typing import List, Optional
+from typing import Optional
 
 from fastapi import APIRouter, Body, Depends, Query
 
-from app.core.dependencies import get_current_user
+from app.core.deps_types import CurrentUserDep
 from app.core.logging import get_logger
+from app.core.openapi import error_responses
 from app.features.memoir.deps import get_memoir_service
 from app.features.memoir.schemas import (
+    BookResponse,
+    ChapterDetailResponse,
+    ChapterListItemResponse,
+    CoverGenerationResponse,
     ExportPdfRequest,
+    ExportPdfResponse,
+    MemoirStateResponse,
+    NextQuestionContextResponse,
     SetChapterStoryOrderRequest,
+    StatusMessageResponse,
+    StoryOrderResponse,
     UpdateBookRequest,
 )
 from app.features.memoir.service import MemoirService
-from app.features.user.models import User
 
 router = APIRouter(
     prefix="/api",
     tags=["memoir"],
-    responses={
-        401: {"description": "认证失败"},
-        403: {"description": "权限不足"},
-        404: {"description": "资源不存在"},
-    },
+    responses=error_responses(401, 403, 404),
 )
 logger = get_logger(__name__)
 
@@ -34,39 +39,39 @@ logger = get_logger(__name__)
 # ===========================================================================
 
 
-@router.get("/books/current")
+@router.get("/books/current", response_model=BookResponse)
 async def get_current_book(
-    current_user: User = Depends(get_current_user),
+    current_user: CurrentUserDep,
     service: MemoirService = Depends(get_memoir_service),
 ):
     """获取当前回忆录（需要认证）"""
     return await service.get_current_book(current_user.id)
 
 
-@router.post("/books/clear-update")
+@router.post("/books/clear-update", response_model=StatusMessageResponse)
 async def clear_book_update(
-    current_user: User = Depends(get_current_user),
+    current_user: CurrentUserDep,
     service: MemoirService = Depends(get_memoir_service),
 ):
     """清除回忆录更新标记"""
     return await service.clear_book_update(current_user.id)
 
 
-@router.put("/books/{book_id}")
+@router.put("/books/{book_id}", response_model=BookResponse)
 async def update_book(
     book_id: str,
+    current_user: CurrentUserDep,
     request: UpdateBookRequest = Body(...),
-    current_user: User = Depends(get_current_user),
     service: MemoirService = Depends(get_memoir_service),
 ):
     """更新书籍标题（需要认证，只能更新自己的回忆录）"""
     return await service.update_book(book_id, current_user.id, request.title)
 
 
-@router.post("/books/export-pdf")
+@router.post("/books/export-pdf", response_model=ExportPdfResponse)
 async def export_pdf(
+    current_user: CurrentUserDep,
     request: ExportPdfRequest = Body(...),
-    current_user: User = Depends(get_current_user),
     service: MemoirService = Depends(get_memoir_service),
 ):
     """导出 PDF（需要认证，只能导出自己的回忆录）"""
@@ -78,9 +83,9 @@ async def export_pdf(
 # ===========================================================================
 
 
-@router.get("/chapters", response_model=List[dict])
+@router.get("/chapters", response_model=list[ChapterListItemResponse])
 async def get_chapters(
-    current_user: User = Depends(get_current_user),
+    current_user: CurrentUserDep,
     is_new: Optional[bool] = Query(None, description="仅返回未读章节"),
     service: MemoirService = Depends(get_memoir_service),
 ):
@@ -90,19 +95,19 @@ async def get_chapters(
     return await service.get_chapters(current_user.id, is_new=is_new)
 
 
-@router.get("/chapters/{chapter_id}", response_model=dict)
+@router.get("/chapters/{chapter_id}", response_model=ChapterDetailResponse)
 async def get_chapter(
     chapter_id: str,
-    current_user: User = Depends(get_current_user),
+    current_user: CurrentUserDep,
     service: MemoirService = Depends(get_memoir_service),
 ):
     """获取章节详情（需要认证，只能访问自己的章节）"""
     return await service.get_chapter(chapter_id, current_user.id)
 
 
-@router.post("/chapters/check-cover-generation")
+@router.post("/chapters/check-cover-generation", response_model=CoverGenerationResponse)
 async def check_cover_generation(
-    current_user: User = Depends(get_current_user),
+    current_user: CurrentUserDep,
     service: MemoirService = Depends(get_memoir_service),
 ):
     """
@@ -112,21 +117,21 @@ async def check_cover_generation(
     return await service.check_and_trigger_cover_generation(current_user.id)
 
 
-@router.delete("/chapters/{chapter_id}")
+@router.delete("/chapters/{chapter_id}", response_model=StatusMessageResponse)
 async def disable_chapter(
     chapter_id: str,
-    current_user: User = Depends(get_current_user),
+    current_user: CurrentUserDep,
     service: MemoirService = Depends(get_memoir_service),
 ):
     """清除章节（将章节标记为 disabled，需要认证，只能操作自己的章节）"""
     return await service.disable_chapter(chapter_id, current_user.id)
 
 
-@router.put("/chapters/{chapter_id}/story-order")
+@router.put("/chapters/{chapter_id}/story-order", response_model=StoryOrderResponse)
 async def set_chapter_story_order(
     chapter_id: str,
+    current_user: CurrentUserDep,
     request: SetChapterStoryOrderRequest = Body(...),
-    current_user: User = Depends(get_current_user),
     service: MemoirService = Depends(get_memoir_service),
 ):
     """
@@ -142,27 +147,27 @@ async def set_chapter_story_order(
 # ===========================================================================
 
 
-@router.get("/memoir-state")
+@router.get("/memoir-state", response_model=MemoirStateResponse)
 async def get_memoir_state(
-    current_user: User = Depends(get_current_user),
+    current_user: CurrentUserDep,
     service: MemoirService = Depends(get_memoir_service),
 ):
     """获取当前用户回忆录状态"""
     return await service.get_memoir_state(current_user.id)
 
 
-@router.get("/memoir-state/next-question")
+@router.get("/memoir-state/next-question", response_model=NextQuestionContextResponse)
 async def get_next_question_context(
-    current_user: User = Depends(get_current_user),
+    current_user: CurrentUserDep,
     service: MemoirService = Depends(get_memoir_service),
 ):
     """获取下一步问题的上下文（当前阶段与空 slot）"""
     return await service.get_next_question_context(current_user.id)
 
 
-@router.post("/memoir-state/mark-read")
+@router.post("/memoir-state/mark-read", response_model=StatusMessageResponse)
 async def mark_memoir_read(
-    current_user: User = Depends(get_current_user),
+    current_user: CurrentUserDep,
     service: MemoirService = Depends(get_memoir_service),
 ):
     """标记回忆录更新已读"""