Files

Your Name cf46b27610 fix: P0-1 RateLimiter并发写安全 + P0-2工单操作错误码区分 + P1 rows.Close修复

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()

2026-05-01 20:56:25 +08:00

6.0 KiB

Raw Blame History

商业化与价值追踪方案

版本：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 接口：

{
  "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
下次审查：灰度第一周期结束后

6.0 KiB Raw Blame History Unescape Escape