nexus/Project/fonrey/PRD/房源管理模块PRD.md

PRD: 房源管理模块

状态: Draft
作者: 产品经理
最后更新: 2026-04-23（v1.3 新增跟进管理各 Tab 页详细说明及业务信息模块：钥匙/委托/实勘）
版本: 1.3
所属系统: Fonrey 房产经纪管理系统
关联模块: 客源管理、组织人事管理、权限管理

---

1. 问题陈述

背景

房产经纪公司的核心业务是匹配买卖双方/租赁双方，而房源是整个业务链路的起点。经纪人日常需要录入、管理、维护大量房源信息，并跟进每套房源的状态变化、与业主沟通、组织带看等。

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

• 信息散乱：房源信息分散在不同经纪人的手机/表格中，无法共享、无法协作
• 跟进缺失：无系统化的跟进记录，房源状态变化靠口头传达，容易遗漏
• 重复录入：同一业主名下多套房源缺乏关联，造成信息重复和沟通冲突
• 查找低效：房源数量大（案例中 89,000+ 条），缺乏多维度筛选能力
• 图片管理混乱：房源照片分类不明确，无法快速识别封面图、各空间图

目标用户

角色	描述	使用频率
一线经纪人	负责录入、维护、跟进自己名下的房源	每日高频
店长/经理	查看全店/全区房源概况，分配任务，监控跟进完成度	每日
行政人员	审核房源信息，维护数据质量	每日

---

2. 目标与成功指标

目标	指标	当前基准	目标值	衡量周期
提升房源录入效率	平均录入一条房源耗时	约 15 分钟（估算）	< 5 分钟	上线后 60 天
提升跟进完成率	近 30 天有跟进的房源比例	待统计	≥ 80%	上线后 90 天
提升数据质量	房源维护完成度（系统评分）平均值	待统计	≥ 70%	上线后 90 天
减少重复房源	重复/疑似问题号码房源数量	待统计	减少 50%	上线后 60 天

---

3. 非目标（本期不做）

• 商业地产类（商铺、商住、写字楼、其他）房源录入功能为低优先级，在住宅类（住宅、别墅）完成并稳定后方可排期开发
• 不包含地图找房的底层地图服务建设（地图组件集成另行规划）
• 不包含房源对外门户网站展示（营销推广为独立模块）
• 不包含 AI 估价引擎的自研（可集成第三方价格解读服务）
• 不包含移动端 App（本期为 Web 端，移动端适配为 v2 规划）

---

4. 用户故事与验收标准

Story 1：经纪人录入新房源

As 一线经纪人，I want 快速录入一套新房源的完整信息，So that 房源能进入公盘流通、并由系统自动提醒后续跟进。

验收标准：

• 支持选择房源类型（住宅/商业），本期实现住宅类型
• 新增住宅表单分为：房源核心信息 / 业主联系人 / 基础信息 / 交易信息 / 相关方，共 5 个区块
• 必填项未填写时，点击保存弹出红色错误提示，并定位到第一个未填项
• 户型字段支持分别输入：室数、厅数、卫数、厨数、是否有阳台
• 楼层填写：所在楼层 + 总楼层，均为数字输入
• 保存成功后跳转到该房源详情页，并显示"保存成功"提示

Story 2：经纪人筛选查找目标房源

As 一线经纪人，I want 在数万条房源中快速定位到符合客户需求的房源，So that 提升匹配推荐效率。

验收标准：

• 支持关键词搜索（小区名称、地址、业主姓名、电话、钥匙编号等）
• 支持多维度组合筛选：范围（最新挂牌/降价/与我相关/我部门相关）、区域（区/地铁）、价格区间、面积区间、户型、楼层、标签、状态/属性、装修/朝向、学校、等级、用途等
• 列表支持排序（售价、单价、面积、挂牌日期、最后跟进日期）
• 支持切换列表展示与海报展示模式
• 已存搜索条件可保存，下次快速调用
• 列表底部显示当前筛选总条数，支持分页（每页 20 条，可跳页）
• 支持导出当前筛选结果

Story 3：经纪人记录房源跟进

As 一线经纪人，I want 随时记录与业主的沟通内容和带看情况，So that 保留完整的房源跟进轨迹，团队协作时不会重复打扰业主。

验收标准：

• 在房源详情页可直接唤起"写跟进"浮层，无需离开当前页面
• 跟进目的为必填下拉选项（如：业主跟进、电话、带看、回访等）
• 跟进内容为必填文本框，最少 6 字，最多 500 字
• 支持附件上传（最多 10 张图片，每张最大 20MB，格式：bmp/jpg/png/svg/gif）
• 跟进日志展示以时间线方式组织，按日期分组，每条记录包含：类型标签（颜色区分）+ 内容 + 操作人（[角色]姓名+门店-组别）+ 时间戳
• 跟进记录右侧提供"公开/隐藏"切换按钮，控制记录在团队内的可见范围
• 每条跟进记录右上角"..."菜单支持：查看详情 / 编辑 / 删除（受权限控制）
• 跟进日志支持按类型筛选（全部/写入跟进/敏感信息跟进/敏感信息查看/修改跟进/其他跟进）
• 跟进日志支持关键词搜索 + 操作员筛选 + 日期范围筛选
• 写入跟进 Tab 中，跟进目的统计显示各类型数量（如：电话 46 次、业主跟进 41 次、议价 1 次）
• 写入跟进 Tab 支持 AI 标签筛选（AI-在售 / AI-不售），辅助判断业主出售意向
• 敏感信息查看 Tab 提供"查看地址"/"查看号码"复选框过滤；敏感信息查看记录由系统自动生成，不可删除

