Files

2026-04-30 20:33:51 +08:00

115 KiB

Raw Blame History

PRD: 客源管理模块

状态: Draft
作者: 产品经理
最后更新: 2026-04-23（v1.4 新增客源信息概览/编辑基础信息/收藏/改等级/改状态/转公客/转成交/转无效/联系人管理/相关员工管理/操作日志章节及Story 15-24，基于35张截图分析完成）
版本: 1.4
所属系统: Fonrey 房产经纪管理系统
关联模块: 房源管理、组织人事管理、权限管理

变更历史

版本	日期	作者	变更说明
v1.0	—	产品经理	初稿
v1.4	2026-04-23	产品经理	新增客源信息概览/编辑基础信息/收藏/改等级/改状态/转公客/转成交/转无效/联系人管理/相关员工管理/操作日志章节及 Story 15-24，基于 35 张截图分析完成

1. 问题陈述

背景

房产经纪公司的核心业务是匹配买卖/租赁双方，客源是业务闭环的另一端核心资产。经纪人日常需要录入、管理、维护大量购房/租房意向客户（以下统称"客源"），并持续跟进每位客户的需求变化、看房进度与成交意向。

传统纸质或 Excel 管理方式存在以下核心痛点：

客户信息散乱：客源信息分散在各经纪人手机通讯录或个人笔记中，无法统一管理和协作
需求跟进缺失：缺乏系统化的跟进记录，客户意向状态靠口头传达，极易遗漏、影响成交
重复录入/撞客：不同经纪人可能录入同一客户，造成重复打扰、内部竞争、客户流失
智能匹配缺位：无法快速将符合条件的房源推送给对应意向客户，匹配全靠人工记忆
活跃度管理缺乏：无法对客源进行活跃度分层（新配对/活跃/即将过期等），导致跟进优先级失控

目标用户

角色	描述	使用频率
Agent（经纪人）	负责录入、维护、跟进自己名下的客源，并与客户进行带看匹配	每日高频
店长/经理	查看全店/全区客源概况，监控跟进完成度及带看活跃度	每日
行政人员	审核客源信息，处理重复客户合并、来源修改审批等	每日

2. 目标与成功指标

目标	指标	当前基准	目标值	衡量周期
提升客源录入效率	平均录入一条客源耗时	约 10 分钟（估算）	< 3 分钟	上线后 60 天
提升客源跟进率	近 30 天有跟进记录的客源比例	待统计	≥ 75%	上线后 90 天
降低重复客源率	私客与成交客重复 / 私客与公客重复数量	待统计	减少 60%	上线后 60 天
提升智能配对效率	客源平均配对房源数量	待统计	每客源 ≥ 5 套	上线后 90 天
提升带看转化率	有效带看次数 / 活跃客源数	待统计	≥ 30%	上线后 90 天

3. 非目标（本期不做）

不包含资料客、营销客、成交客、公客的详细功能（本文档聚焦私客模块，其他客源类型为后续版本规划）
不包含客源与营销推广（端口发布、朋友圈分享等）的集成，营销模块另行规划
不包含 AI 智能推荐引擎自研，智能配房功能可基于规则匹配实现基础版本
不包含移动端 App（本期为 Web 端，移动端适配为 v2 规划）
不包含客源数据的对外 API 开放，接口规范另行设计

4. 用户故事与验收标准

说明：以下用户故事按核心业务流程顺序排列，覆盖客源管理模块私客相关的全部核心功能。

Story 1：经纪人录入新私客

As Agent（经纪人），I want 快速录入一位新客户的基本信息和购房/租房需求，So that 客源进入系统统一管理并支持后续的智能配房和跟进管理。

验收标准：

录入页面标题为"录入私客"，通过顶部导航「客源」→「+ 新增私客」或右侧浮动快捷入口「增客」触达
联系人区块支持录入多个联系人（联系人1 为必填，联系人2 起可增加/删除）
联系人必填字段：姓名（文本输入）、性别（先生/女士单选）、电话1（含国际区号选择 + 手机号输入）
联系人选填扩展字段：电话2、微信、QQ（点击"电话2、微信、QQ等"折叠入口展开）
支持"+ 新增联系人"按钮追加第三个及更多联系人，每个联系人独立填写
基础信息区块必填字段：状态（求购/求租/租购，单选）、用途（住宅/别墅/商住/商铺/写字楼/其他，单选，默认住宅）、等级（A急迫/B较强/C一般/D较弱/E暂不关注，单选）、来源（下拉选择，枚举值由运营维护）
基础信息区块选填扩展字段：证件类型、证件号码、意向学校等（点击折叠入口展开）
相关员工区块：首录人和归属人自动填充当前登录账号的姓名及所属组织，不可手动修改（权限控制）
点击"确定"时对所有必填字段统一校验，未填写的字段高亮红色错误提示并定位到第一个错误处
点击"取消"返回客源列表，不保存数据
保存成功后跳转至该客源详情页，并展示"保存成功"提示

Story 2：经纪人查看与筛选私客列表

As Agent（经纪人），I want 在客源列表中快速定位目标客户并了解其跟进状态，So that 提升客户管理效率，优先跟进高意向客户。

验收标准：

顶部 Tab 导航按需求类型分组：求购 / 求租 / 暂缓 / 全部私客，Tab 间可自由切换
顶部页签同时展示四个客源类型入口：私客 / 资料客 / 营销客 / 成交客 / 公客
顶部右侧显示以下实时重复检测提示：「私客与成交客重复：XX」、「私客与公客重复：XX」、「已删客源：XX」（数字为蓝色可点击链接）
搜索框支持按以下维度关键词检索：客源姓名/号码/号码后4位/客源编号/备注信息
已存搜索条件可保存，支持「X条已存搜索」快速调用入口
列表顶部筛选栏分组展示，支持组合筛选（详见第5章5.1.2节）
列表支持批量操作：修改相关方、修改来源、删除客源、合并客源
列表底部实时显示当前筛选总条数（如"共3910条"），支持分页（默认每页20条，可跳页）
列表支持导出当前筛选结果（Excel格式）
支持自定义列表显示字段（「自定义列表」按钮）
列表中每行客户右侧操作列提供「拨号」快捷按钮

Story 3：经纪人查看求购私客列表

As Agent（经纪人），I want 在求购 Tab 下查看所有有购房意向的私客，并通过多维度筛选快速定位目标客户，So that 优先匹配合适房源，提升成交效率。

验收标准：

求购 Tab 下，状态筛选项为：不限 / 求购 / 租购
需求类型筛选项为：二手 / 新房
购价筛选提供预设区间（200万以下/200-250万/250-300万/300-400万/400-500万/500-700万/700-1000万/1000-1500万/1500-2000万/2000万以上）以及自定义"最小值~最大值万"输入框
房室筛选项为：不限 / 1层 / 2层 / 3层 / 4层 / 5层及以上（此处为房间数）
支持"是大价值"特殊筛选标签
筛选栏支持展开更多筛选项（购房目的、保护客、合作者、偏好新房、巧客力访客、置顶等，详见5.1.2）
客源名称标签支持展示活跃度标签（如：新配偶、7日活跃、30日活跃、销售客、访客、营销客等彩色标签）
列表字段：姓名（含标签）、状态、需求类型、需求/解读（价格区间+面积区间）、智能配房（数量+感叹号提示）、意向商圈/小区、归属人（姓名+门店-组别）、带看进度（未带看/一看/二看等）、带看次数、委托日期、最近时间、操作

Story 4：经纪人查看求租私客列表

As Agent（经纪人），I want 在求租 Tab 下查看所有有租房意向的私客，So that 快速为其匹配合适的出租房源。

验收标准：

求租 Tab 下，状态筛选项为：不限 / 求租 / 租购
需求类型筛选项为：租房（对应的展示字段为租房相关）
租价筛选提供预设区间（2000元以下/2000-2500/2500-3000/3000-4000/4000-5000/5000-6000/6000-7000/7000-8000/8000-10000/10000以上）以及自定义"最小值~最大值元"输入框
房室筛选项为：不限 / 1层 / 2层 / 3层 / 4层 / 5层及以上
列表字段与求购列表一致，需求/解读列展示租价区间+面积区间，不显示"是大价值"筛选

Story 5：经纪人管理暂缓私客

As Agent（经纪人），I want 将暂时没有购房/租房需求的客户标记为"暂缓"状态，So that 保持活跃客源列表的精准性，同时不丢失潜在客户资源。

验收标准：

暂缓 Tab 下仅展示状态为"暂缓"的客源
暂缓状态的客户可通过操作恢复为"求购"或"求租"状态
暂缓状态的客户不计入活跃客源统计

Story 6：经纪人查看私客详情页

As Agent（经纪人），I want 点击客源姓名后进入详情页，查看该客户的完整信息和快捷操作入口，So that 在一个页面内完成客户的跟进、带看、配房等核心操作。

验收标准：

详情页顶部展示客源标题（需求标题+联系人姓名），旁边显示带看进度标签（如"一看"）
右侧固定信息面板展示：客户编号、委托日期、委托日期、需求类型、房源用途、客户来源、购房目的、付款方式、名下房产、贷款记录等关键字段
右侧面板底部提供快捷操作按钮：拨打电话（橙色主按钮）、加微信、签备用单
右侧面板中部提供状态变更操作入口：收藏、不跟进、改等级、修改名下、转公客、转成交、转无效、编辑信息来源
右侧面板"待办提醒"区块：展示系统自动或手动设置的提醒事项，支持「写办」快捷入口
右侧面板"联系人"区块：展示主联系人姓名/手机号（号码默认打码），提供「查看号码」和「新增联系人」入口
右侧面板"相关员工"区块：展示首录人、归属人及其所属门店-组别，支持「编辑」
右侧面板"其他操作"区块：提供「查看操作日志」入口
主内容区顶部为功能 Tab 导航：需求信息 / 跟进记录 / 带看 / 客源解读 / 智能配房
默认激活"需求信息" Tab

Story 7：经纪人查看与编辑需求信息

As Agent（经纪人），I want 在需求信息 Tab 中查看客户的完整购房/租房需求字段，并支持编辑，So that 确保需求信息准确以提升智能配房的匹配精度。

验收标准：

需求信息 Tab 下展示以下字段（三栏布局）：总价（范围区间，万元）、面积（范围区间，㎡）、居室（X居格式）、装修（下拉枚举）、朝向（多选枚举）、楼层（多选：中楼层/低楼层等）、楼龄（范围区间）、意向商圈（多选）、意向小区（多选）、交通情况（文本）、备注（文本）
字段值为空时展示" - "占位符，不隐藏字段名
右上角提供「编辑」蓝色文字链接，点击进入编辑态（字段转为输入框/选择器）
编辑态底部提供「保存」和「取消」按钮

Story 8：经纪人写入与查看跟进记录

As Agent（经纪人），I want 在跟进记录 Tab 中记录每一次与客户的沟通内容，并按类型筛选查看，So that 保留完整的跟进轨迹，便于持续维护客户关系。

验收标准：

跟进记录区块顶部为 5 个子 Tab：全部 / 写入跟进 / 敏感信息跟进 / 修改跟进 / 其他跟进
全部 Tab 右上角提供时间范围筛选器（开始时间 → 结束时间）
全部 Tab 提供「有录音」「有图片」复选框快速过滤
跟进记录以时间线形式展示，按日期分组，每条记录格式：【类型标签】门店-组经纪人时:分 + 跟进内容正文；右侧显示「已开放/隐藏」状态及操作链接
系统日志类记录（如【新增私客】）自动生成，格式：【新增私客】门店-组经纪人时:分 + "新增一个【求购】私客"
写入跟进 Tab 提供跟进目的多选筛选，完整枚举共 23 项：回拨、推房、带看、维护、其他、带看回访、新增私客回访、拜访、保留、电话、短信、房源未认证、激活、接待、勘察、看房、派单、企业来电通、去电、申请、未接通、信函、修改、邮件、转房客
写入跟进 Tab 提供跟进标签多选筛选：有录音、有图片、对房源不满意、还在考虑、对房源满意可交定金（支持「展开」查看更多标签）
敏感信息跟进 Tab：展示含敏感信息的跟进（无数据时展示"暂无跟进"空状态）
修改跟进 Tab：展示对已有跟进的修改记录（无数据时展示"暂无跟进"空状态）
其他跟进 Tab：展示系统自动生成的操作日志类跟进（如新增私客、状态变更等）
详情页右侧面板「写跟进」入口可快速呼起写入跟进浮窗

Story 9：经纪人管理带看记录

As Agent（经纪人），I want 在带看 Tab 中记录与该客户的预约带看和实际带看情况，So that 系统化追踪带看进度，提升成交转化效率。

验收标准：

