feat: batch update - gift card breakdown spec, backend APIs, miniprogram pages, ETL finance recharge, docs & migrations

apps/backend/app/routers/xcx_tasks.py

@@ -1,35 +1,56 @@
 # -*- coding: utf-8 -*-
 """
-小程序任务路由 —— 任务列表、置顶、放弃、取消放弃。
+小程序任务路由 —— 任务列表、任务详情、置顶、放弃、取消放弃。
 
 端点清单：
-- GET  /api/xcx/tasks                  — 获取活跃任务列表
+- GET  /api/xcx/tasks                  — 获取任务列表 + 绩效概览（TASK-1）
+- GET  /api/xcx/tasks/{task_id}        — 获取任务详情完整版（TASK-2）
 - POST /api/xcx/tasks/{id}/pin         — 置顶任务
 - POST /api/xcx/tasks/{id}/unpin       — 取消置顶
 - POST /api/xcx/tasks/{id}/abandon     — 放弃任务
-- POST /api/xcx/tasks/{id}/cancel-abandon — 取消放弃
+- POST /api/xcx/tasks/{id}/restore     — 恢复任务
 
 所有端点均需 JWT（approved 状态）。
 """
 
 from __future__ import annotations
 
-from fastapi import APIRouter, Depends
+from fastapi import APIRouter, Depends, Query
 
 from app.auth.dependencies import CurrentUser
 from app.middleware.permission import require_approved
-from app.schemas.xcx_tasks import AbandonRequest, TaskListItem
+from app.schemas.xcx_tasks import (
+    AbandonRequest,
+    TaskDetailResponse,
+    TaskListResponse,
+)
 from app.services import task_manager
 
 router = APIRouter(prefix="/api/xcx/tasks", tags=["小程序任务"])
 
 
-@router.get("", response_model=list[TaskListItem])
+@router.get("", response_model=TaskListResponse)
 async def get_tasks(
+    status: str = Query("pending", pattern="^(pending|completed|abandoned)$"),
+    page: int = Query(1, ge=1),
+    page_size: int = Query(20, ge=1, le=100),
     user: CurrentUser = Depends(require_approved()),
 ):
-    """获取当前助教的活跃任务列表。"""
-    return await task_manager.get_task_list(user.user_id, user.site_id)
+    """获取任务列表 + 绩效概览。"""
+    return await task_manager.get_task_list_v2(
+        user.user_id, user.site_id, status, page, page_size
+    )
+
+
+@router.get("/{task_id}", response_model=TaskDetailResponse)
+async def get_task_detail(
+    task_id: int,
+    user: CurrentUser = Depends(require_approved()),
+):
+    """获取任务详情完整版。"""
+    return await task_manager.get_task_detail(
+        task_id, user.user_id, user.site_id
+    )
 
 
 @router.post("/{task_id}/pin")
@@ -38,7 +59,8 @@ async def pin_task(
     user: CurrentUser = Depends(require_approved()),
 ):
     """置顶任务。"""
-    return await task_manager.pin_task(task_id, user.user_id, user.site_id)
+    result = await task_manager.pin_task(task_id, user.user_id, user.site_id)
+    return {"is_pinned": result["is_pinned"]}
 
 
 @router.post("/{task_id}/unpin")
@@ -47,7 +69,8 @@ async def unpin_task(
     user: CurrentUser = Depends(require_approved()),
 ):
     """取消置顶。"""
-    return await task_manager.unpin_task(task_id, user.user_id, user.site_id)
+    result = await task_manager.unpin_task(task_id, user.user_id, user.site_id)
+    return {"is_pinned": result["is_pinned"]}
 
 
 @router.post("/{task_id}/abandon")
@@ -62,8 +85,8 @@ async def abandon_task(
     )
 
 
-@router.post("/{task_id}/cancel-abandon")
-async def cancel_abandon(
+@router.post("/{task_id}/restore")
+async def restore_task(
     task_id: int,
     user: CurrentUser = Depends(require_approved()),
 ):