Workspace sync: auto commit 2026-04-23 12:52:58

Project/fonrey/PRD/客源管理模块PRD.md

@@ -1,8 +1,8 @@
 # PRD: 客源管理模块
 **状态**: Draft  
 **作者**: 产品经理  
-**最后更新**: 2026-04-23（v1.3 新增暂缓Tab筛选差异补充、5.13公客/5.14成交客/5.15编辑客源功能章节及Story 12-14，基于22张截图分析完成）  
-**版本**: 1.3  
+**最后更新**: 2026-04-23（v1.4 新增客源信息概览/编辑基础信息/收藏/改等级/改状态/转公客/转成交/转无效/联系人管理/相关员工管理/操作日志章节及Story 15-24，基于35张截图分析完成）  
+**版本**: 1.4  
 **所属系统**: Fonrey 房产经纪管理系统  
 **关联模块**: 房源管理、组织人事管理、权限管理
 
@@ -402,6 +402,285 @@
 
 ---
 
+### Story 15：经纪人查看客源信息概览面板
+
+**As** 一线经纪人，**I want** 在客源详情页右侧快速概览该客源的核心信息和常用操作，**So that** 无需切换 Tab 即可掌握客户关键状态并快速执行高频操作。
+
+**验收标准**：
+- [ ] 客源详情页右侧固定展示"信息概览"面板，不随页面滚动消失
+- [ ] 面板顶部展示客户标签行：需求状态徽标（如"求购"橙色背景）、客户姓名（大字加粗）、带看进度标签（如"一看"）、等级标签（如"C(一般)"）
+- [ ] 面板显示联系人称谓（女士/先生）
+- [ ] 面板依次展示以下只读字段：最近跟进日期、客户编号、委托日期、需求类型（二手/新房）、房源用途、客户来源、购房目的、付款方式、名下房产、贷款记录、证件类型、证件号码、意向学校、入学时间
+- [ ] 未填写的字段显示"-"占位
+- [ ] 面板中部固定展示三个主操作按钮：**打电话**（橙色）、**写跟进**（橙色）、**报备/带看**（白色边框）
+- [ ] 面板下部展示两行快捷操作入口（每行四个图标+文字）：
+  - 第一行：☆ 收藏、置顶/不置顶、改等级、改状态
+  - 第二行：改状态（转公客）、转公客、转成交、转无效、编辑客源
+- [ ] 点击任意快捷操作图标触发对应浮层或操作流程（详见 Story 16-22）
+
+---
+
+### Story 16：经纪人收藏客源至私客收藏夹
+
+**As** 一线经纪人，**I want** 将重点客户收藏至私客收藏夹，**So that** 在私客列表中可按收藏夹快速筛选出重点跟进客户。
+
+**验收标准**：
+- [ ] 点击信息概览面板中的「☆ 收藏」触发"选择私客收藏夹"浮层
+- [ ] 浮层标题为"选择私客收藏夹"，副标题提示文字"可在私客列表筛选收藏的客户"
+- [ ] 浮层内以单选列表形式展示当前用户已有的所有收藏夹，默认选中"默认收藏夹"
+- [ ] 浮层左下角显示「+ 创建收藏夹」蓝色文字链接，点击后触发创建收藏夹内联交互
+- [ ] 创建收藏夹时，列表顶部出现文本输入框（占位文字"请输入名称最多10个字"）+ 「创建」橙色按钮 + 「取消」文字按钮
+- [ ] 输入收藏夹名称后点击「创建」：新收藏夹出现在列表中，自动选中，「+ 创建收藏夹」链接恢复显示
+- [ ] 收藏夹名称最多10个字，超出长度时「创建」按钮置灰不可点击
+- [ ] 浮层底部提供「确定」（橙色）按钮，点击后将客源加入所选收藏夹，浮层关闭
+- [ ] 收藏成功后，信息概览面板中「收藏」图标状态更新为实心★，颜色变为橙色
+- [ ] 再次点击收藏图标（已收藏状态）弹出"选择私客收藏夹"浮层，支持修改或取消收藏所在收藏夹
+
+---
+
+### Story 17：经纪人修改客源等级
+
+**As** 一线经纪人，**I want** 快速修改客源的购买意向等级，**So that** 确保客源等级与客户当前实际意向相符，辅助工作优先级排序。
+
+**验收标准**：
+- [ ] 点击信息概览面板中的「改等级」触发"改等级"弹窗
+- [ ] 弹窗标题为"改等级"
+- [ ] 弹窗展示只读字段"原等级"，显示当前等级值（如"C(一般)"）
+- [ ] 弹窗展示必填字段"新等级"（标注红色*号），组件为下拉选择器
+- [ ] 新等级下拉选项枚举：A急迫 / B较强 / C一般 / D较弱 / E暂不关注
+- [ ] 「确定」按钮：新等级未选择时置灰，选择后高亮可点
+- [ ] 点击「确定」保存成功后：弹窗关闭，信息概览面板等级标签实时更新，并在操作日志中新增一条"改等级"记录
+- [ ] 点击「取消」或右上角×关闭弹窗，不做任何修改
+
+---
+
+### Story 18：经纪人修改客源状态
+
+**As** 一线经纪人，**I want** 修改客源的需求状态（求购/求租/租购），**So that** 准确反映客户当前的业务需求方向，保证配房匹配精准。
+
+**验收标准**：
+- [ ] 点击信息概览面板中的「改状态」触发"改状态"弹窗
+- [ ] 弹窗标题为"改状态"
+- [ ] 弹窗展示只读字段"原状态"，显示当前状态值（如"求购"）
+- [ ] 弹窗展示必填字段"新状态"（标注红色*号），组件为下拉选择器，枚举：求购 / 求租 / 租购
+- [ ] 弹窗展示"等级"字段，组件为下拉选择器，默认回显当前等级（如"C(一般)"），可修改
+- [ ] 弹窗展示必填字段"更改理由"（标注红色*号），组件为多行文本输入框（占位文字"请输入更改理由"）
+- [ ] 「确定」按钮：新状态未选或更改理由未填时置灰，均填写后高亮
+- [ ] 点击「确定」保存成功后：弹窗关闭，信息概览面板状态标签实时更新，并在操作日志新增一条"改状态"记录（含更改理由）
+- [ ] 点击「取消」或右上角×关闭弹窗，不做任何修改
+
+---
+
+### Story 19：经纪人手动将私客转为公客
+
+**As** 一线经纪人或店长，**I want** 主动将某私客转入公共客源池，**So that** 让其他经纪人也能跟进该客户，提升客源利用率和成交机会。
+
+**验收标准**：
+- [ ] 点击信息概览面板中的「转公客」触发"把此私客转为公客"弹窗
+- [ ] 弹窗标题为"把此私客转为公客"
+- [ ] 弹窗展示必填字段"状态"（标注红色*号），组件为下拉选择器，默认回显当前客源状态（如"求购"），可修改
+- [ ] 弹窗展示必填字段"等级"（标注红色*号），组件为下拉选择器，默认回显当前等级（如"C(一般)"），可修改
+- [ ] 「确定」按钮：状态或等级任一未选时置灰
+- [ ] 点击「确定」：
+  - 系统将该客源从私客列表中移除，转入公客池
+  - 弹窗关闭，原私客详情页跳转至客源列表
+  - 操作日志中新增一条"转公客"记录（含操作人、操作时间）
+- [ ] 点击「取消」或右上角×关闭弹窗，不执行转公操作
+- [ ] 权限控制：仅该客源的归属人、首录人或有管理权限的店长/经理可操作"转公客"
+
+---
+
+### Story 20：经纪人将私客转为成交客
+
+**As** 一线经纪人，**I want** 在客户完成购房/租房成交后将其标记为成交客，并录入成交信息，**So that** 完整记录成交数据，同步到成交客列表及业绩统计。
+
+**验收标准**：
+- [ ] 点击信息概览面板中的「转成交」触发"客户成交"弹窗
+- [ ] 弹窗标题为"客户成交"
+- [ ] 弹窗包含以下必填字段：
+
+| 字段 | 组件类型 | 说明 |
+|------|---------|------|
+| 状态 | 单选（我购 / 我租） | 默认选中"我购" |
+| 房源类型 | 单选（二手 / 新房） | 默认选中"二手" |
+| 成交房源 | 链接选择器「+ 选择成交房源」 | 必填，点击后跳出成交房源选择浮层 |
+| 成交日期 | 日期选择器 | 默认为当日，格式 YYYY-MM-DD |
+| 成交价格 | 数字输入（单位：万元） | 必填 |
+| 成交方 | 人员选择器 | 默认带入当前登录人所属门店/小组，可修改 |
+
+- [ ] 成交房源选择浮层：
+  - 浮层标题"选择成交房源"
+  - 搜索栏：支持按房源编号/楼盘地址/业主姓名/电话关键词搜索，以及楼栋/单元/房号独立输入
+  - 筛选栏：区域（下拉）、状态（下拉）、相关方（下拉）、员工/部门选择器
+  - 列表字段：房源名称（蓝色链接）、交易类型、状态、用途、城区商圈、房型、楼层、面积（㎡）
+  - 单选（每次只能选择一套成交房源）
+  - 底部显示「已选 (0/50)」计数和「确定」按钮（选中1条后高亮）
+  - 分页：共 89704 条，50条/页
+- [ ] 点击"客户成交"弹窗「确定」按钮：
+  - 所有必填字段填写完毕后按钮高亮可点
+  - 提交后客源从私客列表移入成交客列表，详情页顶部状态更新为"成交"
+  - 操作日志中新增一条"转成交"记录（含成交信息摘要）
+- [ ] 点击「取消」或右上角×关闭弹窗，不执行转成交操作
+
+---
+
+### Story 21：经纪人将客源标记为无效
+
+**As** 一线经纪人，**I want** 将无效客户（如空号/骚扰/无意向等）标记为无效，**So that** 避免对无效客户持续无效跟进，提升客源列表质量。
+
+**验收标准**：
+- [ ] 点击信息概览面板中的「转无效」触发"请选择无效原因"弹窗
+- [ ] 弹窗顶部显示蓝色信息提示框：「该功能为整体客转无效，将把所有电话标记无效」
+- [ ] 弹窗以单选列表形式展示无效原因，默认选中第一项：
+  - ⦿ 号码无效（默认）
+  - ○ 同行中介
+  - ○ 广告推销
+  - ○ 客户无意向
+  - ○ 其他
+- [ ] 「确定」按钮（橙色）：选择任意原因后高亮
+- [ ] 点击「确定」：
+  - 该客源下所有联系人电话号码全部标记为无效
+  - 客源状态更新为"无效"，从私客活跃列表中移除
+  - 操作日志新增一条"转无效"记录（含选择的无效原因）
+- [ ] 点击「取消」或右上角×关闭弹窗，不执行任何操作
+- [ ] 权限控制：仅归属人、首录人或有管理权限者可操作
+
+---
+
+### Story 22：经纪人编辑客源基础信息（快捷入口）
+
+**As** 一线经纪人，**I want** 通过信息概览面板的快捷入口直接编辑客源基础信息，**So that** 无需进入完整编辑页即可快速更新常用字段。
+
+**验收标准**：
+- [ ] 点击信息概览面板中的「编辑客源」入口，触发"编辑基础信息"弹窗（抽屉浮层）
+- [ ] 弹窗标题为"编辑基础信息"，右上角提供×关闭按钮
+- [ ] 弹窗包含以下字段：
+
+| 字段 | 必填 | 组件类型 | 枚举值/说明 |
+|------|------|---------|------------|
+| 需求类型 | 必填（*） | 复选框 | ☑ 二手 / □ 新房 |
+| 用途 | 必填（*） | 下拉选择 | 住宅 / 别墅 / 商住 / 商铺 / 写字楼 / 其他 |
+| 来源 | 必填（*） | 下拉选择 | 由运营配置，如"线下\|门店接待" |
+| 购房目的 | 选填 | 多选复选框 | 刚需 / 投资 / 学区 / 改善 / 商用 / 其他 |
+| 付款方式 | 选填 | 下拉选择 | 全额 / 商业贷款 / 商业贷款+公积金 / 公积金 |
+| 名下房产 | 选填 | 下拉选择 | 无 / 本地无房外地有房 / 本地有房 |
+| 贷款记录 | 选填 | 单选 | 有 / 无 |
+| 证件类型 | 选填 | 下拉选择 | 身份证（默认）/ 护照 / 港澳通行证 / 其他 |
+| 证件号码 | 选填 | 文本输入 | 占位文字"请输入证件号码" |
+| 意向学校 | 选填 | 文本输入 + 「+ 添加学校」 | 支持添加多所学校 |
+
+- [ ] 底部提供「确定」（橙色）和「取消」按钮
+- [ ] 点击「确定」后必填字段校验，保存成功后弹窗关闭，信息概览面板相关字段实时更新
+- [ ] 点击「取消」或×关闭弹窗，不保存修改
+
+---
+
+### Story 23：经纪人管理客源联系人
+
+**As** 一线经纪人，**I want** 在客源详情页查看、新增或编辑该客源的联系人信息，**So that** 确保联系方式信息完整，随时可以联系到客户。
+
+**验收标准**：
+
+**联系人面板展示**：
+- [ ] 客源详情页右侧展示「联系人」信息面板，面板右上角提供「查看号码」和「新增联系人」两个操作入口
+- [ ] 面板中每位联系人展示以下信息：
+  - 姓名（加粗）、称谓（如"女士"）
+  - 电话1：格式为"+86 135\*\*\*\*\*\*\*\*"（默认打码，需点击「查看号码」后才显示完整号码）
+  - 电话1 下方展示标签状态行：默认拨打标识、接通N次、拨打N次
+  - 微信：显示值或"-"
+  - QQ：显示值或"-"
+  - 备注内容：显示值或"-"
+
+**新增联系人**：
+- [ ] 点击「新增联系人」触发"新增联系人"弹窗
+- [ ] 弹窗标题为"新增联系人"，右上角提供×关闭按钮
+- [ ] 弹窗包含以下字段：
+
+| 字段 | 必填 | 组件类型 | 说明 |
+|------|------|---------|------|
+| 姓名 | 必填（*） | 文本输入 | 占位文字"请输入" |
+| 称呼 | 必填（*） | 单选 | 先生 / 女士 |
+| 电话1 | 必填（*） | 国际区号下拉 + 手机号输入 | 默认区号+86 |
+| 电话2 | 选填 | 国际区号下拉 + 手机号输入 | 默认区号+86 |
+| 微信号 | 选填 | 文本输入 | 占位文字"请输入" |
+| QQ | 选填 | 文本输入 | 占位文字"请输入" |
+| 备注 | 选填 | 多行文本 | 占位文字"请输入，最多200字" |
+
+- [ ] 点击「确定」后校验必填字段，保存成功后联系人面板新增一条记录
+- [ ] 点击「取消」或×关闭弹窗，不保存
+
+**编辑联系人**：
+- [ ] 点击联系人条目中的编辑入口触发"编辑联系人"弹窗
+- [ ] 弹窗标题为"编辑联系人"，字段与新增联系人一致
+- [ ] 电话1 旁额外显示「查看号码 ⓘ」蓝色链接，号码默认打码显示（如"135\*\*\*\*\*\*\*\*"），点击后完整号码展示，进入可编辑状态
+- [ ] 其他字段（电话2/微信号/QQ/备注）直接展示已有值（如无则显示"-"），可直接编辑
+- [ ] 点击「确定」保存修改，点击「取消」或×关闭不保存
+
+---
+
+### Story 24：经纪人管理客源相关员工
+
+**As** 一线经纪人或店长，**I want** 查看和修改客源的首录人与归属人，**So that** 确保客源归属关系正确，保证客源跟进责任到人。
+
+**验收标准**：
+
+**相关员工面板展示**：
+- [ ] 客源详情页右侧展示「相关员工」信息面板，面板右上角提供「编辑」蓝色链接
+- [ ] 面板中依次展示：
+  - 【首录人】：所属门店+小组+姓名，下方显示参与时间（格式"YYYY-MM-DD HH:mm"），行尾提供🤙拨号图标
+  - 【归属人】：所属门店+小组+姓名，下方显示参与时间（格式"YYYY-MM-DD HH:mm"），行尾提供🤙拨号图标
+
+**编辑相关员工**：
+- [ ] 点击面板右上角「编辑」触发"编辑相关员工"弹窗
+- [ ] 弹窗标题为"编辑相关员工"，右上角提供×关闭按钮
+- [ ] 弹窗包含以下字段：
+
+| 字段 | 必填 | 组件类型 | 说明 |
+|------|------|---------|------|
+| 首录人 | 必填（*） | 下拉选择器 | 显示"姓名 - 门店小组"，如"雷威 - 都市港湾店一组" |
+| 归属人 | 必填（*） | 下拉选择器 | 显示"姓名 - 门店小组"，如"雷威 - 都市港湾店一组" |
+
+- [ ] 下拉选择器支持搜索员工姓名，范围为当前登录用户权限内可见的员工
+- [ ] 点击「确定」保存后：弹窗关闭，相关员工面板中首录人/归属人信息实时更新，操作日志中新增一条"修改相关员工"记录
+- [ ] 点击「取消」或×关闭弹窗，不执行任何修改
+- [ ] 权限控制：普通经纪人可修改归属人为自己团队内的成员；修改为跨团队/跨店需店长及以上权限
+
+---
+
+### Story 25：经纪人查看客源操作日志
+
+**As** 一线经纪人或店长，**I want** 查看某一客源的完整操作历史记录，**So that** 了解客源的全生命周期操作轨迹，追溯变更原因，辅助审计和管理。
+
+**验收标准**：
+
+**入口**：
+- [ ] 客源详情页右侧下方展示「其他操作」面板，面板内提供「查看操作日志」蓝色文字链接
+- [ ] 点击「查看操作日志」跳转至独立的"客源操作日志"列表页，面包屑导航为：客源 / 客源详情 / 客源操作日志
+
+**客源操作日志页面**：
+- [ ] 页面标题为"客源操作日志"
+- [ ] 页面顶部提供以下筛选控件：
+  - 日期范围选择器（开始日期 - 结束日期，日历图标选择）
+  - 操作人搜索输入框（占位文字"搜索联系人"）
+  - 操作类型下拉选择器（占位文字"请选择"，枚举值见下文）
+  - 「查询」橙色按钮 / 「清空条件」文字链接
+- [ ] 操作类型枚举（基于截图可见记录，系统实际枚举值更多）：
+  - 新增私客、电话、查看号码、改等级、改状态、转公客、转成交、转无效、收藏、编辑客源、新增联系人、编辑联系人、修改相关员工、写跟进、带看、新增预约带看 等
+- [ ] 日志列表字段：
+
+| 字段 | 说明 |
+|------|------|
+| 操作时间 | 格式"YYYY-MM-DD HH:mm"，如"2026-04-17 19:24" |
+| 操作人 | 所属门店+小组+姓名，如"都市港湾店一组-雷威" |
+| 操作类型 | 如"查看号码"/"电话"/"新增私客" |
+| 操作内容 | 操作的详细描述，如"新增一个【求购】私客"、"市区房子动迁 大概要明年才开始 早着呢" |
+
+- [ ] 日志列表支持分页：底部显示总条数（如"共3条"），分页控件（上一页 / 页码 / 下一页 / 跳页），默认20条/页
+- [ ] 日志记录按操作时间倒序排列（最新操作在最上方）
+- [ ] 日志为只读，不支持编辑或删除
+
+---
+
 ## 5. 功能详细说明
 
 ### 5.1 客源列表
