# Fonrey 房睿 — MVP 范围书

**Status**: Draft  
**Author**: Product Team  
**Last Updated**: 2026-04-24  
**Version**: 1.0

> **For AI assistants**: 本文件定义 Phase 1（MVP）的边界。在任何功能实现前，先对照本文确认是否在范围内。范围外的功能禁止在 MVP 阶段实现。

---

## 1. 产品背景与目标

**Fonrey（房睿）** 是一套面向中小型房产经纪公司的 B2B SaaS 管理平台，解决以下核心痛点：

- 房源/客源信息散乱，全靠人工记录
- 跟进记录缺失，数据流失严重
- 重复录入浪费大量经纪人时间
- 无法支撑 89,000+ 数据量级下的高效房客匹配

**MVP 目标**：在一家种子客户（单租户）环境下，完整跑通"录入房源 → 录入客源 → 匹配带看 → 成交"的核心业务链路。

---

## 2. MVP 核心功能清单（Phase 1 必须实现）

### 2.1 优先级定义

| 优先级 | 含义 |
|--------|------|
| **P0** | MVP 上线前必须完成，阻断核心业务链路 |
| **P1** | MVP 上线后第一个迭代周期内完成 |
| **P2** | 已规划，列入路线图但不阻断上线 |

---

### 2.2 模块优先级矩阵

#### 🏠 房源管理

| 功能 | 优先级 | 说明 |
|------|--------|------|
| 录入住宅（二手出售/出租） | **P0** | 核心业务入口 |
| 房源列表（二手&租赁） | **P0** | 含筛选、排序、分页 |
| 房源详情页 | **P0** | 含基本信息、产证、交易信息展示 |
| 跟进记录（全部/写入/修改/其他） | **P0** | 含钥匙、委托、实勘 |
| 图片管理（相册上传/分类/排序） | **P0** | 核心房源内容 |
| 业主联系人管理 | **P0** | 含新增/编辑/查看同业主房源 |
| 价格调整（调价/调价记录） | **P0** | 核心运营操作 |
| 房源状态变更（在售/暂缓/成交/下架） | **P0** | 状态机核心 |
| 房源维护完成度（诊断面板） | **P1** | 提升数据质量 |
| 敏感信息跟进（查看权限控制） | **P1** | 需配合权限模块 |
| 附件管理 | **P1** | 非阻断性 |
| 市场报盘 | **P1** | 运营辅助功能 |
| 价格解读 | **P1** | 分析辅助 |
| 录入别墅/商铺/商住/写字楼/其他 | **P2** | 住宅优先，商业类低频 |
| 全部商铺列表 / 全部写字楼列表 | **P2** | 配合 P2 录入功能 |
| 房源广场 | **P2** | 跨租户/公共池功能 |

#### 🏙️ 楼盘管理

| 功能 | 优先级 | 说明 |
|------|--------|------|
| 楼盘列表 + 楼盘详情（楼盘信息/楼栋/结构） | **P0** | 房源数据底座，必须先行 |
| 区域管理（城区/商圈） | **P0** | 房源关联必须 |
| 楼盘照片管理 | **P1** | 数据完善 |
| 楼盘价格走势 | **P1** | 分析辅助 |
| 周边配套（学校管理） | **P1** | 补充信息 |
| 应用数据标准 | **P2** | 明确不做 |

#### 👥 客源管理

| 功能 | 优先级 | 说明 |
|------|--------|------|
| 录入私客（求购/求租） | **P0** | 核心业务 |
| 私客列表（全部/求购/求租） | **P0** | 含筛选、排序 |
| 私客详情（基本信息/需求信息） | **P0** | |
| 跟进记录（全部/写入/修改/其他） | **P0** | |
| 带看管理（预约带看/新增带看） | **P0** | 房客匹配核心 |
| 联系人管理 | **P0** | |
| 客源状态变更（改等级/改状态） | **P0** | |
| 转公客 / 转成交 / 转无效 | **P0** | 生命周期核心 |
| 二手配房（智能匹配） | **P1** | 核心价值，但可后续迭代 |
| 客源解读 | **P1** | AI 辅助分析 |
| 客源信息概览 | **P1** | 汇总视图 |
| 客源收藏夹 | **P1** | 辅助功能 |
| 公客管理 | **P2** | 私客优先 |
| 成交客管理 | **P2** | |
| 暂缓私客 | **P2** | |