带看区块顶部提供两个子 Tab：预约 / 带看
带看 Tab 提供「归属人带看」「其他人带看」复选框过滤，以及时间范围筛选器（开始时间→结束时间）
带看记录以时间线形式展示，每条记录格式：日期时间 + 带看情况文本 + 带看房源（蓝色可点击链接，格式：小区名-房号）+ 带看进度标签（一看/二看等，橙色）+ 带看经纪人姓名；右侧提供「详情 >」入口
新增带看表单（独立页面）包含以下字段：
- 业务类型（只读，如"二手"，由系统自动带入）
- 带看客户（只读，自动带入当前客源名称，旁边提供「查看详情」链接）
- 经纪人（只读，自动填充当前登录用户）
- 带看时间（必填：日期选择 + 开始时间→结束时间区间选择）
- 陪看人（选填，最多5位，点击「+ 添加」弹出员工选择器）
- 合作带看人（选填，最多5位，点击「+ 添加」弹出员工选择器）
- 带看情况（必填，多行文本，提示"开启后带看情况至少填写≥6字才可提交"）
- 附件（选填，支持上传含位置信息图片，格式限 bmp/jpg/png/gif，最大20MB）
- 带看房源（必填，至少1套最多10套，为每套房源选择客户意向程度）
新增预约带看表单（独立页面）包含以下字段：
- 业务类型（只读）、预约客户（只读）、预约人（只读）
- 预约时间（必填，日期+时间选择）
- 陪看人（选填，最多5位）、合作带看人（选填，最多5位）
- 添加房源（必填，至少1套最多10套）
员工选择器（选择陪看人/合作带看人弹层）：左侧为组织树（可搜索、按公司/部门/组展开、多选员工）；右侧为已选员工列表，显示"已选：N"；底部操作「确认」/「取消」
带看房源选择器弹层：支持按房源编号/楼盘地址/业主姓名/电话关键词搜索，支持按楼栋/单元/房号精确搜索，提供区域/状态/相关方/员工部门筛选；列表字段：房源名称、交易类型、状态、用途、城区商圈、房型、楼层、面积；共78195条，每页50条分页；底部显示「已选 (N/50)」，最多选50套

Story 10：经纪人查看客源解读（AI行为分析）

As Agent（经纪人），I want 在客源解读 Tab 中查看系统根据该客户的找房行为自动生成的偏好分析，So that 更准确地判断客户真实需求和购房意向，提升推房精准度。

验收标准：

客源解读 Tab 展示说明文字："以下数据通过客户找房行为分析生成，百分比越高代表浏览次数多"，右上角提供「使用指南」链接
活跃行为模块：卡片展示"有找房行为：X 天内"（数字为最近一次找房行为的距今天数）
活跃时间模块：展示"工作日活跃"和"周末活跃"两个维度（无数据时显示" - "）；右上角显示数据更新时间（如"2026-04-23数据更新"）
购房偏好模块：右上角提供近7日 / 近30日 / 近90日三个时间维度切换，切换后数据联动刷新
购房偏好数据展示以下字段（表格形式）：价格（万元区间）、户型（X居）、面积（㎡区间）、二手区域-商圈、二手小区、新房区域-板块、新房楼盘
类型占比：以"二手房偏好 XX%、新房偏好 XX%"形式展示，可切换「二手偏好」/「新房偏好」子视图
二手偏好视图包含三个圆环图：价格偏好（圆环图 + 图例：区间+占比）、户型偏好（圆环图 + 图例）、面积偏好（圆环图 + 图例）
区域-商圈偏好：圆环图或条形图，无数据时展示"暂无数据"
小区偏好：圆环图或条形图，无数据时展示"暂无数据"
活跃时间详细图表（页面下方）：展示客户活跃时间分布热力图或时间段分布，数据更新时间同步显示

Story 11：经纪人使用二手配房功能推荐房源

As Agent（经纪人），I want 在智能配房（二手配房）Tab 中查看系统为该客户匹配的房源列表，并将合适房源分享给客户，So that 提升推房效率，加快成交进度。

验收标准：

二手配房区块标题右侧显示最后更新时间（如"2026-04-22 17:38 更新"）及刷新说明 ⓘ 图标
提供两个子 Tab：录客配房（当前激活，橙色下划线）/ 系统配房
右上角提供「批量分享」按钮，支持一次性分享多套房源给客户
录客配房 Tab 按以下分组展示房源，各分组有独立小标题：
- 优质户型：展示符合客户户型偏好的优质房源
- 降价：近期有降价的匹配房源
- 热门：近7日有带看的热门房源
- 新上：近期新上架的匹配房源
每套房源以卡片形式展示，卡片字段：
- 左上角角标：「新」标签（橙色，含上架日期，如"新 04-22"）
- 封面图片
- 小区名称（粗体）
- 户型/面积/区域（如"2/2/1 101.17㎡嘉定丰庄"）
- 房源标签（如"朝南户型采光好"、"私盘"、"近7日有带看"、"近半个月有降价"、"3天内上架房源"）
- 售价（橙色，万元）+ 降价幅度（绿色，如"已跌20万"）+ 单价（元/㎡）
- 操作链接：「分享房源」| 「反馈 ∨」（反馈下拉，点击展开）
点击「分享房源」触发房源分享流程（分享给该客户）
点击「反馈 ∨」展开反馈选项（具体枚举待业务确认）
系统配房 Tab：由系统算法自动推荐，展示结构与录客配房一致（分组可能不同）

Story 12：经纪人查看与筛选公客列表

As Agent（经纪人），I want 在公客 Tab 中查看全公司公共客源池中的客户，并通过多维度筛选快速找到我有能力跟进的公客，So that 利用公客资源开拓新成交机会。

验收标准：

顶部一级 Tab 切换至「公客」后激活该视图，Tab 标题高亮橙色下划线
顶部右侧显示「私客与公客重复：无」提示（数字为蓝色链接；无重复时显示"无"）
右上角提供「已删客源」入口及「+ 新增公客」按钮
搜索框支持按客源姓名/号码/号码后4位/客源编号关键词检索；右上角「收起筛选/展开筛选」切换
支持「X条已存搜索」快速调用历史搜索条件
常用快捷筛选：
- 高质量（复选框）
- 不看低质量（复选框，截图显示默认已勾选）
- 我未联系过（复选框）
- 联系情况（下拉）
- 是否有效（下拉）
分组筛选条（可展开/收起）：

筛选组	枚举值
状态	不限 / 求购 / 求租 / 租购 / 已购 / 已租 / 暂缓
需求	二手 / 新房 / 租房
等级	不限 / A(急迫) / B(较强) / C(一般) / D(较弱) / E(暂不关注) / 未填写
位置	宝山/崇明/奉贤/黄浦/虹口/嘉定/静安/金山/卢湾/闵行/南汇/普陀/浦东/青浦/松江/上海周边/徐汇/杨浦/长宁/闸北
跳公类型	不限 / 私客手动转公 / 私客自动转公 / 营销客跳公 / 资料客素公
跳公日期	不限 / 最近3天 / 最近7天 / 最近15天 / 最近30天 / 自定义日期区间
筛选（展开）	相关方、归属部门、录入时间、委托日期、价格、居室、面积、来源、带看进度、带看次数、收藏客源、偏好新房、巧客力访客、用途

列表支持批量操作：修改相关方、修改来源、删除客源
列表底部实时显示总条数（截图示例：共28878条），支持分页（默认20条/页）
列表字段：

字段	说明
姓名	客源姓名（含活跃度标签：新配房/7日活跃/营销客/销售客/访客/无效等），蓝色可点击
跳公类型	私客手动转公 / 私客自动转公 / 营销客跳公 / 资料客素公
状态	求购 / 求租 / 租购 / 暂缓(求购) / 已购等
需求/解读	价格区间 + 面积区间（如：1000-1200万，150㎡-1…）
智能配房	套数 + ⓘ图标
意向商圈/小区	意向区域（"-"表示未填写）
归属人	归属经纪人+门店-组别（共享模式，如"都市港湾店一组-共享"）
最近跟进	最近一次跟进距今天数（如"1天前"）
跳公日期	进入公客池的日期（如"2026-04-21"）
操作	「拨号」快捷按钮

支持自定义列表显示字段（「自定义列表」按钮）
支持导出当前筛选结果（Excel）

Story 13：经纪人查看成交客列表

As Agent（经纪人），I want 在成交客 Tab 中查看已完成成交的客户列表，并通过筛选快速回顾历史成交记录，So that 为复购/转介绍跟进和业绩复盘提供数据支撑。

验收标准：

顶部一级 Tab 切换至「成交客」后激活该视图（面包屑：客源 / 客源管理 / 成交客）
顶部右侧显示「成交客与公客重复：无」提示 + 「已删客源」入口 + 「+ 新增锁客」按钮
搜索框支持按客源姓名/号码/号码后4位/客源编号关键词检索，旁边「搜索」橙色按钮 + 「清空条件」文字链接
筛选条：

筛选组	枚举值
状态	不限 / 我购 / 我租
需求类型	二手（复选框）/ 新房（复选框）/ 租房（复选框）
成交日期	不限 / 最近1月 / 最近3月 / 最近6月 / 自定义日期区间
租约到期	不限 / 10天 / 30天 / 60天
等级	不限 / A(急迫) / B(较强) / C(一般) / D(较弱) / E(暂不关注) / 未填写
筛选（展开）	相关方、录入时间、委托日期、来源、活跃情况、偏好新房、巧客力访客、用途、购房目的

列表支持批量操作：修改相关方、删除客源；底部显示「已选 0 条」
支持导出当前筛选结果（Excel）
列表字段：

字段	说明
姓名	客源姓名（含活跃度标签：7日活跃/30日活跃/90日活跃等），蓝色可点击跳转详情
状态	我购 / 我租
需求类型	二手 / 新房 / 租房
购房目的	刚需/投资/学区/改善/商用/其他（"-"表示未填）
解读	需求解读摘要（蓝色可点击，如"解读:需求变化"）
成交房源	成交对应的房源名称（截断显示，可点击跳转）
成交方	成交归属的门店（截断显示，如"都市港湾…"）
委托日期	首次委托日期
成交日期	成交完成日期
最后跟进	最近一次跟进距今天数（如"3天前"）
用途	住宅 / 别墅 / 商住 / 商铺等

列表总条数示例：共353条；支持分页（默认20条/页，支持跳页）

Story 14：经纪人编辑客源信息

As Agent（经纪人），I want 对已录入的客源进行编辑，修改联系方式、基础信息或购房需求，So that 保持客源数据的准确性，提升智能配房匹配精度。

验收标准：

编辑客源页面标题为「编辑客源」，通过私客详情页右侧「编辑」按钮或需求信息 Tab「编辑」链接触达
页面顶部为三个 Tab 导航：联系人 / 基础信息 / 二手（需求类型决定此处 Tab 标题，如"二手"/"新房"/"租房"）
联系人 Tab（默认激活）：
- 与录入私客的联系人区块字段完全一致（姓名/称呼/电话1/电话2/微信/QQ/备注）
- 联系人1 电话1 旁额外显示「查看后可编辑号码」文字说明和「查看号码」蓝色按钮（号码默认打码，需权限点击查看后才可编辑）
- 电话1 旁额外显示「标记无效」蓝色链接，点击将该号码标记为无效
- 新增联系人备注字段（「备注」文本框，最多200字）
- 右上角提供「+ 添加联系人」按钮
基础信息 Tab：
- 字段与录入私客的基础信息区块完全一致，在此基础上新增以下字段（录入时折叠，编辑时全部展开）：

新增字段	类型	枚举值/说明
需求类型	单选	二手 / 新房（截图显示为必填，☑ 二手）
购房目的	多选	刚需 / 投资 / 学区 / 改善 / 商用 / 其他
付款方式	单选	全额 / 商业贷款 / 商业贷款+公积金 / 公积金
名下房产	单选	无 / 本地无房外地有房 / 本地有房
贷款记录	单选	有 / 无
证件类型	下拉	身份证 / 护照 / 港澳通行证 / 其他
证件号码	文本输入	格式校验（身份证18位）
意向学校	文本 + 「+ 添加学校」	支持添加多所意向学校
入学时间	月份选择器	请选择年月

二手 Tab（需求类型为二手时显示；若为新房则显示"新房" Tab，若为租房则显示"租房" Tab）：
- 字段与需求信息 5.8.1 完全一致，但为可编辑态，具体组件如下：

字段	组件类型	备注
总价	数字输入区间（最小值 - 最大值，万元）	必填，如"550 - 600"
面积	数字输入区间（最小值 - 最大值，㎡）	必填，如"100 - 110"
居室	多选复选框	1居 / 2居 / 3居 / 4居 / 5居及以上
楼层	多选复选框	不要一层 / 低楼层 / 中楼层 / 高楼层 / 不要顶层
朝向	多选复选框	东 / 南 / 西 / 北
装修	多选复选框	毛坯 / 清水 / 简装 / 中装 / 精装 / 豪装
楼龄	多选复选框	5年以内 / 5-10年 / 10-15年 / 15-20年 / 20年以上
意向商圈	下拉多选	请选择商圈
意向小区	文本输入 + 「+ 添加小区」	支持添加多个意向小区
交通	文本输入	最多50字
备注	多行文本	最多200字

页面底部固定显示「保存」（橙色主按钮）和「取消」按钮
点击「保存」时校验所有必填字段，保存成功后返回详情页并刷新需求信息区块
点击「取消」返回详情页，不保存任何更改

Story 15：经纪人查看客源信息概览面板

As Agent（经纪人），I want 在客源详情页右侧快速概览该客源的核心信息和常用操作，So that 无需切换 Tab 即可掌握客户关键状态并快速执行高频操作。

验收标准：

客源详情页右侧固定展示"信息概览"面板，不随页面滚动消失
面板顶部展示客户标签行：需求状态徽标（如"求购"橙色背景）、客户姓名（大字加粗）、带看进度标签（如"一看"）、等级标签（如"C(一般)"）
面板显示联系人称谓（女士/先生）
面板依次展示以下只读字段：最近跟进日期、客户编号、委托日期、需求类型（二手/新房）、房源用途、客户来源、购房目的、付款方式、名下房产、贷款记录、证件类型、证件号码、意向学校、入学时间
未填写的字段显示"-"占位
面板中部固定展示三个主操作按钮：打电话（橙色）、写跟进（橙色）、报备/带看（白色边框）
面板下部展示两行快捷操作入口（每行四个图标+文字）：
- 第一行：☆ 收藏、置顶/不置顶、改等级、改状态
- 第二行：改状态（转公客）、转公客、转成交、转无效、编辑客源
点击任意快捷操作图标触发对应浮层或操作流程（详见 Story 16-22）

