Workspace sync: auto commit 2026-04-23 08:25:18

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

@@ -1,8 +1,8 @@
 # PRD: 房源管理模块
 **状态**: Draft  
 **作者**: 产品经理  
-**最后更新**: 2026-04-23（v1.6 重写 5.3 新增房源：基于截图完整描述住宅表单5个区块字段及交互规则；新增 5.3.1 各房源类型差异字段说明、5.3.2 各类型字段对比总览；删除原 5.3.3 房源类型选择入口设计和旧 5.3.2 编辑房源章节）  
-**版本**: 1.6  
+**最后更新**: 2026-04-23（v1.7 重写第 4 章用户故事与验收标准：由原 5 个 Story 扩展为 11 个，全面覆盖房源录入、列表筛选、状态变更、快捷编辑、跟进记录、钥匙/委托管理、实勘提交、同业主房源、图片管理、附件管理、补全详细信息等所有已文档化功能；补充 5.2.7 附件信息完整需求）  
+**版本**: 1.7  
 **所属系统**: Fonrey 房产经纪管理系统  
 **关联模块**: 客源管理、组织人事管理、权限管理
 
@@ -55,69 +55,185 @@
 
 ## 4. 用户故事与验收标准
 
+> **说明**：以下用户故事按核心业务流程顺序排列，覆盖房源管理模块已文档化的全部功能。每条验收标准与第 5 章功能说明对应。
+
+---
+
 ### Story 1：经纪人录入新房源
 
-**As** 一线经纪人，**I want** 快速录入一套新房源的完整信息，**So that** 房源能进入公盘流通、并由系统自动提醒后续跟进。
+**As** 一线经纪人，**I want** 快速录入一套新房源的完整信息，**So that** 房源能进入公盘流通并留存完整的基础数据。
 
 **验收标准**：
-- [ ] 支持选择房源类型（住宅/商业），本期实现住宅类型
-- [ ] 新增住宅表单分为：房源核心信息 / 业主联系人 / 基础信息 / 交易信息 / 相关方，共 5 个区块
-- [ ] 必填项未填写时，点击保存弹出红色错误提示，并定位到第一个未填项
-- [ ] 户型字段支持分别输入：室数、厅数、卫数、厨数、是否有阳台
-- [ ] 楼层填写：所在楼层 + 总楼层，均为数字输入
-- [ ] 保存成功后跳转到该房源详情页，并显示"保存成功"提示
+- [ ] 支持选择 6 种房源类型（住宅、别墅、商铺、商住、写字楼、其他），本期 P0 实现住宅，P1 实现别墅，商业类型低优先级
+- [ ] 新增住宅表单分为 5 个区块（Tab）：房源核心信息 / 业主联系人 / 基础信息 / 交易信息 / 相关方，支持 Tab 顶部导航快速跳转
+- [ ] 必填项未填写时，点击保存弹出红色错误提示并自动滚动定位到第一个未填项
+- [ ] 小区名称支持模糊搜索联想，选中后自动回填楼盘信息
+- [ ] 户型字段支持独立输入：室数、厅数、卫数、厨数，及有/无阳台单选
+- [ ] 楼层填写：当前楼层 + 总楼层，均为正整数，当前楼层不得大于总楼层
+- [ ] 价格填写：出售价格（万元）或出租价格（元/月），依据交易类型动态显示
+- [ ] 业主/联系人区块支持录入姓名、电话（手机号或固话），手机号录入后系统自动校验是否存在重复房源
+- [ ] 相关方区块支持选择：首录经纪人、号码来源经纪人、出售方/实买方经纪人
+- [ ] 保存成功后跳转至该房源详情页，并展示"保存成功"提示
+
+---
 
 ### Story 2：经纪人筛选查找目标房源
 
-**As** 一线经纪人，**I want** 在数万条房源中快速定位到符合客户需求的房源，**So that** 提升匹配推荐效率。
+**As** 一线经纪人，**I want** 在数万条房源中快速定位符合客户需求的房源，**So that** 提升匹配推荐效率、减少无效沟通。
 
 **验收标准**：
