cf46b27610
P0-1 (limits.go): Allow()方法改为全程使用写锁保护counters map读写，避免RLock写入时的data race P0-2 (ticket_workflow.go+ticket_handler.go): Assign/Resolve/Close操作先查询ticket存在性和状态，返回明确的CS_TICKET_4001/CS_TKT_4002/CS_TICKET_4092/CS_TICKET_4093错误码，handler根据错误前缀路由HTTP状态码 P1-1 (ticket_store.go): 移除GetStats中3处手动rows.Close()，只保留defer Close()
175 lines
6.0 KiB
Markdown
175 lines
6.0 KiB
Markdown
# 商业化与价值追踪方案
|
||
|
||
> 版本：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
|
||
- **下次审查**：灰度第一周期结束后
|