Story 16：经纪人收藏客源至私客收藏夹

As Agent（经纪人），I want 将重点客户收藏至私客收藏夹，So that 在私客列表中可按收藏夹快速筛选出重点跟进客户。

验收标准：

点击信息概览面板中的「☆ 收藏」触发"选择私客收藏夹"浮层
浮层标题为"选择私客收藏夹"，副标题提示文字"可在私客列表筛选收藏的客户"
浮层内以单选列表形式展示当前用户已有的所有收藏夹，默认选中"默认收藏夹"
浮层左下角显示「+ 创建收藏夹」蓝色文字链接，点击后触发创建收藏夹内联交互
创建收藏夹时，列表顶部出现文本输入框（占位文字"请输入名称最多10个字"）+ 「创建」橙色按钮 + 「取消」文字按钮
输入收藏夹名称后点击「创建」：新收藏夹出现在列表中，自动选中，「+ 创建收藏夹」链接恢复显示
收藏夹名称最多10个字，超出长度时「创建」按钮置灰不可点击
浮层底部提供「确定」（橙色）按钮，点击后将客源加入所选收藏夹，浮层关闭
收藏成功后，信息概览面板中「收藏」图标状态更新为实心★，颜色变为橙色
再次点击收藏图标（已收藏状态）弹出"选择私客收藏夹"浮层，支持修改或取消收藏所在收藏夹

Story 17：经纪人修改客源等级

As Agent（经纪人），I want 快速修改客源的购买意向等级，So that 确保客源等级与客户当前实际意向相符，辅助工作优先级排序。

验收标准：

点击信息概览面板中的「改等级」触发"改等级"弹窗
弹窗标题为"改等级"
弹窗展示只读字段"原等级"，显示当前等级值（如"C(一般)"）
弹窗展示必填字段"新等级"（标注红色*号），组件为下拉选择器
新等级下拉选项枚举：A急迫 / B较强 / C一般 / D较弱 / E暂不关注
「确定」按钮：新等级未选择时置灰，选择后高亮可点
点击「确定」保存成功后：弹窗关闭，信息概览面板等级标签实时更新，并在操作日志中新增一条"改等级"记录
点击「取消」或右上角×关闭弹窗，不做任何修改

Story 18：经纪人修改客源状态

As Agent（经纪人），I want 修改客源的需求状态（求购/求租/租购），So that 准确反映客户当前的业务需求方向，保证配房匹配精准。

验收标准：

点击信息概览面板中的「改状态」触发"改状态"弹窗
弹窗标题为"改状态"
弹窗展示只读字段"原状态"，显示当前状态值（如"求购"）
弹窗展示必填字段"新状态"（标注红色*号），组件为下拉选择器，枚举：求购 / 求租 / 租购
弹窗展示"等级"字段，组件为下拉选择器，默认回显当前等级（如"C(一般)"），可修改
弹窗展示必填字段"更改理由"（标注红色*号），组件为多行文本输入框（占位文字"请输入更改理由"）
「确定」按钮：新状态未选或更改理由未填时置灰，均填写后高亮
点击「确定」保存成功后：弹窗关闭，信息概览面板状态标签实时更新，并在操作日志新增一条"改状态"记录（含更改理由）
点击「取消」或右上角×关闭弹窗，不做任何修改

Story 19：经纪人手动将私客转为公客

As Agent（经纪人）或店长，I want 主动将某私客转入公共客源池，So that 让其他经纪人也能跟进该客户，提升客源利用率和成交机会。

验收标准：

点击信息概览面板中的「转公客」触发"把此私客转为公客"弹窗
弹窗标题为"把此私客转为公客"
弹窗展示必填字段"状态"（标注红色*号），组件为下拉选择器，默认回显当前客源状态（如"求购"），可修改
弹窗展示必填字段"等级"（标注红色*号），组件为下拉选择器，默认回显当前等级（如"C(一般)"），可修改
「确定」按钮：状态或等级任一未选时置灰
点击「确定」：
- 系统将该客源从私客列表中移除，转入公客池
- 弹窗关闭，原私客详情页跳转至客源列表
- 操作日志中新增一条"转公客"记录（含操作人、操作时间）
点击「取消」或右上角×关闭弹窗，不执行转公操作
权限控制：仅该客源的归属人、首录人或有管理权限的店长/经理可操作"转公客"

Story 20：经纪人将私客转为成交客

As Agent（经纪人），I want 在客户完成购房/租房成交后将其标记为成交客，并录入成交信息，So that 完整记录成交数据，同步到成交客列表及业绩统计。

验收标准：

点击信息概览面板中的「转成交」触发"客户成交"弹窗
弹窗标题为"客户成交"
弹窗包含以下必填字段：

字段	组件类型	说明
状态	单选（我购 / 我租）	默认选中"我购"
房源类型	单选（二手 / 新房）	默认选中"二手"
成交房源	链接选择器「+ 选择成交房源」	必填，点击后跳出成交房源选择浮层
成交日期	日期选择器	默认为当日，格式 YYYY-MM-DD
成交价格	数字输入（单位：万元）	必填
成交方	人员选择器	默认带入当前登录人所属门店/小组，可修改

成交房源选择浮层：
- 浮层标题"选择成交房源"
- 搜索栏：支持按房源编号/楼盘地址/业主姓名/电话关键词搜索，以及楼栋/单元/房号独立输入
- 筛选栏：区域（下拉）、状态（下拉）、相关方（下拉）、员工/部门选择器
- 列表字段：房源名称（蓝色链接）、交易类型、状态、用途、城区商圈、房型、楼层、面积（㎡）
- 单选（每次只能选择一套成交房源）
- 底部显示「已选 (0/50)」计数和「确定」按钮（选中1条后高亮）
- 分页：共 89704 条，50条/页
点击"客户成交"弹窗「确定」按钮：
- 所有必填字段填写完毕后按钮高亮可点
- 提交后客源从私客列表移入成交客列表，详情页顶部状态更新为"成交"
- 操作日志中新增一条"转成交"记录（含成交信息摘要）
点击「取消」或右上角×关闭弹窗，不执行转成交操作

Story 21：经纪人将客源标记为无效

As Agent（经纪人），I want 将无效客户（如空号/骚扰/无意向等）标记为无效，So that 避免对无效客户持续无效跟进，提升客源列表质量。

验收标准：

点击信息概览面板中的「转无效」触发"请选择无效原因"弹窗
弹窗顶部显示蓝色信息提示框：「该功能为整体客转无效，将把所有电话标记无效」
弹窗以单选列表形式展示无效原因，默认选中第一项：
- ⦿ 号码无效（默认）
- ○ 同行中介
- ○ 广告推销
- ○ 客户无意向
- ○ 其他
「确定」按钮（橙色）：选择任意原因后高亮
点击「确定」：
- 该客源下所有联系人电话号码全部标记为无效
- 客源状态更新为"无效"，从私客活跃列表中移除
- 操作日志新增一条"转无效"记录（含选择的无效原因）
点击「取消」或右上角×关闭弹窗，不执行任何操作
权限控制：仅归属人、首录人或有管理权限者可操作

Story 22：经纪人编辑客源基础信息（快捷入口）

As Agent（经纪人），I want 通过信息概览面板的快捷入口直接编辑客源基础信息，So that 无需进入完整编辑页即可快速更新常用字段。

验收标准：

点击信息概览面板中的「编辑客源」入口，触发"编辑基础信息"弹窗（抽屉浮层）
弹窗标题为"编辑基础信息"，右上角提供×关闭按钮
弹窗包含以下字段：

字段	必填	组件类型	枚举值/说明
需求类型	必填（*）	复选框	☑ 二手 / □ 新房
用途	必填（*）	下拉选择	住宅 / 别墅 / 商住 / 商铺 / 写字楼 / 其他
来源	必填（*）	下拉选择	由运营配置，如"线下\|门店接待"
购房目的	选填	多选复选框	刚需 / 投资 / 学区 / 改善 / 商用 / 其他
付款方式	选填	下拉选择	全额 / 商业贷款 / 商业贷款+公积金 / 公积金
名下房产	选填	下拉选择	无 / 本地无房外地有房 / 本地有房
贷款记录	选填	单选	有 / 无
证件类型	选填	下拉选择	身份证（默认）/ 护照 / 港澳通行证 / 其他
证件号码	选填	文本输入	占位文字"请输入证件号码"
意向学校	选填	文本输入 + 「+ 添加学校」	支持添加多所学校

底部提供「确定」（橙色）和「取消」按钮
点击「确定」后必填字段校验，保存成功后弹窗关闭，信息概览面板相关字段实时更新
点击「取消」或×关闭弹窗，不保存修改

Story 23：经纪人管理客源联系人

As Agent（经纪人），I want 在客源详情页查看、新增或编辑该客源的联系人信息，So that 确保联系方式信息完整，随时可以联系到客户。

验收标准：

联系人面板展示：

客源详情页右侧展示「联系人」信息面板，面板右上角提供「查看号码」和「新增联系人」两个操作入口
面板中每位联系人展示以下信息：
- 姓名（加粗）、称谓（如"女士"）
- 电话1：格式为"+86 135********"（默认打码，需点击「查看号码」后才显示完整号码）
- 电话1 下方展示标签状态行：默认拨打标识、接通N次、拨打N次
- 微信：显示值或"-"
- QQ：显示值或"-"
- 备注内容：显示值或"-"

新增联系人：

点击「新增联系人」触发"新增联系人"弹窗
弹窗标题为"新增联系人"，右上角提供×关闭按钮
弹窗包含以下字段：

字段	必填	组件类型	说明
姓名	必填（*）	文本输入	占位文字"请输入"
称呼	必填（*）	单选	先生 / 女士
电话1	必填（*）	国际区号下拉 + 手机号输入	默认区号+86
电话2	选填	国际区号下拉 + 手机号输入	默认区号+86
微信号	选填	文本输入	占位文字"请输入"
QQ	选填	文本输入	占位文字"请输入"
备注	选填	多行文本	占位文字"请输入，最多200字"

点击「确定」后校验必填字段，保存成功后联系人面板新增一条记录
点击「取消」或×关闭弹窗，不保存

编辑联系人：

点击联系人条目中的编辑入口触发"编辑联系人"弹窗
弹窗标题为"编辑联系人"，字段与新增联系人一致
电话1 旁额外显示「查看号码 ⓘ」蓝色链接，号码默认打码显示（如"135********"），点击后完整号码展示，进入可编辑状态
其他字段（电话2/微信号/QQ/备注）直接展示已有值（如无则显示"-"），可直接编辑
点击「确定」保存修改，点击「取消」或×关闭不保存

Story 24：经纪人管理客源相关员工

As Agent（经纪人）或店长，I want 查看和修改客源的首录人与归属人，So that 确保客源归属关系正确，保证客源跟进责任到人。

验收标准：

相关员工面板展示：

客源详情页右侧展示「相关员工」信息面板，面板右上角提供「编辑」蓝色链接
面板中依次展示：
- 【首录人】：所属门店+小组+姓名，下方显示参与时间（格式"YYYY-MM-DD HH:mm"），行尾提供🤙拨号图标
- 【归属人】：所属门店+小组+姓名，下方显示参与时间（格式"YYYY-MM-DD HH:mm"），行尾提供🤙拨号图标

编辑相关员工：

点击面板右上角「编辑」触发"编辑相关员工"弹窗
弹窗标题为"编辑相关员工"，右上角提供×关闭按钮
弹窗包含以下字段：

字段	必填	组件类型	说明
首录人	必填（*）	下拉选择器	显示"姓名 - 门店小组"，如"雷威 - 都市港湾店一组"
归属人	必填（*）	下拉选择器	显示"姓名 - 门店小组"，如"雷威 - 都市港湾店一组"

下拉选择器支持搜索员工姓名，范围为当前登录用户权限内可见的员工
点击「确定」保存后：弹窗关闭，相关员工面板中首录人/归属人信息实时更新，操作日志中新增一条"修改相关员工"记录
点击「取消」或×关闭弹窗，不执行任何修改
权限控制：普通经纪人可修改归属人为自己团队内的成员；修改为跨团队/跨店需店长及以上权限

Story 25：经纪人查看客源操作日志

As Agent（经纪人）或店长，I want 查看某一客源的完整操作历史记录，So that 了解客源的全生命周期操作轨迹，追溯变更原因，辅助审计和管理。

验收标准：

入口：

客源详情页右侧下方展示「其他操作」面板，面板内提供「查看操作日志」蓝色文字链接
点击「查看操作日志」跳转至独立的"客源操作日志"列表页，面包屑导航为：客源 / 客源详情 / 客源操作日志

客源操作日志页面：

页面标题为"客源操作日志"
页面顶部提供以下筛选控件：
- 日期范围选择器（开始日期 - 结束日期，日历图标选择）
- 操作人搜索输入框（占位文字"搜索联系人"）
- 操作类型下拉选择器（占位文字"请选择"，枚举值见下文）
- 「查询」橙色按钮 / 「清空条件」文字链接
操作类型枚举（基于截图可见记录，系统实际枚举值更多）：
- 新增私客、电话、查看号码、改等级、改状态、转公客、转成交、转无效、收藏、编辑客源、新增联系人、编辑联系人、修改相关员工、写跟进、带看、新增预约带看等
日志列表字段：

字段	说明
操作时间	格式"YYYY-MM-DD HH:mm"，如"2026-04-17 19:24"
操作人	所属门店+小组+姓名，如"都市港湾店一组-雷威"
操作类型	如"查看号码"/"电话"/"新增私客"
操作内容	操作的详细描述，如"新增一个【求购】私客"、"市区房子动迁大概要明年才开始早着呢"