@@ -1393,7 +1672,275 @@
 
 ---
 
-## 6. 技术考量
+### 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 创建收藏夹内联交互
+
+1. 点击「+ 创建收藏夹」后，浮层顶部出现内联输入行
+2. 输入框（占位文字"请输入名称最多10个字"）+ 「创建」橙色按钮 + 「取消」文字
+3. 超过10字时「创建」按钮置灰
+4. 点击「创建」成功后新收藏夹出现在列表并自动选中
+5. 点击「取消」收起内联输入行，恢复「+ 创建收藏夹」显示
+
+---
+
+### 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.1 依赖关系
 
@@ -1466,6 +2013,23 @@
 | 成交客 | `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 术语表
 
@@ -1480,3 +2044,7 @@
 | 归属人 | 对该客源负责跟进的经纪人，也是该客源的主要责任人 |
 | 首录人 | 最初将该客源录入系统的经纪人 |
 | 活跃度标签 | 系统根据跟进频次和来源自动打的多维度标签，辅助经纪人识别高价值客户 |
+| 收藏夹 | 经纪人私有的客源分类标签，用于在私客列表中快速筛选特定分组的客源 |
+| 转无效 | 对整体客源标记为无效状态，同时将该客源下所有电话号码标记为无效 |
+| 转公客 | 将私客手动转入公共客源池，需填写状态与等级，转后全员可见可跟进 |
+| 转成交 | 将私客标记为成交状态，需填写成交信息（状态/房源类型/成交房源/日期/价格/成交方） |