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

PRD: 房源管理模块

状态: Draft
作者: 产品经理
最后更新: 2026-04-23（v2.1 重写 8.3 相关截图参考：修正所有路径拼写错误（sreenshots→screenshots）；补充全部未收录截图（房源详情1-3、房源备注、价格解读、市场报盘、全部商铺、全部写字楼、附件信息、编辑业主联系人、小区/楼盘管理全部截图）；按文档章节分组重新整理为表格格式）
版本: 2.1
所属系统: Fonrey 房产经纪管理系统
关联模块: 客源管理、组织人事管理、权限管理

变更历史

版本	日期	作者	变更说明
v1.0	—	产品经理	初稿
v2.1	2026-04-23	产品经理	重写 §8.3 相关截图参考：修正所有路径拼写错误（sreenshots→screenshots）；补充全部未收录截图（房源详情1-3、房源备注、价格解读、市场报盘、全部商铺、全部写字楼、附件信息、编辑业主联系人、小区/楼盘管理全部截图）；按文档章节分组重新整理为表格格式

---

1. 问题陈述

背景

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

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

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

目标用户

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

---

2. 目标与成功指标

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

---

3. 非目标（本期不做）

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

---

4. 用户故事与验收标准

说明：以下用户故事按核心业务流程顺序排列，覆盖房源管理模块已文档化的全部功能。每条验收标准与第 5 章功能说明对应。

---

Story 1：经纪人录入新房源

As Agent（经纪人），I want 快速录入一套新房源的完整信息，So that 房源能进入公盘流通并留存完整的基础数据。

验收标准：

• 支持选择 6 种房源类型（住宅、别墅、商铺、商住、写字楼、其他），本期 P0 实现住宅，P1 实现别墅，商业类型低优先级
• 新增住宅表单分为 5 个区块（Tab）：房源核心信息 / 业主联系人 / 基础信息 / 交易信息 / 相关方，支持 Tab 顶部导航快速跳转
• 必填项未填写时，点击保存弹出红色错误提示并自动滚动定位到第一个未填项
• 小区名称支持模糊搜索联想，选中后自动回填楼盘信息
• 户型字段支持独立输入：室数、厅数、卫数、厨数，及有/无阳台单选
• 楼层填写：当前楼层 + 总楼层，均为正整数，当前楼层不得大于总楼层
• 价格填写：出售价格（万元）或出租价格（元/月），依据交易类型动态显示
• 业主/联系人区块支持录入姓名、电话（手机号或固话），手机号录入后系统自动校验是否存在重复房源
• 相关方区块支持选择：首录经纪人、号码来源经纪人、出售方/实买方经纪人
• 保存成功后跳转至该房源详情页，并展示"保存成功"提示

---

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

As Agent（经纪人），I want 在数万条房源中快速定位符合客户需求的房源，So that 提升匹配推荐效率、减少无效沟通。

验收标准：

• 支持关键词搜索：小区名称、地址、业主姓名、电话、钥匙编号等
• 支持多维度组合筛选：
  • 范围：最新挂牌 / 最新降价 / 与我相关 / 我部门相关
  • 区域：行政区 / 地铁线路+站点
  • 价格区间（售价/租价）、面积区间、户型（室/厅/卫）、楼层区间
  • 状态（出售/出租/暂缓/他售/他租/成交）、属性（公盘/私盘）
  • 装修情况、朝向、标签、等级、用途、学区
• 列表支持按售价、单价、面积、挂牌日期、最后跟进日期排序（升/降序）
• 支持在列表视图与海报视图之间切换
• 搜索条件可保存为筛选方案，支持快速调用
• 列表底部实时显示当前筛选总条数，支持分页（每页 20 条，可跳页）
• 支持导出当前筛选结果
• 地图视图：在地图上按区域/小区聚合展示房源分布（低优先级，可延后）

---

Story 3：经纪人变更房源状态

As Agent（经纪人），I want 在房源详情页快速变更房源的交易状态并说明原因，So that 保持房源状态与实际情况同步，团队成员能及时感知。

验收标准：

• 状态变更入口位于详情页顶部操作区"改状态"按钮
• 浮窗展示当前状态（只读）和新状态下拉选项，新状态选项依据当前状态动态过滤（如：出售中只能变更为暂缓/他售/成交）
• 更改理由为必填文本框，最多 50 字
• 确认后列表中该房源状态标签即时更新，并在跟进日志中自动生成状态变更记录
• 支持从暂缓/他售/他租状态恢复为出售/出租（重新挂牌）

---

Story 4：经纪人在详情页快捷编辑房源核心字段

As Agent（经纪人），I want 不离开房源详情页就能直接修改价格、等级、属性、现状、用途等高频字段，So that 减少页面跳转，快速响应业主意向变化。

验收标准：

• 详情页顶部支持快捷编辑栋座单元房号（含更改理由，最多 200 字）
• 核心信息区块点击对应字段触发浮窗编辑，支持以下快捷操作：
  • 调价：修改出售/出租价格，记录调价原因，历史调价记录可查
  • 更改等级：A+/A/B/C/D 五级选择，支持批量修改
  • 更改属性：公盘 / 私盘切换，私盘说明必填
  • 更改房屋现状：有人居住 / 空置 / 租客居住 / 其他，填写详情
  • 更改用途：住宅 / 商住 / 商业等用途切换，需填写更改理由
  • 设置看房时间：随时可看 / 提前预约等选项
• 每次快捷编辑操作确认后，详情页对应字段即时刷新，并在跟进日志中写入操作记录
• 挂牌历史记录可查（价格、状态、操作时间、操作人的完整变更轨迹）

---

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

As Agent（经纪人），I want 随时记录与业主的沟通内容，So that 保留完整的跟进轨迹，团队协作时不会重复打扰业主。

验收标准：

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

---

Story 6：经纪人管理钥匙与委托

As Agent（经纪人），I want 在系统中登记钥匙持有情况和委托协议信息，So that 提升房源维护完成度评分，并让团队知悉钥匙状态，避免带看时出现无法入场的情况。

验收标准：

钥匙管理：

• 支持新增钥匙，填写：钥匙类型（机械锁/密码锁）、钥匙方（经纪人）、保管部门，可上传附件和录音
• 支持"钥匙在他司"备注，填写他司信息（最多 30 字），不生成钥匙方记录
• 新增己方钥匙后，"钥匙在他司"标记自动清除
• 新增钥匙操作自动写入跟进日志（归类至"其他跟进"）

委托管理：

• 支持新增委托（独立页面），填写：委托类型、委托期限（起止日期）、委托方、签约方式
• 签约方式选择后，下方自动展示对应委托书模板内容
• 委托人（产权信息）区块支持：选择产权人 / 授权第三方，填写产权人姓名、证件信息，上传房产证
• 支持上传其他资料（每类附件最多 10 个文件）及备注（最多 200 字）
• 提交成功后跳回详情页，业务信息面板"委托"栏状态更新，跟进日志自动写入记录

---

Story 7：经纪人提交实勘记录

As Agent（经纪人），I want 完成实地勘察后在系统中提交实勘报告和分类照片，So that 提升房源维护完成度、保障房源信息真实性，给客户提供更可信的参考依据。

验收标准：

