准准 - 连麦预约系统 PRD

# 连麦预约系统 产品需求文档 (PRD)

## 1. 需求背景

### 1.1 需求说明

在"准准"产品中，用户与达人（老师）的连麦通话是核心服务。目前存在以下痛点：
1. **达人在连麦中时**，其他用户无法预约，只能等待或寻找其他达人
2. **大R用户（高消费用户）缺乏优先通道**，体验不佳
3. **达人漏接电话后**，缺乏便捷的回拨机制
4. **特殊新用户连麦占用时间**，达人无法及时服务付费用户

本系统旨在为大R用户提供预约通道，优化达人连麦调度，提升整体服务体验。

### 1.2 需求目标

| 指标 | 目标 | 衡量方式 |
|------|------|----------|
| 大R用户连麦成功率 | 提升20% | 预约后成功连麦比例 |
| 大R用户平均等待时间 | 缩短30% | 从预约到连麦的时间 |
| 达人服务效率 | 提升15% | 单位时间内服务用户数 |
| 预约功能使用率 | 大R用户使用率≥40% | 大R用户中点击预约的比例 |

### 1.3 目标用户

| 用户类型 | 用户画像 | 核心诉求 |
|---------|---------|---------|
| 大R用户 | 历史消费金额高，星币余额充足，对服务即时性要求高 | 优先获得老师服务，减少等待时间 |
| 普通用户 | 一般消费用户，可能使用免费连麦分钟数 | 体验连麦服务，寻求情绪支持 |
| 达人（老师） | 认证服务提供者，通过连麦获得星币收入 | 高效安排连麦，优先服务高价值用户 |
| 首登当月新用户 | 首次登录当月的新用户，可能有免费连麦分钟数 | 体验产品，建立信任 |

### 1.4 核心价值主张

为大R用户提供优先预约通道，优化达人连麦调度，提升整体服务体验与平台收入。

## 2. 产品架构

### 2.1 功能架构图

```mermaid
mindmap
  root((连麦预约系统))
    用户端
      未接通话处理
        未接通知显示
        回拨按钮（60秒免费）
      预约连麦功能
        大R用户识别
        预约入口显示
        等待时间预估
        预约确认
      预约管理
        预约队列查看
        取消预约
        接收可连麦推送
      连麦发起
        一键连麦
    达人端
      连麦中状态管理
        预约入口展示
        预约用户查看
        特殊新用户提示
      预约处理
        查看预约队列
        选择响应预约
        取消预约
      通知管理
        未接通知
        预约通知
        可连麦推送
    后台系统
      用户标签管理
        大R用户识别
        新用户标记
      预约队列管理
        排队逻辑
        超时处理
      消息推送服务
        推送触发
        推送模板
```

### 2.2 用户角色定义

| 角色名称 | 角色描述 | 主要权限 |
|---------|---------|---------|
| 普通用户 | 平台一般用户，可进行连麦 | 查看达人主页、发起连麦、查看个人预约 |
| 大R用户 | 历史消费金额高的用户 | 普通用户权限 + 预约连麦功能 |
| 达人（老师） | 认证服务提供者 | 查看预约队列、选择响应、取消预约、接收通知 |
| 系统管理员 | 平台运营人员 | 配置大R阈值、查看预约数据、管理推送模板 |

## 3. 核心业务流程

```mermaid
flowchart TD
    A[用户查看连麦中达人] --> B{是否为大R用户?}
    B -->|是| C[显示"可预约连麦"按钮]
    B -->|否| D[显示"连麦中"状态]
    C --> E[用户点击预约]
    E --> F[计算预估等待时间]
    F --> G[显示等待时间并确认]
    G --> H[预约成功进入队列]
    
    H --> I{达人端逻辑}
    I --> J[显示预约通知]
    J --> K{当前连麦用户是否特殊新用户?}
    K -->|是| L[显示"将在X分钟后结束"提示]
    K -->|否| M[正常显示预约信息]
    
    L --> N[免费连麦时长结束]
    M --> O[达人结束当前连麦]
    N --> P[系统向预约用户推送]
    O --> P
    
    P --> Q[用户点击推送]
    Q --> R[一键发起连麦]
    R --> S[连麦接通]
```

## 4. 详细功能说明

### 4.1 未接通话处理模块

#### 4.1.1 未接通知显示

| 字段 | 说明 |
|-----|------|
| **功能描述** | 达人对漏接/未接通的用户，在IM窗口显示"未接通知"提示 |
| **前置条件** | 用户发起连麦请求，达人未接听或错过 |

**页面元素**：

