# 商业化与价值追踪方案

> 版本：v1.0 | 状态：已生效
> 关联：tech/INTERFACE.md、PRODUCTION_PHASE1_STATUS.md

---

## 1. 商业化模式

### 1.1 当前阶段定位

生产一期**不涉及商业化计费**，重点是建立可量化的价值追踪基础，为后续商业化提供数据支撑。

### 1.2 未来商业化模式（Phase 2+ 规划）

| 模式 | 说明 | 前提条件 |
|------|------|----------|
| 按会话量计费 | 每个机器人会话收取固定费用 | 计量系统完善 |
| 按节省人工计费 | 机器人处理的会话替代了 N 个人工客服 | 准确率数据稳定 |
| 按 API 调用计费 | 提供独立 API 供第三方调用 | API 鉴权完善 |
| SaaS 订阅制 | 按租户/坐席数月费 | 多租户隔离完成 |

---

## 2. 核心价值指标（KVIs）

### 2.1 客服效率提升

| 指标 | 定义 | 计算方式 | 当前状态 |
|------|------|----------|----------|
| 机器人接待率 | 机器人接待的会话占总会话比例 | `机器人接待会话 / 总会话` | 待实现计量 |
| 转人工率 | 需要人工介入的会话比例 | `转人工会话 / 总会话` | 待实现统计 |
| 平均处理时长 | 客服处理单个工单的平均时间 | `SUM(resolve_time - create_time) / ticket_count` | ✅ 已记录 created_at/updated_at |
| 机器人处理时长 | 机器人处理单个会话的平均时间 | `会话结束时间 - 会话开始时间（机器人部分）` | 待实现 |

### 2.2 成本节约

| 指标 | 定义 | 数据来源 | 当前状态 |
|------|------|----------|----------|
| 节省人工工时 | 机器人处理掉的会话 × 平均人工处理时长 | ticket + session 数据 | 待计量 |
| 人工响应速度提升 | 用户从发起会话到首次人工响应的时长缩短 | 工单 created_at → assign 时间 | ✅ 已记录 |
| 一站式解决率 | 用户无需再次联系即解决问题的比例 | 同一 user_id 在 7 天内无重复工单 | 待实现 |

### 2.3 用户体验

| 指标 | 定义 | 数据来源 | 当前状态 |
|------|------|----------|----------|
| 用户满意度 | 客服解决后用户评分（1-5 分） | 用户反馈 | 待实现 |
| 机器人回答质量 | FAQ 命中后用户点"不满意"的比例 | 用户反馈 + FAQ 命中日志 | 待实现 |
| 平均等待时长 | 用户从发消息到收到首次响应的时长 | session message timestamp | 待实现 |

---

## 3. 价值追踪工具

### 3.1 运营大盘（待实现）

`tech/INTERFACE.md` 中定义的 `/admin/dashboard` 接口：

```json
{
  "total_sessions_today": 1200,
  "robot_handled_sessions": 1020,
  "handoff_sessions": 180,
  "handoff_rate": "15%",
  "avg_robot_response_time_ms": 3200,
  "open_tickets": 12,
  "resolved_tickets_today": 45,
  "avg_resolution_time_minutes": 38,
  "top_handoff_reasons": [
    { "reason": "refund", "count": 65 },
    { "reason": "sensitive", "count": 40 },
    { "reason": "unknown", "count": 75 }
  ]
}
```

**当前状态**：接口**已定义但未落地**，dashboard 数据聚合需要 session / ticket / message 数据的完整计量。

### 3.2 数据来源映射

| 指标 | 数据来源 | 当前状态 |
|------|----------|----------|
| 会话总量 | session 表 + message 表 | ✅ session store 已落地 |
| 机器人处理量 | intent.needs_human = false 的 session | ✅ 对话服务已记录 |
| 转人工量 | ticket 表（每个 ticket = 一次转人工） | ✅ 工单已落地 |
| 响应时间 | message 表 timestamp | ✅ message 存储已落地 |
| 解决时间 | ticket created_at → updated_at | ✅ 工单时间戳已落地 |

---

## 4. ROI 估算框架

### 4.1 输入参数（灰度阶段采集）

| 参数 | 估算值（待验证） | 数据来源 |
|------|------------------|----------|
| 机器人接待率 | 85% | 上线后统计 |
| 转人工率 | 15% | 上线后统计 |
| 平均人工处理时长 | 15 min/工单 | 灰度阶段记录 |
| 机器人处理时长 | 1 min/会话 | 灰度阶段记录 |
| 人工客服时薪 | ¥50/h | 运营数据 |

### 4.2 节约计算公式

```
月度节约 = 机器人处理的会话数 × (平均人工处理时长 - 平均机器人处理时长) × 人工时薪

示例（待灰度验证）：
月度会话量 = 50,000
机器人处理 = 50,000 × 85% = 42,500
人工处理 = 50,000 × 15% = 7,500

月度节约 = 42,500 × (15min - 1min) / 60 × ¥50
         = 42,500 × 0.233 × ¥50
         = ¥495,125/月
```

> **注**：上述为理论估算，实际值需灰度阶段真实数据验证。

---

## 5. 商业化准备清单

### 5.1 生产一期需完成的基础能力

| 能力 | 说明 | 状态 |
|------|------|------|
| 会话计量 | 每次 webhook 触发计入一个 session | ✅ 已实现 |
| 意图分类 | 区分 robot_handled vs handoff | ✅ 已实现 |
| 工单计量 | ticket 创建计入一次转人工 | ✅ 已实现 |
| 响应时间埋点 | message timestamp 记录 | ✅ 已实现 |
| 运营大盘 API | `/admin/dashboard` 数据聚合 | ❌ 未落地 |

### 5.2 Phase 2 商业化需补充

| 能力 | 优先级 | 说明 |
|------|--------|------|
| 多租户隔离 | P0 | 按租户计量和计费 |
| API 鉴权与配额 | P0 | 防止 API 滥用和盗用 |
| 详细计费日志 | P1 | 每笔费用的详细来源 |
| 账单系统对接 | P1 | 与财务系统联通 |
| 用户分级定价 | P2 | 按套餐区分功能 |

---

## 6. 灰度阶段数据采集计划

### 6.1 第一周期（灰度 5%，1-2 周）

目标：验证核心指标可行性

| 指标 | 采集方式 | 目标精度 |
|------|----------|----------|
| 会话总量 | session 表 count | 日级别 |
| 转人工率 | ticket count / session count | 1% |
| 平均响应时间 | message timestamp diff | 10% 误差 |
| 满意度 | 用户反馈录入 | 样本量 > 100 |

### 6.2 第二周期（灰度 20%，2-3 周）

目标：建立基线和 ROI 模型

- 收集足够数据建立基线
- 验证 ROI 估算公式
- 识别优化方向（如转人工率过高需优化意图识别）

---

## 7. 当前版本状态

- **本文档版本**：v1.0
- **生效日期**：2026-04-30
- **下次审查**：灰度第一周期结束后