-- [ ] 支持关键词搜索（小区名称、地址、业主姓名、电话、钥匙编号等）
-- [ ] 支持多维度组合筛选：范围（最新挂牌/降价/与我相关/我部门相关）、区域（区/地铁）、价格区间、面积区间、户型、楼层、标签、状态/属性、装修/朝向、学校、等级、用途等
-- [ ] 列表支持排序（售价、单价、面积、挂牌日期、最后跟进日期）
-- [ ] 支持切换列表展示与海报展示模式
-- [ ] 已存搜索条件可保存，下次快速调用
-- [ ] 列表底部显示当前筛选总条数，支持分页（每页 20 条，可跳页）
+- [ ] 支持关键词搜索：小区名称、地址、业主姓名、电话、钥匙编号等
+- [ ] 支持多维度组合筛选：
+  - 范围：最新挂牌 / 最新降价 / 与我相关 / 我部门相关
+  - 区域：行政区 / 地铁线路+站点
+  - 价格区间（售价/租价）、面积区间、户型（室/厅/卫）、楼层区间
+  - 状态（出售/出租/暂缓/他售/他租/成交）、属性（公盘/私盘）
+  - 装修情况、朝向、标签、等级、用途、学区
+- [ ] 列表支持按售价、单价、面积、挂牌日期、最后跟进日期排序（升/降序）
+- [ ] 支持在列表视图与海报视图之间切换
+- [ ] 搜索条件可保存为筛选方案，支持快速调用
+- [ ] 列表底部实时显示当前筛选总条数，支持分页（每页 20 条，可跳页）
 - [ ] 支持导出当前筛选结果
+- [ ] 地图视图：在地图上按区域/小区聚合展示房源分布（低优先级，可延后）
 
-### Story 3：经纪人记录房源跟进
+---
 
-**As** 一线经纪人，**I want** 随时记录与业主的沟通内容和带看情况，**So that** 保留完整的房源跟进轨迹，团队协作时不会重复打扰业主。
+### 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 提供"查看地址"/"查看号码"复选框过滤；敏感信息查看记录由系统自动生成，不可删除
+- [ ] 状态变更入口位于详情页顶部操作区"改状态"按钮
+- [ ] 浮窗展示当前状态（只读）和新状态下拉选项，新状态选项依据当前状态动态过滤（如：出售中只能变更为暂缓/他售/成交）
+- [ ] 更改理由为必填文本框，最多 50 字
+- [ ] 确认后列表中该房源状态标签即时更新，并在跟进日志中自动生成状态变更记录
+- [ ] 支持从暂缓/他售/他租状态恢复为出售/出租（重新挂牌）
 