#### 🏢 组织人事

| 功能 | 优先级 | 说明 |
|------|--------|------|
| 公司组织结构（部门/门店树） | **P0** | 权限系统基础 |
| 员工列表/员工详情 | **P0** | |
| 员工入职/账号创建 | **P0** | |
| 员工离职 / 调动 | **P1** | |
| 员工通讯录 | **P1** | |
| 异动记录 | **P1** | |
| 奖惩记录 | **P2** | |
| 职务管理 | **P1** | |
| 门店分布地图 | **P2** | |

#### 🔐 权限管理

| 功能 | 优先级 | 说明 |
|------|--------|------|
| 角色管理（预设角色 + 自定义角色） | **P0** | 权限基础 |
| 人员权限列表 | **P0** | |
| 角色批量分配 | **P0** | |
| 功能权限（菜单级） | **P0** | |
| 数据权限（部门/个人/全司） | **P0** | |
| 字段级权限（敏感字段可见性） | **P1** | 配合房源/客源敏感信息 |
| 个人特定权限覆盖 | **P1** | |

#### 🔑 用户登录

| 功能 | 优先级 | 说明 |
|------|--------|------|
| 账号密码登录 | **P0** | |
| 多租户识别（子域名/域名） | **P0** | |
| Token 管理 / 会话超时 | **P0** | |
| 短信验证码登录 | **P1** | |
| 密码重置 | **P1** | |
| 记住登录状态 | **P1** | |

#### ⚙️ 系统配置

| 功能 | 优先级 | 说明 |
|------|--------|------|
| 首页设置 | **P1** | |
| 房源设置（字段必填/自定义字段/标签） | **P0** | 影响录入表单 |
| 相关方设置 | **P1** | |
| 客源设置（基本配置/参数配置） | **P1** | |
| 人事OA设置 | **P2** | |
| 交易设置 | **P2** | |
| 财务设置 | **P2** | |
| 合同设置 | **P2** | |

#### 🖥️ 系统管理（运营后台）

| 功能 | 优先级 | 说明 |
|------|--------|------|
| 租户管理（开通/暂停/配置） | **P1** | 单租户种子阶段可手动 |
| 系统健康监控 | **P1** | |
| 操作审计日志 | **P2** | |
| 灰度发布 / 滚动升级 | **P2** | |

#### 💻 客户端发布

| 功能 | 优先级 | 说明 |
|------|--------|------|
| Windows 桌面客户端（内置浏览器） | **P1** | 种子客户使用 Web 端可先行 |
| 自动更新机制 | **P1** | 配合客户端 |

---

## 3. 非目标（Out of Scope — MVP 阶段绝对不做）

以下功能在 MVP 阶段**明确不实现**，AI 生成代码时不得为这些功能预留接口或引入相关依赖：

| 功能 | 原因 |
|------|------|
| 移动端适配 | v2 规划 |
| 新房模块（新房管理/新房设置） | 独立模块，后续版本 |
| 合同管理模块 | 独立模块，后续版本 |
| 财务管理/提成结算 | 独立模块，后续版本 |
| 三网发布（安居客/链家/贝壳对接） | 独立模块，后续版本 |
| 数据报表/行程量化 | 独立模块，后续版本 |
| 在线充值/增值服务 | 独立模块，后续版本 |
| 任务管理（OA任务/入职祝福） | 低优先 |
| 考勤管理 | 独立 HR 模块 |
| 审批流程 | 独立 OA 模块 |
| 智慧大屏 / VR换装 | 增值产品 |
| 房源广场（跨租户公共池） | 多租户复杂场景 |