• 实勘为独立页面，包含：实勘定位（GPS）、实勘说明（最多 200 字）
• 实勘相册按空间分类上传，必填分类：户型图（≥1张）、客厅+餐厅合计（≥2张）、卧室（≥2张）、卫生间（≥1张）、厨房（≥1张）；选填：玄关、阳台、书房、室内其他、室外
• 必填分类未满足最低数量要求时，不允许点击"提交实勘"
• 支持"VR 一键截图"从已有 VR 素材截图（无 VR 素材时按钮置灰）
• 支持"另存草稿"，草稿不计入维护完成度
• 提交成功后：详情页业务信息面板"实勘"状态更新，房源维护完成度"实勘"维度得分更新，跟进日志自动写入记录

---

Story 8：经纪人管理房源业主与联系人

As Agent（经纪人），I want 在房源详情页随时新增、编辑业主/联系人信息，并查看该业主名下的其他房源，So that 保持联系人资料准确完整，了解业主资产全貌，避免重复打扰、提升沟通效率。

验收标准 8.1：新增业主/联系人

• 详情页右侧"业主/联系人"区块提供"新增联系人"按钮，点击触发浮窗，无需跳转页面
• 浮窗必填项：姓名、性别（先生/女士，默认先生）、身份、电话1；未填写时点击确定触发红色错误提示并定位到未填项
• 身份单选项包含：业主 / 联系人 / 二房东 / 租客 / 代理人 / 企业法人，默认选中"联系人"
• 电话1 须通过格式校验：手机号或含区号座机格式（如 021-XXXXXXXX）
• 选填项：电话2、微信、QQ、备注（文本区域，可拖拽调整高度）
• 浮窗底部提供"修改号码相关方"复选框（默认未勾选）；勾选后展示说明文字："申请修改将触发审批流，审批通过可成为号码方"，提交后系统自动发起审批流程
• 保存成功后，右侧"业主/联系人"面板即时刷新，新联系人出现在列表中
• 新增操作自动写入跟进日志（归类至"其他跟进"）

验收标准 8.2：编辑业主/联系人

• 联系人卡片提供"编辑"按钮，点击触发编辑浮窗，字段与新增一致但行为有差异
• 浮窗打开时，姓名、性别、身份自动回填已保存值，可直接修改
• 电话1、电话2 默认以打码形式只读展示（如 021******03、177******03），不可直接在字段内编辑
• 浮窗右上角显示蓝色"查看号码"链接；点击后，电话1、电话2、微信、QQ 字段同步切换为可编辑明文输入框，同时系统自动写入"敏感信息查看"跟进日志记录（不可手动删除）
• 微信、QQ 无数据时显示"-"，点击"查看号码"后切换为可编辑输入框
• 编辑浮窗不包含"修改号码相关方"复选框
• 保存成功后，右侧面板对应联系人卡片信息即时更新
• 编辑操作自动写入跟进日志（归类至"修改跟进"）

验收标准 8.3：查看同业主其他房源

• 系统通过业主姓名+电话匹配，识别同业主名下其他房源；识别到时，在"业主/联系人"区块顶部显示提示条："业主还有其他房源，建议您一起跟进，避免重复打扰"
• 点击"查看房源"唤起"同业主房源"浮窗，列表展示字段：房源名称（可点击跳转详情）、状态、城区商圈、房型、面积（m²）、售价（万）、租价（元/月）
• 浮窗副标题灰色小字注明："房源详情提示条存在缓存，以本页面数据为准"
• 当业主有多个关联联系人时，浮窗顶部显示业主下拉选择器，切换业主后列表实时刷新；仅一位业主时不显示下拉
• 列表无数据时展示"暂无数据"空状态；列表列数较多时支持横向滚动

---

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

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

验收标准：

• 支持图片分类：封面（限 1 张）、玄关、客厅、餐厅、卧室、卫生间、厨房、阳台、书房、室内其他、室外、全景
• 支持点击上传区域或拖拽批量上传，上传时或上传后可选择/修改分类
• 支持批量修改分类、批量删除、批量下载
• 支持拖拽调整同类图片顺序（有"点击后可拖拽图片调整排序"操作提示）
• 封面图显示"封面"标识标签，同一房源只能设置一张封面图

---

Story 10：经纪人管理房源附件

As Agent（经纪人），I want 为房源上传并分类管理证件/协议等附件文件，So that 将核心证明材料与房源绑定留存，方便后续合规审查和团队共享查阅。

验收标准：

• 附件分类 Tab 包含：全部 / 身份证 / 房产证 / 委托书 / 其他，每个 Tab 实时显示该分类文件数量
• 点击"上传附件"按钮支持批量上传文件，上传时可选择所属分类
• 支持批量修改类别（勾选后通过下拉选择统一变更分类）
• 支持批量下载（勾选后打包下载至本地）
• 当前分类无附件时，展示空状态图示及"暂无附件"文案

---

Story 11：经纪人补全房源详细信息

As Agent（经纪人），I want 不离开房源详情页补充或修改基本信息、产证信息、房屋介绍和楼盘信息，So that 提升房源维护完成度评分，增强房源对买家/租客的吸引力。

验收标准：

• 「房源信息」Tab 下，以下区块均支持点击"编辑"触发浮窗编辑，无需跳转页面：
  • 基本信息：建筑结构、建筑年代、供水/供电/供气/供暖类型、产权年限、用途分类等
  • 产证信息：产证状态、产证号、首次登记时间、权属性质、土地性质、是否有抵押等
  • 房屋介绍：卖点标题（营销文案）、房源描述（最多 3000 字）
  • 楼盘信息：楼盘名称、开发商、物业公司、物业费、车位情况等
• 各浮窗保存后，详情页对应区块数据即时刷新
• 修改操作自动写入跟进日志（归类至"修改跟进"）

---

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.0 标题栏浮窗快捷编辑

详情页顶部标题栏操作区提供三个核心快捷入口，支持不离开详情页完成最高频的位置标识、状态变更和房源全量编辑操作。

---

5.2.0.1 编辑栋座单元房号

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

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

浮窗字段：

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

交互规则：

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

---

5.2.0.2 房源状态变更

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

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

浮窗字段：

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

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

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

交互规则：

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

---

5.2.0.3 编辑房源

入口：详情页顶部操作区"编辑房源"按钮触发 → 跳转至独立编辑页面

页面标题：编辑房源（面包屑：房源 / 二手/租赁 / 编辑房源）

与新增的差异：编辑页在新增表单基础上，增加了「修改房源类型」入口、套内面积字段，并在基础信息区块展示更多扩展字段；不含"业主/联系人"和"相关方"区块（这两项通过详情页其他入口管理）。Tab 导航简化为：房源核心信息 / 基础信息 / 交易信息。

---

① 房源核心信息-住宅

区块标题右侧显示蓝色「修改房源类型」链接，可切换房源类型（住宅/别墅/商铺等）。

字段	类型	必填	说明
用途	单选	否	住宅：普通住宅 / 花园洋房（各类型差异见 5.3.1）
户型	下拉选择 × 5	是	室 / 厅 / 卫 / 厨 各自独立下拉 + 末位"阳台"标签，数据预填充
建筑面积	数字输入	是	单位：m²，数据预填充
套内面积	数字输入	否	单位：m²，编辑专属字段，新增时不展示

状态、房源属性、小区名称、户室号、楼层、售/租价等字段通过详情页顶部浮窗快捷编辑（参见 5.2.0.1、5.2.0.2、5.2.1.x），不在编辑页重复展示。

---

② 基础信息

编辑页在新增基础上，额外展示以下扩展字段：

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

---

③ 交易信息