Story 4：经纪人查看同业主其他房源

As 一线经纪人，I want 在查看某套房源时一键查看该业主名下的其他房源，So that 了解业主资产全貌，避免重复打扰、统一谈判。

验收标准：

• 在房源详情的业主/联系人区块，显示"业主还有其他房源，建议您一起跟进，避免重复打扰"提示
• 点击可唤起"同业主房源"弹窗，显示字段：房源名称、状态、城区商圈、房型、面积、售价、租价
• 支持选择业主（当业主有多个关联人时）再查询
• 弹窗内可点击房源名称直接跳转到对应房源详情

Story 5：经纪人管理房源图片

As 一线经纪人，I want 为房源上传分类管理的照片并设置封面，So that 提升房源展示质量，吸引更多买家/租客关注。

验收标准：

• 支持图片分类标签：封面、玄关、客厅、餐厅、卧室、卫生间、厨房、阳台、书房、室内其他、室外、全景等
• 支持批量上传、批量修改分类、批量删除、批量下载
• 支持拖拽排序调整图片顺序
• 封面图有显著标识，只能设置一张
• 图片显示尺寸规格信息（如 1440×1080）

---

5. 功能详细说明

5.1 房源列表

5.1.1 列表视图

房源列表为系统核心入口，支持以下视图和操作：

顶部标签页（房源交易类型切换）：

• 出售
• 出租
• 未挂牌
• 成交房源
• 全部房源

核心列表字段（可自定义显示列）：

字段	说明
房源名称	小区名称 + 户室号，显示交易类型标签（买卖/租赁）颜色区分
楼栋	楼栋号
单元	单元号
房号	房号
区域板块	区 + 商圈/板块
状态	出售/出租/他售/他租/暂缓等
售价（万）	总价，支持升降序排序，价格变动显示箭头
单价（元/m²）	每平米均价
租价（元/月）	月租金
面积（m²）	建筑面积
户型	X室X厅
楼层	所在层/总层数
朝向	朝向描述
挂牌日期	房源上架日期
房源最后跟进日	最近一次跟进记录时间

列表顶部操作栏：

• 批量操作：批量收藏、取消收藏、设置保护房、修改相关方、删除
• 导出：导出当前筛选结果（Excel）
• 自定义列表：自定义显示字段和顺序
• 智能排序：系统推荐排序

右上角快捷功能：

• 新增房源按钮（主要 CTA）
• 重复房源检测
• 疑似问题号码房源查询

5.1.2 搜索与筛选系统

关键词搜索：

• 搜索范围：房源编号、小区/学校名称、地址、业主主姓名、电话、钥匙编号等
• 支持楼栋、单元、房号独立精确输入

多维度筛选分组：

筛选组	筛选项
范围	最新挂牌、最降价、与我相关、我部门相关、收藏房源、超时未跟进房源
区域	地区（多选）、地铁
价格	售价区间 / 单价，支持自定义最小值~最大值
面积	面积区间（预设段 + 自定义）
户型	1室/2室/3室/4室/5室及以上 + 卫生间数量
楼层	低层/中层/高层/顶楼/底楼 + 自定义层数范围
标签	速销、独家、有钥匙、电梯、唯一、有照片、贷款、视频、AI视频、有VR、3D
筛选	相关方、维护人、房屋现状、状态/属性、装修/朝向、学校、等级、用途、房本年限、唯一住房、税费/贷款、建成年代、产权性质、挂牌类型、来源、看房时间、审核、保护房
维护	发布、实勘、核验、跟进/带看、钥匙/委托、维护完成度

筛选条件可保存，支持命名保存，下次一键调用。

5.1.3 地图找房

提供地图视图入口，在地图上以点位展示房源分布，支持地图拖拽缩放查找房源（地图功能为独立组件，接入规范另行定义）。

---

5.2 房源详情

房源详情页采用多 Tab 布局，包含以下标签页：

Tab	内容
核心信息	房源基本属性、价格、图片轮播、基础信息、交易信息
跟进日志	所有跟进记录的时间线，支持筛选和搜索
业务信息	带看记录、实勘记录等业务操作
房源信息	详细的物业/楼盘信息
营销信息	营销相关设置
相关员工	首录方、号码方、出售方、实买方等相关方员工信息
相册信息	房源图片管理
附件信息	其他文件附件

详情页顶部操作区：

• 房源标题（交易类型标签 + 小区名称 + 户室号）
• 快速操作：改状态、编辑房源、分享、写跟进
• 更多操作下拉菜单

核心信息 Tab 内容：