日志列表支持分页：底部显示总条数（如"共3条"），分页控件（上一页 / 页码 / 下一页 / 跳页），默认20条/页
日志记录按操作时间倒序排列（最新操作在最上方）
日志为只读，不支持编辑或删除

5. 功能详细说明

5.1 客源列表

5.1.1 页面整体布局

客源列表页分为以下层级结构：

顶部一级 Tab（客源大类切换）：

Tab	说明
私客	经纪人自己维护的客源（本模块核心）
资料客	通过多方渠道获取的意向客户资料
营销客	通过营销活动引入的客户
成交客	已完成成交的客户
公客	公共客源池，全员可见可跟进

顶部右侧全局状态提示：

提示项	说明
私客与成交客重复：XX	数字为蓝色可点击链接，点击查看重复名单
私客与公客重复：XX	数字为蓝色可点击链接，点击查看重复名单
已删客源：XX	数字为蓝色可点击链接，点击查看已删除客源

二级 Tab（需求类型切换），位于一级 Tab 下方：

Tab	说明
求购	有购房需求的客源，共 XX 条
求租	有租房需求的客源，共 XX 条
暂缓	暂时搁置需求的客源
全部私客	不限需求类型，展示所有私客

5.1.2 搜索与筛选系统

关键词搜索：

搜索框左侧提供「客户信息」下拉范围选择器，默认为客户信息，搜索内容包括：

客源姓名
号码（完整手机号）
号码后4位
客源编号
备注信息

支持"X条已存搜索"入口，保存并快速调用历史搜索条件。

常用快捷筛选条（位于搜索栏下方）：

筛选项	说明
即将掉公	快捷过滤即将变为公客的私客
录入时间	按录入时间区间筛选（下拉选择）
与我相关	仅展示与当前登录用户相关的客源
我部门相关	展示当前用户所属部门的客源

分组筛选条（可展开/收起）：

筛选组	筛选项	说明
状态	不限 / 求购 / 求租 / 租购 / 已购 / 已租 / 暂缓	求购Tab下显示：不限/求购/租购；求租Tab下显示：不限/求租/租购
需求	二手 / 新房 / 租房	对应购/租需求的房源类型
等级	不限 / A(急迫) / B(较强) / C(一般) / D(较弱) / E(暂不关注) / 未填写	多选
位置	宝山/崇明/奉贤/黄浦/虹口/嘉定/金山/卢湾/闵行/南汇/普陀/浦东/青浦/松江/上海周边/徐汇/杨浦/长宁/闸北	多选，地区维度
购价（求购Tab）	200万以下/200-250万/.../2000万以上 + 自定义区间	预设区间 + 自定义最小~最大万
租价（求租Tab）	2000以下/2000-2500/.../10000以上 + 自定义区间	预设区间 + 自定义最小~最大元
房室（求购）	不限/1层/2层/3层/4层/5层及以上 + 是大价值
房室（求租）	不限/1层/2层/3层/4层/5层及以上
筛选（更多，展开显示）	相关方、委托日期、来源、购房目的、带看进度、活跃情况、是否有效、面积、跟进时间、带看时间、审批中、审批驳回、收藏客源	点击"展开"展示更多筛选维度
筛选（收起后隐藏）	保护客、合作者、偏好新房、巧客力访客、置顶、用途、带看次数

求购私客专属筛选项（相较全部私客额外增加的过滤维度）：

购房目的
保护客
合作者
偏好新房
巧客力访客
置顶
用途
带看次数

暂缓 Tab 专属筛选差异：

筛选组	暂缓 Tab 下的枚举值
状态	不限 / 暂缓(租购) / 暂缓(求租) / 暂缓(求购)
需求	二手 / 新房 / 租房
购价	不限 / 200万以下 / … / 2000万以上 + 自定义区间（同求购）
房室	不限 / 1居 / 2居 / 3居 / 4居 / 5居及以上

暂缓 Tab 总条数示例：共 1436 条（截图实测），列表同样支持服务端分页（默认20条/页）。

5.1.3 列表字段说明

核心列表字段：

字段	说明
姓名	客源姓名，蓝色可点击跳转详情；姓名下方展示活跃度标签（详见下方说明）
状态	求购 / 求租 / 租购 / 暂缓等
需求类型	二手 / 新房 / 租房
需求/解读	价格区间 + 面积区间（如：550-600万，100㎡-110㎡...）
智能配房	系统自动匹配的房源套数 + ⓘ 图标（点击查看配房详情）
意向商圈/小区	客户意向的商圈或小区名称，"-"表示未填写
归属人	归属经纪人姓名 + 门店-组别（如：雷威-都市港湾店一组）
带看进度	未带看 / 一看 / 二看 / 复看等阶段
带看次数	累计带看次数（次）
委托日期	客户委托日期（如：2026-04-19）
最近时间	最近一次跟进或带看的距今天数（如：3天前）
操作	「拨号」快捷按钮

活跃度标签说明（展示于姓名下方，彩色标签）：

标签	颜色	触发条件
新配偶	蓝色	新完成智能配房
7日活跃	绿色	最近7天内有跟进或带看记录
30日活跃	浅绿色	最近30天内有跟进或带看记录
销售客	橙色	来源为销售渠道
访客	灰色	来自巧客力访客
营销客	紫色	来源为营销推广

批量操作按钮（列表上方，勾选后激活）：

操作	说明
修改相关方	批量修改归属人、首录人等相关方信息
修改来源	批量修改客源来源渠道
删除客源	批量软删除客源（可在"已删客源"中恢复）
合并客户	将重复的客源合并为一条（需选择主记录）

5.2 录入私客

5.2.1 页面布局

录入私客为独立页面，标题为「录入私客」，页面分为三个主区块：联系人 / 基础信息 / 相关员工，底部为「确定」和「取消」操作按钮。

5.2.2 联系人区块

支持录入多个联系人，联系人1 为主联系人（默认展示，不可删除），联系人2 起可通过「+ 新增联系人」按钮追加，并可点击「删除」移除。

必填字段：

字段	类型	说明
姓名	文本输入	最多不限字数，请输入客户真实姓名或昵称
性别	单选	先生 / 女士，默认无选中
电话1	区号选择 + 手机号输入	左侧区号下拉（默认+86 中国大陆），右侧输入手机号

选填扩展字段（点击"电话2、微信、QQ等"折叠展开）：

字段	类型	说明
电话2	区号选择 + 手机号输入	同电话1格式
微信	文本输入	微信号
QQ	文本输入	QQ号

联系人操作规则：

联系人2 起，区块标题右侧显示红色「删除」链接，点击后移除该联系人区块
「+ 新增联系人」按钮每次点击新增一个联系人区块，理论上不限联系人数量（建议上限5个）
电话1 录入后系统自动实时校验是否存在重复私客，若重复则在输入框下方展示提示

5.2.3 基础信息区块

必填字段：

字段	类型	必填	枚举值 / 说明
状态	单选	是	求购 / 求租 / 租购
用途	单选	是	住宅 / 别墅 / 商住 / 商铺 / 写字楼 / 其他（默认选中"住宅"）
等级	单选	是	A(急迫) / B(较强) / C(一般) / D(较弱) / E(暂不关注)
来源	下拉选择	是	枚举值由运营维护，如：门店接待/电话咨询/朋友介绍/线上渠道等

选填扩展字段（点击"证件类型、证件号码、意向学校等"折叠展开）：

字段	类型	说明
证件类型	下拉选择	身份证 / 护照 / 港澳通行证 / 其他
证件号码	文本输入	支持格式校验（身份证18位）
意向学校	下拉多选	选择意向学区学校

5.2.4 相关员工区块

字段	类型	说明
首录人	只读文本	自动填充当前登录用户姓名及所属组织，格式：「姓名 - 门店-组别」
归属人	只读文本	默认与首录人一致，管理员可在详情页修改归属人

5.2.5 表单交互规则

页面底部固定显示「确定」（橙色主按钮）和「取消」按钮
点击「确定」时对所有必填字段统一校验，未通过高亮红框并滚动至第一个错误处
保存成功后跳转至该客源详情页，并展示"保存成功"提示
点击「取消」直接返回客源列表，不保存数据，不弹出确认提示（操作轻量）
电话1 失去焦点时，后台自动发起重复检测：若与已有私客号码重复，在输入框下方展示橙色警告"存在重复客源：XXX（可点击查看）"，但不阻断录入（允许继续保存，后续通过重复检测管理）

5.3 客源活跃度与标签体系

客源列表中，姓名下方展示多个彩色标签，辅助经纪人快速识别客户状态和跟进优先级。

5.3.1 活跃度标签

标签文案	触发逻辑	样式
新配偶	系统为该客源新增了智能配房结果	蓝色高亮
7日活跃	最近7天内有跟进记录或带看记录	绿色
30日活跃	最近30天内有跟进记录或带看记录（但不满足7日活跃）	浅绿色
销售客	该客源来源为销售渠道	橙色
访客	来自巧客力平台访客	灰色
营销客	来源于营销推广活动	紫色

5.3.2 等级标签

等级标签（A/B/C/D/E）直接展示在姓名后，配合活跃度标签共同显示。等级由经纪人手动设置，代表客户购房/租房意向的紧迫程度：

等级	说明
A（急迫）	近期确定要成交，需高频跟进
B（较强）	明确需求，已在积极看房
C（一般）	有需求但时间较宽松
D（较弱）	需求模糊，观望为主
E（暂不关注）	短期内无成交意向，可降频跟进

5.4 重复检测机制

系统提供以下三种重复客源检测，结果展示于客源列表顶部右侧：

检测类型	说明	检测逻辑
私客与成交客重复	当前私客中与已成交客户号码相同的记录数	以电话号码为主键进行匹配
私客与公客重复	当前私客中与公客号码相同的记录数	以电话号码为主键进行匹配
已删客源	被软删除的客源数量	管理员可查看并恢复

检测交互规则：

三个数字均为蓝色可点击链接，点击后跳转至对应重复名单页面
名单页面支持按经纪人/日期筛选，支持批量处理（合并/忽略/删除）
录入新客源时，电话1 字段实时触发系统内重复检测，结果以提示信息展示

5.5 智能配房功能

客源列表中「智能配房」列展示系统自动为该客户匹配的房源套数。

配房逻辑（基础规则版）：

维度	匹配规则
需求状态	客源状态为求购/求租，对应匹配出售/出租房源
用途	客源用途与房源用途一致
价格区间	房源售价/租价在客源预算区间内（±10% 容差）
面积区间	房源建筑面积在客源需求面积区间内
位置意向	客源意向商圈/小区与房源所在区域匹配

展示规则：

「智能配房」列显示匹配套数数字，旁边 ⓘ 图标悬浮后展示配房结果概要
点击套数数字可跳转至该客源的配房详情页，展示匹配到的具体房源列表
有新配房结果时，客源名称下方展示「新配偶」标签提示经纪人查看

5.6 客源状态流转

私客的状态流转规则如下：

[录入] → 求购 / 求租 / 租购
                ↓
           暂缓（临时搁置）
                ↓
           求购 / 求租（恢复）
                ↓
           成交（进入成交客）

当前状态	可变更至	触发条件
求购	求租、租购、暂缓	经纪人手动变更
求租	求购、租购、暂缓	经纪人手动变更
租购	求购、求租、暂缓	经纪人手动变更
暂缓	求购、求租、租购	经纪人手动恢复
任意	成交客	交易完成后系统自动或经纪人手动触发

5.7 私客详情页

5.7.1 页面整体布局

私客详情页采用左右分栏结构：

左侧主内容区（约70%宽度）：顶部功能 Tab 导航 + 各 Tab 对应内容区域
右侧固定信息面板（约30%宽度）：客源核心信息摘要 + 快捷操作

5.7.2 顶部功能 Tab 导航

Tab	说明
需求信息	客户购房/租房需求的全量字段（默认激活）
跟进记录	所有跟进记录，按时间线展示
带看	预约带看与实际带看记录
客源解读	AI行为分析：找房偏好、活跃时间、区域偏好
智能配房	系统匹配的二手房源推荐（录客配房+系统配房）

5.7.3 右侧信息面板

客源标题区（面板顶部）：

展示客源需求标题（如"姚叔叔置换电梯两房（上门）"）
姓名及称呼（如"先生"）
带看进度标签（如"私客一看已(一看)"）

基础信息字段（竖向列表）：

字段	示例值
最近记录	2026-04-19
客户编号	60419C03182A3
委托日期	2026-04-19
需求类型	二手
房源用途	住宅
客户来源	线下·门店接待
购房目的	-
付款方式	-
名下房产	未填写
贷款记录	-

点击"展开全部"可查看更多基础信息字段。

快捷操作按钮（面板中部）：

按钮	类型	说明
拨打电话	橙色主按钮	直接拨打客户电话1
加微信	次要按钮	复制微信号或跳转微信
签备用单	次要按钮	发起备用单签署流程

状态变更操作（面板中部，图标+文字）：

操作	说明
收藏	将该客源加入个人收藏
不跟进	标记当前不需要跟进
改等级	手动修改客源等级（A/B/C/D/E）
修改名下	修改客户名下房产信息
转公客	将私客转入公客池
转成交	标记为已成交，进入成交客
转无效	标记为无效客源
编辑信息来源	修改客源的来源渠道

待办提醒区块：

显示待处理提醒条数（如"待办提醒 (0)"）
说明文字："系统会在设置的时间点发送跟进通知"
提供「写办」快捷入口

联系人区块：

显示主联系人姓名（可点击查看详情）
手机号码默认打码（如"电话1: +86 137********"）
提供「查看号码」链接（需权限，操作留痕）
提供「新增联系人」快捷入口
显示"帮你联系拨打或拨打70次"快捷通话辅助

相关员工区块：