---

## 4. 用户故事（MVP 核心路径）

### Story 1 — 经纪人录入房源
> As a **一线经纪人**,  
> I want to **快速录入一套二手住宅并上传图片和业主联系方式**,  
> So that **这套房源的信息能被团队所有成员找到和跟进**.

**验收标准**：
- 可在 3 分钟内完成住宅基本信息录入
- 上传图片后自动按分类展示
- 录入后即刻出现在房源列表

---

### Story 2 — 经纪人跟进房源
> As a **一线经纪人**,  
> I want to **对我负责的房源记录每次跟进（面访/电话/钥匙/实勘）**,  
> So that **我的跟进历史有据可查，团队不会重复联系同一业主**.

**验收标准**：
- 跟进记录按时间线倒序展示
- 支持写入跟进、修改跟进、其他跟进（钥匙/委托/实勘）
- 敏感信息跟进只对有权限的人员可见

---

### Story 3 — 经纪人录入客源
> As a **一线经纪人**,  
> I want to **录入意向购房/租房客户并跟进其需求变化**,  
> So that **我能在合适时机将客户与合适房源匹配**.

**验收标准**：
- 区分求购/求租两种意向
- 支持跟进记录
- 可安排带看并记录带看结果

---

### Story 4 — 转成交
> As a **一线经纪人**,  
> I want to **将已达成交易的客源标记为"成交"并关联成交房源**,  
> So that **成交数据进入系统留存，房源状态自动更新**.

**验收标准**：
- 转成交时必须选择关联房源
- 成交后客源状态自动变为"成交客"
- 关联房源状态建议变更为"成交"（可手动确认）

---

### Story 5 — 店长查看团队数据
> As a **门店店长**,  
> I want to **查看本门店所有员工的房源和客源列表**,  
> So that **我能掌握团队整体情况并合理分配资源**.

**验收标准**：
- 数据权限按部门隔离，店长可见本门店数据
- 可筛选查看特定员工的房源/客源
- 无法看到其他门店的数据

---

## 5. MVP 技术边界

| 约束 | 决策 |
|------|------|
| 租户数 | **单租户**种子阶段，多租户架构已就位但不激活多租户切换 UI |
| 数据量 | 目标支撑 **89,000 条**房源，测试阶段以 10,000 条压测 |
| 浏览器支持 | Chrome 最新版 / Edge 最新版，不支持 IE |
| 语言 | 简体中文，不做国际化 |
| 移动端 | **不做**，Web 端 Desktop-first |
| 导出 | Excel/CSV 导出通过 Celery 异步，不超时 |

---

## 6. MVP 交付检查清单

在 MVP 正式上线前，以下项目必须全部勾选：

- [ ] 房源录入（住宅）完整流程可用
- [ ] 房源列表可筛选/排序/分页
- [ ] 客源录入（求购/求租）完整流程可用
- [ ] 带看创建与记录可用
- [ ] 转成交流程可用
- [ ] 楼盘数据可录入（为房源提供底座）
- [ ] 员工账号可创建/分配角色
- [ ] 权限隔离：经纪人只能看自己数据，店长能看本店数据
- [ ] 89,000 条数据量下列表查询 < 2 秒（含索引优化）
- [ ] 图片上传到 Cloudflare R2 可用
- [ ] 多租户 Schema 隔离验证通过

---

## 7. 版本路线图

| 版本 | 目标 | 核心功能 |
|------|------|---------|
| **v0.1 MVP** | 单租户种子验证 | P0 功能全部上线 |
| **v0.2** | 功能完善 | P1 功能上线，开始多租户测试 |
| **v0.3** | 商业化就绪 | Windows 客户端、多租户正式开放、系统配置完善 |
| **v1.0** | 正式发布 | 新房模块、合同/财务模块路线图确认 |