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

apps/backend/app/schemas/xcx_tasks.py

@@ -1,15 +1,17 @@
 """
 小程序任务相关 Pydantic 模型。
 
-覆盖：任务列表项、放弃请求等场景。
+覆盖：任务列表项、任务详情、绩效概览、放弃请求等场景。
 """
 
 from __future__ import annotations
 
-from pydantic import BaseModel, Field
+from pydantic import Field
+
+from app.schemas.base import CamelModel
 
 
-class TaskListItem(BaseModel):
+class TaskListItem(CamelModel):
     """任务列表项（含客户信息 + RS 指数 + 爱心 icon）。"""
 
     id: int
@@ -30,7 +32,138 @@ class TaskListItem(BaseModel):
     abandon_reason: str | None = None
 
 
-class AbandonRequest(BaseModel):
+class AbandonRequest(CamelModel):
     """放弃任务请求（reason 必填）。"""
 
     reason: str = Field(..., min_length=1, description="放弃原因（必填）")
+
+
+# ---------------------------------------------------------------------------
+# RNS1.1 扩展模型
+# ---------------------------------------------------------------------------
+
+
+class PerformanceSummary(CamelModel):
+    """绩效概览（附带在任务列表响应中）。"""
+
+    total_hours: float
+    total_income: float
+    total_customers: int
+    month_label: str
+    tier_nodes: list[float]
+    basic_hours: float
+    bonus_hours: float
+    current_tier: int
+    next_tier_hours: float
+    tier_completed: bool
+    bonus_money: float
+    income_trend: str
+    income_trend_dir: str  # 'up' | 'down'
+    prev_month: str
+    current_tier_label: str
+
+
+class TaskItem(CamelModel):
+    """任务列表项（扩展版）。"""
+
+    id: int
+    customer_name: str
+    customer_avatar: str
+    task_type: str
+    task_type_label: str
+    deadline: str | None
+    heart_score: float
+    hobbies: list[str]
+    is_pinned: bool
+    has_note: bool
+    status: str
+    last_visit_days: int | None = None
+    balance: float | None = None
+    ai_suggestion: str | None = None
+
+
+class TaskListResponse(CamelModel):
+    """TASK-1 响应。"""
+
+    items: list[TaskItem]
+    total: int
+    page: int
+    page_size: int
+    performance: PerformanceSummary
+
+
+class RetentionClue(CamelModel):
+    """维客线索。"""
+
+    tag: str
+    tag_color: str
+    emoji: str
+    text: str
+    source: str  # 'manual' | 'ai_consumption' | 'ai_note'
+    desc: str | None = None
+
+
+class ServiceRecord(CamelModel):
+    """服务记录。"""
+
+    table: str | None = None
+    type: str
+    type_class: str  # 'basic' | 'vip' | 'tip' | 'recharge' | 'incentive'
+    record_type: str | None = None  # 'course' | 'recharge'
+    duration: float
+    duration_raw: float | None = None
+    income: float
+    is_estimate: bool | None = None
+    drinks: str | None = None
+    date: str
+
+
+class AiAnalysis(CamelModel):
+    """AI 分析结果。"""
+
+    summary: str
+    suggestions: list[str]
+
+
+class NoteItem(CamelModel):
+    """备注项。"""
+
+    id: int
+    content: str
+    tag_type: str
+    tag_label: str
+    created_at: str
+    score: int | None = None
+
+
+class ServiceSummary(CamelModel):
+    """服务记录摘要。"""
+
+    total_hours: float
+    total_income: float
+    avg_income: float
+
+
+class TaskDetailResponse(CamelModel):
+    """TASK-2 响应。"""
+
+    # 基础信息
+    id: int
+    customer_name: str
+    customer_avatar: str
+    task_type: str
+    task_type_label: str
+    deadline: str | None
+    heart_score: float
+    hobbies: list[str]
+    is_pinned: bool
+    has_note: bool
+    status: str
+    customer_id: int
+    # 扩展模块
+    retention_clues: list[RetentionClue]
+    talking_points: list[str]
+    service_summary: ServiceSummary
+    service_records: list[ServiceRecord]
+    ai_analysis: AiAnalysis
+    notes: list[NoteItem]