| 元素 | 类型 | 说明 | 校验规则 |
|-----|------|-----|---------|
| 未接通知卡片 | 卡片组件 | 显示用户头像、昵称、漏接时间 | 自动显示，点击可查看用户详情 |
| 回拨按钮 | 按钮 | "回拨"按钮，点击后呼叫用户 | 按钮颜色使用primary_gradient |

**交互逻辑**：
1. 用户发起连麦，达人未接听
2. 系统在达人IM窗口顶部显示未接通知卡片
3. 达人点击卡片可查看用户详情
4. 达人点击"回拨"按钮，系统发起呼叫
5. 用户接通后，前60秒免费（不计星币）

**异常处理**：
| 异常场景 | 处理方式 |
|---------|---------|
| 用户已离线 | 显示"用户暂时无法接通" |
| 回拨时用户正忙 | 显示"用户正在连麦中" |
| 网络异常 | 显示"网络连接失败，请重试" |

### 4.2 预约连麦模块（大R用户专属）

#### 4.2.1 预约入口显示

| 字段 | 说明 |
|-----|------|
| **功能描述** | 达人在连麦中时，其主页、IM窗口显示"可预约连麦"按钮/标签，仅对大R用户可见 |
| **前置条件** | 1. 达人处于连麦中状态 2. 当前用户为大R用户 |

