Files
shanxia2.0/backend/app/schemas/crm/clue.py
T
2026-06-01 08:21:21 +08:00

175 lines
9.2 KiB
Python

"""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=100, 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="创建时间止")
# ── 线索新增/编辑 ──────────────────────────────────────────────────
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=100, 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="趋势粒度别名")