手动更新

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

@@ -1,8 +1,8 @@
 # PRD: 房源管理模块
 **状态**: Draft  
 **作者**: 产品经理  
-**最后更新**: 2026-04-22（v1.1 新增别墅/商铺/商住/写字楼/其他房源类型）  
-**版本**: 1.1  
+**最后更新**: 2026-04-23（v1.2 新增房源详情页浮窗快捷编辑操作说明）  
+**版本**: 1.2  
 **所属系统**: Fonrey 房产经纪管理系统  
 **关联模块**: 客源管理、组织人事管理、权限管理
 
@@ -234,6 +234,302 @@
 
 ---
 
+### 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 新增住宅表单结构
@@ -687,3 +983,16 @@
 - 上传图片：`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`