字段	类型	必填	枚举值 / 说明
产权年限	单选	否	40年 / 50年 / 70年 / 永久产权 / 其他
产权性质	单选	否	商品房 / 房改房 / 集资房 / 经济活用房
房本年限	下拉 + 下拉	是	左侧"具体年限"（如：不满2年/满2年/满5年等）+ 右侧辅助下拉（如：满五）
唯一住房	单选	否	唯一 / 不唯一
购房付款方式	单选	否	一次付清 / 按揭付款 / 分批次付款 / 垫资解按
包税费	单选	否	各付 / 到手 / 包税
抵押	单选	否	有 / 无
贷款	单选	否	有 / 无
查封	单选	否	有 / 无
限制	单选	否	有 / 无
原购价	数字输入	否	单位：万，输入框右侧显示固定单位标签

---

全局交互规则：

• 页面底部固定显示「保存」（橙色主按钮）和「取消」按钮
• 保存时对所有必填字段整体校验，未通过高亮红框并滚动至第一个错误处
• 保存成功后返回该房源详情页，详情页信息即时刷新
• 点击「修改房源类型」弹出类型选择器，切换类型后表单字段动态重新渲染，已填数据中通用字段保留，差异字段清空
• 点击「取消」时提示"是否放弃当前修改内容"，确认后返回详情页不保存

---

5.2.1 核心信息浮窗快捷编辑

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

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

---

5.2.1.1 调价（编辑房源价格）

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

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

浮窗字段：

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

交互规则：

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

---

5.2.1.2 调价记录

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

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

浮窗内容：

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

交互规则：

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

---

5.2.1.3 编辑交易信息

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

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

浮窗字段：

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

交互规则：

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

---

5.2.1.4 更改房源等级

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

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

浮窗字段：

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

交互规则：

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

---

5.2.1.5 更改房源属性

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

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

浮窗字段：

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

交互规则：

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

---

5.2.1.6 更改房屋现状

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

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

浮窗字段：

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

交互规则：

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

---

5.2.1.7 更改房源用途

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

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

浮窗字段：

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

交互规则：

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

---

5.2.1.8 看房时间

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

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

浮窗字段：

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

交互规则：

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

---

5.2.1.9 挂牌历史记录

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

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

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

每条挂牌记录字段：

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

交互规则：

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

---

5.2.1.10 快捷编辑功能汇总

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

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

---

5.2.2 跟进管理

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

所有 Tab 共用以下通用设计：

• 时间线布局：按日期分组（日期为橙色圆点 + 日期文字），同日记录依时间倒序排列
• 每条记录右侧提供公开/隐藏切换操作（控制该条记录在团队内的可见性）
• 顶部显示智能总结入口横幅（AI 功能，快速了解近期跟进关键内容，属增值功能）
• 底部提供"查看全部跟进"按钮（部分 Tab 默认仅展示最近若干条）

---

5.2.2.1 全部

功能说明：聚合展示该房源所有类型的跟进记录，是最完整的视图。

过滤器（位于 Tab 内容区顶部）：

• 复选框过滤：有录音 / 有附件

展示的跟进类型标签（方括号标注，以下为从截图归纳的完整枚举）：

跟进类型标签	产生来源	说明示例
【查看号码】	敏感信息查看	经纪人查看业主电话号码，自动记录
【图片下载】	其他跟进	经纪人下载了房源图片，自动记录
【查看隐号业主】	敏感信息查看	经纪人查看业主隐号信息，自动记录
【编辑房源】	修改跟进	房源字段被修改，自动记录变更前后值
【房源置顶】	修改跟进	房源被设置为置顶，记录置顶期限及理由
【房源相关方保护/未保护】	敏感信息跟进	相关方保护状态变更，system 自动记录
【修改相关方】	修改跟进	手动修改出售方等相关方信息
【改状态】	修改跟进	房源状态变更记录
【改价格】	修改跟进	调价记录（含调价前后值）
【改等级】	修改跟进	等级变更（含系统自动修改）
【修改】	修改跟进	其他信息修改（如联系人电话变更）
【完善相册】	修改跟进	图片编辑/上传操作记录
跟进-电话	写入跟进	经纪人主动写入，跟进目的为电话
跟进-业主跟进	写入跟进	经纪人主动写入，跟进目的为业主跟进
跟进-议价	写入跟进	经纪人主动写入，跟进目的为议价

交互规则：

• 所有类型的跟进记录均展示于此 Tab，不做类型过滤
• 支持通过"有录音"、"有附件"复选框快速过滤含特定附属内容的记录
• 每条记录显示：类型标签 + 操作人（[角色]姓名 门店-组别）+ 时间戳 + 内容摘要 + 右侧"公开/隐藏"操作

---

5.2.2.2 写入跟进

功能说明：仅展示经纪人主动写入的跟进记录（区别于系统自动生成的修改/敏感类日志）。

过滤器（位于 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.2.2.3 敏感信息跟进

功能说明：展示涉及相关方保护机制的系统自动日志，记录房源相关方（首录方/号码方/出售方等）保护状态的变更。此类日志由系统（system）自动生成，不由经纪人手动写入。

展示的记录类型：

记录标签	触发场景	记录内容示例
【房源相关方未保护】	前一相关方离职或保护期到期，保护自动解除	"【都市港湾店一组 - 史彬彬】未能成为房源【出售方】，原房源下架时间：【2025-06-13 13:47:11】，保护期0天；"
【房源相关方保护】	房源下架后系统自动分配相关方保护	"【都市港湾店一组 - 史彬彬】成为房源【员工】，原房源下架时间：【2025-06-13 13:47:11】；"
【修改相关方】	管理员或行政人员手动修改相关方	"【出售方】由【都市港湾店一组-史彬彬】，修改为【都市港湾店一组-雷威】"
【改状态】	房源状态变更（含相关方保护联动）	"将房源【暂缓】状态，修改为【出售】状态，备注：申请出售"
【改价格】	房源价格调整	"售价：8500000=>7500000；备注：0"

交互规则：

• 此 Tab 无额外过滤器，仅展示敏感信息类系统日志
• 操作人显示为 [初始职务]system 系统管理组 的记录为系统自动生成，不可编辑或删除
• 右侧"公开/隐藏"操作对系统自动日志同样有效，管理员可选择是否对普通经纪人展示

---

5.2.2.4 敏感信息查看

功能说明：专项记录所有查看敏感信息的操作日志，包括查看业主电话号码、查看业主隐号（打码号码解码查看）等。用于合规审计和追溯，防止信息泄露。

过滤器（位于 Tab 内容区顶部）：

• 复选框过滤：查看地址 / 查看号码

展示的记录类型：

记录标签	触发场景
【查看号码】	经纪人点击查看业主电话明文号码
【查看隐号业主】	经纪人查看已被打码的业主联系人信息（解密查看）

每条记录格式：

【查看号码】  [角色]姓名 门店名称-组别  YYYY-MM-DD HH:mm:ss     ⓘ 公开  隐藏

交互规则：

• 每次经纪人点击查看号码或查看隐号业主，系统自动生成一条记录，无需经纪人手动操作
• 记录不可删除（合规要求）
• 可通过"查看地址"/"查看号码"复选框过滤对应类型的查看记录
• 底部提供"查看全部跟进"按钮，跳转至全部 Tab 并应用对应过滤条件

---

5.2.2.5 修改跟进

功能说明：聚合展示所有房源信息变更的操作日志，包括字段修改、状态变更、价格调整、等级调整、相册编辑、置顶操作等。由操作行为自动触发生成，为管理者提供完整的房源信息变更追溯。

展示的记录类型：

记录标签	触发场景	记录格式示例
【编辑房源】	房源字段被修改	"阳台：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.2.2.6 其他跟进