[图片轮播区]
总价：XXX 万    单价：XXXXX 元/m²    [昨天最新下降 XX 万，降幅 X.X%]
了解同小区市行情 → 价格解读

户型：X室X厅X卫X阳台
面积：XX.X m²  等级：X（XX）  属性：公盘/私盘
房屋现状：XX   看房时间：随时可看
用途：住宅      录入时间：XXXX-XX-XX
地址：XX区-XX镇
房源备注：-

右侧信息面板（详情页右侧固定栏）：

• 业主/联系人区块：联系人姓名（打码）、电话（打码）、身份标注、操作按钮（查看号码、新增联系人、更多）
• 跟进提醒 TIPS：提示是否有同业主其他房源
• 房源维护完成度：百分比进度条 + 各维度完成情况（重点信息、附件、实勘、VR、钥匙、委托、验证等）
• 房源动态（近 30 天）：带看次数、复看次数、空看人次、面访次数、收藏房源人数、巧客力分享次数

---

5.2.1 房源详情页浮窗快捷编辑

房源详情页的核心信息区块中，大量字段支持不离开详情页、通过点击相关链接/图标唤起浮窗（Modal）进行快速编辑。这一设计减少了页面跳转成本，经纪人可在查看房源信息的同时即时完成信息维护。

以下对各浮窗功能逐一说明。

---

5.2.1.1 编辑栋座单元房号

入口：详情页标题或核心信息区块中点击"编辑"按钮触发

功能说明：允许经纪人更正房源的位置定位信息，包括所属小区、户室号和楼层。由于此类改动影响房源的核心标识，需填写更改理由以便审计追溯。

浮窗字段：

字段	类型	必填	说明
小区名称	文本输入（只读/灰底）	是	显示当前小区名称，不可修改（小区调整须走其他流程）
户室号	双输入框	是	左框：栋/楼栋号；右框：单元/室号（如"055" + "0301"）
所在楼层	数字输入 + 固定文字"层，共" + 数字输入 + "层"	是	第一个数字为当前楼层，第二个数字为总楼层
更改理由	文本区域	是	最多 200 字

交互规则：

• 小区名称字段显示当前值，输入框灰底不可编辑
• 户室号为两个独立输入框，分别对应不同的编码段
• 所在楼层与总楼层均为正整数，所在楼层不得大于总楼层
• 更改理由为必填，未填写时点击确定弹出错误提示
• 点击确定后更新详情页对应字段，并在跟进日志中记录"修改房源信息"操作条目

---

5.2.1.2 调价（编辑房源价格）

入口：详情页核心信息区块价格旁的"编辑"图标，或顶部操作区"更多"菜单中触发

功能说明：经纪人在与业主沟通后调整挂牌价，支持同时设置对内的售底价（底价不对外展示）以及备案/核验价。调价操作需填写更改理由并自动生成调价记录。

浮窗字段：

字段	类型	必填	说明
售价	数字输入	是	单位：万。对外展示的挂牌价
售底价	数字输入	否	单位：万。业主心理底价，仅内部可见，不对外展示
备案/核验价	数字输入	否	单位：万。填写后将同步至营销库，字段旁有提示"填写后，将同步至营销库"
更改理由	文本区域	是	最多 200 字

交互规则：

• 售价为必填字段，为空时不可提交
• 售底价和备案/核验价为选填，不填则保留原值或为空
• 备案/核验价旁展示灰色提示文案："填写后，将同步至营销库"
• 确定后系统自动生成调价记录（含调价前后价格、操作人、时间）
• 详情页顶部价格区域即时更新，并根据价格变化方向显示"↓下降 XX 万，降幅 X.X%"或"↑上涨 XX 万"标注

---

5.2.1.3 调价记录

入口：详情页价格区域旁的"调价记录"或折叠图标触发浮窗

功能说明：以折线图方式可视化展示该房源历史售价和售底价的走势，辅助经纪人向买方展示价格谈判空间。

浮窗内容：

元素	说明
折线图	X 轴为时间（调价日期），Y 轴为价格（万），数据点标注价格值
售价折线	橙红色实线，每个调价时间点有圆形数据节点，节点上方显示具体价格数值
售底价折线	黄色虚线（如有设置底价则显示，否则该图例项存在但无数据线）
图例	左上角显示"售价"与"售底价"色块图例；右上角显示"单位：万"

交互规则：

• 若仅有一次挂牌记录，则折线图仅显示一个数据点
• 鼠标悬浮在数据节点上，显示 Tooltip：日期 + 售价/底价具体数值
• 图表横轴日期自动适配，保证所有历史记录均可展示

---

5.2.1.4 编辑交易信息

入口：详情页核心信息区块"交易信息"旁的"编辑"链接触发

功能说明：单独维护该房源的交易属性，包含产权、税费、贷款等买方关心的关键信息，以及学区情况。与整体编辑房源相比，此浮窗聚焦交易维度，操作更轻量。

浮窗字段：

