"""CRM 线索管理 Pydantic Schemas""" from typing import List, Optional from pydantic import BaseModel, ConfigDict, Field # ── 线索列表查询 ────────────────────────────────────────────────── class ClueListBody(BaseModel): model_config = ConfigDict(populate_by_name=True) page: int = Field(default=1, ge=1, description="页码") pageSize: int = Field(default=10, ge=1, le=500, description="每页条数") keyword: Optional[str] = Field(default=None, description="搜索关键词(线索名称/手机号)") search_keyword: Optional[str] = Field( default=None, alias="searchKeyword", description="快速搜索关键词(与 keyword 等价)" ) clue_name: Optional[str] = Field(default=None, alias="clueName", description="线索名称") company: Optional[str] = Field(default=None, description="公司名称") mobile: Optional[str] = Field(default=None, description="手机号") source: Optional[str] = Field(default=None, description="线索来源") level: Optional[str] = Field(default=None, description="线索级别") status: Optional[str] = Field(default=None, description="线索状态") industry: Optional[str] = Field(default=None, description="所属行业") park_area: Optional[str] = Field(default=None, alias="parkArea", description="所在园区") owner_user_id: Optional[str] = Field(default=None, alias="ownerUserId", description="负责人ID") view_type: Optional[str] = Field( default=None, alias="viewType", description="视图类型(mine/all/toFollow/todayNew/converted)" ) view_mode: Optional[str] = Field(default=None, alias="viewMode", description="视图模式(mine/all)") create_time_range: Optional[List[str]] = Field( default=None, alias="createTimeRange", description="创建时间范围 [start, end]" ) begin_time: Optional[str] = Field(default=None, alias="beginTime", description="创建时间起") end_time: Optional[str] = Field(default=None, alias="endTime", description="创建时间止") # ── 线索新增/编辑 ────────────────────────────────────────────────── ids: Optional[List[str]] = Field(default=None, description="导出指定ID列表") columns: Optional[List[str]] = Field(default=None, description="导出列(前端 visibleColumns)") class ClueCreateBody(BaseModel): model_config = ConfigDict(populate_by_name=True) clue_name: str = Field(..., alias="clueName", min_length=1, max_length=100, description="线索名称") mobile: str = Field(..., min_length=1, max_length=20, description="手机号") company: Optional[str] = Field(default=None, max_length=200, description="公司名称") customer_type: Optional[str] = Field(default=None, alias="customerType", max_length=20, description="客户类型") telephone: Optional[str] = Field(default=None, max_length=30, description="座机") email: Optional[str] = Field(default=None, max_length=100, description="邮箱") title: Optional[str] = Field(default=None, max_length=10, description="称谓") position: Optional[str] = Field(default=None, max_length=50, description="职位") source: str = Field(..., max_length=20, description="线索来源") level: Optional[str] = Field(default="unrated", max_length=10, description="线索级别") industry: Optional[str] = Field(default=None, max_length=50, description="所属行业") park_area: Optional[str] = Field(default=None, alias="parkArea", max_length=100, description="所在园区") province: Optional[str] = Field(default=None, max_length=50, description="省份") city: Optional[str] = Field(default=None, max_length=50, description="城市") district: Optional[str] = Field(default=None, max_length=50, description="区县") address: Optional[str] = Field(default=None, max_length=255, description="详细地址") website: Optional[str] = Field(default=None, max_length=500, description="网站") intent_products: Optional[str] = Field( default=None, alias="intentProducts", max_length=500, description="意向产品" ) expect_time: Optional[str] = Field(default=None, alias="expectTime", description="预计购买时间") budget: Optional[str] = Field(default=None, max_length=20, description="预算") requirement: Optional[str] = Field(default=None, description="需求描述") owner_user_id: Optional[str] = Field(default=None, alias="ownerUserId", description="负责人ID") next_time: Optional[str] = Field(default=None, alias="nextTime", description="下次联系时间") remark: Optional[str] = Field(default=None, max_length=512, description="备注") class ClueUpdateBody(ClueCreateBody): id: str = Field(..., min_length=1, description="线索ID") # ── 线索操作 ────────────────────────────────────────────────── class ClueDeleteBody(BaseModel): model_config = ConfigDict(populate_by_name=True) ids: List[str] = Field(..., min_length=1, description="线索ID列表") class ClueAssignBody(BaseModel): model_config = ConfigDict(populate_by_name=True) ids: List[str] = Field(..., min_length=1, description="线索ID列表") owner_user_id: str = Field(..., alias="ownerUserId", description="新负责人ID") remark: Optional[str] = Field(default=None, description="分配说明") class ClueConvertBody(BaseModel): model_config = ConfigDict(populate_by_name=True) id: str = Field(..., min_length=1, description="线索ID") customer_name: Optional[str] = Field(default=None, alias="customerName", description="客户名称") customer_type: Optional[str] = Field(default=None, alias="customerType", description="客户类型") contact_name: Optional[str] = Field(default=None, alias="contactName", description="联系人姓名") contact_mobile: Optional[str] = Field(default=None, alias="contactMobile", description="联系人手机号") remark: Optional[str] = Field(default=None, description="转化说明") class ClueStatusBody(BaseModel): model_config = ConfigDict(populate_by_name=True) id: str = Field(..., min_length=1, description="线索ID") status: str = Field(..., max_length=20, description="目标状态") class ClueLevelBody(BaseModel): model_config = ConfigDict(populate_by_name=True) ids: List[str] = Field(..., min_length=1, description="线索ID列表") level: str = Field(..., max_length=10, description="目标级别") class ClueInvalidBody(BaseModel): model_config = ConfigDict(populate_by_name=True) id: Optional[str] = Field(default=None, description="线索ID") ids: Optional[List[str]] = Field(default=None, description="线索ID列表") remark: Optional[str] = Field(default=None, description="作废原因") # ── 跟进记录 ────────────────────────────────────────────────── class ClueFollowListBody(BaseModel): model_config = ConfigDict(populate_by_name=True) clue_id: str = Field(..., alias="clueId", description="线索ID") page: int = Field(default=1, ge=1, description="页码") pageSize: int = Field(default=10, ge=1, le=500, description="每页条数") class ClueFollowCreateBody(BaseModel): model_config = ConfigDict(populate_by_name=True) clue_id: str = Field(..., alias="clueId", description="线索ID") follow_type: str = Field(..., alias="followType", max_length=20, description="跟进方式") follow_content: str = Field(..., alias="followContent", description="跟进内容") next_time: Optional[str] = Field(default=None, alias="nextTime", description="下次联系时间") attachments: Optional[str] = Field(default=None, max_length=1000, description="附件URL(逗号分隔)") remark: Optional[str] = Field(default=None, description="备注") class ClueFollowDeleteBody(BaseModel): model_config = ConfigDict(populate_by_name=True) ids: List[str] = Field(..., min_length=1, description="跟进记录ID列表") class ClueFollowUpdateBody(BaseModel): model_config = ConfigDict(populate_by_name=True) id: str = Field(..., min_length=1, description="跟进记录ID") follow_type: Optional[str] = Field(default=None, alias="followType", description="跟进方式") follow_content: Optional[str] = Field(default=None, alias="followContent", description="跟进内容") next_time: Optional[str] = Field(default=None, alias="nextTime", description="下次联系时间") attachments: Optional[str] = Field(default=None, max_length=1000, description="附件URL(逗号分隔)") remark: Optional[str] = Field(default=None, description="备注") class ClueStatisticsBody(BaseModel): model_config = ConfigDict(populate_by_name=True) begin_time: Optional[str] = Field(default=None, alias="beginTime", description="开始日期") end_time: Optional[str] = Field(default=None, alias="endTime", description="结束日期") owner_user_id: Optional[str] = Field(default=None, alias="ownerUserId", description="负责人ID") time_unit: Optional[str] = Field(default="day", alias="timeUnit", description="趋势粒度 day/week/month") type: Optional[str] = Field(default=None, description="趋势粒度别名")