功能说明：展示非写入跟进、非修改、非敏感类的其他自动操作记录，主要包括图片下载等操作日志。同时，此 Tab 内容区底部展示业务信息面板（钥匙 / 委托 / 实勘）的当前状态概览及快捷操作入口。

展示的记录类型：

记录标签	触发场景
【图片下载】	经纪人下载了房源图片，自动记录

业务信息面板（位于此 Tab 跟进记录下方，独立区块）：

此面板为快捷入口，展示三类业务信息的当前状态，并提供操作按钮：

业务项	无记录时展示	操作按钮
钥匙	无钥匙（灰色标签）	钥匙在他司 / 新增钥匙
委托	无委托（灰色标签）	新增委托 / 全部（N）
实勘	无实勘（灰色标签）	新增实勘

交互规则：

• 业务信息面板与跟进日志列表在同一 Tab 页内垂直排列（跟进日志在上，业务信息在下）
• 三项业务信息（钥匙/委托/实勘）均显示当前有效记录状态；若无记录则显示对应灰色"无XX"标签
• 委托旁"全部（N）"链接显示已有委托数量，点击跳转至委托列表

---

5.2.2.7 写跟进（新增跟进浮窗）

入口：房源详情页顶部操作区"写跟进"按钮，或跟进日志区顶部入口

功能说明：跟进功能以浮层（Drawer/Modal）方式呈现，不离开当前页面：

字段	类型	必填	说明
跟进目的	下拉选择	是	电话 / 业主跟进 / 议价 / 带看 / 回访 / 其他等（枚举值由业务运营维护）
跟进内容	文本区域	是	最少 6 字，最多 500 字
附件	文件上传	否	最多 10 张，单张最大 20MB，格式：bmp/jpg/png/svg/gif

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

交互规则：

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

---

5.2.3 业务信息

业务信息包含三类核心业务记录：钥匙管理 / 委托管理 / 实勘管理。入口均在「其他跟进」Tab 下方的业务信息面板（见 5.2.2.6），新增操作均为独立浮窗或独立页面。

---

5.2.3.1 钥匙管理

新增钥匙

入口：其他跟进 Tab → 业务信息面板 → "新增钥匙"按钮

功能说明：经纪人从业主处获取房源钥匙后，在系统中登记钥匙托管信息。托管钥匙是房源维护完成度的重要维度，有助于提升带看便利性。

浮窗字段：

字段	类型	必填	说明
钥匙类型	单选	是	机械锁 / 密码锁
钥匙方	下拉选择	是	选择持有钥匙的经纪人（默认显示当前登录用户），格式：姓名 - 所属组
保管部门	下拉选择	是	钥匙实际存放的部门/门店（联动钥匙方所属组，可单独修改）
上传附件	文件上传	否	上传钥匙相关附件（如钥匙图片、委托书扫描件等）
选择录音	音频上传	否	上传与业主沟通的录音文件
备注	文本区域	否	最多 200 字，补充说明钥匙情况

交互规则：

• 钥匙类型为必填单选，默认无选中
• 钥匙方默认填充当前登录用户，可从下拉中切换为其他经纪人
• 保管部门根据钥匙方自动联动，也可独立选择
• 确认后在业务信息面板"钥匙"一栏展示已登记的钥匙记录（如"机械锁 - 张三 - 都市港湾店一组"）
• 新增钥匙操作自动写入跟进日志（归类至"其他跟进"）

---

备注钥匙在他司

入口：其他跟进 Tab → 业务信息面板 → "钥匙在他司"按钮

功能说明：当业主的钥匙由其他中介公司持有时，经纪人可登记此信息，系统将在房源上标注"钥匙在他司"提示，供其他同事知悉，避免带看时出现钥匙无法获取的情况。

注意事项说明（浮窗内显示）：

1. 备注钥匙在他司信息不生成钥匙方
2. 新增钥匙后将覆盖钥匙在他司信息

浮窗字段：

字段	类型	必填	说明
钥匙在	文本区域	否	输入钥匙所在公司和门店信息，最多 30 字

交互规则：

• 文本框为选填，可为空提交（仅标记"钥匙在他司"状态）
• 确认后业务信息面板"钥匙"一栏显示"钥匙在他司"标记及输入的文本说明
• 当后续通过"新增钥匙"登记己方钥匙后，"钥匙在他司"信息自动被覆盖清除
• 该操作不生成钥匙方记录，不影响房源维护完成度中"钥匙"维度的计分

---

5.2.3.2 委托管理

新增委托

入口：其他跟进 Tab → 业务信息面板 → "新增委托"按钮

功能说明：经纪人与业主签署房源委托协议后，在系统中录入委托信息并上传相关证明文件。委托信息是房源维护完成度的重要权重项（10%），也是合规管理的重要依据。

页面布局：新增委托为独立页面（非浮窗 Modal），包含三个信息区块：

区块一：委托信息

字段	类型	必填	说明
委托类型	下拉选择	是	如：独家委托 / 非独家委托 等（枚举值由业务运营维护）
委托期限	日期区间	是	开始日期（默认今日）- 结束日期（可选"已知结束日期"下拉或手动选择截止时间）
委托方	下拉选择	是	负责该委托的经纪人（默认当前登录用户），格式：姓名 - 所属组

区块二：委托内容

字段	类型	必填	说明
签约方式	下拉选择	是	选择委托签约的方式（选项由业务定义），选择后下方动态展示对应委托书模板
委托书	动态展示	—	根据签约方式自动展示对应委托书内容/模板（"选择签约方式后展示对应内容"）

区块三：委托人（产权信息）

字段	类型	必填	说明
委托人类型	单选	是	产权人本人 / 授权第三方
产权人	下拉选择	是	从业主联系人中选择产权人
产权人姓名	文本输入	是	产权人真实姓名
产权人证件	证件类型下拉 + 证件号文本 + 附件上传	否	证件类型（如：身份证）+ 证件号码 + 上传证件扫描件
房产证	文件上传	否	上传房产证扫描件/照片

区块四：其他

字段	类型	必填	说明
其他资料	文件上传	否	上传其他相关附件（每项附件内容最多可上传 10 个附件）
备注	文本区域	否	最多 200 字

底部操作：

• 提交：保存委托信息
• 取消：返回上一页

交互规则：

• 委托类型、委托期限、委托方、签约方式、委托人类型、产权人、产权人姓名均为必填
• 签约方式选择后，委托书区域动态加载对应模板内容
• 委托人类型选择"授权第三方"时，需额外填写授权人信息
• 每项附件上传最多支持 10 个文件
• 提交成功后跳回房源详情页，业务信息面板"委托"一栏更新状态，"全部（N）"数量+1
• 新增委托操作自动写入跟进日志

---

5.2.3.3 实勘管理

新增实勘

入口：其他跟进 Tab → 业务信息面板 → "新增实勘"按钮

功能说明：经纪人对房源进行实地勘察（简称"实勘"）后，在系统中提交实勘报告，包括实地说明和分类实勘照片。实勘记录是房源维护完成度的核心权重项（16%），也是保障房源信息真实性的关键环节。

页面布局：新增实勘为独立页面（非浮窗 Modal），包含以下区块：

顶部提示区

• 显示实地核验说明：若该小区不支持实地核验，显示"该小区不支持实地核验，无需拍图"

区块一：实勘信息

字段	类型	必填	说明
实勘定位	只读文本/GPS	—	显示"—"表示当前未获取定位（支持 GPS 定位功能）
实勘说明	文本区域	否	最多 200 字，描述实地情况

区块二：实勘相册

实勘照片按空间分类上传，规则如下：