字段	类型	必填	说明
房本年限	双下拉	是	第一个下拉：具体年限；第二个下拉：满五 / 不满五 / 不满两年等
唯一住房	单选（唯一 / 不唯一 / 重置）	否	重置选项用于清除已选值
产权性质	下拉选择	否	商品房 / 房改房 / 集资房 / 经济活用房
贷款	单选（有 / 无 / 重置）	否	该房源是否有未还清贷款
抵押	单选（有 / 无）	否	该房源是否存在抵押
售房原因	文本区域	否	最多 200 字（截图显示示例值"置换"）
学校	多条目	否	每条目含两个下拉：学校名称 + 学区情况（选填）；支持"+ 添加学校"增加多个学区

交互规则：

• 房本年限为必填，未选择时点击确定弹出提示
• 单选字段（唯一住房、贷款）提供"重置"选项，点击后清除当前选中值
• 学校支持多条目，每条为"学校名称（下拉）+ 学区情况（选填下拉）"组合，点击"+ 添加学校"新增一行
• 保存后详情页右侧"交易信息"区块实时刷新

---

5.2.1.5 更改房源等级

入口：详情页基础信息区块"等级"字段旁的"编辑"链接触发

功能说明：经纪人根据对业主出售意愿的最新判断，快速调整该房源的意向等级，辅助公盘优先级排序和跟进策略制定。

浮窗字段：

字段	类型	必填	说明
原等级	只读文本	—	展示当前等级，如"C（一般）"
新等级	下拉选择	是	选项：A（急迫）/ B（较强）/ C（一般）

交互规则：

• 浮窗展示原等级供对比参考，不可修改
• 新等级下拉为必选，未选择时不可提交
• 确认后详情页等级标识即时更新；变更操作自动记录至跟进日志

---

5.2.1.6 更改房源属性

入口：详情页基础信息区块"属性"字段旁的"编辑"链接触发

功能说明：调整房源的流通范围属性。公盘为全体经纪人可见并可跟进；私盘仅录入人（或其团队）可见；特盘为特殊保护状态；封盘表示暂时从流通中移出。属性变更影响可见范围和权限，需填写理由留存记录。

浮窗字段：

字段	类型	必填	说明
原属性	只读文本	—	展示当前属性，如"公盘"
新属性	单选	是	选项：私盘 / 特盘 / 封盘（注意：截图显示当原属性为公盘时，新属性选项不含公盘，只显示其他三个选项）
更改理由	文本区域	是	最多 200 字

交互规则：

• 新属性选项根据当前原属性动态调整（不展示与原属性相同的选项）
• 更改理由为必填
• 变更为私盘/封盘后，该房源在公盘列表中不可见，权限控制需联动权限模块
• 确认后变更记录写入跟进日志，注明原属性 → 新属性及操作人

---

5.2.1.7 房源状态变更

入口：详情页顶部操作区"改状态"按钮触发，或"更多"菜单中触发

功能说明：当房源的交易状态发生变化（如业主暂缓出售、他处成交、恢复挂牌等），经纪人通过此浮窗快速变更状态，并说明原因。状态变更直接影响该房源在列表中的分组归属和展示。

浮窗字段：

字段	类型	必填	说明
原状态	只读文本	—	展示当前状态，如"出售"
原交易类型	只读文本	—	展示当前交易类型，如"买卖"
新状态	下拉选择	是	根据当前状态可选的目标状态（见状态流转规则）
更改理由	文本区域	是	最多 50 字

可选新状态范围（依据当前状态）：

当前状态	可变更至
出售	暂缓、他售、成交
出租	暂缓、他租、成交
暂缓	出售、出租（恢复挂牌）
他售 / 他租	出售、出租（重新挂牌）

交互规则：

• 原状态与原交易类型均为只读展示，不可修改
• 新状态下拉枚举项根据当前状态动态过滤，不显示无效的跳转选项
• 更改理由最多 50 字，超出截断并提示
• 确认后：列表视图中该房源的状态标签即时更新；状态变更记录写入跟进日志

---

5.2.1.8 更改房屋现状

入口：详情页基础信息区块"房屋现状"字段旁触发

功能说明：记录房屋当前的使用状态，影响买方查房安排及经纪人带看策略。

浮窗字段：

字段	类型	必填	说明
房屋现状	单选	是	业主自住 / 空置 / 租客租住 / 未知

交互规则：

• 单选按钮，默认显示当前值
• 无需填写更改理由（轻量操作）
• 确认后详情页"房屋现状"字段即时更新

---

5.2.1.9 更改房源用途

入口：详情页基础信息区块"用途"字段旁触发

功能说明：更改房屋的规划用途分类，同时允许一并修正建筑面积、套内面积、装修情况、朝向和户型等基础物理属性，避免因单字段更改而多次弹窗操作。

浮窗字段：

字段	类型	必填	说明
原用途	只读文本	—	如"住宅"
新用途	双下拉	是	第一个下拉：用途类型（大类）；第二个下拉：用途（选填，细分小类）
建筑面积	数字输入	是	单位：m²，显示当前值可编辑
套内面积	数字输入	否	单位：m²
装修	下拉选择	是	毛坯 / 清水 / 简装 / 中装 / 精装 / 豪装
朝向	下拉选择	是	东/南/西/北/东南/东北/东西/南北/西北/西南
户型	多级数字下拉	是	室（下拉）+ 厅（下拉）+ 卫（下拉）+ 厨（下拉）+ 阳台（数字）