展示首录人（姓名+门店-组别）及参与时间
展示归属人（姓名+门店-组别）及参与时间
提供「编辑」入口（管理员权限）

其他操作区块：

「查看操作日志」链接入口

5.8 需求信息

需求信息 Tab 展示该客源的购房/租房需求全量字段，采用三栏网格布局，字段值为空时显示" - "占位符。

5.8.1 需求信息字段表

字段	类型	示例值	说明
总价	价格区间	550-600万元	购房总价预算范围，万元为单位
面积	面积区间	100㎡-110㎡	需求建筑面积范围
居室	枚举	2居	居室数量，如1居/2居/3居等
装修	枚举	-	精装/简装/毛坯/不限等
朝向	多选枚举	-	南/北/东/西/东南/西南等
楼层	多选枚举	中楼层、低楼层	低楼层/中楼层/高楼层/不限等
楼龄	区间或枚举	-	房屋建成年代/年限
意向商圈	多选	-	意向区域商圈名称
意向小区	多选	-	意向小区名称
交通情况	文本	-	对交通出行的需求描述
备注	长文本	-	其他补充需求描述

5.8.2 交互规则

字段值为空时展示" - "，不隐藏字段标签
右上角提供「编辑」蓝色文字链接，点击进入编辑态
编辑态下，各字段转为对应的输入组件（文本框/下拉/多选等）
编辑态底部提供「保存」和「取消」操作按钮
保存成功后自动刷新当前区块内容，并重新触发智能配房计算

5.9 跟进记录

跟进记录 Tab 记录经纪人与客户之间的全部沟通和操作历史，是客源管理的核心功能之一。

5.9.1 Tab 结构

子 Tab	展示内容
全部	所有类型跟进记录，按时间倒序时间线展示
写入跟进	经纪人手动录入的跟进记录，支持按跟进目的和标签筛选
敏感信息跟进	含敏感信息的跟进记录（如查看号码等操作留痕）
修改跟进	对已有跟进记录修改后的变更日志
其他跟进	系统自动生成的操作类日志（如新增私客、状态变更等）

5.9.2 全部 Tab

右上角提供时间范围筛选器（开始时间 → 结束时间，日期选择器）
提供「有录音」「有图片」快速过滤复选框
跟进记录按日期分组，每日分组以橙色圆点时间轴标注

每条记录格式：

【类型标签】门店-组别 经纪人姓名 HH:mm
跟进内容正文...
                                  ⓘ 已开放  隐藏

「已开放」表示该记录对团队成员可见；「隐藏」操作可将该条记录设为仅自己可见

5.9.3 写入跟进 Tab

跟进目的多选筛选（共23项）：

第一行	第二行	第三行
回拨	电话	去电
推房	短信	申请
带看	房源未认证	未接通
维护	激活	信函
其他	接待	修改
带看回访	勘察	邮件
新增私客回访	看房	转房客
拜访	派单
保留	企业来电通

跟进标签筛选（常用展示，支持展开查看全部）：

有录音、有图片、对房源不满意、还在考虑、对房源满意可交定金

跟进记录格式（写入跟进视图中，每条记录额外展示跟进目的标签）：

目的标签以蓝色方框标注（如 电话）显示在记录正文上方
正文下方：门店-组别经纪人姓名日期时:分
右侧显示操作入口（···三点菜单：编辑/删除/隐藏等）

5.9.4 敏感信息跟进 Tab

展示所有查看号码、查看敏感信息等操作的留痕记录。无数据时展示"暂无跟进"空状态提示。

5.9.5 修改跟进 Tab

展示对已有跟进记录进行修改的变更日志（修改前/修改后对比）。无数据时展示"暂无跟进"空状态提示。

5.9.6 其他跟进 Tab

展示系统自动生成的操作类日志，包括：

新增私客日志：【新增私客】门店-组别经纪人 HH:mm + "新增一个【求购】私客"
状态变更日志（如私客转公客、等级变更等）

5.10 带看管理

带看 Tab 管理该客源相关的所有带看活动，分为预约带看和实际带看两类。

5.10.1 Tab 结构

子 Tab	说明
预约	提前预约的带看计划（尚未实际带看）
带看	已完成的实际带看记录

5.10.2 带看列表（带看 Tab）

提供「归属人带看」「其他人带看」复选框过滤（可同时选中）
右上角提供时间范围筛选器（开始时间 → 结束时间）

记录以时间线形式展示，每条记录格式：

● YYYY-MM-DD HH:mm    带看情况：[情况文本]                  详情 >
                      [房源名称-房号]（蓝色可点击链接）
                      [进度标签] 带看: [经纪人姓名]

带看进度标签：一看（橙色）/ 二看 / 复看等
「详情 >」链接跳转至该次带看详情页

5.10.3 新增带看表单

新增带看为独立页面（面包屑：客源 / 客源管理 / 新增带看），包含以下区块：

带看信息区块：

字段	类型	必填	说明
业务类型	只读文本	-	如"二手"，系统自动带入
带看客户	只读文本	-	当前客源名称，旁边提供「查看详情」链接
经纪人	只读文本	-	自动填充当前登录用户及所属组别
带看时间	日期+时间区间	是	日期选择 + 开始时间→结束时间
陪看人	员工选择器	否	最多5位，点击「+ 添加」弹出选择器
合作带看人	员工选择器	否	最多5位，点击「+ 添加」弹出选择器
带看情况	多行文本	是	至少6个字才可提交
附件	图片上传	否	格式：bmp/jpg/png/gif；最大20MB；建议在手机端上传含位置信息的图片

带看房源区块：

字段	类型	必填	说明
添加房源	房源选择器	是	至少1套最多10套；为每套房源选择客户意向程度

表单底部操作按钮：「提交」（橙色主按钮）/ 「保存」/ 「取消」

5.10.4 新增预约带看表单

新增预约带看为独立页面（面包屑：客源 / 客源管理 / 新增预约），包含以下区块：

约看信息区块：

字段	类型	必填	说明
业务类型	只读文本	-	如"二手"，系统自动带入
预约客户	只读文本	-	当前客源名称，旁边提供「查看详情」链接
预约人	只读文本	-	自动填充当前登录用户及所属组别
预约时间	日期+时间	是	日期选择 + 时间选择（精确到分钟）
陪看人	员工选择器	否	最多5位
合作带看人	员工选择器	否	最多5位

房源区块：

字段	类型	必填	说明
添加房源	房源选择器	是	至少1套最多10套

表单底部操作按钮：「提交」（橙色主按钮）/ 「取消」

5.10.5 员工选择器（陪看人/合作带看人）

点击「+ 添加」弹出"选择员工"弹层，交互规则如下：

弹层标题：「选择员工」
左侧组织树（约50%宽度）：
- 顶部搜索框："搜索员工"（橙色边框聚焦态）
- 组织树节点：公司 → 部门/门店 → 组别 → 员工，支持折叠展开
- 每个节点前有复选框，支持按组批量选择（勾选部门/组则选中其下所有员工）
- 已关闭的组织节点旁显示「关闭」灰色标签
右侧已选列表（约50%宽度）：
- 标题："已选: N"（N为当前已选员工数）
- 每位已选员工显示姓名，右侧「×」移除
弹层底部：「确认」（橙色主按钮）/ 「取消」
最多选择5位员工，超过后提示"最多添加5位"

5.10.6 带看房源选择器

点击「添加房源」区块中的「+ 添加房源」触发"添加房源"弹层：

弹层标题：「添加房源」，右上角「×」关闭
搜索区：
- 关键词输入框："房源编号/楼盘地址/业主姓名/电话..."
- 楼栋、单元、房号独立输入框
- 「搜索」橙色按钮 + 「重置」文字按钮
筛选区：区域（下拉）/ 状态（下拉）/ 相关方（下拉）/ 选中员工/部门（输入）
房源列表：
- 列字段：复选框 / 房源名称（蓝色链接）/ 交易类型 / 状态 / 用途 / 城区商圈 / 房型 / 楼层 / 面积(㎡)
- 共78195条，每页50条，分页导航：页码 + 每页条数选择
底部：「已选 (N/50)」状态 + 「确定」按钮（最多选50套）

5.10.7 带看详情页

点击带看列表中某条记录进入带看详情页（面包屑：客源 / 客源管理 / 带看详情）。

页面标题区

标题格式：「{业务类型}带看详情」（如"二手带看详情"）
标题右侧徽章：带看次数标签（如"一看"）+ 状态标签（如"无需回访"，灰色）
右上角操作按钮：
- 「分享带看房源」（白色描边按钮）
- 「生成看房报告」（橙色主按钮）；点击后弹出提示气泡："点击生成看房报告将楼盘信息生成PDF，可支持打印或保存"

审批记录区

区块标题：「审批记录」
字段：审批状态（绿色文字，如"审核通过"）+ 申请时间（格式：YYYY-MM-DD HH:mm）

客户区

字段	说明
客户	客源名称（含简要描述，如"姚叔叔置换电梯两房（上门）"）+ 「查看详情」蓝色链接
客户标签	彩色标签枚举（如"私客 / 求购 / 一看 / C(一般)"）
性别	文字（先生 / 女士）
服务评价	五星评分组件（空星表示未评价）
评价内容	文字，无内容时显示"-"

房源区

区块标题：「房源(N)」，N 为本次带看房源数量
每套房源展示为卡片，包含：
- 缩略图（左侧，约80×80px）
- 房源名称（蓝色链接，过长时截断+省略号）+ 「详情」蓝色链接（右侧）
- 交易类型标签（如"出售"，橙色）+ 用途标签（如"住宅"，灰色）
- 区域·商圈 | 房型 | 面积（㎡）
- 价格（橙色大字，如"630万"）
- 客户意向：星级评分（1-5星，带文字描述，如"一般"）
- 带看反馈：文字，无内容时显示"-"

回访信息区

区块标题：「回访信息」
无回访时区块内容为空（预留区域）

轨迹区

区块标题：「轨迹(N)」，N 为轨迹条数
无轨迹时显示占位文字"暂无轨迹"

业务基础信息面板（右侧）

字段	说明
编号	系统生成唯一编号 + 「复制」蓝色链接
业务类型	如"二手"
带看时间	格式：YYYY-MM-DD HH:mm-HH:mm（含结束时间）
申请时间	格式：YYYY-MM-DD HH:mm
带看人	所属门店·组别 \| 员工姓名
陪看人	员工姓名（无时为空）
合作带看人	员工姓名（无时为空）
置业顾问	员工姓名（无时为空）
带看情况	文字描述（如"客户继续维护"）
附件	附件列表（无时为空）

右侧快捷操作栏（垂直图标按钮）

增房（房源图标）
增客（客源图标）
发审批（审批图标）
刷新
待办（带红色数字徽章）
消息（带红色数字徽章）
私信
在线客服

5.11 客源解读

客源解读 Tab 基于客户在平台的找房行为数据，由系统自动生成购房偏好分析报告，帮助经纪人理解客户的真实需求和意向。

5.11.1 页面结构

标题「客源解读」右侧说明文字："以下数据通过客户找房行为分析生成，百分比越高代表浏览次数多"
右上角提供「使用指南」蓝色链接
数据更新时间显示在各模块右上角（如"2026-04-23数据更新"）

5.11.2 活跃行为模块

指标	展示形式	说明
有找房行为	"X 天内"（大号字体展示）	最近一次找房浏览行为距今天数

5.11.3 活跃时间模块

指标	说明
工作日活跃	工作日的高频活跃时段（无数据时显示 -）
周末活跃	周末的高频活跃时段（无数据时显示 -）

5.11.4 购房偏好模块

时间维度切换（右上角）：近7日 / 近30日 / 近90日，切换后所有数据联动刷新。

偏好汇总表格：

列	说明
价格	最高频浏览的价格区间（万元）
户型	最高频浏览的户型（X居）
面积	最高频浏览的面积区间（㎡）
二手区域-商圈	二手房最高频浏览的商圈
二手小区	二手房最高频浏览的小区
新房区域-板块	新房最高频浏览的区域板块
新房楼盘	新房最高频浏览的楼盘

类型占比：

文字展示："二手房偏好 XX%、新房偏好 XX%"（百分比以橙色/蓝色区分强调）
提供「二手偏好」/「新房偏好」子视图切换 Tab

二手偏好视图（圆环图）：

图表	说明
价格偏好	圆环图 + 图例（区间 + 占比%）
户型偏好	圆环图 + 图例（户型 + 占比%）
面积偏好	圆环图 + 图例（面积区间 + 占比%）
区域-商圈偏好	圆环图或条形图（无数据时显示"暂无数据"）
小区偏好	圆环图或条形图（无数据时显示"暂无数据"）

活跃时间分布图（页面底部）：

按小时/星期维度展示客户找房活跃热力图，数据更新时间同步标注

5.12 二手配房

二手配房（智能配房）Tab 为该客源提供系统自动匹配的二手房推荐列表，分录客配房和系统配房两种来源。

5.12.1 页面结构

标题「二手配房」，右侧显示最后更新时间（如"2026-04-22 17:38 更新"）+ ⓘ 刷新说明
子 Tab：录客配房（默认激活）/ 系统配房
右上角：「批量分享」按钮（支持批量选择房源后一次性分享给客户）

5.12.2 录客配房 Tab

按以下四个分组展示房源卡片，各分组独立标题：

分组	推荐逻辑
优质户型	符合客户户型偏好的优质房源（朝南/采光好等标签）
降价	近期有价格下调的匹配房源
热门	近7日内有带看记录的热门房源
新上	近3天内新上架的匹配房源

5.12.3 房源卡片字段

每套房源以卡片形式展示，字段说明：