分类	最低上传数量要求	说明
户型图	至少 1 张	必须上传，支持手绘/打印户型图
绘制户型图	—	与户型图并列 Tab，支持手绘上传
客厅	至少 2 张（客厅和餐厅任意上传 2 张即可）	必须上传
餐厅	至少 2 张（客厅和餐厅任意上传 2 张即可）	必须上传（与客厅共享要求）
卧室	至少 2 张	必须上传
卫生间	至少 1 张	必须上传
厨房	至少 1 张	必须上传
玄关	无最低要求	选填
阳台	无最低要求	选填
书房	无最低要求	选填
室内其他	无最低要求	选填
室外	无最低要求	选填

实勘相册顶部辅助功能：

• 图片大小限制：每张最大 20MB
• "VR 一键截图"按钮：快捷从已有 VR 素材截取图片
• "批量上传照片"按钮：支持一次性多选并上传

底部操作：

• 提交实勘：保存并提交实勘记录
• 另存草稿：暂存未完成的实勘，不计入维护完成度
• 取消：返回上一页

交互规则：

• 标有星号（*）的照片分类为必填项（户型图、客厅、餐厅、卧室、卫生间、厨房），未上传时不可提交实勘
• 客厅和餐厅照片数量合并计算，两类合计 ≥ 2 张即满足要求
• 每类照片支持单张点击上传或拖拽上传
• "VR 一键截图"按钮仅在该房源已有 VR 素材时可用，否则置灰
• 提交成功后跳回房源详情页，业务信息面板"实勘"一栏更新状态
• 新增实勘记录后，房源维护完成度"实勘"维度得分更新
• 实勘记录自动写入跟进日志

---

5.2.4 房源信息浮窗快捷编辑

房源详情页除「核心信息」Tab 外，还设有专属的**「房源信息」Tab**，该 Tab 聚合展示与房源物业属性、产权合规、营销文案及楼盘背景相关的信息。这些信息同样支持不离开详情页的浮窗编辑模式，点击对应区块的编辑链接后弹出 Modal 进行更新。

以下为该 Tab 内 4 个浮窗的详细说明。

---

5.2.4.1 编辑基本信息

入口：房源详情「房源信息」Tab → 基本信息区块旁的"编辑"链接触发

功能说明：维护房源的购房条件与来源渠道信息。这些字段对买方决策有重要影响（付款方式影响贷款规划，包税费影响到手成本），同时"来源"字段用于统计各渠道引流效果，辅助运营决策。

浮窗字段：

字段	类型	必填	说明
购房付款方式	单选	否	一次付清 / 按揭付款 / 分批次付款 / 垫资解按
原购价	数字输入	否	单位：万，业主当年购入价格，用于参考增值空间
包税费	单选	否	各付 / 到手 / 包税
来源	下拉选择	否	房源信息来源渠道（如：朋友、自主开发、老客介绍等，枚举值由业务运营维护）

交互规则：

• 所有字段均为选填，可部分填写后保存
• 购房付款方式与包税费均为单选按钮组，默认无选中（或保持原值）
• 原购价输入框右侧显示固定单位"万"
• 来源字段为下拉，截图示例值为"朋友"，下拉枚举值由业务运营侧维护
• 确认后详情页「房源信息」Tab 内对应字段即时更新
• 变更操作写入跟进日志（归类至"修改跟进"，记录变更前后值）

---

5.2.4.2 编辑产证信息

入口：房源详情「房源信息」Tab → 产证信息区块旁的"编辑"链接触发

功能说明：录入和维护房屋产权方的身份信息及产权证明材料。产证信息是房源合规性的核心依据，用于委托签署、过户核验等关键业务环节。与「新增委托」中的产权人信息互为补充，此处为独立的产证档案维护入口。

浮窗字段：

字段	类型	必填	说明
权属方名称	文本输入	否	房屋产权所有人的姓名（可为个人或机构名称）
权属方证件号码	文本输入	否	产权人的身份证号或统一社会信用代码等
权属方证明	下拉选择 + 文本输入	否	左侧下拉：证明类型（如：身份证/护照/营业执照等）；右侧：对应证件号码
房屋坐落	文本区域	否	产权证书上登记的房屋坐落地址描述，最多 50 字（截图显示 0/50 计数器）

交互规则：

• 所有字段均为选填，可部分填写后保存
• 权属方证明为"证件类型下拉 + 证件号文本"组合输入，两者均可独立填写
• 房屋坐落文本区域设有字数计数器，最多 50 字，超出截断并提示
• 确认后详情页「房源信息」Tab 内产证信息区块即时更新
• 产证信息涉及业主隐私，查看权限需与权限模块联动（参见 6.3 待解决问题）
• 变更操作写入跟进日志（归类至"修改跟进"）

---

5.2.4.3 编辑房屋介绍

入口：房源详情「房源信息」Tab → 房屋介绍区块旁的"编辑"链接触发

功能说明：维护面向买方/租客展示的营销文案内容。此浮窗填写的内容会在对外营销分享（如巧客力分享、门户网站展示）时直接呈现给客户，是影响潜在买家第一印象和决策的重要营销素材。浮窗标题区显示蓝色提示："填写的内容，对外营销分享时将展示给客户"。

系统内置 AI 辅助写作功能（"小安帮您写"），降低经纪人文案创作门槛。

浮窗字段：

字段	类型	必填	说明
营销标题	文本输入	否	对外展示的标题，占位提示"建议填写可以吸引人的标题 ~ 必须在10-30个字"，字数限制：10-30字
核心卖点	文本区域 + AI辅助	否	描述该房屋的核心优势，占位提示"建议填写该房屋的核心卖点 ~ 最少20字"，最多 200 字；字段旁提供"小安帮您写"AI一键生成入口
业主心态	文本区域 + AI辅助	否	描述业主出售动机和出售意愿，占位提示"建议填写该房源的业主心态 ~ 最少20个字"，最多 200 字；字段旁提供"小安帮您写"AI一键生成入口
户型介绍	文本区域	否	描述户型格局及装修情况，占位提示"建议填写该房源的户型及装修情况等 ~ "，最多 200 字
小区介绍	文本区域	否	描述小区配套和学区信息，占位提示"建议填写该房源的小区情况及对口学校等 ~ "，最多 200 字

交互规则：

• 所有字段均为选填
• 营销标题字数区间为 10-30 字，低于 10 字或超过 30 字时保存前弹出校验提示（字段为选填，但填写时须满足字数要求）
• 核心卖点和业主心态建议最少 20 字，填写不足时显示黄色引导提示（非强制阻断）
• 核心卖点、业主心态旁"小安帮您写"按钮点击后调用 AI 接口，根据当前房源基本信息自动生成对应文案，填入文本框，经纪人可在生成结果基础上二次编辑
• 每个文本区域右下角显示字数计数器（当前字数 / 最大字数）
• 确认后内容即时更新至「房源信息」Tab 对应展示区，并在对外营销分享时同步生效
• 变更操作写入跟进日志（归类至"修改跟进"）

---

5.2.4.4 编辑楼盘信息

入口：房源详情「房源信息」Tab → 楼盘信息区块旁的"编辑"链接触发

功能说明：维护该房源所在楼盘（小区）的整体物业属性信息。楼盘信息在同一小区的多套房源之间共享，首次填写后若需修改，需前往楼盘管理系统操作（浮窗标题区以蓝色文字提示："楼盘信息首次填写后若要修改请至楼盘管理系统！"）。

此设计保证楼盘基础信息的数据一致性，避免同一小区不同房源下出现矛盾数据。