-### Story 4：经纪人查看同业主其他房源
+---
+
+### Story 4：经纪人在详情页快捷编辑房源核心字段
+
+**As** 一线经纪人，**I want** 不离开房源详情页就能直接修改价格、等级、属性、现状、用途等高频字段，**So that** 减少页面跳转，快速响应业主意向变化。
+
+**验收标准**：
+- [ ] 详情页顶部支持快捷编辑栋座单元房号（含更改理由，最多 200 字）
+- [ ] 核心信息区块点击对应字段触发浮窗编辑，支持以下快捷操作：
+  - **调价**：修改出售/出租价格，记录调价原因，历史调价记录可查
+  - **更改等级**：A+/A/B/C/D 五级选择，支持批量修改
+  - **更改属性**：公盘 / 私盘切换，私盘说明必填
+  - **更改房屋现状**：有人居住 / 空置 / 租客居住 / 其他，填写详情
+  - **更改用途**：住宅 / 商住 / 商业等用途切换，需填写更改理由
+  - **设置看房时间**：随时可看 / 提前预约等选项
+- [ ] 每次快捷编辑操作确认后，详情页对应字段即时刷新，并在跟进日志中写入操作记录
+- [ ] 挂牌历史记录可查（价格、状态、操作时间、操作人的完整变更轨迹）
+
+---
+
+### Story 5：经纪人记录房源跟进
+
+**As** 一线经纪人，**I want** 随时记录与业主的沟通内容，**So that** 保留完整的跟进轨迹，团队协作时不会重复打扰业主。
+
+**验收标准**：
+- [ ] 在房源详情页顶部可直接唤起"写跟进"浮层，无需离开当前页面
+- [ ] 跟进目的为必填下拉选项（如：业主跟进、电话沟通、带看、议价等，枚举值由运营维护）
+- [ ] 跟进内容为必填文本框，最少 6 字，最多 500 字
+- [ ] 支持附件上传：最多 10 张图片，每张最大 20MB，支持格式 bmp/jpg/png/svg/gif
+- [ ] 跟进日志以时间线方式展示，按日期分组，每条记录包含：类型标签（颜色区分）+ 内容摘要 + 操作人（[角色] 姓名 + 门店-组别）+ 时间戳
+- [ ] 跟进记录支持"公开/隐藏"切换，控制对团队成员的可见范围
+- [ ] 每条记录右上角"..."菜单支持：查看详情 / 编辑 / 删除（受权限控制）
+- [ ] 跟进日志支持按类型筛选：全部 / 写入跟进 / 敏感信息跟进 / 敏感信息查看 / 修改跟进 / 其他跟进
+- [ ] 跟进日志支持关键词搜索 + 操作员筛选 + 日期范围筛选
+- [ ] 写入跟进 Tab 中，跟进目的统计显示各类型历史次数（如：电话 46 次、业主跟进 41 次）
+- [ ] 写入跟进 Tab 支持 AI 标签筛选（AI-在售 / AI-不售），辅助判断业主出售意向
+- [ ] 敏感信息查看 Tab 提供"查看地址" / "查看号码"复选框过滤；查看记录由系统自动生成，不可手动删除
+
+---
+
+### Story 6：经纪人管理钥匙与委托
+
+**As** 一线经纪人，**I want** 在系统中登记钥匙持有情况和委托协议信息，**So that** 提升房源维护完成度评分，并让团队知悉钥匙状态，避免带看时出现无法入场的情况。
+
+**验收标准**：
+
+**钥匙管理**：
+- [ ] 支持新增钥匙，填写：钥匙类型（机械锁/密码锁）、钥匙方（经纪人）、保管部门，可上传附件和录音
+- [ ] 支持"钥匙在他司"备注，填写他司信息（最多 30 字），不生成钥匙方记录
+- [ ] 新增己方钥匙后，"钥匙在他司"标记自动清除
+- [ ] 新增钥匙操作自动写入跟进日志（归类至"其他跟进"）
+
+**委托管理**：
+- [ ] 支持新增委托（独立页面），填写：委托类型、委托期限（起止日期）、委托方、签约方式
+- [ ] 签约方式选择后，下方自动展示对应委托书模板内容
+- [ ] 委托人（产权信息）区块支持：选择产权人 / 授权第三方，填写产权人姓名、证件信息，上传房产证
+- [ ] 支持上传其他资料（每类附件最多 10 个文件）及备注（最多 200 字）
+- [ ] 提交成功后跳回详情页，业务信息面板"委托"栏状态更新，跟进日志自动写入记录
+
+---
+
+### Story 7：经纪人提交实勘记录
+
+**As** 一线经纪人，**I want** 完成实地勘察后在系统中提交实勘报告和分类照片，**So that** 提升房源维护完成度、保障房源信息真实性，给客户提供更可信的参考依据。
+
+**验收标准**：
+- [ ] 实勘为独立页面，包含：实勘定位（GPS）、实勘说明（最多 200 字）
+- [ ] 实勘相册按空间分类上传，必填分类：户型图（≥1张）、客厅+餐厅合计（≥2张）、卧室（≥2张）、卫生间（≥1张）、厨房（≥1张）；选填：玄关、阳台、书房、室内其他、室外
+- [ ] 必填分类未满足最低数量要求时，不允许点击"提交实勘"
+- [ ] 支持"VR 一键截图"从已有 VR 素材截图（无 VR 素材时按钮置灰）
+- [ ] 支持"另存草稿"，草稿不计入维护完成度
+- [ ] 提交成功后：详情页业务信息面板"实勘"状态更新，房源维护完成度"实勘"维度得分更新，跟进日志自动写入记录
+
+---
+
+### Story 8：经纪人查看同业主其他房源
 
 **As** 一线经纪人，**I want** 在查看某套房源时一键查看该业主名下的其他房源，**So that** 了解业主资产全貌，避免重复打扰、统一谈判。
 
 **验收标准**：
-- [ ] 在房源详情的业主/联系人区块，显示"业主还有其他房源，建议您一起跟进，避免重复打扰"提示
-- [ ] 点击可唤起"同业主房源"弹窗，显示字段：房源名称、状态、城区商圈、房型、面积、售价、租价
-- [ ] 支持选择业主（当业主有多个关联人时）再查询
-- [ ] 弹窗内可点击房源名称直接跳转到对应房源详情
+- [ ] 当业主名下存在其他房源时，详情页右侧业主区块显示提示条："业主还有其他房源，建议您一起跟进，避免重复打扰"
+- [ ] 点击"查看房源"唤起弹窗，展示字段：房源名称（可点击跳转）、状态、城区商圈、房型、面积、售价、租价
+- [ ] 当业主有多个关联联系人时，弹窗顶部提供业主下拉选择器，切换后刷新列表
+- [ ] 弹窗内标注数据来源提示："以本页面数据为准"
 
-### Story 5：经纪人管理房源图片
+---
 