交互规则：

• 新用途为两个独立下拉，第一个为用途大类（必选），第二个为细分选填（根据大类联动候选值）
• 建筑面积、装修、朝向、户型均为必填
• 套内面积为选填
• 户型字段采用"室/厅/卫/厨 + 阳台数"组合，每项均为独立下拉
• 确认后详情页对应字段即时更新

---

5.2.1.10 看房时间

入口：详情页基础信息区块"看房时间"字段旁触发

功能说明：快速更新买方前往看房的时间安排约束，辅助经纪人合理安排带看计划。

浮窗字段：

字段	类型	必填	说明
看房时间	单选	是	随时可看 / 提前预约 / 不方便看

交互规则：

• 单选按钮，默认显示当前值（无选中时三个选项均为未选状态）
• 无需填写更改理由
• 确认后详情页"看房时间"字段即时更新

---

5.2.1.11 挂牌历史记录

入口：详情页核心信息区块"挂牌时间"旁的"历史"链接触发，跳转至独立子页面（非浮窗）

功能说明：完整记录该房源每一次挂牌的关键信息，包括当次挂牌的价格、交易条件、挂牌时间范围及负责经纪人。帮助经纪人和管理者回溯历史，判断业主的价格变化趋势和挂牌持续性。

页面布局：面包屑导航 房客管理 / 房源 / 房源详情 / 挂牌记录，正文区以卡片列表展示每次挂牌，按时间倒序排列（最新在前）。

每条挂牌记录字段：

字段	说明
挂牌类型标题	如"出售挂牌"
挂牌状态标签	挂牌中（橙红色高亮）/ 已结束（灰色）
房源编号	点击可跳转到房源详情，蓝色可点击链接
售价	该次挂牌价格（万）
购买时间	如"满五"（表示房本年限状态）
出售方	负责经纪人姓名及所在门店+组别（如"都市港湾店一组 雷威"）
售房原因	业主售房原因，如无则显示"-"
挂牌时间	当次挂牌的开始时间（在售中状态显示起始时间；已结束状态显示"开始时间 - 结束时间"）
售单价	元/平米
唯一住房	是 / 否 / -（未知）
包税费	包税方式，如无则显示"-"

交互规则：

• 卡片列表最新挂牌记录排在最前
• "挂牌中"状态以橙红色文字显示；"已结束"以灰色文字显示
• 房源编号为蓝色可点击链接，点击跳转至该房源详情页
• 挂牌时间：在售中显示"YYYY-MM-DD HH:mm:ss"；已结束显示"YYYY-MM-DD HH:mm:ss - YYYY-MM-DD HH:mm:ss"
• 此页面为只读展示，不支持在此直接编辑挂牌记录

---

5.2.1.12 快捷编辑功能汇总

功能	入口位置	交互形式	是否需要更改理由	操作记录日志
编辑栋座单元房号	标题区/核心信息编辑按钮	浮窗 Modal	是（最多 200 字）	是
调价	价格旁编辑图标	浮窗 Modal	是（最多 200 字）	是（自动生成调价记录）
查看调价记录	价格旁折叠图标	浮窗 Modal（只读）	—	—
编辑交易信息	交易信息区块编辑链接	浮窗 Modal	否	是
更改房源等级	等级字段旁编辑链接	浮窗 Modal	否	是
更改房源属性	属性字段旁编辑链接	浮窗 Modal	是（最多 200 字）	是
房源状态变更	顶部"改状态"按钮	浮窗 Modal	是（最多 50 字）	是
更改房屋现状	房屋现状字段旁	浮窗 Modal	否	是
更改房源用途	用途字段旁	浮窗 Modal	否	是
看房时间	看房时间字段旁	浮窗 Modal	否	是
挂牌历史记录	挂牌时间旁"历史"链接	独立子页面（只读）	—	—

设计原则：所有涉及敏感属性或影响多人可见范围的变更（属性、栋座、调价）均需要填写更改理由以支持审计；轻量的状态/属性单选类操作不强制要求理由，降低经纪人操作摩擦。

---

5.3 新增/编辑房源

5.3.1 新增住宅表单结构

新增住宅采用单页长表单，按信息类别分为以下区块：

① 房源核心信息

字段	类型	必填	说明
状态	单选	是	出售 / 出租 / 租售 / 暂缓
房源属性	单选	是	公盘 / 私盘
用途	单选	否	普通住宅 / 花园洋房
小区名称	文本输入	是	支持联想搜索
户室号	文本输入	否	栋/幢/弄/湖同 + 单元/号 + 门牌/室号
所在楼层	数字输入	是	所在层数
总楼层	数字输入	是	楼栋总层数
户型	数字输入	是	室数 + 厅数 + 卫数 + 厨数 + 阳台（是否）
建筑面积	数字输入	是	单位：m²
售价	数字输入	条件必填	出售状态必填，单位：万
租价	数字输入	条件必填	出租状态必填，单位：元/月

② 业主/联系人

