feat(notification): 通知标题和正文支持多语言

- 通知静态配置支持 title/body i18n
- 前端通知列表和详情页展示本地化内容
- 新增数据库迁移脚本
- 更新通知协议文档

backend/src/v1/notifications/router.py

@@ -1,11 +1,13 @@
 from __future__ import annotations
 
+from datetime import datetime
 from typing import Annotated
 
 from fastapi import APIRouter, Depends, Query
 
 from core.logging import get_logger
 from core.auth.models import CurrentUser
+from core.http.errors import ApiProblemError, problem_payload
 from v1.notifications.dependencies import get_notification_service
 from v1.notifications.schemas import (
     MarkAllReadResponse,
@@ -13,33 +15,42 @@ from v1.notifications.schemas import (
     NotificationListResponse,
     UnreadCountResponse,
 )
-from v1.notifications.service import NotificationService
+from v1.notifications.service import NotificationService, normalize_locale
 from v1.users.dependencies import get_current_user
 
 router = APIRouter(prefix="/notifications", tags=["notifications"])
 logger = get_logger("v1.notifications.router")
 
 
+def _parse_cursor(cursor: str | None) -> datetime | None:
+    if cursor is None:
+        return None
+    try:
+        return datetime.fromisoformat(cursor.replace("Z", "+00:00"))
+    except ValueError as exc:
+        raise ApiProblemError(
+            status_code=422,
+            detail=problem_payload(
+                code="NOTIFICATION_INVALID_CURSOR",
+                detail="Notification cursor must be an ISO 8601 datetime",
+                params={"cursor": cursor},
+            ),
+        ) from exc
+
+
 @router.get("", response_model=NotificationListResponse)
 async def list_notifications(
     service: Annotated[NotificationService, Depends(get_notification_service)],
     current_user: Annotated[CurrentUser, Depends(get_current_user)],
     limit: int = Query(default=20, ge=1, le=50),
     cursor: str | None = Query(default=None),
+    locale: str | None = Query(default=None),
 ) -> NotificationListResponse:
-    from datetime import datetime
-
-    parsed_cursor = None
-    if cursor is not None:
-        try:
-            parsed_cursor = datetime.fromisoformat(cursor.replace("Z", "+00:00"))
-        except (ValueError, AttributeError):
-            parsed_cursor = None
-
     result = await service.list_notifications(
         user_id=current_user.id,
         limit=limit,
-        cursor=parsed_cursor,
+        cursor=_parse_cursor(cursor),
+        locale=normalize_locale(locale),
     )
     logger.info(
         "Notification list fetched",
@@ -89,14 +100,13 @@ async def mark_notification_read(
     notification_id: str,
     service: Annotated[NotificationService, Depends(get_notification_service)],
     current_user: Annotated[CurrentUser, Depends(get_current_user)],
+    locale: str | None = Query(default=None),
 ) -> NotificationItemResponse:
     from uuid import UUID
 
     try:
         uid = UUID(notification_id)
     except ValueError:
-        from core.http.errors import ApiProblemError, problem_payload
-
         raise ApiProblemError(
             status_code=404,
             detail=problem_payload(
@@ -108,6 +118,7 @@ async def mark_notification_read(
     item = await service.mark_read(
         user_notification_id=uid,
         user_id=current_user.id,
+        locale=normalize_locale(locale),
     )
     logger.info(
         "Notification marked as read",