Auto-sync: 2026-04-23 00:02

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

@@ -1,8 +1,8 @@
 # PRD: 房源管理模块
 **状态**: Draft  
 **作者**: 产品经理  
-**最后更新**: 2026-04-22  
-**版本**: 1.0  
+**最后更新**: 2026-04-22（v1.1 新增别墅/商铺/商住/写字楼/其他房源类型）  
+**版本**: 1.1  
 **所属系统**: Fonrey 房产经纪管理系统  
 **关联模块**: 客源管理、组织人事管理、权限管理
 
@@ -45,7 +45,7 @@
 
 ## 3. 非目标（本期不做）
 
-- 不包含商业地产（商铺、办公室、厂房）房源管理，本期仅覆盖住宅类
+- 商业地产类（商铺、商住、写字楼、其他）房源录入功能为**低优先级**，在住宅类（住宅、别墅）完成并稳定后方可排期开发
 - 不包含地图找房的底层地图服务建设（地图组件集成另行规划）
 - 不包含房源对外门户网站展示（营销推广为独立模块）
 - 不包含 AI 估价引擎的自研（可集成第三方价格解读服务）
@@ -302,6 +302,163 @@
 | 号码方 | 默认为当前用户，可修改 |
 | 出售方 | 默认为当前用户，可修改 |
 
+---
+
+### 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 编辑房源
 
 - 编辑页面结构与新增一致，数据预填充
@@ -521,6 +678,11 @@
 - 房源列表（出售视图）：`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`