• 支持添加多个联系人（"添加联系人"按钮）
• 每个联系人包含：姓名、性别（先生/女士）、身份（业主/联系人/委托人等）、电话1、电话2
• 电话格式：手机号或座机号（座机需写区号）

③ 基础信息

字段	类型	必填	说明
朝向	单选	是	东/南/西/北/东南/东北/东西/南北/西北/西南
装修	单选	是	毛坯/清水/简装/中装/精装/豪装
电梯	单选	否	有/无/重置
建成年代	下拉选择	否	年份选择，提示：建成年代为空可能影响营销发房
学校	下拉多选	否	支持添加多个学区，"添加学校"按钮
看房时间	单选	否	随时可看/提前预约/不方便看/重置
房屋现状	下拉选择	否	空置/自住/出租中等
等级	单选	否	A（急迫）/ B（较强）/ C（一般）
来源	下拉选择	否	房源来源渠道
售房原因	文本区域	否	最多 200 字
房源备注	文本区域	否	最多 500 字

④ 交易信息

字段	类型	必填	说明
产权年限	单选	否	40年/50年/70年/永久产权/其他
产权性质	单选	否	商品房/房改房/集资房/经济活用房
房本年限	下拉 + 下拉	是	具体年限 + 满五/不满五等
唯一住房	单选	否	唯一/不唯一
购房付款方式	单选	否	一次付清/按揭付款/分批次付款/垫资解按
包税费	单选	否	各付/到手/包税
抵押	单选	否	有/无
贷款	单选	否	有/无
查封	单选	否	有/无
限制	单选	否	有/无
原购价	数字输入	否	单位：万

⑤ 相关方

字段	说明
首录方	自动填入当前登录用户（只读）
号码方	默认为当前用户，可修改
出售方	默认为当前用户，可修改

---

5.3.x 房源类型体系与优先级

系统支持 6 种房源类型，录入表单在通用结构基础上各有差异字段。按业务重要性和开发优先级排序如下：

优先级	房源类型	适用场景	开发阶段
P0（必须）	住宅	普通住宅、花园洋房，最高频业务	v1 上线
P1（高）	别墅	联排/独栋/双拼/叠加别墅	v1 上线
P2（低）	商住	商住两用类物业	v2 排期
P2（低）	商铺	临街/商场/底商/综合体铺位	v2 排期
P2（低）	写字楼	办公楼层/整层出租出售	v2 排期
P2（低）	其他	车库/车位/平房/四合院/仓库/厂房/地皮等	v2 排期

优先级说明：P2 类型（商住/商铺/写字楼/其他）在 v1 版本中不开发，但需在"新增房源"入口预留类型选择器的 UI 占位，选择后提示"该类型即将上线，敬请期待"，避免后期大规模改动入口设计。

---

5.3.2 各房源类型差异字段说明

以下以「新增住宅」为基准（通用字段不重复列出），仅标注各类型的新增字段或差异字段。

① 新增别墅（P1 — v1 上线）

与住宅表单高度相似，核心差异点：

差异字段	变化说明
用途	选项变更为：联排别墅 / 独栋别墅 / 双拼别墅 / 叠加别墅（替换住宅的"普通住宅/花园洋房"）
其他字段	与住宅完全一致（核心信息/业主/基础信息/交易信息/相关方）

别墅与住宅共用同一套表单框架，用途字段枚举值不同，后端可通过房源类型参数控制渲染，开发成本低。

---

② 新增商铺（P2 — v2 排期）

商铺为纯商业物业，字段差异较大：

核心信息区块 — 新增/差异字段：

字段	类型	必填	说明
用途	无选项（字段空白）	—	商铺无细分用途，该行保留占位但无输入项
开间	数字输入	否	单位：米，商铺特有尺寸维度
进深	数字输入	否	单位：米，商铺特有尺寸维度
层高	数字输入	否	单位：米，商铺特有尺寸维度
位置	单选	是	临街 / 商场 / 小区 / 底商 / 商业综合体

无交易信息区块：商铺表单仅含「房源核心信息 / 业主联系人 / 基础信息 / 相关方」4 个区块，没有"交易信息" Tab（无房本年限等住宅特有交易字段）。

---

③ 新增商住（P2 — v2 排期）

商住两用物业，字段结构与住宅高度相似，核心差异：

差异字段	变化说明
用途	字段保留但选项为空（待业务方定义商住用途枚举值）
户型	与住宅一致（室/厅/卫/厨/阳台）
交易信息	仅保留「房本年限」，其余交易字段（产权年限/产权性质/唯一住房等）不展示

商住介于住宅与商铺之间，本质是住宅户型 + 精简版交易信息的组合。

---

④ 新增写字楼（P2 — v2 排期）

写字楼为纯办公物业，表单最为精简：

表单区块：房源核心信息 / 业主联系人 / 基础信息 / 相关方（无"交易信息" Tab，与商铺一致）

核心信息区块 — 差异字段：

字段	变化说明
用途	字段保留但选项为空（待业务定义）
户型	无户型字段（写字楼无室/厅概念）
建筑面积	保留，必填
售价	保留

写字楼表单是所有类型中字段最少的，核心信息区块仅有：状态/属性/用途/小区名称/户室号/楼层/建筑面积/售价。