-**As** 一线经纪人，**I want** 为房源上传分类管理的照片并设置封面，**So that** 提升房源展示质量，吸引更多买家/租客关注。
+### Story 9：经纪人管理房源图片
+
+**As** 一线经纪人，**I want** 为房源上传并分类管理照片、设置封面图，**So that** 提升房源展示质量，吸引更多买家/租客关注。
 
 **验收标准**：
-- [ ] 支持图片分类标签：封面、玄关、客厅、餐厅、卧室、卫生间、厨房、阳台、书房、室内其他、室外、全景等
-- [ ] 支持批量上传、批量修改分类、批量删除、批量下载
-- [ ] 支持拖拽排序调整图片顺序
-- [ ] 封面图有显著标识，只能设置一张
-- [ ] 图片显示尺寸规格信息（如 1440×1080）
+- [ ] 支持图片分类：封面（限 1 张）、玄关、客厅、餐厅、卧室、卫生间、厨房、阳台、书房、室内其他、室外、全景
+- [ ] 支持点击上传区域或拖拽批量上传，上传时或上传后可选择/修改分类
+- [ ] 支持批量修改分类、批量删除、批量下载
+- [ ] 支持拖拽调整同类图片顺序（有"点击后可拖拽图片调整排序"操作提示）
+- [ ] 封面图显示"封面"标识标签，同一房源只能设置一张封面图
+
+---
+
+### Story 10：经纪人管理房源附件
+
+**As** 一线经纪人，**I want** 为房源上传并分类管理证件/协议等附件文件，**So that** 将核心证明材料与房源绑定留存，方便后续合规审查和团队共享查阅。
+
+**验收标准**：
+- [ ] 附件分类 Tab 包含：全部 / 身份证 / 房产证 / 委托书 / 其他，每个 Tab 实时显示该分类文件数量
+- [ ] 点击"上传附件"按钮支持批量上传文件，上传时可选择所属分类
+- [ ] 支持批量修改类别（勾选后通过下拉选择统一变更分类）
+- [ ] 支持批量下载（勾选后打包下载至本地）
+- [ ] 当前分类无附件时，展示空状态图示及"暂无附件"文案
+
+---
+
+### Story 11：经纪人补全房源详细信息
+
+**As** 一线经纪人，**I want** 不离开房源详情页补充或修改基本信息、产证信息、房屋介绍和楼盘信息，**So that** 提升房源维护完成度评分，增强房源对买家/租客的吸引力。
+
+**验收标准**：
+- [ ] 「房源信息」Tab 下，以下区块均支持点击"编辑"触发浮窗编辑，无需跳转页面：
+  - **基本信息**：建筑结构、建筑年代、供水/供电/供气/供暖类型、产权年限、用途分类等
+  - **产证信息**：产证状态、产证号、首次登记时间、权属性质、土地性质、是否有抵押等
+  - **房屋介绍**：卖点标题（营销文案）、房源描述（最多 3000 字）
+  - **楼盘信息**：楼盘名称、开发商、物业公司、物业费、车位情况等
+- [ ] 各浮窗保存后，详情页对应区块数据即时刷新
+- [ ] 修改操作自动写入跟进日志（归类至"修改跟进"）
 
 ---
 
@@ -1138,7 +1254,25 @@
 
 ### 5.2.7 附件信息
 
-> 📌 **占位章节**：支持上传和管理与房源相关的附件文件（如委托书扫描件、产证复印件、合同文件等）。详细字段与交互规则待补充。
+#### 5.2.7.1 附件分类体系
+
+| 分类 | 说明 |
+|------|------|
+| 全部 | 显示所有分类的附件，Tab 上展示总数量 |
+| 身份证 | 业主身份证扫描件/照片 |
+| 房产证 | 房产证/不动产权证书扫描件 |
+| 委托书 | 业主委托授权书扫描件 |
+| 其他 | 合同、协议等其他相关文件 |
+
+- 每个分类 Tab 右侧括号内实时显示该分类附件数量（如"身份证 (0)"）
+- 默认选中「全部」Tab，切换 Tab 时列表内容随之筛选
+
+#### 5.2.7.2 附件操作
+
+- **上传**：点击「上传附件」按钮触发文件选择，支持批量上传；上传时或上传后可选择所属分类
+- **批量修改类别**：勾选多个附件后，点击「批量修改类别」下拉按钮，统一变更附件分类
+- **批量下载**：勾选多个附件后，点击「批量下载」，将所选附件打包下载至本地
+- **空状态**：当前分类下无附件时，展示空状态图示及"暂无附件"文案
 
 ---