浮窗字段（左右两列布局）：

字段	类型	必填	单位	说明
产权年限	下拉选择	否	—	40年 / 50年 / 70年 / 永久产权 / 其他（截图示例值为"70年"）
建成年代	数字输入 + 日期图标	否	年	楼盘竣工年份（截图示例值为"2008"），支持日历选择或手动输入
物业公司	文本输入	否	—	物业管理公司名称（截图示例值为"尚博物业"）
物业费	数字输入	否	元/㎡/月	物业管理费标准（截图示例值为"0.00"）
绿化率	数字输入	否	%	小区绿化率（截图示例值为"40"）
容积率	数字输入	否	—	楼盘容积率（截图示例值为"1.76"）

交互规则：

• 浮窗顶部以蓝色文字明确提示"楼盘信息首次填写后若要修改请至楼盘管理系统！"，告知经纪人数据归属权
• 所有字段均为选填，可部分填写后保存
• 产权年限为下拉选择，枚举值与新增/编辑房源表单中"产权年限"字段保持一致
• 建成年代字段支持日历图标点击弹出年份选择器，也可直接键入4位年份数字
• 物业费输入框右侧显示固定单位"元/㎡/月"；绿化率右侧显示"%"
• 首次填写：经纪人可直接在浮窗内填写并确认，数据同步更新至楼盘库
• 再次修改：浮窗内各字段置灰不可编辑（或显示只读状态），需跳转至楼盘管理系统操作
• 确认后详情页「房源信息」Tab 内楼盘信息区块即时更新
• 楼盘信息变更操作写入跟进日志（归类至"修改跟进"）

---

5.2.5 相关员工

📌 占位章节：展示与该房源关联的员工信息（如首录方、号码方、出售方、跟进人等），支持查看各角色负责人及其联系方式。详细交互规则待补充。

---

5.2.6 相册信息 图片管理

5.2.6.1 图片分类体系

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

5.2.6.2 图片操作

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

---

5.2.7 附件信息

5.2.7.1 附件分类体系

分类	说明
全部	显示所有分类的附件，Tab 上展示总数量
身份证	业主身份证扫描件/照片
房产证	房产证/不动产权证书扫描件
委托书	业主委托授权书扫描件
其他	合同、协议等其他相关文件

• 每个分类 Tab 右侧括号内实时显示该分类附件数量（如"身份证 (0)"）
• 默认选中「全部」Tab，切换 Tab 时列表内容随之筛选

5.2.7.2 附件操作

• 上传：点击「上传附件」按钮触发文件选择，支持批量上传；上传时或上传后可选择所属分类
• 批量修改类别：勾选多个附件后，点击「批量修改类别」下拉按钮，统一变更附件分类
• 批量下载：勾选多个附件后，点击「批量下载」，将所选附件打包下载至本地
• 空状态：当前分类下无附件时，展示空状态图示及"暂无附件"文案

---

5.2.8 业主联系人

功能说明：展示和管理与该房源关联的全部业主及联系人信息，支持在详情页右侧面板直接发起新增、编辑等浮窗操作，无需离开当前页面。

---

5.2.8.1 新增业主/联系人

入口：详情页右侧"业主/联系人"区块 → "新增联系人"按钮触发浮窗

功能说明：为当前房源新增一位业主或相关联系人，记录其身份角色和联系方式，用于后续跟进沟通及合规管理。

浮窗标题：新增业主/联系人

浮窗字段：

字段	类型	必填	说明
姓名	文本输入	是	联系人真实姓名，placeholder："请输入"
性别	单选	是	先生 / 女士，默认选中"先生"
身份	单选	是	业主 / 联系人 / 二房东 / 租客 / 代理人 / 企业法人，默认选中"联系人"
电话1	文本输入	是	手机号或座机（座机需写区号），placeholder："手机号/座机需要写区号"
电话2	文本输入	否	备用联系电话，格式同电话1
微信	文本输入	否	微信号，placeholder："请输入"
QQ	文本输入	否	QQ号，placeholder："请输入"
备注	文本区域	否	补充说明，可拖拽调整高度，placeholder："请输入"
修改号码相关方	复选框	否	勾选后申请将此联系人设为号码方；勾选后显示说明文字："申请修改将触发审批流，审批通过可成为号码方"

交互规则：

• 姓名、性别、身份、电话1 为必填，未填写时点击确定触发红色错误提示
• 电话1 须通过手机号/座机格式校验（座机格式：区号-号码）
• 身份默认选中"联系人"，可切换为其他角色
• "修改号码相关方"复选框默认未勾选；勾选后在复选框下方展示灰色说明文字："申请修改将触发审批流，审批通过可成为号码方"
• 勾选"修改号码相关方"后提交，系统自动发起审批流程，审批通过后该联系人成为房源号码方
• 点击确定保存成功后，右侧"业主/联系人"面板即时刷新，新增联系人出现在列表中
• 新增联系人操作写入跟进日志（归类至"其他跟进"）

---

5.2.8.2 编辑业主/联系人

入口：详情页右侧"业主/联系人"区块 → 对应联系人卡片的"编辑"按钮触发浮窗

功能说明：修改已有业主或联系人的基本信息及联系方式。与新增浮窗的核心差异在于：电话号码默认打码展示以保护隐私，需主动点击"查看号码"后方可查看并编辑；微信/QQ 无数据时以"-"展示而非空输入框；浮窗不包含"修改号码相关方"复选框。

浮窗标题：编辑业主/联系人

浮窗字段：

字段	类型	必填	说明
姓名	文本输入	是	回填已保存姓名，可直接编辑（示例："方叔叔"）
性别	单选	是	先生 / 女士，回填已保存值
身份	单选	是	业主 / 联系人 / 二房东 / 租客 / 代理人 / 企业法人，回填已保存值
电话1	只读文本（默认打码）	是	默认显示打码号码（如 021******03），需点击右上角"查看号码"后方可查看完整号码并进入可编辑状态
电话2	只读文本（默认打码）	否	同电话1，有数据时打码展示（如 177******03），无数据时不展示
微信	只读文本	否	有数据时展示值，无数据时显示"-"
QQ	只读文本	否	有数据时展示值，无数据时显示"-"
备注	文本区域	否	回填已保存备注，可编辑；无数据时显示 placeholder "请输入"

查看号码功能：

浮窗右上角（身份字段行末）显示蓝色文字链接"查看号码"及说明图标（ℹ️）：

• 点击"查看号码"后，电话1、电话2 字段从只读打码状态切换为可编辑的明文输入框
• 查看号码操作触发系统自动生成"敏感信息查看"跟进日志记录，不可手动删除

交互规则：

• 浮窗打开时，姓名、性别、身份自动回填已保存值，可直接修改
• 电话1、电话2 默认以打码形式只读展示，不可直接编辑
• 点击"查看号码"后，电话字段切换为可编辑明文输入框，同时系统写入"敏感信息查看"日志
• 姓名、性别、身份、电话1 为必填，保存前进行格式校验（电话1 须为有效手机号或含区号座机格式）
• 微信、QQ 无数据时仅展示"-"，点击"查看号码"后这两个字段同步切换为可编辑输入框
• 编辑浮窗不含"修改号码相关方"复选框（号码相关方变更通过其他专项流程处理）
• 点击确定保存后，右侧面板对应联系人卡片信息即时更新
• 编辑操作写入跟进日志（归类至"修改跟进"）

---

5.2.8.3 查看同业主房源

入口：详情页右侧"业主/联系人"区块 → 提示条"查看房源"链接触发浮窗