---

⑤ 新增其他（P2 — v2 排期）

"其他"类型覆盖所有非标准物业形态，是兜底类型：

核心信息区块 — 用途枚举值（与其他类型最大差异）：

用途选项	说明
车库	地下/地上车库
车位	停车位
平房	平房/老式民居
四合院	传统院落式住宅
仓库	储存类物业
厂房	工业厂房
地皮	土地/地块
铺厂	商铺+厂房复合
网点	金融网点/营业厅类
写厂	写字楼+厂房复合

表单结构：与住宅完全一致（含交易信息 Tab，有房本年限字段），但用途枚举值替换为上述列表，且有户型字段（室/厅/卫/厨/阳台）。

---

5.3.3 房源类型选择入口设计

新增房源 按钮点击后，先弹出类型选择步骤（不直接进入表单）：

选择房源类型
┌──────────┬──────────┬──────────┐
│   住宅   │   别墅   │  商住    │
│ （P0）   │ （P1）   │ 即将上线 │
├──────────┼──────────┼──────────┤
│   商铺   │  写字楼  │   其他   │
│ 即将上线 │ 即将上线 │ 即将上线 │
└──────────┴──────────┴──────────┘

• P0/P1 类型（住宅/别墅）：可点击，进入对应录入表单
• P2 类型（商住/商铺/写字楼/其他）：点击后 Toast 提示"该房源类型即将上线，敬请期待"，不跳转表单
• v2 上线后，P2 类型逐步解锁，无需改动入口结构

---

5.3.x+1 各类型字段对比总览

字段	住宅	别墅	商住	商铺	写字楼	其他
状态	✅	✅	✅	✅	✅	✅
房源属性（公/私盘）	✅	✅	✅	✅	✅	✅
用途	住宅/洋房	联排/独栋等	空（待定）	无选项	空（待定）	车库/车位等10项
小区名称	✅	✅	✅	✅	✅	✅
户室号	✅	✅	✅	✅	✅	✅
楼层	✅	✅	✅	✅	✅	✅
户型（室/厅/卫/厨）	✅	✅	✅	❌	❌	✅
建筑面积	✅	✅	✅	✅	✅	✅
售价	✅	✅	✅	✅	✅	✅
开间/进深/层高	❌	❌	❌	✅	❌	❌
位置（商铺专属）	❌	❌	❌	✅	❌	❌
朝向	✅	✅	✅	✅	✅	✅
装修	✅	✅	✅	✅	✅	✅
电梯	✅（编辑时）	✅（编辑时）	—	—	—	—
建成年代	✅（编辑时）	✅（编辑时）	—	—	—	—
学校	✅（编辑时）	—	—	—	—	—
交易信息 Tab	✅（完整）	✅（完整）	仅房本年限	❌	❌	✅（完整）
业主/联系人	✅	✅	✅	✅	✅	✅
相关方	✅	✅	✅	✅	✅	✅

---

5.3.2 编辑房源

• 编辑页面结构与新增一致，数据预填充
• 顶部显示"修改房源类型"入口（可在住宅/商业等类型间切换）
• 套内面积为非必填字段，仅在编辑时展示
• 保存/取消按钮固定在页面底部

---

5.4 跟进管理

房源详情页的跟进管理区域通过 Tab 页签切换，展示不同维度的跟进记录。共有 6 个 Tab：全部 / 写入跟进 / 敏感信息跟进 / 敏感信息查看 / 修改跟进 / 其他跟进。

所有 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

支持"跟进模版"功能（快速套用常用跟进话术模板）。

交互规则：

• 跟进目的为必填，未选择时不可提交
• 跟进内容少于 6 字时提交弹出错误提示
• 提交成功后浮窗关闭，跟进日志列表实时更新，新记录出现在列表顶部
• 写入的跟进记录同步出现在"全部"及"写入跟进"两个 Tab 中

---

5.4.8 业务信息：钥匙管理

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 素材时可用，否则置灰
• 提交成功后跳回房源详情页，业务信息面板"实勘"一栏更新状态
• 新增实勘记录后，房源维护完成度"实勘"维度得分更新
• 实勘记录自动写入跟进日志

---

5.5 图片管理

5.5.1 图片分类体系

分类	说明
封面	房源主封面，限 1 张
玄关	入户区域
客厅	客厅空间
餐厅	餐厅空间
卧室	各卧室
卫生间	卫浴空间
厨房	厨房空间
阳台	阳台/露台
书房	书房/办公空间
室内其他	其他室内区域
室外	外观/小区环境
全景	360° 全景图

5.5.2 图片操作

• 上传：点击上传区域或拖拽上传，支持批量
• 排序：拖拽调整同类图片顺序（"点击后可拖拽图片调整排序"提示）
• 分类设置：上传时选择分类，或批量修改已有图片分类
• 批量操作：全选、批量修改分类、批量删除、批量下载
• 封面设置：在图片缩略图上标注"封面"标签

---

5.6 同业主房源

当系统识别到当前房源的业主名下还有其他房源时，触发以下交互：

