# PRD: 房源管理模块
**状态**: Draft  
**作者**: 产品经理  
**最后更新**: 2026-04-23（v1.2 新增房源详情页浮窗快捷编辑操作说明）  
**版本**: 1.2  
**所属系统**: 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）
- [ ] 跟进记录展示：跟进类型标签 + 内容 + 操作人（姓名+所属门店）+ 时间
- [ ] 跟进日志支持按类型筛选（全部/写入跟进/敏感信息跟进/敏感信息查看/修改跟进/其他跟进）
- [ ] 跟进日志支持关键词搜索 + 操作员筛选 + 日期范围筛选
- [ ] 跟进目的支持按维度统计展示（如：电话 45 次、业主跟进 20 次、回访 1 次）

### 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 跟进管理

#### 5.4.1 写跟进

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

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

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

#### 5.4.2 跟进日志展示

跟进日志以时间线方式展示，每条记录包含：

- **跟进类型标签**：不同颜色区分（如绿色=业主跟进、蓝色=电话、橙色=其他）
- **跟进内容正文**
- **操作信息**：`[角色] 姓名 门店名称-组别 时间`
- **操作菜单**（...）：查看详情/编辑/删除（权限控制）

**跟进过滤 Tab**：
- 全部
- 写入跟进
- 敏感信息跟进
- 敏感信息查看
- 修改跟进
- 其他跟进

---

### 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`