字段	展示形式	说明
新上角标	左上角橙色「新」标签 + 日期（如"04-22"）	近期新上架标记
封面图	左侧缩略图	房源主图
小区名称	粗体文字	可点击跳转房源详情
户型/面积/区域	格式：X/X/X XXX㎡城区商圈	如"2/2/1 101.17㎡嘉定丰庄"
房源标签	彩色小标签	如：朝南户型采光好、私盘、近7日有带看、近半个月有降价、3天内上架房源等
售价	橙色大字 + 万	当前挂牌价（万元）
降价幅度	绿色文字	如"已跌20万"
单价	灰色小字	元/㎡
操作链接	「分享房源 \| 反馈 ∨」	分享触发分享流程；反馈展开下拉选项

5.12.4 系统配房 Tab

由系统算法自动推荐，展示结构与录客配房一致
分组策略可能与录客配房不同（以算法推荐分组为准）

5.12.5 批量分享

点击「批量分享」后，房源卡片进入多选模式
勾选目标房源后，点击「确认分享」触发分享流程（微信/短信/平台消息等，具体渠道待产品设计）
单条「分享房源」链接点击后也触发相同分享流程（仅分享该单套房源）

5.13 公客模块

公客是私客因长期未跟进（"掉公"）或经纪人主动转公后进入的公共客源池，全员均可见、可跟进。

5.13.1 页面整体布局

公客列表与私客列表共用顶部一级 Tab 导航（私客/资料客/营销客/成交客/公客），切换至「公客」后激活橙色下划线。

顶部右侧全局状态提示：

提示项	说明
私客与公客重复：无	有重复时显示数字蓝色链接
已删客源	蓝色链接，点击查看已删除客源
+ 新增公客	主操作按钮（橙色）

5.13.2 搜索与筛选系统

关键词搜索：支持客源姓名/号码/号码后4位/客源编号；右上角「收起筛选/展开筛选」切换；「X条已存搜索」快速调用历史条件。

常用快捷筛选（搜索栏下方）：

筛选项	说明
高质量	过滤高质量公客
不看低质量	默认勾选，屏蔽低质量客源
我未联系过	仅展示当前用户未跟进过的公客
联系情况	下拉选择（已联系/未联系等）
是否有效	下拉选择（有效/无效/不限）

分组筛选条（可展开/收起）：

筛选组	枚举值
状态	不限 / 求购 / 求租 / 租购 / 已购 / 已租 / 暂缓
需求	二手 / 新房 / 租房
等级	不限 / A(急迫) / B(较强) / C(一般) / D(较弱) / E(暂不关注) / 未填写
位置	宝山/崇明/奉贤/黄浦/虹口/嘉定/静安/金山/卢湾/闵行/南汇/普陀/浦东/青浦/松江/上海周边/徐汇/杨浦/长宁/闸北
跳公类型	不限 / 私客手动转公 / 私客自动转公 / 营销客跳公 / 资料客素公
跳公日期	不限 / 最近3天 / 最近7天 / 最近15天 / 最近30天 / 自定义日期区间（开始日期→结束日期）
筛选（展开后）	相关方、归属部门、录入时间、委托日期、价格、居室、面积、来源、带看进度、带看次数、收藏客源、偏好新房、巧客力访客、用途

已激活筛选条件展示：筛选栏下方显示当前生效的条件标签（如"不看低质量 ×"），支持单条清空；右侧提供「清空」全部清除 + 「保存条件」按钮。

5.13.3 列表字段说明

字段	说明
姓名	客源姓名（含活跃度标签：新配房/营销客/无效等），蓝色可点击跳转详情
跳公类型	私客手动转公 / 私客自动转公 / 营销客跳公 / 资料客素公
状态	求购 / 求租 / 租购 / 暂缓(求购) / 已购等
需求/解读	价格区间 + 面积区间（如"1000-1200万，150㎡-1…"，超长截断显示）
智能配房	系统匹配套数 + ⓘ图标
意向商圈/小区	意向区域（"-"表示未填写）
归属人	归属经纪人+门店-组别，公客归属格式为"门店-共享"（如"都市港湾店一组-共享"）
最近跟进	最近一次跟进距今天数（如"1天前"）
跳公日期	进入公客池的日期（如"2026-04-21"）
操作	「拨号」快捷按钮

5.13.4 批量操作与数据规模

列表支持批量操作：修改相关方、修改来源、删除客源
列表底部实时显示总条数（截图示例：共28878条）
支持分页（默认20条/页，支持跳页）
支持自定义列表显示字段（「自定义列表」按钮）
支持导出当前筛选结果（Excel）

5.13.5 公客跳公逻辑说明

跳公类型	触发条件
私客手动转公	经纪人在私客详情页主动点击「转公客」操作
私客自动转公（掉公）	私客超过规定天数未跟进，系统自动转入公客池（具体天数待业务运营确认）
营销客跳公	营销渠道引入的客源进入公客池
资料客素公	资料客来源进入公客池

5.14 成交客模块

成交客是已完成购房或租房成交的客户，记录历史成交信息，支持复购/转介绍跟进和业绩复盘。

5.14.1 页面整体布局

成交客列表通过顶部一级 Tab「成交客」进入（面包屑：客源 / 客源管理 / 成交客）。

顶部右侧全局状态提示：

提示项	说明
成交客与公客重复：无	有重复时显示数字蓝色链接
已删客源	蓝色链接
+ 新增锁客	橙色主按钮（新增锁定客源）

5.14.2 搜索与筛选系统

关键词搜索：支持客源姓名/号码/号码后4位/客源编号；提供「搜索」橙色按钮 + 「清空条件」文字链接（无"已存搜索"入口）。

筛选条：

筛选组	枚举值
状态	不限 / 我购 / 我租
需求类型	二手（复选框）/ 新房（复选框）/ 租房（复选框）
成交日期	不限 / 最近1月 / 最近3月 / 最近6月 / 自定义日期区间（开始时间→结束时间）
租约到期	不限 / 10天 / 30天 / 60天
等级	不限 / A(急迫) / B(较强) / C(一般) / D(较弱) / E(暂不关注) / 未填写
筛选（展开）	相关方、录入时间、委托日期、来源、活跃情况、偏好新房、巧客力访客、用途、购房目的

5.14.3 列表字段说明

字段	说明
姓名	客源姓名（含活跃度标签：7日活跃/30日活跃/90日活跃等），蓝色可点击跳转详情
状态	我购 / 我租
需求类型	二手 / 新房 / 租房
购房目的	刚需/投资/学区/改善/商用/其他（"-"表示未填）
解读	客源解读摘要（蓝色可点击链接，如"解读:需求变化"），无数据显示"-"
成交房源	成交对应的房源名称（截断显示，可点击跳转房源详情）
成交方	成交归属门店（截断显示，如"都市港湾…"）
委托日期	首次委托/录入日期
成交日期	成交完成日期（可点击排序）
最后跟进	最近一次跟进距今天数（如"3天前"）
用途	住宅 / 别墅 / 商住 / 商铺 / 写字楼 / 其他

5.14.4 批量操作与数据规模

列表支持批量操作：修改相关方、删除客源；底部显示「已选 0 条」
支持导出当前筛选结果（Excel）
列表总条数示例：共353条；支持分页（默认20条/页，支持跳页/上下页切换）

5.15 编辑客源

编辑客源是私客详情页的延伸操作，允许经纪人（含管理员）修改客源的联系人信息、基础信息及购房/租房需求信息。

5.15.1 页面布局

编辑客源为独立页面，标题「编辑客源」，通过私客详情页右侧「编辑」入口或需求信息 Tab 右上角「编辑」链接进入。页面顶部为三个 Tab 导航：

Tab	说明
联系人	编辑客源的联系人及号码信息（默认激活）
基础信息	编辑客源的基本属性信息
二手 / 新房 / 租房	根据客源需求类型动态显示对应的需求字段 Tab

5.15.2 联系人 Tab

字段说明（在录入私客联系人区块基础上新增以下差异）：

字段	类型	新增/差异说明
姓名	文本输入	与录入一致（必填）
称呼	单选	先生 / 女士（与录入一致）
电话1	区号+手机号	默认打码显示；右侧额外显示「查看后可编辑号码」说明 + 「查看号码」蓝色按钮（点击后需权限验证，验证通过后号码解码可编辑）
电话1状态	链接操作	旁边显示「标记无效」蓝色链接（点击将该号码标记为无效状态）
微信	文本输入	与录入一致
电话2	区号+手机号	与录入一致
QQ	文本输入	与录入一致
备注	多行文本	新增字段，最多200字

右上角提供「+ 添加联系人」按钮，可追加更多联系人区块

5.15.3 基础信息 Tab

在录入私客基础信息基础上，编辑态新增/展开以下字段（录入时默认折叠）：

字段	类型	枚举值/说明
需求类型	单选（必填）	二手 / 新房
用途	单选（必填）	住宅 / 别墅 / 商住 / 商铺 / 写字楼 / 其他
等级	单选（必填）	A(急迫) / B(较强) / C(一般) / D(较弱) / E(暂不关注)
来源	下拉（必填）	如"线下\|门店接待"
购房目的	多选复选框	刚需 / 投资 / 学区 / 改善 / 商用 / 其他
付款方式	单选复选框	全额 / 商业贷款 / 商业贷款+公积金 / 公积金
名下房产	单选	无 / 本地无房外地有房 / 本地有房
贷款记录	单选	有 / 无
证件类型	下拉	身份证 / 护照 / 港澳通行证 / 其他
证件号码	文本输入	身份证18位格式校验
意向学校	文本 + 「+ 添加学校」	支持多所学校，可追加
入学时间	月份选择器	请选择年月

5.15.4 二手 Tab（需求类型为"二手"时显示）

二手 Tab 为需求信息（5.8.1）的可编辑态，所有字段转为对应输入组件：

字段	组件类型	必填	备注
总价	数字输入区间（最小值 - 最大值，万元）	是	如"550 - 600"
面积	数字输入区间（最小值 - 最大值，㎡）	是	如"100 - 110"
居室	多选复选框	是	1居 / 2居 / 3居 / 4居 / 5居及以上
楼层	多选复选框	否	不要一层 / 低楼层 / 中楼层 / 高楼层 / 不要顶层
朝向	多选复选框	否	东 / 南 / 西 / 北
装修	多选复选框	否	毛坯 / 清水 / 简装 / 中装 / 精装 / 豪装
楼龄	多选复选框	否	5年以内 / 5-10年 / 10-15年 / 15-20年 / 20年以上
意向商圈	下拉多选	否	请选择商圈
意向小区	文本 + 「+ 添加小区」	否	支持追加多个
交通	文本输入	否	最多50字
备注	多行文本	否	最多200字

新房 Tab / 租房 Tab：字段结构与二手 Tab 类似，但字段内容针对新房/租房场景调整（具体字段待新房/租房截图补充确认）。

5.15.5 表单交互规则

页面底部固定显示「保存」（橙色主按钮）和「取消」按钮
点击「保存」时校验所有必填字段，未通过的字段高亮红框并滚动至第一个错误处
保存成功后返回私客详情页，并刷新对应区块数据（需求信息/联系人）
点击「取消」返回私客详情页，不保存任何更改
三个 Tab 之间切换时，已填写的内容保持在各 Tab 的表单状态中（不因切换 Tab 而丢失）

5.16 客源信息概览面板

5.16.1 面板整体布局

客源详情页右侧固定展示信息概览面板，由以下区块从上至下组成：

区块	内容
客户标识区	需求状态徽标 + 客户姓名 + 带看进度标签 + 等级标签 + 称谓
基础信息区	最近跟进、客户编号、委托日期、需求类型、房源用途、客户来源、购房目的、付款方式、名下房产、贷款记录、证件类型、证件号码、意向学校、入学时间
主操作按钮区	打电话（橙色）、写跟进（橙色）、报备/带看（白色边框）
快捷操作区1	☆收藏、置顶、改等级、改状态
快捷操作区2	改状态（转公客）、转公客、转成交、转无效、编辑客源

5.16.2 字段只读显示规则

所有字段在概览面板中均为只读展示
未填写字段显示"-"占位符，不留空白
联系人称谓显示在客户姓名右侧（如"女士"）
带看进度标签显示客户当前看房阶段（未带看 / 一看 / 二看 / 复看）
等级标签以字母+括号格式展示（如"C(一般)"），背景色按等级差异化

5.16.3 快捷操作交互规则

操作入口	触发方式	响应行为
收藏	点击☆图标	弹出"选择私客收藏夹"浮层（详见5.17）
置顶/不置顶	点击图标	直接切换置顶状态，列表中该客源置顶/取消置顶
改等级	点击图标	弹出"改等级"弹窗（详见5.18）
改状态	点击图标	弹出"改状态"弹窗（详见5.19）
转公客	点击图标	弹出"把此私客转为公客"弹窗（详见5.20）
转成交	点击图标	弹出"客户成交"弹窗（详见5.21）
转无效	点击图标	弹出"请选择无效原因"弹窗（详见5.22）
编辑客源	点击图标	弹出"编辑基础信息"弹窗（详见5.23）

5.17 私客收藏夹管理

5.17.1 收藏夹数据结构

每个用户拥有独立的私客收藏夹列表，收藏夹属于个人私有数据，不对其他用户可见
系统默认为每个用户创建一个「默认收藏夹」，不可删除
用户可创建自定义收藏夹，名称最多10个字

5.17.2 选择收藏夹浮层

元素	说明
浮层标题	"选择私客收藏夹"
副标题	"可在私客列表筛选收藏的客户"（灰色辅助文字）
收藏夹列表	单选，默认选中"默认收藏夹"
创建入口	左下角「+ 创建收藏夹」蓝色文字链接
操作按钮	右下角「确定」橙色按钮

5.17.3 创建收藏夹内联交互