**页面元素**：
| 元素 | 类型 | 说明 | 校验规则 |
|-----|------|-----|---------|
| 可预约标签 | 标签 | "可预约连麦"标签，带星形图标 | 背景色使用secondary (#FFCC4D) |
| 预约按钮 | 按钮 | "预约连麦"按钮，点击后弹出预约确认 | 按钮样式使用渐变色primary_gradient |

**大R用户识别规则**：
- 历史累计消费金额 ≥ 1000星币
- 或 最近30天消费金额 ≥ 500星币
- 用户标签由后台系统实时更新

#### 4.2.2 等待时间预估

| 字段 | 说明 |
|-----|------|
| **功能描述** | 大R用户点击预约按钮后，系统实时计算并显示预估等待时间 |
| **前置条件** | 用户点击预约按钮 |

**计算公式**：
```
等待时间（分钟）=（当前连麦用户账户余额 ÷ 达人每分钟连麦价格）+ 当前用户免费分钟数
```
**显示规则**：
- 若计算结果 ≤ 60分钟：显示具体分钟数（如"预计等待：25分钟"）
- 若计算结果 > 60分钟：统一显示"60分钟+"

**页面元素**：
| 元素 | 类型 | 说明 | 校验规则 |
|-----|------|-----|---------|
| 等待时间显示 | 文本 | 显示预估时间 | 字体颜色使用text_main |
| 确认按钮 | 按钮 | "确认预约"按钮 | 主按钮样式 |
| 取消按钮 | 按钮 | "取消"按钮 | 次要按钮样式 |

**交互逻辑**：
1. 大R用户点击"预约连麦"按钮
2. 系统获取当前连麦用户的账户余额、达人连麦单价、当前用户免费分钟数
3. 实时计算等待时间并显示
4. 用户确认预约，系统记录预约关系
5. 预约成功，用户进入达人预约队列

#### 4.2.3 预约队列管理

| 字段 | 说明 |
|-----|------|
| **功能描述** | 管理达人预约队列，按预约时间排序，达人可选择响应 |
| **前置条件** | 有用户预约该达人 |

**排队规则**：
- **先预约先展示**：按预约时间先后排序
- **达人选择响应**：达人可从队列中选择任一用户进行连麦
- **有效期24小时**：预约24小时后自动取消
- **取消机制**：用户或达人均可手动取消预约

**页面元素**（达人端）：
| 元素 | 类型 | 说明 | 校验规则 |
|-----|------|-----|---------|
| 预约队列列表 | 列表 | 显示预约用户信息、预约时间、等待状态 | 每项显示用户头像、昵称、预约时间 |
| 响应按钮 | 按钮 | "立即连麦"按钮 | 每项右侧的响应按钮 |
| 取消按钮 | 按钮 | "取消预约"按钮 | 每项右侧的取消按钮 |

### 4.3 预约通知与中断模块

#### 4.3.1 特殊新用户提示

| 字段 | 说明 |
|-----|------|
| **功能描述** | 当特定条件满足时，在达人端显示特殊提示，告知连麦结束时间 |
| **触发条件** | 同时满足以下三个条件： 1. 当前连麦用户账户余额=0 2. 当前连麦用户使用免费连麦分钟数 3. 当前连麦用户为**首登当月新用户** |

**提示文案**：
"您有用户向您预约了连麦，本次连麦将在X分钟后结束"

**计算规则**：
- X = 当前免费用户的剩余免费连麦时长（分钟）
- 免费连麦时长：新用户注册赠送的免费分钟数

**特殊规则**：
- 若预约发起后，正在连麦的免费用户进行了充值，本次连麦仍在其免费时长结束后自动断连
- 充值不影响预约用户的等待时间计算

#### 4.3.2 连麦中断逻辑

| 字段 | 说明 |
|-----|------|
| **功能描述** | 根据预约情况和用户类型，智能控制连麦中断时机 |
| **业务规则** | 1. 普通用户连麦：按正常流程结束 2. 特殊新用户连麦：免费时长结束后自动断连 3. 有预约等待时：优先结束当前连麦，服务预约用户 |

### 4.4 预约后推送模块

#### 4.4.1 可连麦推送

| 字段 | 说明 |
|-----|------|
| **功能描述** | 达人结束当前连麦后，系统向所有已预约用户推送"达人可连麦"通知 |
| **触发时机** | 达人结束连麦（手动挂断或自动断连） |

**推送内容**：
- 标题：您预约的[达人昵称]现在可以连麦了！
- 内容：点击立即发起连麦，快速接通
- 数据：包含达人ID、预约ID、推送时间

**推送规则**：
- 仅向预约有效期内的用户推送（24小时内）
- 若多个预约用户，同时推送
- 用户点击推送后，直接进入连麦准备页面

#### 4.4.2 快速发起连麦

| 字段 | 说明 |
|-----|------|
| **功能描述** | 用户点击推送后，可直接进入连麦准备页面，一键发起连麦 |
| **前置条件** | 用户收到可连麦推送并点击 |

**页面流程**：
1. 用户点击推送
2. 直接进入连麦准备页面（跳过达人主页、IM窗口）
3. 页面显示达人信息、连麦单价
4. 用户确认星币扣除，点击"立即连麦"
5. 系统向达人发起连麦请求

**费用规则**：
- 连麦费用按达人定价正常扣除星币
- 若用户星币不足，引导充值

## 5. 数据需求

### 5.1 分析思路

| 目标指标 | 分析思路 | 数据来源 |
|---------|---------|---------|
| 大R用户连麦成功率 | 预约后成功连麦用户数 ÷ 总预约用户数 | 预约记录、连麦记录 |
| 平均等待时间 | 从预约成功到连麦发起的时间差平均值 | 预约时间、连麦开始时间 |
| 预约功能使用率 | 使用预约功能的大R用户数 ÷ 总大R用户数 | 用户标签、预约记录 |
| 达人响应效率 | 从可连麦推送到达人接听的平均时间 | 推送时间、连麦接通时间 |
| 预约取消率 | 取消预约数 ÷ 总预约数 | 预约状态变更记录 |

### 5.2 数据采集

#### 5.2.1 现有埋点复用

| 分析需求 | 现有埋点 | 可用属性/维度 | 需新增 |
|---------|---------|--------------|-------|
| 页面浏览 | PageView | zz_page_name, zz_expert_id | 否 |
| 按钮点击 | ButtonClick | zz_button_name, zz_expert_id | 是（需新增按钮类型） |
| 连麦记录 | CallStart | zz_expert_id, zz_call_duration | 否 |

#### 5.2.2 新增埋点

| 埋点名称 | 触发时机 | 上报参数 | 说明 |
|---------|---------|---------|------|
| zz_appointment_click | 用户点击预约按钮 | zz_expert_id, zz_is_big_r, zz_wait_time | 预约点击事件 |
| zz_appointment_confirm | 用户确认预约 | zz_appointment_id, zz_expert_id, zz_estimated_wait | 预约成功事件 |
| zz_appointment_cancel | 用户或达人取消预约 | zz_appointment_id, zz_cancel_by, zz_reason | 预约取消事件 |
| zz_notification_send | 系统发送可连麦推送 | zz_appointment_id, zz_expert_id, zz_user_count | 推送发送事件 |
| zz_notification_click | 用户点击推送 | zz_appointment_id, zz_push_id, zz_time_to_click | 推送点击事件 |
| zz_quick_call_start | 用户通过推送快速发起连麦 | zz_appointment_id, zz_expert_id, zz_call_type | 快速连麦事件 |

**新增埋点参数格式**：
| 参数名 | 类型 | 说明 |
|-------|------|------|
| zz_appointment_id | STRING | 预约记录ID |
| zz_is_big_r | BOOL | 是否为大R用户 |
| zz_estimated_wait | NUMBER | 预估等待时间（分钟） |
| zz_cancel_by | STRING | 取消方（user/expert/system） |
| zz_wait_time | NUMBER | 实际等待时间（分钟） |
| zz_push_id | STRING | 推送消息ID |

---

*文档版本：v1.0*
*最后更新：2026-03-16*
*相关文档：UI_Reference.md, Design_System.json*