触发条件：系统识别到当前房源的业主（依据业主姓名+电话匹配）名下还登记有其他房源时，在"业主/联系人"区块顶部展示提示条：

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

浮窗标题：同业主房源（副标题灰色小字："房源详情提示条存在缓存，以本页面数据为准"）

浮窗字段：

字段	说明
业主	浮窗顶部下拉选择器；当业主有多个关联联系人时，可切换业主后刷新列表
房源名称	可点击跳转至对应房源详情页
状态	当前交易状态（如：出售、暂缓、成交等）
城区商圈	房源所在区域及商圈
房型	户型描述（如：3室2厅）
面积（m²）	建筑面积
售价（万）	出售价格，无售价时显示"—"
租价（元/月）	出租价格，无租价时显示"—"

交互规则：

• 弹窗顶部"业主"下拉选择器默认展示当前房源的第一位业主，列表内容随选中业主实时刷新
• 仅当业主名下有多个关联联系人时，才显示业主下拉选择器；只有一位时无需展示下拉
• 房源列表无数据时，展示"暂无数据"空状态
• 列表区域支持横向滚动（字段列数较多时）
• 点击房源名称直接跳转至对应房源详情页，当前浮窗关闭

---

5.2.9 房屋维护完成度

📌 占位章节：展示房源信息的完整度评分或维护进度，引导经纪人补全关键信息以提升营销效果。详细字段与交互规则待补充。

---

5.3 新增房源

入口：房源列表页右上角「新增房源」按钮 → 选择房源类型 → 进入对应录入表单

系统支持 6 种房源类型，各类型共享相同的表单框架（分区块 Tab 导航），但部分字段存在差异。按业务重要性排序如下：

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

P2 类型在 v1 中不开发，入口预留占位，选择后 Toast 提示"该房源类型即将上线，敬请期待"。

---

表单页面结构：以「新增住宅」为标准，表单采用分区块竖向布局，顶部固定 Tab 锚点导航（房源核心信息 / 业主联系人 / 基础信息 / 交易信息 / 相关方），各区块依次排列，滚动时锚点高亮跟随。

---

① 房源核心信息

字段	类型	必填	枚举值 / 说明
状态	单选	是	出售 / 出租 / 租售 / 暂缓（默认选中"出售"）
房源属性	单选	是	公盘 / 私盘（默认选中"公盘"）
用途	单选	否	住宅：普通住宅 / 花园洋房（各类型差异见 5.3.1）
小区名称	文本输入	是	支持联想搜索楼盘库，占位提示"请输入小区名称"
户室号	三段文本输入	否	栋/幢/弄/胡同 + 单元/号 + 门牌/室号，三个输入框并排
所在楼层	数字输入 × 2	是	「所在楼层」输入框 + "楼，共" + 「总楼层」输入框 + "层"；两者均必填，未填时显示红色提示文案
户型	下拉选择 × 5	是	室 / 厅 / 卫 / 厨 各自独立下拉，末位"阳台"为固定文本标签（各类型差异见 5.3.1）
建筑面积	数字输入	是	单位：m²，输入框右侧显示固定单位
售价	数字输入	条件必填	状态含"出售/租售"时显示，单位：万
租价	数字输入	条件必填	状态含"出租/租售"时显示，单位：元/月

交互规则：

• 状态选"出售"时仅显示售价字段；选"出租"时仅显示租价字段；选"租售"时两者均显示；选"暂缓"时两者均隐藏
• 所在楼层与总楼层均为必填，提交时校验；未填时字段框变红并显示提示文字（截图可见"请输入所在楼层"、"请输入总楼层"）
• 小区名称输入时调用楼盘联想接口，选中楼盘后自动回填楼盘关联信息

---

② 业主/联系人

支持录入一个或多个联系人，默认展示"业主/联系人1"卡片。

字段	类型	必填	说明
姓名	文本输入	是	占位提示"请输入"
性别	单选	是	先生 / 女士（默认选中"先生"）
身份	下拉选择	是	默认值"业主"，可选：业主 / 联系人 / 委托人等
电话1	文本输入	否	占位提示"手机号或座机号，座机号需要写区号"
电话2	文本输入	否	同上，备用号码

交互规则：

• 点击"＋ 添加联系人"追加新联系人卡片，卡片标题递增（业主/联系人2、3……）
• 每个联系人卡片可独立填写，支持删除（第1个不可删除）
• 姓名为必填，提交时校验

---

③ 基础信息

字段	类型	必填	枚举值 / 说明
朝向	单选	是	东 / 南 / 西 / 北 / 东南 / 东北 / 东西 / 南北 / 西北 / 西南（10个选项，两行排列）
装修	单选	是	毛坯 / 清水 / 简装 / 中装 / 精装 / 豪装

交互规则：

• 朝向与装修均为必填单选，提交时校验
• 新增表单仅展示上述两个必填字段；电梯、建成年代、学校、看房时间、房屋现状、来源、售房原因、房源备注等扩展字段在编辑房源时展示（见 5.2.0.3）

---

④ 交易信息

并非所有类型都有此区块，详见 5.3.1。

字段	类型	必填	说明
房本年限	下拉 + 下拉	是	左侧"具体年限"下拉（如：不满2年/满2年/满5年等）+ 右侧辅助下拉（如：请选择）

交互规则：

• 住宅、别墅、其他类型显示此区块；商铺、写字楼不显示；商住仅显示房本年限字段
• 房本年限为必填，两个下拉均需选择

---

⑤ 相关方

字段	类型	必填	说明
首录方	只读文本	—	自动填入当前登录用户 + 所属组（如"杜利强 - 系统管理组"），不可修改
号码方	可编辑选择	是	默认为当前用户，可修改；右侧显示清除按钮（⊗）
出售方	可编辑选择	是	默认为当前用户，可修改；右侧显示清除按钮（⊗）

交互规则：

• 首录方自动填充，灰色只读样式，不可编辑
• 号码方、出售方默认填入当前用户，支持点击修改（选择其他员工）
• 点击清除按钮（⊗）可清空号码方/出售方重新选择

---

全局交互规则：

• 页面顶部显示面包屑导航：房源 / 二手/租赁 / 新增房源
• 表单提交时，对所有必填字段进行整体校验，未通过的字段高亮红框并滚动至第一个错误处
• 提交成功后跳转至新创建的房源详情页
• 不存在"保存草稿"功能，离开页面时提示"是否放弃当前填写内容"

---

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

以下以「新增住宅」为基准，仅列出各类型与住宅的差异字段或差异规则。

---

① 别墅（P1 — v1 上线）

表单区块：房源核心信息 / 业主联系人 / 基础信息 / 交易信息 / 相关方（与住宅完全一致）

差异字段	住宅	别墅
用途	普通住宅 / 花园洋房	联排别墅 / 独栋别墅 / 双拼别墅 / 叠加别墅
其他所有字段	—	与住宅完全相同

---

② 商住（P2 — v2 排期）

表单区块：房源核心信息 / 业主联系人 / 基础信息 / 交易信息 / 相关方

差异字段	住宅	商住
用途	普通住宅 / 花园洋房	字段保留，选项为空（无可选项，待定）
交易信息	完整（房本年限等）	仅保留「房本年限」字段，其余不展示
户型	✅	✅（与住宅一致）

---

③ 商铺（P2 — v2 排期）

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