点击「+ 创建收藏夹」后，浮层顶部出现内联输入行
输入框（占位文字"请输入名称最多10个字"）+ 「创建」橙色按钮 + 「取消」文字
超过10字时「创建」按钮置灰
点击「创建」成功后新收藏夹出现在列表并自动选中
点击「取消」收起内联输入行，恢复「+ 创建收藏夹」显示

5.18 改等级弹窗

字段	类型	必填	说明
原等级	只读文本	-	显示当前等级，如"C(一般)"
新等级	下拉选择	必填（*）	A急迫 / B较强 / C一般 / D较弱 / E暂不关注

新等级未选择时「确定」按钮置灰
保存后概览面板等级标签实时更新，操作日志记录变更

5.19 改状态弹窗

字段	类型	必填	说明
原状态	只读文本	-	显示当前需求状态，如"求购"
新状态	下拉选择	必填（*）	求购 / 求租 / 租购
等级	下拉选择	选填	默认回显当前等级，可修改
更改理由	多行文本	必填（*）	最多500字

新状态和更改理由任一未填时「确定」按钮置灰
保存后概览面板状态标签实时更新，操作日志记录变更理由

5.20 转公客弹窗

弹窗标题："把此私客转为公客"

字段	类型	必填	说明
状态	下拉选择	必填（*）	默认回显当前状态，可修改（求购/求租/租购）
等级	下拉选择	必填（*）	默认回显当前等级，可修改

提交后客源从私客列表移除，转入公客池，不可撤回
操作日志记录"转公客"操作及时间

5.21 转成交弹窗

弹窗标题："客户成交"

字段	类型	必填	说明
状态	单选	必填（*）	我购 / 我租，默认"我购"
房源类型	单选	必填（*）	二手 / 新房，默认"二手"
成交房源	链接选择器	必填（*）	「+ 选择成交房源」，跳出成交房源选择浮层
成交日期	日期选择器	必填（*）	默认当日，格式YYYY-MM-DD
成交价格	数字输入	必填（*）	单位万元，正整数或小数
成交方	人员选择器	必填（*）	默认带入登录人所属门店/小组

5.21.1 成交房源选择浮层

功能	说明
搜索	支持房源编号/楼盘地址/业主姓名/电话，以及楼栋/单元/房号独立输入
筛选	区域、状态、相关方、员工/部门多维筛选
列表字段	房源名称、交易类型、状态、用途、城区商圈、房型、楼层、面积
选择规则	单选，最多选择1套成交房源
数据量	支持大数据量（示例共89704条），50条/页

5.22 转无效弹窗

弹窗标题："请选择无效原因"

顶部蓝色信息提示："该功能为整体客转无效，将把所有电话标记无效"
无效原因（单选，默认选中第一项）：

选项	场景说明
号码无效	电话打不通、空号、停机
同行中介	来电为其他中介经纪人
广告推销	非真实购房意向来电
客户无意向	联系上但已无购买/租赁意向
其他	其他不适合上述分类的原因

提交后该客源下全部电话号码标记为无效，客源转为无效状态，从私客活跃列表移除

5.23 编辑基础信息弹窗

详见 Story 22 验收标准，字段说明如下：

字段	必填	类型	枚举值
需求类型	必填（*）	复选框	二手 / 新房
用途	必填（*）	下拉	住宅 / 别墅 / 商住 / 商铺 / 写字楼 / 其他
来源	必填（*）	下拉	运营配置，如"线下\|门店接待"
购房目的	选填	多选	刚需 / 投资 / 学区 / 改善 / 商用 / 其他
付款方式	选填	下拉	全额 / 商业贷款 / 商业贷款+公积金 / 公积金
名下房产	选填	下拉	无 / 本地无房外地有房 / 本地有房
贷款记录	选填	单选	有 / 无
证件类型	选填	下拉	身份证 / 护照 / 港澳通行证 / 其他
证件号码	选填	文本	格式校验（身份证18位）
意向学校	选填	文本+追加	支持「+ 添加学校」添加多所学校

5.24 联系人管理

5.24.1 联系人面板

位于客源详情页右侧，独立区块展示
右上角入口：「查看号码」（查看该客源全部号码，需权限）、「新增联系人」（蓝色）
每条联系人记录展示：姓名+称谓、电话1（打码）、拨打统计（接通N次/拨打N次）、微信/QQ/备注

5.24.2 号码打码规则

电话号码默认以"135********"格式显示（中间7位打码）
点击「查看号码」或「查看后可编辑号码」需消耗号码查看权限次数
查看后该操作记录到操作日志，类型为"查看号码"

5.24.3 新增/编辑联系人字段规范

字段	必填	最大长度/格式
姓名	必填	50字
称呼	必填	先生/女士
电话1	必填	国际区号+手机号，格式校验
电话2	选填	国际区号+手机号，格式校验
微信号	选填	50字
QQ	选填	纯数字
备注	选填	最多200字

5.25 相关员工管理

5.25.1 相关员工面板

位于客源详情页右侧，联系人面板下方
展示首录人和归属人：所属门店+小组+姓名，参与时间，拨号快捷图标
右上角提供「编辑」蓝色链接

5.25.2 编辑相关员工弹窗

字段	必填	类型	说明
首录人	必填（*）	下拉搜索选择	格式"姓名 - 门店小组"
归属人	必填（*）	下拉搜索选择	格式"姓名 - 门店小组"

下拉搜索范围：当前用户权限内可见员工
保存后操作日志记录"修改相关员工"

5.26 客源操作日志

5.26.1 入口路径

客源详情页 → 右侧「其他操作」面板 → 点击「查看操作日志」蓝色链接 → 跳转独立日志页

面包屑：客源 / 客源详情 / 客源操作日志

5.26.2 筛选条件

筛选项	组件类型	说明
日期范围	日期区间选择器	开始日期 - 结束日期
操作人	文本搜索输入	搜索联系人/员工姓名
操作类型	下拉选择（单选）	见5.26.3操作类型枚举

「查询」橙色按钮触发搜索，「清空条件」文字链接重置所有筛选

5.26.3 操作类型枚举

操作类型	触发场景
新增私客	首次录入客源
电话	通过系统拨打客户电话
查看号码	查看打码号码完整号码
改等级	修改客源等级
改状态	修改客源需求状态
转公客	手动将私客转为公客
转成交	将客源标记为成交
转无效	将客源标记为无效
收藏	收藏至私客收藏夹
编辑客源	修改客源基础信息/需求信息
新增联系人	新增联系人记录
编辑联系人	修改联系人信息
修改相关员工	变更首录人/归属人
写跟进	新增跟进记录
带看	新增带看记录
新增预约带看	新增预约带看记录

5.26.4 日志列表字段与规则

字段	类型	说明
操作时间	文本	格式"YYYY-MM-DD HH:mm"，如"2026-04-17 19:24"
操作人	文本	所属门店+小组-姓名，如"都市港湾店一组-雷威"
操作类型	文本	见枚举表
操作内容	文本	操作详情描述，如"新增一个【求购】私客"

列表按操作时间倒序排列（最新操作在最上方）
日志为只读，不支持编辑或删除
分页：默认20条/页，底部显示总条数，支持跳页

6. 技术考量

6.0 核心技术设计

6.0.1 客源状态机

客源在生命周期内的状态流转是系统的核心业务逻辑，必须在后端通过状态机严格控制，禁止跨状态直接跳转。

                    ┌─────────────────────────────────────────┐
                    │                                         ▼
  [录入] ──► 私客（求购/求租/暂缓）──► 公客 ──► 成交客
                    │                   │
                    │  手动转公/自动掉公  │  转私客（若有权限）
                    │                   │
                    ▼                   ▼
                  无效客              无效客

状态	允许流转目标	触发方式
私客（求购）	求租、暂缓、公客、成交客、无效	手动操作 / 掉公规则
私客（求租）	求购、暂缓、公客、成交客、无效	手动操作 / 掉公规则
私客（暂缓）	求购、求租、公客、无效	手动操作
公客	无效	手动操作（暂不支持公转私）
成交客	—	终态，不可流转
无效客	—	终态，不可流转

实现要求：

所有状态变更须通过后端 API 的状态机校验，前端不直接修改状态字段
每次状态变更自动写入 ClientStatusChangeLog 审计表（变更人、变更前后状态、时间、理由）
状态变更失败须返回明确错误码，前端展示友好提示

6.0.2 重复客源检测算法

重复检测是客源管理的核心数据质量保障。采用异步检测 + 前端提示策略，不阻塞录入流程。

检测触发时机：

录入时：提交表单后，后端异步触发检测，结果以橙色提示横幅展示
编辑手机号时：号码变更保存后重新触发
批量导入后：全量扫描，生成重复报告

去重匹配规则（按优先级）：

优先级	匹配维度	匹配逻辑	说明
P0	手机号精确匹配	`phone_normalized = normalize(input_phone)`	去除空格、+86、国际区号后精确比对
P1	手机号模糊匹配	去除格式差异后匹配	处理 `135****8888` 与 `13500008888` 等录入差异
P2	姓名 + 意向商圈组合	同名 + 相同意向区域	辅助人工判断，不自动合并

去重处理规则：

私客与私客重复：提示「该手机号已存在于 [员工姓名] 名下私客，请确认是否为同一客户」，由操作人决定是否继续录入或转为该员工协作方
私客与公客重复：提示「该手机号已在公客池中，请确认业务归属后操作」
合并客户：合并以首录时间更早的记录为主数据，跟进记录、带看记录全部合并至主记录，被合并记录保留为「已合并」历史副本，不可恢复

数据模型：

class ClientDuplicateLog(TenantModel):
    source_client = ForeignKey(Client, related_name='duplicate_source')
    target_client = ForeignKey(Client, related_name='duplicate_target')
    match_type = CharField(choices=['phone_exact', 'phone_fuzzy', 'name_area'])
    detected_at = DateTimeField(auto_now_add=True)
    resolved_by = ForeignKey(User, null=True)
    resolution = CharField(choices=['merged', 'ignored', 'pending'])

6.0.3 私客掉公（自动转公）机制

掉公规则由运营配置，初期建议默认值如下（待业务确认后写入系统配置模块）：

触发条件	默认值	是否可配置
私客无跟进天数	30 天	是（系统配置模块）
触发检测频率	每日凌晨 02:00 Celery 定时任务	否
提前预警天数	到期前 3 天，系统消息通知归属人	是

掉公流程：

Celery Beat（每日 02:00）
  └─► 扫描：last_follow_up_at < NOW() - 掉公天数 AND status='private'
        └─► 批量更新状态为 'public'
              └─► 写入 ClientStatusChangeLog（operator='system'）
                    └─► 触发消息推送：「您的 N 个客源已自动转入公客池」

边界情况：

暂缓状态的私客不参与掉公计算
成交客、无效客不参与掉公计算
掉公后归属人变更为 NULL，首录人保留

6.0.4 敏感号码权限与留痕

手机号码为核心敏感数据，访问须满足以下要求：

场景	展示方式	查看权限	留痕要求
列表页	`+86 135****8888` 打码	无需额外权限	不留痕
详情页联系人面板	`+86 135****8888` 打码	无需额外权限	不留痕
点击「查看号码」	展示完整号码 10 秒后重新打码	需「查看客源完整号码」权限	必须留痕：写入操作日志
编辑联系人	打码显示 + 「查看号码」链接	查看需权限，编辑需「编辑客源联系人」权限	查看留痕

实现要求：

号码存储使用字段级加密（AES-256），与房源模块同等安全标准
查看完整号码的 API 须独立端点（不含在标准详情接口内），方便审计
操作日志异步写入，不影响查看响应时间

6.0.5 列表性能策略

当前截图显示公客池已有 28,878 条，私客总量持续增长，列表性能须在设计阶段预防：

策略	说明
服务端分页	所有列表接口默认 20 条/页，禁止前端全量加载
筛选条件下推	所有筛选条件传至 Django ORM，生成 SQL WHERE 子句，不做内存过滤
索引设计	联合索引：`(tenant_id, status,归属人, 最后跟进时间)`；手机号哈希索引（辅助去重查询）
慢查询监控	超过 500ms 的查询写入慢日志，上线前需通过 EXPLAIN ANALYZE 验证核心列表查询
智能配房批量计算	不在请求链路内实时计算，通过 Celery 定时或客源更新时异步触发，结果缓存至 Redis

6.1 依赖关系

系统/模块	依赖原因	优先级风险
房源管理模块	智能配房功能依赖房源数据库的搜索与过滤接口	中
组织人事模块	归属人、首录人、相关方字段需调用员工组织架构数据	中
权限管理模块	私客可见范围、相关方修改审批、敏感号码查看均需权限控制	高
消息/通知系统	新配房结果通知、即将掉公提醒等需触达经纪人	低（可延后）

6.2 已知风险

风险	可能性	影响	缓解措施
客源重复检测实时性性能	中	中	录入时异步触发检测，结果以提示形式展示，不阻塞录入流程
智能配房匹配算法复杂度	高	中	v1 采用规则引擎匹配，AI/ML 推荐延后至 v2
大量客源导致列表性能下降	中（截图显示已有3910+条）	高	列表接口分页加载，筛选条件传服务端过滤，不做前端全量加载
号码敏感信息合规要求	高	高	号码默认打码显示，查看需权限+操作留痕，与房源模块同等安全标准

6.3 待确认问题

归属人是否支持单个客源被多人共同归属？还是严格一对一归属？ — 待产品与业务确认 — 开发前必须明确
「私客掉公」的规则：私客多少天无跟进后自动转为公客？是否需要经纪人手动确认？ — 待与业务运营确认规则
智能配房的配对结果是否对经纪人实时可见，还是每日批量推送？ — 待技术评估
客源的号码查看权限是否与房源模块一样需要操作留痕？ — 待法务/合规确认
「合并客户」功能中，合并后以哪条记录为主数据？历史跟进记录如何合并？ — 待产品设计评审

