微信小程序页面迁移校验之前 P5任务处理之前

apps/backend/app/schemas/execution.py

@@ -50,6 +50,7 @@ class ExecutionHistoryItem(BaseModel):
     duration_ms: int | None = None
     command: str | None = None
     summary: dict[str, Any] | None = None
+    schedule_id: str | None = None
 
 
 class ExecutionLogsResponse(BaseModel):

apps/backend/app/schemas/member_retention_clue.py

@@ -0,0 +1,54 @@
+"""
+维客线索相关 Pydantic 模型。
+
+大类枚举：客户基础信息、消费习惯、玩法偏好、促销偏好、社交关系、重要反馈
+"""
+
+from datetime import datetime
+from enum import Enum
+from typing import Optional
+
+from pydantic import BaseModel, Field
+
+
+class ClueCategory(str, Enum):
+    """维客线索大类枚举"""
+    BASIC_INFO = "客户基础信息"
+    CONSUMPTION = "消费习惯"
+    PLAY_PREF = "玩法偏好"
+    PROMO_PREF = "促销偏好"
+    SOCIAL = "社交关系"
+    FEEDBACK = "重要反馈"
+
+
+class ClueSource(str, Enum):
+    """维客线索来源枚举"""
+    MANUAL = "manual"                # 助教手动录入
+    AI_CONSUMPTION = "ai_consumption"  # 应用 3：消费分析自动生成
+    AI_NOTE = "ai_note"              # 应用 6：备注分析自动提取
+
+
+class RetentionClueSubmit(BaseModel):
+    """提交维客线索请求。"""
+    member_id: int = Field(..., gt=0, description="会员 ID")
+    category: ClueCategory = Field(..., description="线索大类")
+    summary: str = Field(..., min_length=1, max_length=200, description="摘要：重点信息")
+    detail: Optional[str] = Field(None, max_length=2000, description="详情：分析及扩展说明，可为空")
+    recorded_by_assistant_id: int = Field(..., gt=0, description="记录助教 ID")
+    recorded_by_name: str = Field(..., min_length=1, max_length=50, description="记录助教姓名")
+    site_id: int = Field(..., gt=0, description="门店 ID")
+    source: ClueSource = Field(default=ClueSource.MANUAL, description="线索来源")
+
+
+class RetentionClueOut(BaseModel):
+    """维客线索返回模型。"""
+    id: int
+    member_id: int
+    category: ClueCategory
+    summary: str
+    detail: Optional[str]
+    recorded_by_assistant_id: Optional[int]
+    recorded_by_name: Optional[str]
+    recorded_at: datetime
+    site_id: int
+    source: ClueSource = ClueSource.MANUAL

apps/backend/app/schemas/schedules.py

@@ -32,6 +32,7 @@ class CreateScheduleRequest(BaseModel):
     task_codes: list[str]
     task_config: dict[str, Any]
     schedule_config: ScheduleConfigSchema
+    run_immediately: bool = False
 
 
 class UpdateScheduleRequest(BaseModel):

apps/backend/app/schemas/tasks.py

@@ -47,6 +47,11 @@ class TaskConfigSchema(BaseModel):
     store_id: int | None = None
     dwd_only_tables: list[str] | None = None
     force_full: bool = False
+    # Pipeline 调优参数（可选，不传则使用 ETL 默认值）
+    pipeline_workers: int | None = None
+    pipeline_batch_size: int | None = None
+    pipeline_rate_min: float | None = None
+    pipeline_rate_max: float | None = None
     extra_args: dict[str, Any] = {}
 
     @model_validator(mode="after")

apps/backend/app/schemas/xcx_auth.py

@@ -25,6 +25,46 @@ class WxLoginResponse(BaseModel):
     user_id: int
 
 
+class DevLoginRequest(BaseModel):
+    """开发模式 mock 登录请求（仅 WX_DEV_MODE=true 时可用）。"""
+    openid: str = Field(..., min_length=1, description="模拟的微信 openid")
+    status: str | None = Field(None, description="模拟的用户状态；为空时保留已有用户的当前状态，新用户默认 new")
+
+
+    # ── 开发调试端点（仅 WX_DEV_MODE=true） ─────────────────
+
+    class DevSwitchRoleRequest(BaseModel):
+        """切换角色请求。替换当前用户在当前门店下的所有角色为指定角色。"""
+        role_code: str = Field(..., description="目标角色 code（coach/staff/site_admin/tenant_admin）")
+
+
+    class DevSwitchStatusRequest(BaseModel):
+        """切换用户状态请求。"""
+        status: str = Field(..., description="目标状态（new/pending/approved/rejected/disabled）")
+
+
+    class DevSwitchBindingRequest(BaseModel):
+        """切换人员绑定请求。"""
+        binding_type: str = Field(..., description="绑定类型（assistant/staff/manager）")
+        assistant_id: int | None = Field(None, description="助教 ID（binding_type=assistant 时必填）")
+        staff_id: int | None = Field(None, description="员工 ID（binding_type=staff/manager 时必填）")
+
+
+    class DevContextResponse(BaseModel):
+        """开发调试上下文信息。"""
+        user_id: int
+        openid: str | None = None
+        status: str
+        nickname: str | None = None
+        site_id: int | None = None
+        site_name: str | None = None
+        roles: list[str] = []
+        permissions: list[str] = []
+        binding: dict | None = None
+        all_sites: list[dict] = []
+
+
+
 # ── 用户申请 ──────────────────────────────────────────────
 
 class ApplicationRequest(BaseModel):
