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

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