# PRD: 客源管理模块
**状态**: Draft  
**作者**: 产品经理  
**最后更新**: 2026-04-23（v1.3 新增暂缓Tab筛选差异补充、5.13公客/5.14成交客/5.15编辑客源功能章节及Story 12-14，基于22张截图分析完成）  
**版本**: 1.3  
**所属系统**: Fonrey 房产经纪管理系统  
**关联模块**: 房源管理、组织人事管理、权限管理

---

## 1. 问题陈述

### 背景

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

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

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

### 目标用户

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

---

## 2. 目标与成功指标

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

---

## 3. 非目标（本期不做）

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

---

## 4. 用户故事与验收标准

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

---

### Story 1：经纪人录入新私客

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

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

---

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

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

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

---

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

**As** 一线经纪人，**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** 一线经纪人，**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** 一线经纪人，**I want** 将暂时没有购房/租房需求的客户标记为"暂缓"状态，**So that** 保持活跃客源列表的精准性，同时不丢失潜在客户资源。

**验收标准**：
- [ ] 暂缓 Tab 下仅展示状态为"暂缓"的客源
- [ ] 暂缓状态的客户可通过操作恢复为"求购"或"求租"状态
- [ ] 暂缓状态的客户不计入活跃客源统计

---

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

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

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

---

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

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

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

---

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

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

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

---

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

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

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

---

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

**As** 一线经纪人，**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** 一线经纪人，**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** 一线经纪人，**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** 一线经纪人，**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字 |

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

---

## 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 而丢失）

---

## 6. 技术考量

### 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` | 带看详情页整体布局、审批记录区块、客户区块（标签/评价）、房源卡片（意向星级/反馈）、回访信息/轨迹区块、右侧业务基础信息面板字段（编号/业务类型/带看时间/申请时间/带看人/陪看人/合作带看人/置业顾问/带看情况/附件）、生成看房报告功能 |

### 8.2 术语表

| 术语 | 定义 |
|------|------|
| 私客 | 经纪人自己开发和维护的客源，属于个人/团队资产，不对外公开 |
| 公客 | 进入公共客源池的客户，全员可见、可跟进 |
| 成交客 | 已完成购房或租房成交的客户 |
| 掉公 | 私客因长期未跟进而自动转入公客池的机制 |
| 智能配房 | 系统根据客户需求自动匹配符合条件的房源并推荐给经纪人 |
| 带看进度 | 经纪人带客户实地看房的阶段，依次为：未带看 → 一看 → 二看 → 复看 |
| 归属人 | 对该客源负责跟进的经纪人，也是该客源的主要责任人 |
| 首录人 | 最初将该客源录入系统的经纪人 |
| 活跃度标签 | 系统根据跟进频次和来源自动打的多维度标签，辅助经纪人识别高价值客户 |