@@ -102,3 +142,69 @@ class RejectRequest(BaseModel):
     """拒绝申请请求。"""
     review_note: str = Field(..., min_length=1, description="拒绝原因")
 
+
+# ── 开发调试端点（仅 WX_DEV_MODE=true） ─────────────────
+
+class DevSwitchRoleRequest(BaseModel):
+    """切换角色请求。替换当前用户在当前门店下的所有角色为指定角色。"""
+    role_code: str = Field(..., description="目标角色 code（coach/staff/site_admin/tenant_admin）")
+
+
+class DevSwitchStatusRequest(BaseModel):
+    """切换用户状态请求。"""
+    status: str = Field(..., description="目标状态（new/pending/approved/rejected/disabled）")
+
+
+class DevSwitchBindingRequest(BaseModel):
+    """切换人员绑定请求。"""
+    binding_type: str = Field(..., description="绑定类型（assistant/staff/manager）")
+    assistant_id: int | None = Field(None, description="助教 ID（binding_type=assistant 时必填）")
+    staff_id: int | None = Field(None, description="员工 ID（binding_type=staff/manager 时必填）")
+
+
+class DevContextResponse(BaseModel):
+    """开发调试上下文信息。"""
+    user_id: int
+    openid: str | None = None
+    status: str
+    nickname: str | None = None
+    site_id: int | None = None
+    site_name: str | None = None
+    roles: list[str] = []
+    permissions: list[str] = []
+    binding: dict | None = None
+    all_sites: list[dict] = []
+
+
+# ── 开发调试端点（仅 WX_DEV_MODE=true） ─────────────────
+
+class DevSwitchRoleRequest(BaseModel):
+    """切换角色请求。替换当前用户在当前门店下的所有角色为指定角色。"""
+    role_code: str = Field(..., description="目标角色 code（coach/staff/site_admin/tenant_admin）")
+
+
+class DevSwitchStatusRequest(BaseModel):
+    """切换用户状态请求。"""
+    status: str = Field(..., description="目标状态（new/pending/approved/rejected/disabled）")
+
+
+class DevSwitchBindingRequest(BaseModel):
+    """切换人员绑定请求。"""
+    binding_type: str = Field(..., description="绑定类型（assistant/staff/manager）")
+    assistant_id: int | None = Field(None, description="助教 ID（binding_type=assistant 时必填）")
+    staff_id: int | None = Field(None, description="员工 ID（binding_type=staff/manager 时必填）")
+
+
+class DevContextResponse(BaseModel):
+    """开发调试上下文信息。"""
+    user_id: int
+    openid: str | None = None
+    status: str
+    nickname: str | None = None
+    site_id: int | None = None
+    site_name: str | None = None
+    roles: list[str] = []
+    permissions: list[str] = []
+    binding: dict | None = None
+    all_sites: list[dict] = []
+

apps/backend/app/schemas/xcx_notes.py

@@ -0,0 +1,35 @@
+"""
+小程序备注相关 Pydantic 模型。
+
+覆盖：备注创建请求、备注输出等场景。
+"""
+
+from __future__ import annotations
+
+from pydantic import BaseModel, Field
+
+
+class NoteCreateRequest(BaseModel):
+    """创建备注请求（含星星评分，评分 1-5 范围约束）。"""
+
+    target_type: str = Field(default="member")
+    target_id: int
+    content: str = Field(..., min_length=1)
+    task_id: int | None = None
+    rating_service_willingness: int | None = Field(None, ge=1, le=5)
+    rating_revisit_likelihood: int | None = Field(None, ge=1, le=5)
+
+
+class NoteOut(BaseModel):
+    """备注输出模型（含评分 + AI 评分）。"""
+
+    id: int
+    type: str
+    content: str
+    rating_service_willingness: int | None
+    rating_revisit_likelihood: int | None
+    ai_score: int | None
+    ai_analysis: str | None
+    task_id: int | None
+    created_at: str
+    updated_at: str

apps/backend/app/schemas/xcx_tasks.py

@@ -0,0 +1,34 @@
+"""
+小程序任务相关 Pydantic 模型。
+
+覆盖：任务列表项、放弃请求等场景。
+"""
+
+from __future__ import annotations
+
+from pydantic import BaseModel, Field
+
+
+class TaskListItem(BaseModel):
+    """任务列表项（含客户信息 + RS 指数 + 爱心 icon）。"""
+
+    id: int
+    task_type: str
+    status: str
+    priority_score: float | None
+    is_pinned: bool
+    expires_at: str | None
+    created_at: str
+    # 客户信息（FDW 读取）
+    member_id: int
+    member_name: str | None
+    member_phone: str | None
+    # RS 指数 + 爱心 icon
+    rs_score: float | None
+    heart_icon: str  # 💖 / 🧡 / 💛 / 💙
+
+
+class AbandonRequest(BaseModel):
+    """放弃任务请求（reason 必填）。"""
+
+    reason: str = Field(..., min_length=1, description="放弃原因（必填）")