7. 上线计划

阶段	时间	受众	成功门槛
内部 Alpha	TBD	产品+1-2家试点门店	无 P0 Bug，核心录入/列表流程跑通
封闭 Beta	TBD	5家门店经纪人（约50人）	错误率 < 1%，录入流程 < 3分钟/条
全量上线	TBD	全体经纪人	核心指标达目标值的 80%

回滚标准：若上线后7天内客源重复率上升超过50%或系统性数据丢失，立即回滚并排查原因。

8. 附录

8.1 截图参考说明

本文档基于以下截图分析完成：

截图	路径	主要分析内容
录入私客	`Project/fonrey/screenshots/客源/录入客源.png`	录入表单结构、联系人区块字段、基础信息字段、相关员工区块
全部私客	`Project/fonrey/screenshots/客源/全部私客.png`	列表整体布局、全量筛选体系、列表字段、批量操作、活跃度标签体系
求购私客	`Project/fonrey/screenshots/客源/求购私客.png`	求购Tab专属筛选项（购价区间、房室、购房目的等）、列表字段展示
求租私客	`Project/fonrey/screenshots/客源/求租私客.png`	求租Tab专属筛选项（租价区间）、租房列表字段差异
私客详情	`Project/fonrey/screenshots/客源/私客详情.png`	详情页整体布局、右侧信息面板、顶部操作区、Tab结构
需求信息	`Project/fonrey/screenshots/客源/需求信息.png`	需求信息区块全量字段：总价/面积/居室/装修/朝向/楼层/楼龄/意向商圈小区/交通/备注
跟进记录-全部	`Project/fonrey/screenshots/客源/跟进记录-全部.png`	全部Tab结构、时间线布局、有录音/有图片筛选、已开放/隐藏操作
跟进记录-写入跟进	`Project/fonrey/screenshots/客源/跟进记录-写入跟进.png`	跟进目的完整枚举（20+项）、跟进标签筛选、记录格式
跟进记录-敏感信息跟进	`Project/fonrey/screenshots/客源/跟进记录-敏感信息跟进.png`	敏感信息跟进Tab结构（暂无跟进空状态）
跟进记录-修改跟进	`Project/fonrey/screenshots/客源/跟进记录-修改跟进.png`	修改跟进Tab结构（暂无跟进空状态）
跟进记录-其他跟进	`Project/fonrey/screenshots/客源/跟进记录-其他跟进.png`	其他跟进Tab、【新增私客】系统自动日志格式
带看列表	`Project/fonrey/screenshots/客源/带看.png`	带看Tab布局、预约/带看子Tab、归属人带看/其他人带看过滤、带看记录卡片字段
新增预约带看	`Project/fonrey/screenshots/客源/新增预约带看.png`	预约带看独立页表单：业务类型/预约客户/预约人/预约时间/陪看人/合作带看人/添加房源
新增带看	`Project/fonrey/screenshots/客源/新增带看.png`	带看独立页表单：带看时间/陪看人/合作带看人/带看情况/附件/带看房源（含客户意向程度）
陪看人/合作带看人选择器	`Project/fonrey/screenshots/客源/陪看人合作带看人.png`	选择员工浮层：左侧组织树搜索+多选，右侧已选列表，最多5位
带看房源选择器	`Project/fonrey/screenshots/客源/带看房源.png`	添加房源浮层：搜索+筛选+列表（78195条），最多50套，列字段
客源解读	`Project/fonrey/screenshots/客源/客源解读.png`	AI行为分析：活跃行为/活跃时间/购房偏好（近7/30/90日）/圆环图/区域商圈小区偏好
二手配房	`Project/fonrey/screenshots/客源/二手配房.png`	录客配房+系统配房双Tab、分组展示（优质户型/降价/热门/新上）、房源卡片字段、批量分享
暂缓私客	`Project/fonrey/screenshots/客源/暂缓私客.png`	暂缓Tab专属状态筛选（暂缓-租购/求租/求购）、列表字段（共1436条）、分页规则
公客	`Project/fonrey/screenshots/客源/公客.png`	公客列表整体布局、跳公类型筛选体系（私客手动/自动转公/营销客跳公/资料客素公）、跳公日期筛选、列表字段（共28878条）、"不看低质量"默认筛选
成交客	`Project/fonrey/screenshots/客源/成交客.png`	成交客列表布局、状态（我购/我租）、成交日期/租约到期筛选、列表字段（共353条）、「+ 新增锁客」入口
编辑客源	`Project/fonrey/screenshots/客源/编辑客源.png`	编辑页三Tab结构（联系人/基础信息/二手）、联系人查看号码权限机制（标记无效）、基础信息新增字段（购房目的/付款方式/名下房产/贷款记录/意向学校/入学时间）、二手需求全量可编辑字段（楼层/朝向/装修/楼龄/意向商圈小区完整枚举）
带看详情	`Project/fonrey/screenshots/客源/带看详情.png`	带看详情页整体布局、审批记录区块、客户区块（标签/评价）、房源卡片（意向星级/反馈）、回访信息/轨迹区块、右侧业务基础信息面板字段（编号/业务类型/带看时间/申请时间/带看人/陪看人/合作带看人/置业顾问/带看情况/附件）、生成看房报告功能
客源信息概览	`Project/fonrey/screenshots/客源/客源信息概览.png`	详情页右侧信息概览面板：客户标识区（需求状态/姓名/带看进度/等级/称谓）、基础信息只读字段（最近跟进/客户编号/委托日期/需求类型/用途/来源/购房目的/付款方式/名下房产/贷款记录/证件信息/意向学校/入学时间）、三个主操作按钮、两行快捷操作图标（收藏/置顶/改等级/改状态/转公客/转成交/转无效/编辑客源）
编辑基础信息	`Project/fonrey/screenshots/客源/编辑基础信息.png`	编辑基础信息弹窗：需求类型复选框（二手/新房）、用途/来源必填下拉、购房目的多选复选框（刚需/投资/学区/改善/商用/其他）、付款方式/名下房产下拉、贷款记录单选、证件类型/证件号码、意向学校文本+添加
选择私客收藏夹	`Project/fonrey/screenshots/客源/选择私客收藏夹.png`	收藏夹选择浮层：副标题提示、单选收藏夹列表（默认收藏夹）、「+ 创建收藏夹」链接、「确定」按钮
创建私客收藏夹	`Project/fonrey/screenshots/客源/创建私客收藏夹.png`	创建收藏夹内联交互：顶部内联输入框（最多10个字占位）+ 「创建」橙色按钮 + 「取消」文字，创建时既有收藏夹列表置灰
改等级	`Project/fonrey/screenshots/客源/改等级.png`	改等级弹窗：原等级只读（如"C(一般)"）、新等级必填下拉选择器
改状态	`Project/fonrey/screenshots/客源/改状态.png`	改状态弹窗：原状态只读（如"求购"）、新状态必填下拉、等级下拉（可修改）、更改理由必填多行文本
转公客	`Project/fonrey/screenshots/客源/转公客.png`	转公客弹窗：标题"把此私客转为公客"、状态必填下拉（默认回显当前状态）、等级必填下拉（默认回显当前等级）
转成交	`Project/fonrey/screenshots/客源/转成交.png`	客户成交弹窗：状态单选（我购/我租）、房源类型单选（二手/新房）、成交房源链接选择器、成交日期选择器（默认当日）、成交价格输入（万元）、成交方人员选择器
选择成交房源	`Project/fonrey/screenshots/客源/选择成交房源.png`	成交房源选择浮层：搜索栏（房源编号/楼盘地址/业主姓名/电话+楼栋/单元/房号）、筛选栏（区域/状态/相关方/员工部门）、列表字段（房源名称/交易类型/状态/用途/城区商圈/房型/楼层/面积）、共89704条/50条页、已选计数
转无效	`Project/fonrey/screenshots/客源/转无效.png`	转无效弹窗：蓝色警示提示（整体客转无效将标记所有电话）、无效原因单选（号码无效/同行中介/广告推销/客户无意向/其他，默认选中"号码无效"）
联系人	`Project/fonrey/screenshots/客源/联系人.png`	联系人面板：姓名+称谓、电话1打码格式（+86 135********）、默认拨打标签、接通/拨打次数统计、微信/QQ/备注字段、右上角「查看号码」和「新增联系人」入口
新增联系人	`Project/fonrey/screenshots/客源/新增联系人.png`	新增联系人弹窗：姓名/称呼必填，电话1必填（+86区号+手机号），电话2选填，微信号/QQ/备注选填（备注最多200字）
编辑联系人	`Project/fonrey/screenshots/客源/编辑联系人.png`	编辑联系人弹窗：姓名/称呼必填，电话1打码+「查看号码 ⓘ」蓝色链接，其他字段直接展示可编辑，备注最多200字
相关员工	`Project/fonrey/screenshots/客源/相关员工.png`	相关员工面板：首录人（门店+小组+姓名+参与时间+拨号图标）、归属人（同格式），右上角「编辑」链接
编辑相关员工	`Project/fonrey/screenshots/客源/编辑相关员工.png`	编辑相关员工弹窗：首录人/归属人均为必填下拉选择器（格式"姓名 - 门店小组"）
其他操作	`Project/fonrey/screenshots/客源/其他操作.png`	其他操作面板：仅含「查看操作日志」蓝色文字链接
客源操作日志	`Project/fonrey/screenshots/客源/客源操作日志.png`	操作日志独立页：面包屑导航、筛选栏（日期/操作人/操作类型）、列表字段（操作时间/操作人/操作类型/操作内容）、共3条示例数据（查看号码/电话/新增私客）、分页20条/页

8.2 术语表

术语	定义
私客	经纪人自己开发和维护的客源，属于个人/团队资产，不对外公开
公客	进入公共客源池的客户，全员可见、可跟进
成交客	已完成购房或租房成交的客户
掉公	私客因长期未跟进而自动转入公客池的机制
智能配房	系统根据客户需求自动匹配符合条件的房源并推荐给经纪人
带看进度	经纪人带客户实地看房的阶段，依次为：未带看 → 一看 → 二看 → 复看
归属人	对该客源负责跟进的经纪人，也是该客源的主要责任人
首录人	最初将该客源录入系统的经纪人
活跃度标签	系统根据跟进频次和来源自动打的多维度标签，辅助经纪人识别高价值客户
收藏夹	经纪人私有的客源分类标签，用于在私客列表中快速筛选特定分组的客源
转无效	对整体客源标记为无效状态，同时将该客源下所有电话号码标记为无效
转公客	将私客手动转入公共客源池，需填写状态与等级，转后全员可见可跟进
转成交	将私客标记为成交状态，需填写成交信息（状态/房源类型/成交房源/日期/价格/成交方）

115 KiB Raw Blame History Unescape Escape

PRD: 客源管理模块

变更历史

1. 问题陈述

背景

目标用户

2. 目标与成功指标

3. 非目标（本期不做）

4. 用户故事与验收标准

Story 1：经纪人录入新私客

Story 2：经纪人查看与筛选私客列表

Story 3：经纪人查看求购私客列表

Story 4：经纪人查看求租私客列表

Story 5：经纪人管理暂缓私客

Story 6：经纪人查看私客详情页

Story 7：经纪人查看与编辑需求信息

Story 8：经纪人写入与查看跟进记录

Story 9：经纪人管理带看记录

Story 10：经纪人查看客源解读（AI行为分析）

Story 11：经纪人使用二手配房功能推荐房源

Story 12：经纪人查看与筛选公客列表

Story 13：经纪人查看成交客列表

Story 14：经纪人编辑客源信息

Story 15：经纪人查看客源信息概览面板

Story 16：经纪人收藏客源至私客收藏夹

Story 17：经纪人修改客源等级

Story 18：经纪人修改客源状态

Story 19：经纪人手动将私客转为公客

Story 20：经纪人将私客转为成交客

Story 21：经纪人将客源标记为无效

Story 22：经纪人编辑客源基础信息（快捷入口）

Story 23：经纪人管理客源联系人

Story 24：经纪人管理客源相关员工

Story 25：经纪人查看客源操作日志

5. 功能详细说明

5.1 客源列表

5.1.1 页面整体布局

5.1.2 搜索与筛选系统

5.1.3 列表字段说明

5.2 录入私客

5.2.1 页面布局

5.2.2 联系人区块

5.2.3 基础信息区块

5.2.4 相关员工区块

5.2.5 表单交互规则

5.3 客源活跃度与标签体系

5.3.1 活跃度标签

5.3.2 等级标签

5.4 重复检测机制

5.5 智能配房功能

5.6 客源状态流转

5.7 私客详情页

5.7.1 页面整体布局

5.7.2 顶部功能 Tab 导航

5.7.3 右侧信息面板

5.8 需求信息

5.8.1 需求信息字段表

5.8.2 交互规则

5.9 跟进记录

5.9.1 Tab 结构

5.9.2 全部 Tab

5.9.3 写入跟进 Tab

5.9.4 敏感信息跟进 Tab

5.9.5 修改跟进 Tab

5.9.6 其他跟进 Tab

5.10 带看管理

5.10.1 Tab 结构

5.10.2 带看列表（带看 Tab）

5.10.3 新增带看表单

5.10.4 新增预约带看表单

5.10.5 员工选择器（陪看人/合作带看人）

5.10.6 带看房源选择器

5.10.7 带看详情页

5.11 客源解读

5.11.1 页面结构

5.11.2 活跃行为模块

5.11.3 活跃时间模块

5.11.4 购房偏好模块

5.12 二手配房

5.12.1 页面结构

115 KiB

Raw Blame History