预约看房 · 产品需求文档（PRD）

---

1. 背景与目标

1.1 背景

租房场景中，用户在线预约看房后，需由平台完成经纪人匹配，再由经纪人确认时间并完成线下带看。现有流程要求：

• 分配经纪人由平台人工完成，经纪人不可自行领取预约。
• 待分配预约对经纪人不可见，仅用户端与平台端可见。
• 用户、平台运营、经纪人分别在不同端协作完成全链路。

1.2 产品目标

1. 用户可在线完成看房预约、进度跟踪、评价与签约入口。
2. 平台可在 PC 端管理预约线索：分配状态、带看状态、评分评价与带看记录查阅。
3. 经纪人在被分配后完成确认带看、签到与带看记录提交。

1.3 成功标准（演示阶段）

2. 角色与端

3. 业务流转图

交互版泳道图见 Cursor Canvas：预约看房业务流转图（booking-role-flow.canvas.tsx）。

下文为文档内嵌的同口径流转说明，可随 PRD 一并评审与归档。

3.1 一句话主链

用户端提交预约 → 平台端手动分配经纪人 → 经纪人端确认带看 → 线下签到带看 → 用户端评价（可发起签约）。

3.2 跨端泳道图（主流程）

flowchart LR
  subgraph U["用户端 · C端"]
    U1[选房预约]
    U2[待分配]
    U3[待看]
    U4[带看中]
    U5[评价 / 已看]
  end

  subgraph P["平台端 · PC"]
    P1[预约看房记录]
    P2[筛选待分配]
    P3[分配页指派经纪人]
    P4[带看已完成可查看带看记录]
  end

  subgraph A["经纪人端 · B端"]
    A1[收到已分配任务]
    A2[详情确认带看]
    A3[到达签到]
    A4[带看记录完成]
  end

  U1 --> U2
  U2 --> P1
  P1 --> P2 --> P3
  P3 --> A1
  A1 --> A2
  A2 --> U3
  U3 --> A3 --> U4
  A3 --> A4 --> U5
  A4 --> P4
    

3.3 主链路步骤（按负责端）

3.4 状态机（系统状态）

stateDiagram-v2
  [*] --> none: 未预约
  none --> pending: 用户提交预约
  pending --> assigned: 平台手动分配
  assigned --> confirmed: 经纪人确认带看
  confirmed --> viewing: 经纪人签到
  viewing --> done: 带看完成
  viewing --> cancelled: 客户未到场
  done --> reviewed: 用户评价
  pending --> cancelled: 用户取消 / 自动超时失效
  assigned --> cancelled: 用户取消 / 自动超时失效
  confirmed --> cancelled: 用户取消 / 自动超时失效
    

3.5 状态对照（三端展示）

3.6 平台端双状态说明

带看状态为「已完成」时：列表展示评分与评价，操作提供「带看记录」弹窗。

3.7 异常支路

本期经纪人端不提供取消预约操作；历史「经纪人取消」态仅作结果展示演示。

flowchart TD
  S[已分配 / 待看] --> C1{用户取消?}
  C1 -->|是| N1[未看·用户取消]
  S --> T{看房日已过24点?}
  T -->|是且未签到| N0[未看·超时失效]
  V[带看记录] --> NS{客户到场?}
  NS -->|否| N3[未看·未到场]
  NS -->|是| D[带看完成]
    

3.8 自动超时失效

针对当天带看订单（预约看房日期为当日），系统在当日 24:00（次日 00:00）自动判定是否失效。

3.8.1 会自动失效的条件（满足任一）

结果统一记为：cancelled，取消类型为超时失效（用户端展示「未看 · 超时失效」；平台分配状态「已取消」）。

3.8.2 不进行自动失效的状态

口径：只要经纪人已提交到场记录（进入 viewing 及之后），不做按日自动失效。付定、成交等节点不单独触发本超时规则。

3.8.3 执行与展示要求

1. 触发时点：以预约看房日期 D 计算，在 D+1 日 00:00 起可扫描处理（或等价定时任务）。
2. 仅处理「预约看房日期 = 当日且跨过 24 点」的订单；非当天预约不按本条提前失效。
3. 进度时间轴写入「超时失效」节点及原因说明（如：当日未分配 / 已分配未到场签到）。
4. 失效后不可再分配、确认带看或签到；用户可重新预约。