1. 在房源详情右侧"业主/联系人"区块显示提示条：

   "业主还有其他房源，建议您一起跟进，避免重复打扰"

2. 点击"查看房源"触发弹窗，字段如下：

字段	说明
房源名称	可点击跳转到对应房源
状态	当前交易状态
城区商圈	所在区域
房型	户型描述
面积（m²）	建筑面积
售价（万）	出售价格
租价（元/月）	出租价格

3. 当业主有多个关联联系人时，弹窗顶部提供业主下拉选择器。

4. 弹窗提示注意事项："房源详情提示条存在缓存，以本页面数据为准"

---

5.7 房源状态流转

                    ┌─────────┐
                    │  新增   │
                    └────┬────┘
                         │
              ┌──────────▼──────────┐
              │       出售/出租      │
              └──────────┬──────────┘
                         │
        ┌────────────────┼────────────────┐
        ▼                ▼                ▼
    ┌───────┐        ┌───────┐        ┌───────┐
    │  暂缓  │        │ 他售   │        │ 成交   │
    └───┬───┘        │ 他租   │        └───────┘
        │            └───────┘
        └────────────────▶ 出售/出租（恢复）

状态说明：

状态	说明
出售	当前正在出售中，公盘流通
出租	当前正在出租中，公盘流通
暂缓	业主暂时不出售/出租，保留记录
他售	已委托其他中介或自行处置（非本平台成交）
他租	同上，出租版本
成交	通过本平台成功成交
未挂牌	录入但尚未公开挂牌

---

6. 技术考量

6.1 依赖关系

依赖项	用途	时间线风险
组织人事模块	相关方（首录方/号码方/出售方）员工数据	低（并行开发）
权限模块	控制私盘/公盘可见性、敏感信息访问权限	中（需明确权限矩阵）
地图服务	地图找房功能	低（可延后）
文件存储服务	房源图片和附件存储（OSS/S3）	中（需确定存储方案）
小区数据库	小区名称联想搜索的基础数据	高（需预导入或接入外部数据源）

6.2 已知风险

风险	可能性	影响	缓解措施
小区基础数据缺失	高	高	提前采购或导入小区数据，支持手动输入兜底
大数据量列表性能（89000+ 条）	中	高	后端分页 + 索引优化，禁止前端全量加载
图片存储成本	中	中	限制单张大小，压缩处理，CDN 分发
号码隐私合规	高	高	手机号默认打码，设置查看权限，记录查看日志

6.3 待解决问题（开发前必须明确）

• 小区数据来源：是自建小区库还是接入第三方（安居客、链家数据接口）？— Owner: 技术负责人 — Deadline: 开发启动前 1 周
• 私盘可见范围：私盘仅录入人可见，还是录入人所在门店可见？— Owner: 业务负责人
• 房源号码查看权限：什么角色可以查看未打码号码？是否需要记录每次查看日志？— Owner: 产品 + 合规
• 重复房源判断逻辑：以业主电话为主键还是（小区+楼栋+单元+房号）为主键？— Owner: 产品
• 跟进目的选项：需要业务方提供完整的跟进目的枚举值 — Owner: 业务运营

---

7. 上线计划

阶段	时间	用户范围	通过条件
内部 Alpha	TBD	开发+产品+1个试点门店（5人）	核心流程无 P0 Bug，房源增删改查完整
封闭 Beta	TBD	3个试点门店（50人）	错误率 < 1%，跟进记录功能稳定，用户反馈 CSAT ≥ 4/5
全量上线	TBD	全部门店	性能指标达标，帮助文档完备，客服培训完成

回滚标准：若上线后 24 小时内出现房源数据丢失、错误率 > 5% 或业主电话泄露等 P0 问题，立即回滚并启动事故响应流程。

---

8. 附录

8.1 字段枚举值速查

房源状态：出售、出租、租售、暂缓、他售、他租、成交、未挂牌

朝向：东、南、西、北、东南、东北、东西、南北、西北、西南

装修：毛坯、清水、简装、中装、精装、豪装

等级：A（急迫）、B（较强）、C（一般）

产权年限：40年、50年、70年、永久产权、其他

产权性质：商品房、房改房、集资房、经济活用房

付款方式：一次付清、按揭付款、分批次付款、垫资解按

包税方式：各付、到手、包税

看房时间：随时可看、提前预约、不方便看

电梯：有、无

唯一住房：唯一、不唯一

8.2 房源维护完成度评分维度（参考）

维度	满分权重
重点信息（户型/面积/价格/朝向等核心字段完整度）	8%
附件（上传合同等文件）	8%
实勘（经纪人实地勘察记录）	16%
VR（全景视频/图片）	8%
钥匙（是否托管钥匙）	10%
委托（是否签署委托协议）	10%
验证（房源信息核实）	7%
跟进（近期跟进活跃度）	8%
带看	8%
其他	17%

8.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
• 写跟进：Project/fonrey/sreenshots/房源/增房/写跟进.png
• 查看同业主房源：Project/fonrey/sreenshots/房源/增房/查看同业主房源.png

详情页快捷编辑浮窗截图（v1.2 新增）：

• 编辑栋座单元房号：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
• 挂牌历史记录：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