差异字段	住宅	商铺
用途	普通住宅 / 花园洋房	字段行保留但无可选项（空白）
户型	✅（室/厅/卫/厨/阳台）	❌ 无户型字段
开间	❌	✅ 数字输入，单位：米
进深	❌	✅ 数字输入，单位：米
层高	❌	✅ 数字输入，单位：米
位置	❌	✅ 单选必填：临街 / 商场 / 小区 / 底商 / 商业综合体
交易信息	✅	❌ 整个区块不展示

---

④ 写字楼（P2 — v2 排期）

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

差异字段	住宅	写字楼
用途	普通住宅 / 花园洋房	字段保留，选项为空（待定）
户型	✅（室/厅/卫/厨/阳台）	❌ 无户型字段
交易信息	✅	❌ 整个区块不展示
其他字段	—	与住宅一致（楼层/建筑面积/售价/朝向/装修等）

---

⑤ 其他（P2 — v2 排期）

表单区块：房源核心信息 / 业主联系人 / 基础信息 / 交易信息 / 相关方（与住宅完全一致）

差异字段	住宅	其他
用途	普通住宅 / 花园洋房	车库 / 车位 / 平房 / 四合院 / 仓库 / 厂房 / 地皮 / 铺厂 / 网点 / 写厂（10个选项，两行排列）
其他所有字段	—	与住宅完全相同（含户型、交易信息等）

---

5.3.2 各房源类型字段对比总览

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

---

5.4 房源状态流转

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

状态说明：

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

---

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/screenshots/房源/

---

5.1 房源列表

截图说明	文件路径
房源列表（出售视图）	Project/fonrey/screenshots/房源/房源列表.png
全部房源视图	Project/fonrey/screenshots/房源/全部房源.png
全部商铺视图	Project/fonrey/screenshots/房源/全部商铺.png
全部写字楼视图	Project/fonrey/screenshots/房源/全部写字楼.png
市场报盘	Project/fonrey/screenshots/房源/市场报盘.png

---

5.2 房源详情（总览）

截图说明	文件路径
房源详情页总览	Project/fonrey/screenshots/房源/房源详情.jpg
房源详情页（核心信息区块）	Project/fonrey/screenshots/房源/房源详情1.png
房源详情页（右侧面板）	Project/fonrey/screenshots/房源/房源详情2.png
房源详情页（Tab 区域）	Project/fonrey/screenshots/房源/房源详情3.png
房源备注	Project/fonrey/screenshots/房源/房源备注.png

---

5.2.0 标题栏浮窗快捷编辑

截图说明	文件路径
编辑栋座单元房号	Project/fonrey/screenshots/房源/编辑房源栋座单元房号.png
房源状态变更	Project/fonrey/screenshots/房源/房源状态变更.png
编辑房源（编辑页面）	Project/fonrey/screenshots/房源/增房/编辑房源.png

---

5.2.1 核心信息浮窗快捷编辑

截图说明	文件路径
调价（编辑房源价格）	Project/fonrey/screenshots/房源/调价.png
调价记录	Project/fonrey/screenshots/房源/调价记录.png
编辑交易信息	Project/fonrey/screenshots/房源/编辑交易信息.png
更改房源等级	Project/fonrey/screenshots/房源/更改房源等级.png
更改房源属性	Project/fonrey/screenshots/房源/更改房源属性.png
更改房屋现状	Project/fonrey/screenshots/房源/更改房屋现状.png
更改房源用途	Project/fonrey/screenshots/房源/更改房源用途.png
看房时间	Project/fonrey/screenshots/房源/看房时间.png
挂牌历史记录	Project/fonrey/screenshots/房源/挂牌历史记录.png
价格解读	Project/fonrey/screenshots/房源/价格解读.png

---

5.2.2 跟进管理

截图说明	文件路径
跟进管理-全部 Tab	Project/fonrey/screenshots/房源/跟进管理/全部.png
跟进管理-写入跟进 Tab	Project/fonrey/screenshots/房源/跟进管理/写入跟进.png
跟进管理-敏感信息跟进 Tab	Project/fonrey/screenshots/房源/跟进管理/敏感信息跟进.png
跟进管理-敏感信息查看 Tab	Project/fonrey/screenshots/房源/跟进管理/敏感信息查看.png
跟进管理-修改跟进 Tab	Project/fonrey/screenshots/房源/跟进管理/修改跟进.png
跟进管理-其他跟进（含业务信息面板）	Project/fonrey/screenshots/房源/跟进管理/其他跟进.png
写跟进浮窗	Project/fonrey/screenshots/房源/增房/写跟进.png

---

5.2.3 业务信息（钥匙 / 委托 / 实勘）

截图说明	文件路径
新增钥匙	Project/fonrey/screenshots/房源/跟进管理/新增钥匙.png
备注钥匙在他司	Project/fonrey/screenshots/房源/跟进管理/钥匙在他司.png
新增委托	Project/fonrey/screenshots/房源/跟进管理/新增委托.png
新增实勘	Project/fonrey/screenshots/房源/跟进管理/新增实勘.png

---

5.2.4 房源信息 Tab 浮窗编辑

截图说明	文件路径
编辑基本信息	Project/fonrey/screenshots/房源/编辑基本信息.png
编辑产证信息	Project/fonrey/screenshots/房源/编辑产证信息.png
编辑房屋介绍	Project/fonrey/screenshots/房源/编辑房屋介绍.png
编辑楼盘信息	Project/fonrey/screenshots/房源/编辑楼盘信息.png

---

5.2.7 附件信息

截图说明	文件路径
附件信息（空状态）	Project/fonrey/screenshots/房源/附件信息.png

---

5.2.8 业主联系人

截图说明	文件路径
新增业主/联系人浮窗	Project/fonrey/screenshots/房源/新增业主联系人.png
编辑业主/联系人浮窗	Project/fonrey/screenshots/房源/编辑业主联系人.png
查看同业主房源浮窗	Project/fonrey/screenshots/房源/查看同业主房源.png

---

5.3 新增房源

截图说明	文件路径
新增住宅表单	Project/fonrey/screenshots/房源/增房/新增住宅.png
新增别墅表单	Project/fonrey/screenshots/房源/增房/新增别墅.png
新增商铺表单	Project/fonrey/screenshots/房源/增房/新增商铺.png
新增商住表单	Project/fonrey/screenshots/房源/增房/新增商住.png
新增写字楼表单	Project/fonrey/screenshots/房源/增房/新增写字楼.png
新增其他类型表单	Project/fonrey/screenshots/房源/增房/新增其他.png
新增房源-上传图片	Project/fonrey/screenshots/房源/增房/上传图片.png

---

小区 / 楼盘管理（关联模块参考）

截图说明	文件路径
楼盘管理列表	Project/fonrey/screenshots/房源/小区/楼盘管理/楼盘管理.jpg
楼盘信息详情	Project/fonrey/screenshots/房源/小区/楼盘管理/楼盘信息.png
楼栋管理	Project/fonrey/screenshots/房源/小区/楼盘管理/楼栋管理.png
区域管理	Project/fonrey/screenshots/房源/小区/楼盘管理/区域管理.png
商圈管理	Project/fonrey/screenshots/房源/小区/楼盘管理/商圈管理.png
编辑商圈	Project/fonrey/screenshots/房源/小区/楼盘管理/编辑商圈.png
学校管理	Project/fonrey/screenshots/房源/小区/楼盘管理/学校管理.png
编辑学校	Project/fonrey/screenshots/房源/小区/楼盘管理/编辑学校.png
查看关联	Project/fonrey/screenshots/房源/小区/楼盘管理/查看关联.png
应用数据管理	Project/fonrey/screenshots/房源/小区/楼盘管理/应用数据管理.jpg