Auto-sync: 2026-04-23 06:14

This commit is contained in:
2026-04-23 06:14:22 +08:00
parent 5a63b6dc72
commit 5c5732418b
7 changed files with 592 additions and 21 deletions

View File

@@ -1,8 +1,8 @@
# PRD: 房源管理模块
**状态**: Draft
**作者**: 产品经理
**最后更新**: 2026-04-23v1.2 新增房源详情页浮窗快捷编辑操作说明
**版本**: 1.2
**最后更新**: 2026-04-23v1.3 新增跟进管理各 Tab 页详细说明及业务信息模块:钥匙/委托/实勘
**版本**: 1.3
**所属系统**: Fonrey 房产经纪管理系统
**关联模块**: 客源管理、组织人事管理、权限管理
@@ -89,10 +89,14 @@
- [ ] 跟进目的为必填下拉选项(如:业主跟进、电话、带看、回访等)
- [ ] 跟进内容为必填文本框,最少 6 字,最多 500 字
- [ ] 支持附件上传(最多 10 张图片,每张最大 20MB格式bmp/jpg/png/svg/gif
- [ ] 跟进记录展示:跟进类型标签 + 内容 + 操作人(姓名+所属门店+ 时间
- [ ] 跟进日志展示以时间线方式组织,按日期分组,每条记录包含:类型标签(颜色区分)+ 内容 + 操作人([角色]姓名+门店-组别+ 时间
- [ ] 跟进记录右侧提供"公开/隐藏"切换按钮,控制记录在团队内的可见范围
- [ ] 每条跟进记录右上角"..."菜单支持:查看详情 / 编辑 / 删除(受权限控制)
- [ ] 跟进日志支持按类型筛选(全部/写入跟进/敏感信息跟进/敏感信息查看/修改跟进/其他跟进)
- [ ] 跟进日志支持关键词搜索 + 操作员筛选 + 日期范围筛选
- [ ] 跟进目的支持按维度统计展示(如:电话 45 次、业主跟进 20 次、回访 1 次)
- [ ] 写入跟进 Tab 中,跟进目的统计显示各类型数量(如:电话 46 次、业主跟进 41 次、议价 1 次)
- [ ] 写入跟进 Tab 支持 AI 标签筛选AI-在售 / AI-不售),辅助判断业主出售意向
- [ ] 敏感信息查看 Tab 提供"查看地址"/"查看号码"复选框过滤;敏感信息查看记录由系统自动生成,不可删除
### Story 4经纪人查看同业主其他房源
@@ -766,34 +770,366 @@
### 5.4 跟进管理
#### 5.4.1 写跟进
房源详情页的跟进管理区域通过 Tab 页签切换,展示不同维度的跟进记录。共有 6 个 Tab**全部 /跟进 / 敏感信息跟进 / 敏感信息查看 / 修改跟进 / 其他跟进**。
跟进功能以浮层Drawer/Modal方式呈现不离开当前页面
所有 Tab 共用以下通用设计
- 时间线布局:按日期分组(日期为橙色圆点 + 日期文字),同日记录依时间倒序排列
- 每条记录右侧提供**公开/隐藏**切换操作(控制该条记录在团队内的可见性)
- 顶部显示**智能总结**入口横幅AI 功能,快速了解近期跟进关键内容,属增值功能)
- 底部提供"查看全部跟进"按钮(部分 Tab 默认仅展示最近若干条)
---
#### 5.4.1 全部Tab全部
**功能说明**:聚合展示该房源所有类型的跟进记录,是最完整的视图。
**过滤器**(位于 Tab 内容区顶部):
- 复选框过滤:`有录音` / `有附件`
**展示的跟进类型标签**(方括号标注,以下为从截图归纳的完整枚举):
| 跟进类型标签 | 产生来源 | 说明示例 |
|------------|---------|---------|
| 【查看号码】 | 敏感信息查看 | 经纪人查看业主电话号码,自动记录 |
| 【图片下载】 | 其他跟进 | 经纪人下载了房源图片,自动记录 |
| 【查看隐号业主】 | 敏感信息查看 | 经纪人查看业主隐号信息,自动记录 |
| 【编辑房源】 | 修改跟进 | 房源字段被修改,自动记录变更前后值 |
| 【房源置顶】 | 修改跟进 | 房源被设置为置顶,记录置顶期限及理由 |
| 【房源相关方保护/未保护】 | 敏感信息跟进 | 相关方保护状态变更system 自动记录 |
| 【修改相关方】 | 修改跟进 | 手动修改出售方等相关方信息 |
| 【改状态】 | 修改跟进 | 房源状态变更记录 |
| 【改价格】 | 修改跟进 | 调价记录(含调价前后值) |
| 【改等级】 | 修改跟进 | 等级变更(含系统自动修改) |
| 【修改】 | 修改跟进 | 其他信息修改(如联系人电话变更) |
| 【完善相册】 | 修改跟进 | 图片编辑/上传操作记录 |
| 跟进-电话 | 写入跟进 | 经纪人主动写入,跟进目的为电话 |
| 跟进-业主跟进 | 写入跟进 | 经纪人主动写入,跟进目的为业主跟进 |
| 跟进-议价 | 写入跟进 | 经纪人主动写入,跟进目的为议价 |
**交互规则**
- [ ] 所有类型的跟进记录均展示于此 Tab不做类型过滤
- [ ] 支持通过"有录音"、"有附件"复选框快速过滤含特定附属内容的记录
- [ ] 每条记录显示:类型标签 + 操作人([角色]姓名 门店-组别)+ 时间戳 + 内容摘要 + 右侧"公开/隐藏"操作
---
#### 5.4.2 写入跟进Tab写入跟进
**功能说明**:仅展示经纪人**主动写入**的跟进记录(区别于系统自动生成的修改/敏感类日志)。
**过滤器**(位于 Tab 内容区顶部):
| 过滤维度 | 选项 | 说明 |
|---------|------|------|
| 跟进目的 | 电话N/ 业主跟进N/ 议价N | 复选框,括号内显示该类型当前记录数量 |
| 跟进标签 | 有录音 / 有附件 / 我的跟进 / AI-在售N/ AI-不售N | 复选框AI 标签表示 AI 辅助判断业主出售意向 |
**记录展示格式**
```
[跟进类型标签](如"跟进-业主跟进"蓝色标签) ...(操作菜单)
跟进内容正文sqcs 房子650万在卖 看房联系 号码不变)
[角色] 姓名 门店名称-组别 YYYY-MM-DD HH:mm:ss
```
**交互规则**
- [ ] 跟进目的过滤器以复选框形式排列,支持多选组合过滤
- [ ] 跟进目的旁显示对应数量统计(如:电话(46) / 业主跟进(41) / 议价(1)),实时反映当前过滤结果数
- [ ] AI 标签AI-在售 / AI-不售)为系统根据跟进内容智能分析后打的标记,协助经纪人判断业主意向
- [ ] 每条记录右上角"..."操作菜单提供:查看详情 / 编辑 / 删除(受权限控制)
- [ ] 右侧提供"公开/隐藏"切换(隐藏后仅本人及上级可见)
---
#### 5.4.3 敏感信息跟进Tab敏感信息跟进
**功能说明**:展示涉及**相关方保护机制**的系统自动日志,记录房源相关方(首录方/号码方/出售方等保护状态的变更。此类日志由系统system自动生成不由经纪人手动写入。
**展示的记录类型**
| 记录标签 | 触发场景 | 记录内容示例 |
|---------|---------|------------|
| 【房源相关方未保护】 | 前一相关方离职或保护期到期,保护自动解除 | "【都市港湾店一组 - 史彬彬】未能成为房源【出售方】原房源下架时间【2025-06-13 13:47:11】保护期0天" |
| 【房源相关方保护】 | 房源下架后系统自动分配相关方保护 | "【都市港湾店一组 - 史彬彬】成为房源【员工】原房源下架时间【2025-06-13 13:47:11】" |
| 【修改相关方】 | 管理员或行政人员手动修改相关方 | "【出售方】由【都市港湾店一组-史彬彬】,修改为【都市港湾店一组-雷威】" |
| 【改状态】 | 房源状态变更(含相关方保护联动) | "将房源【暂缓】状态,修改为【出售】状态,备注:申请出售" |
| 【改价格】 | 房源价格调整 | "售价8500000=>7500000备注0" |
**交互规则**
- [ ] 此 Tab 无额外过滤器,仅展示敏感信息类系统日志
- [ ] 操作人显示为 `[初始职务]system 系统管理组` 的记录为系统自动生成,不可编辑或删除
- [ ] 右侧"公开/隐藏"操作对系统自动日志同样有效,管理员可选择是否对普通经纪人展示
---
#### 5.4.4 敏感信息查看Tab敏感信息查看
**功能说明**:专项记录所有**查看敏感信息**的操作日志,包括查看业主电话号码、查看业主隐号(打码号码解码查看)等。用于合规审计和追溯,防止信息泄露。
**过滤器**(位于 Tab 内容区顶部):
- 复选框过滤:`查看地址` / `查看号码`
**展示的记录类型**
| 记录标签 | 触发场景 |
|---------|---------|
| 【查看号码】 | 经纪人点击查看业主电话明文号码 |
| 【查看隐号业主】 | 经纪人查看已被打码的业主联系人信息(解密查看) |
**每条记录格式**
```
【查看号码】 [角色]姓名 门店名称-组别 YYYY-MM-DD HH:mm:ss ⓘ 公开 隐藏
```
**交互规则**
- [ ] 每次经纪人点击查看号码或查看隐号业主,系统自动生成一条记录,无需经纪人手动操作
- [ ] 记录不可删除(合规要求)
- [ ] 可通过"查看地址"/"查看号码"复选框过滤对应类型的查看记录
- [ ] 底部提供"查看全部跟进"按钮,跳转至全部 Tab 并应用对应过滤条件
---
#### 5.4.5 修改跟进Tab修改跟进
**功能说明**:聚合展示所有**房源信息变更**的操作日志,包括字段修改、状态变更、价格调整、等级调整、相册编辑、置顶操作等。由操作行为自动触发生成,为管理者提供完整的房源信息变更追溯。
**展示的记录类型**
| 记录标签 | 触发场景 | 记录格式示例 |
|---------|---------|------------|
| 【编辑房源】 | 房源字段被修改 | "阳台0=>2" 或 "状态:暂缓=>出售厨房0=>1装修=>精装等级D较弱=>C一般售价7500000=>6500000" |
| 【房源置顶】 | 房源被设为置顶 | "将房源设为置顶2026-04-02至2026-05-02置顶理由12" |
| 【完善相册】 | 房源图片编辑 | "编辑了16张照片上传了0张照片" |
| 【改等级】 | 等级变更(含系统自动变更) | "由于不符合等级与状态的对应关系系统自动修改房源等级B=>D" |
| 【修改】 | 其他信息修改 | "【修改】联系人电话2==>17721156903" |
| 【改状态】 | 房源状态变更 | "将房源【出售】状态,修改为【暂缓】状态;状态:出售=>暂缓;保护房设置:否=>备注0" |
| 【改价格】 | 价格调整(历史格式含 HTML 标签) | "售价↓860=>850售单价78345.63=>77434.64" |
**交互规则**
- [ ] 系统自动生成的修改日志(操作人为 system与人工操作日志混排均按时间倒序展示
- [ ] 变更内容以"字段名:旧值=>新值"格式记录,多字段同时变更则在同一条记录中逐行列出
- [ ] 等级联动状态的自动变更(如:出售=>暂缓时系统自动降等级)单独生成一条系统操作记录
- [ ] 此 Tab 不提供额外过滤器(已通过类型 Tab 本身完成过滤)
---
#### 5.4.6 其他跟进Tab其他跟进
**功能说明**:展示非写入跟进、非修改、非敏感类的其他自动操作记录,主要包括**图片下载**等操作日志。同时,此 Tab 内容区底部展示**业务信息**面板(钥匙 / 委托 / 实勘)的当前状态概览及快捷操作入口。
**展示的记录类型**
| 记录标签 | 触发场景 |
|---------|---------|
| 【图片下载】 | 经纪人下载了房源图片,自动记录 |
**业务信息面板**(位于此 Tab 跟进记录下方,独立区块):
此面板为快捷入口,展示三类业务信息的当前状态,并提供操作按钮:
| 业务项 | 无记录时展示 | 操作按钮 |
|--------|------------|---------|
| 钥匙 | `无钥匙`(灰色标签) | 钥匙在他司 / 新增钥匙 |
| 委托 | `无委托`(灰色标签)| 新增委托 / 全部N|
| 实勘 | `无实勘`(灰色标签) | 新增实勘 |
**交互规则**
- [ ] 业务信息面板与跟进日志列表在同一 Tab 页内垂直排列(跟进日志在上,业务信息在下)
- [ ] 三项业务信息(钥匙/委托/实勘)均显示当前有效记录状态;若无记录则显示对应灰色"无XX"标签
- [ ] 委托旁"全部N"链接显示已有委托数量,点击跳转至委托列表
---
#### 5.4.7 写跟进(新增跟进浮窗)
**入口**:房源详情页顶部操作区"写跟进"按钮,或跟进日志区顶部入口
**功能说明**跟进功能以浮层Drawer/Modal方式呈现不离开当前页面
| 字段 | 类型 | 必填 | 说明 |
|------|------|------|------|
| 跟进目的 | 下拉选择 | 是 | 电话/业主跟进/带看/回访/其他等 |
| 跟进目的 | 下拉选择 | 是 | 电话 / 业主跟进 / 议价 / 带看 / 回访 / 其他等(枚举值由业务运营维护) |
| 跟进内容 | 文本区域 | 是 | 最少 6 字,最多 500 字 |
| 附件 | 文件上传 | 否 | 最多 10 张,单张最大 20MB格式bmp/jpg/png/svg/gif |
支持"跟进模版"功能(快速套用常用跟进话术模板)。
#### 5.4.2 跟进日志展示
**交互规则**
- [ ] 跟进目的为必填,未选择时不可提交
- [ ] 跟进内容少于 6 字时提交弹出错误提示
- [ ] 提交成功后浮窗关闭,跟进日志列表实时更新,新记录出现在列表顶部
- [ ] 写入的跟进记录同步出现在"全部"及"写入跟进"两个 Tab 中
跟进日志以时间线方式展示,每条记录包含:
---
- **跟进类型标签**:不同颜色区分(如绿色=业主跟进、蓝色=电话、橙色=其他)
- **跟进内容正文**
- **操作信息**`[角色] 姓名 门店名称-组别 时间`
- **操作菜单**...):查看详情/编辑/删除(权限控制)
### 5.4.8 业务信息:钥匙管理
**跟进过滤 Tab**
- 全部
- 写入跟进
- 敏感信息跟进
- 敏感信息查看
- 修改跟进
- 其他跟进
#### 5.4.8.1 新增钥匙
**入口**:其他跟进 Tab → 业务信息面板 → "新增钥匙"按钮
**功能说明**:经纪人从业主处获取房源钥匙后,在系统中登记钥匙托管信息。托管钥匙是房源维护完成度的重要维度,有助于提升带看便利性。
**浮窗字段**
| 字段 | 类型 | 必填 | 说明 |
|------|------|------|------|
| 钥匙类型 | 单选 | 是 | 机械锁 / 密码锁 |
| 钥匙方 | 下拉选择 | 是 | 选择持有钥匙的经纪人(默认显示当前登录用户),格式:姓名 - 所属组 |
| 保管部门 | 下拉选择 | 是 | 钥匙实际存放的部门/门店(联动钥匙方所属组,可单独修改) |
| 上传附件 | 文件上传 | 否 | 上传钥匙相关附件(如钥匙图片、委托书扫描件等) |
| 选择录音 | 音频上传 | 否 | 上传与业主沟通的录音文件 |
| 备注 | 文本区域 | 否 | 最多 200 字,补充说明钥匙情况 |
**交互规则**
- [ ] 钥匙类型为必填单选,默认无选中
- [ ] 钥匙方默认填充当前登录用户,可从下拉中切换为其他经纪人
- [ ] 保管部门根据钥匙方自动联动,也可独立选择
- [ ] 确认后在业务信息面板"钥匙"一栏展示已登记的钥匙记录(如"机械锁 - 张三 - 都市港湾店一组"
- [ ] 新增钥匙操作自动写入跟进日志(归类至"其他跟进"
---
#### 5.4.8.2 备注钥匙在他司
**入口**:其他跟进 Tab → 业务信息面板 → "钥匙在他司"按钮
**功能说明**:当业主的钥匙由其他中介公司持有时,经纪人可登记此信息,系统将在房源上标注"钥匙在他司"提示,供其他同事知悉,避免带看时出现钥匙无法获取的情况。
**注意事项说明**(浮窗内显示):
1. 备注钥匙在他司信息不生成钥匙方
2. 新增钥匙后将覆盖钥匙在他司信息
**浮窗字段**
| 字段 | 类型 | 必填 | 说明 |
|------|------|------|------|
| 钥匙在 | 文本区域 | 否 | 输入钥匙所在公司和门店信息,最多 30 字 |
**交互规则**
- [ ] 文本框为选填,可为空提交(仅标记"钥匙在他司"状态)
- [ ] 确认后业务信息面板"钥匙"一栏显示"钥匙在他司"标记及输入的文本说明
- [ ] 当后续通过"新增钥匙"登记己方钥匙后,"钥匙在他司"信息自动被覆盖清除
- [ ] 该操作不生成钥匙方记录,不影响房源维护完成度中"钥匙"维度的计分
---
### 5.4.9 业务信息:委托管理
#### 5.4.9.1 新增委托
**入口**:其他跟进 Tab → 业务信息面板 → "新增委托"按钮
**功能说明**经纪人与业主签署房源委托协议后在系统中录入委托信息并上传相关证明文件。委托信息是房源维护完成度的重要权重项10%),也是合规管理的重要依据。
**页面布局**:新增委托为**独立页面**(非浮窗 Modal包含三个信息区块
##### 区块一:委托信息
| 字段 | 类型 | 必填 | 说明 |
|------|------|------|------|
| 委托类型 | 下拉选择 | 是 | 如:独家委托 / 非独家委托 等(枚举值由业务运营维护) |
| 委托期限 | 日期区间 | 是 | 开始日期(默认今日)- 结束日期(可选"已知结束日期"下拉或手动选择截止时间) |
| 委托方 | 下拉选择 | 是 | 负责该委托的经纪人(默认当前登录用户),格式:姓名 - 所属组 |
##### 区块二:委托内容
| 字段 | 类型 | 必填 | 说明 |
|------|------|------|------|
| 签约方式 | 下拉选择 | 是 | 选择委托签约的方式(选项由业务定义),选择后下方动态展示对应委托书模板 |
| 委托书 | 动态展示 | — | 根据签约方式自动展示对应委托书内容/模板("选择签约方式后展示对应内容" |
##### 区块三:委托人(产权信息)
| 字段 | 类型 | 必填 | 说明 |
|------|------|------|------|
| 委托人类型 | 单选 | 是 | 产权人本人 / 授权第三方 |
| 产权人 | 下拉选择 | 是 | 从业主联系人中选择产权人 |
| 产权人姓名 | 文本输入 | 是 | 产权人真实姓名 |
| 产权人证件 | 证件类型下拉 + 证件号文本 + 附件上传 | 否 | 证件类型(如:身份证)+ 证件号码 + 上传证件扫描件 |
| 房产证 | 文件上传 | 否 | 上传房产证扫描件/照片 |
##### 区块四:其他
| 字段 | 类型 | 必填 | 说明 |
|------|------|------|------|
| 其他资料 | 文件上传 | 否 | 上传其他相关附件(每项附件内容最多可上传 10 个附件) |
| 备注 | 文本区域 | 否 | 最多 200 字 |
**底部操作**
- 提交:保存委托信息
- 取消:返回上一页
**交互规则**
- [ ] 委托类型、委托期限、委托方、签约方式、委托人类型、产权人、产权人姓名均为必填
- [ ] 签约方式选择后,委托书区域动态加载对应模板内容
- [ ] 委托人类型选择"授权第三方"时,需额外填写授权人信息
- [ ] 每项附件上传最多支持 10 个文件
- [ ] 提交成功后跳回房源详情页,业务信息面板"委托"一栏更新状态,"全部N"数量+1
- [ ] 新增委托操作自动写入跟进日志
---
### 5.4.10 业务信息:实勘管理
#### 5.4.10.1 新增实勘
**入口**:其他跟进 Tab → 业务信息面板 → "新增实勘"按钮
**功能说明**:经纪人对房源进行实地勘察(简称"实勘"在系统中提交实勘报告包括实地说明和分类实勘照片。实勘记录是房源维护完成度的核心权重项16%),也是保障房源信息真实性的关键环节。
**页面布局**:新增实勘为**独立页面**(非浮窗 Modal包含以下区块
##### 顶部提示区
- 显示实地核验说明:若该小区不支持实地核验,显示"该小区不支持实地核验,无需拍图"
##### 区块一:实勘信息
| 字段 | 类型 | 必填 | 说明 |
|------|------|------|------|
| 实勘定位 | 只读文本/GPS | — | 显示"—"表示当前未获取定位(支持 GPS 定位功能) |
| 实勘说明 | 文本区域 | 否 | 最多 200 字,描述实地情况 |
##### 区块二:实勘相册
实勘照片按空间分类上传,规则如下:
| 分类 | 最低上传数量要求 | 说明 |
|------|--------------|------|
| 户型图 | 至少 1 张 | 必须上传,支持手绘/打印户型图 |
| 绘制户型图 | — | 与户型图并列 Tab支持手绘上传 |
| 客厅 | 至少 2 张(客厅和餐厅任意上传 2 张即可) | 必须上传 |
| 餐厅 | 至少 2 张(客厅和餐厅任意上传 2 张即可) | 必须上传(与客厅共享要求) |
| 卧室 | 至少 2 张 | 必须上传 |
| 卫生间 | 至少 1 张 | 必须上传 |
| 厨房 | 至少 1 张 | 必须上传 |
| 玄关 | 无最低要求 | 选填 |
| 阳台 | 无最低要求 | 选填 |
| 书房 | 无最低要求 | 选填 |
| 室内其他 | 无最低要求 | 选填 |
| 室外 | 无最低要求 | 选填 |
**实勘相册顶部辅助功能**
- 图片大小限制:每张最大 20MB
- "VR 一键截图"按钮:快捷从已有 VR 素材截取图片
- "批量上传照片"按钮:支持一次性多选并上传
**底部操作**
- 提交实勘:保存并提交实勘记录
- 另存草稿:暂存未完成的实勘,不计入维护完成度
- 取消:返回上一页
**交互规则**
- [ ] 标有星号(*)的照片分类为必填项(户型图、客厅、餐厅、卧室、卫生间、厨房),未上传时不可提交实勘
- [ ] 客厅和餐厅照片数量合并计算,两类合计 ≥ 2 张即满足要求
- [ ] 每类照片支持单张点击上传或拖拽上传
- [ ] "VR 一键截图"按钮仅在该房源已有 VR 素材时可用,否则置灰
- [ ] 提交成功后跳回房源详情页,业务信息面板"实勘"一栏更新状态
- [ ] 新增实勘记录后,房源维护完成度"实勘"维度得分更新
- [ ] 实勘记录自动写入跟进日志
---
@@ -996,3 +1332,15 @@
- 更改房源用途:`Project/fonrey/sreenshots/房源/更改房源用途.png`
- 看房时间:`Project/fonrey/sreenshots/房源/看房时间.png`
- 挂牌历史记录:`Project/fonrey/sreenshots/房源/挂牌历史记录.png`
**跟进管理截图v1.3 新增)**
- 跟进管理-全部:`Project/fonrey/sreenshots/房源/跟进管理/全部.png`
- 跟进管理-写入跟进:`Project/fonrey/sreenshots/房源/跟进管理/写入跟进.png`
- 跟进管理-敏感信息跟进:`Project/fonrey/sreenshots/房源/跟进管理/敏感信息跟进.png`
- 跟进管理-敏感信息查看:`Project/fonrey/sreenshots/房源/跟进管理/敏感信息查看.png`
- 跟进管理-修改跟进:`Project/fonrey/sreenshots/房源/跟进管理/修改跟进.png`
- 跟进管理-其他跟进(含业务信息面板):`Project/fonrey/sreenshots/房源/跟进管理/其他跟进.png`
- 新增钥匙:`Project/fonrey/sreenshots/房源/跟进管理/新增钥匙.png`
- 备注钥匙在他司:`Project/fonrey/sreenshots/房源/跟进管理/钥匙在他司.png`
- 新增委托:`Project/fonrey/sreenshots/房源/跟进管理/新增委托.png`
- 新增实勘:`Project/fonrey/sreenshots/房源/跟进管理/新增实勘.png`