3.8.4 超时失效 · 两端页面文案

用户端提示条：「系统已自动关闭本单。如仍需看房，请重新预约。」经纪人端提示条：「系统已自动关闭本单，不可再确认带看或签到。」未分配超时对经纪人不可见。

3.9 用户端 / 经纪人端进度状态一览

3.9.1 用户端进度状态

我的预约列表：异常关闭单不得只显示笼统「未看」，须按取消类型展示上表「列表标签」。

3.9.2 经纪人端进度状态

viewing 及之后状态不进入自动超时；付定审核、成交审核、结束带看等节点不改变超时口径。

3.9.3 详情「进度」时间轴节点（分端）

详情页「进度」时间轴按节点展示标题与内容。用户端与经纪人端数据同源，但展示范围不同：用户端不展示「付定」「成交」进度节点；经纪人端完整展示，且付定 / 成交 / 结束带看 / 客户评价可点开详情（取消单除外）。

用户端进度节点

看房时间按「M月D日 周X」展示；距今天 0～2 天时前加「今天 / 明天 / 后天」，例如 明天 11月5日 周四 14:00-15:00。下表示例按绝对日期书写。

明确不展示：付定、成交（含其审核角标与详情入口）。

经纪人端进度节点（线上预约）

经纪人端进度节点（员工自提）

3.10 多套房源与线下独立节点

3.10.1 多套房源

3.10.2 底部四按钮（互不阻塞）

确认带看后，经纪人详情底部提供四个独立入口：到场、付定、成交、结束带看。任意顺序提交；结束带看不影响到场补签、付定与成交补交。

3.10.3 付定

3.10.4 成交

3.10.5 带看档案（结束带看）

结束带看单独记一笔「带看档案」。档案字段含客户、时间、签到、客户到场、时长、意向、下一步、备注等；不展示房源信息。进度可点开查看档案。

3.10.6 看房评价

评价维度：总体 / 准时 / 专业 / 房源真实、标签、补充文字；只可评价一次。评价页与评价链接页不展示房源信息（可展示经纪人等）。员工自提带看结束后发送评价链接，字段与用户端一致。经纪人端「评价链接已发送」页仅展示客户与手机号等，不展示房源字段。

3.10.7 员工自提带看

经纪人可录入客户手机号自行提交带看。进度时间轴按原节点展示（员工提交带看、看房时间、到场、付定、成交、结束带看、发送评价链接、客户评价等），与线上预约共用线下节点规则。客户评价后，经纪人端可查看「详情 · 客户已评价」及进度详情「客户评价」（评价内容不展示房源）。

3.11 发起签约（按房源合同）

带看完成（done / reviewed）后，用户可在「我的预约」已看卡片或预约详情发起签约。签约以房源为粒度校验合同状态。

3.11.1 按钮展示规则

3.11.2 多套房源选房提交

本期原型为签约入口与合同状态演示，不含完整电子签约后续页；完整签约流程见后续建议。

3.12 预约入口展示（再次预约 / 房源详情预约）

针对某套房源的预约入口（含房源详情「预约看房」、预约页「立即预约」、详情「再次预约这套房 / 重新预约」、评价成功「再约一套时间」等），按下列规则展示或隐藏。判定粒度以目标房源为准（再次预约默认对本单主房源）。

隐藏后不可通过底部入口进入提交；若用户仍进入预约页，提交时同样按上表拦截并提示原因。「上架」「可预约」由房源侧状态提供，本期原型以房源字段演示。

4. 功能需求

4.1 用户端（C 端）

4.1.1 发起预约

4.1.2 我的预约

4.1.3 详情与交互

4.2 平台端（PC）

4.2.1 预约看房记录

4.2.2 带看记录弹窗

4.2.3 分配页

4.3 经纪人端（B 端）

4.3.1 能力与流程

4.3.2 预约详情信息结构

4.3.3 明确不提供（本期剔除）

底栏仅保留：工作台 / 任务 / 我的。

5. 非功能需求

4.4 系统规则 · 自动超时失效

6. 信息架构（页面清单）

6.1 用户端

房源详情 → 预约看房 → 选择时间 → 预约成功 → 我的预约 → 各状态详情 → 评价 / 沟通 / 取消 / 发起签约（多套时选房提交）

6.2 平台端

预约看房记录（含带看状态、评分评价、带看记录弹窗） → 分配经纪人

6.3 经纪人端

工作台 / 带看任务 → 预约详情（确认带看） → 添加房源 / 到场（选房签到） / 付定 / 成交 / 结束带看（带看档案） → 进度详情 → 在线沟通 / 我的 / 员工自提带看

不含：联系客户、确认带看独立页、申请改期、今日行程、待分配详情、取消预约、客户跟进。

7. 验收标准（主链路）

1. 用户提交预约后，用户端与平台端均可见「待分配」；经纪人端不可见该预约。
2. 经纪人端无自行领取能力、无取消预约、无客户跟进页。
3. 平台在记录列表筛选「待分配」，点「分配」进入分配页，确认后：
   • 分配状态变为「已分配」，写入指派人与时间；
   • 用户端展示已分配经纪人信息；
   • 经纪人端工作台/任务出现该单，可在详情确认带看。
4. 经纪人确认带看后：用户端「待看」；平台带看状态「待看」。
5. 签到后：用户端「带看中」；平台带看状态「到场签到」。多套房源到场须先选房；用户详情可见全部房源。
6. 结束后：用户端「已看」并可评价（评价页不展示房源）；平台分配状态仍为「已分配」、带看状态「已完成」，可打开带看记录弹窗；评价维度与用户端一致。
7. 平台分配状态筛选无「已看房」选项。
8. 经纪人预约详情无客户备注、无小区/标签；用户端无见面地点、无服务分/成交、评价页无继续服务开关。
9. 当天待分配订单过 24 点后自动变为「未看·超时失效」；我的预约列表角标同步展示该细分状态。
10. 当天已分配但未提交到场签到（assigned / confirmed）的订单过 24 点后同样超时失效。
11. 已签到及之后状态（viewing / done / reviewed）不因跨日自动失效。
12. 付定须含房源、日期、有效期、图片；成交进度展示成交房源；带看档案不展示房源。
13. 到场 / 付定 / 成交 / 结束带看可独立提交；结束带看不阻断其他节点补交。
14. 签约入口按房源合同状态展示：待签约 / 已签约 / 他人已签不展示；多套房源时选房列表仅含可签约房源，选择后提交。
15. 预约入口：当前用户已签约该房源则隐藏再次预约等入口；未签约时仅上架且可预约的房源展示预约按钮。

8. 本期范围与后续

8.1 本期（已覆盖原型）

• 三端主流程与异常演示（用户取消、经纪人取消、未到场、超时失效）；我的预约列表展示细分未看状态
• 平台手动分配 / 改派；分配状态与带看状态分列
• 平台带看记录弹窗布局与经纪人端详情一致（多套房源列表展示）
• 经纪人：确认带看后四按钮独立提交；多套房源追加与选房到场；付定（含有效期/图片）/ 成交选房 / 带看档案无房源
• 看房评价与评价链接不展示房源信息
• 员工自提带看与评价链接
• 用户端签约入口：合同状态校验、多套房源选房提交（无完整电子签约后续页）
• 预约入口：已签约隐藏；其他情况校验上架 + 可预约
• 当天订单自动超时：未分配，或已分配未到场，过 24 点失效；其他状态不失效

8.2 本期明确剔除

• 联系客户页、确认带看独立页、申请改期、今日行程
• 经纪人待分配态、取消预约、客户跟进
• 详情小区/标签、客户备注、见面地点、服务分/成交
• 评价「愿意继续让该经纪人服务」
• 平台分配状态「已看房」
• 完整电子签约后续页（盖章/支付等）

8.3 后续建议

• 签约完整流程页（待签约合同详情、签署、支付联动）
• 分配规则引擎（片区/负载/在线自动推荐 + 人工确认）
• 分配操作日志（操作人、前后经纪人）
• 消息触达（短信/推送）与超时前提醒催办
• 真实账号权限与数据权限

9. 附录

9.1 术语

9.2 关联产物

9.3 修订记录