@zeyue0329/xiaoma-cli 1.12.0 → 1.13.0

package/demo/xiaoma-prd-saas-zh/epics.md

@@ -0,0 +1,303 @@
+---
+stepsCompleted:
+  - step-01-validate-prerequisites
+  - step-02-design-epics
+  - step-03-create-stories
+  - step-04-final-validation
+inputDocuments:
+  - ./prd.md
+  - ./domain-research.md
+workflowType: 'epics-stories'
+prdVersion: '1.0.0'
+date: '2026-05-08'
+author: 张明远
+---
+
+# 灵协 Linkly — Epics 与 User Stories
+
+> 本文件是 [prd.md](./prd.md) 的下游产物，演示 FR → Epic → Story 拆分。FR 总数 24，按 6 个 capability area 拆为 6 个 Epic，每个 Epic 含 4-6 个 Story（24 FR 共拆为 18 个 Story，符合 prd-purpose.md FR-to-Story Heuristics 规则 1：1 FR ↔ 1-3 Story）。
+
+## Epic 总览
+
+| Epic ID | 名称        | 包含 FR              | Story 数 | Sprint 排序  |
+| ------- | ----------- | -------------------- | -------- | ------------ |
+| EP-01   | 客户档案管理 | FR-PROFILE-01..04    | 3        | Sprint 1-2   |
+| EP-02   | 旅程画布    | FR-JOURNEY-01..04    | 3        | Sprint 2-3   |
+| EP-03   | 风险预警    | FR-RISK-01..04       | 3        | Sprint 3-4   |
+| EP-04   | AI 摘要     | FR-SUMMARY-01..04    | 3        | Sprint 4-5   |
+| EP-05   | 工单整合    | FR-TICKET-01..04     | 3        | Sprint 5-6   |
+| EP-06   | 租户与权限  | FR-TENANT-01..04     | 3        | Sprint 1（基础） |
+
+---
+
+## EP-01 客户档案管理
+
+**Goal：** 让 CSM 可以快速找到客户、看到 12 个月聚合活动，让 Manager 可以批量管理责任归属。
+**FR Coverage：** FR-PROFILE-01, 02, 03, 04
+**Maps to PRD §：** 1（价值主张 1）· 3（MVP）· 4.1（CSM 日检视）· 8.1
+**Acceptance：** 24 个客户档案核心场景测试用例全通过；§8.1 所有 FR 在 e2e 测试中可被复现
+
+### Story EP-01-01 — 客户档案多维检索
+
+**FR mapped:** FR-PROFILE-01
+**Persona:** CSM
+**Acceptance Criteria:**
+
+- 给定 100+ 客户档案，CSM 输入公司名前缀，结果在 < 500ms 返回前 20 条匹配
+- 多维筛选（公司名 + 标签 + 健康度区间）组合命中精确
+- 排序支持：健康度升降序、最近活动时间、ACV 升降序
+- 空结果时显示提示与"创建新筛选"建议
+
+### Story EP-01-02 — 12 个月聚合时间轴
+
+**FR mapped:** FR-PROFILE-02
+**Persona:** CSM
+**Acceptance Criteria:**
+
+- 单客户档案页加载 12 个月聚合事件 ≤ 2.5 秒（满足 NFR-PERF-02）
+- 事件类型聚类显示：CRM 字段变更、客服记录、合同事件、IM 历史
+- 每个事件可点击跳转到源系统详情（FR-JOURNEY-03 协同）
+- 数据缺失时间段显示明确占位（"暂无数据"），不留空白
+
+### Story EP-01-03 — 标签管理（合并 FR-PROFILE-03 + 04）
+
+**FR mapped:** FR-PROFILE-03 (Admin 添加标签), FR-PROFILE-04 (Manager 批量更新归属)
+**Personas:** Admin, Manager
+**Note:** 这两个 FR 都涉及客户档案的"配置/批量"动作且 Actor 不重叠（一个是 Admin 一个是 Manager），但 UI 入口和实现路径在同一个"档案管理后台"页面，合并为单 Story 实现以减少上下文切换。
+**Acceptance Criteria:**
+
+- Admin 可为单客户添加 ≤ 20 个标签，超过上限提示具体超出数量
+- Manager 可勾选 ≤ 200 客户批量更新责任 CSM
+- 所有变更进入审计日志（NFR-COMP-01）
+
+---
+
+## EP-02 旅程画布
+
+**Goal：** 把 12 个月客户事件可视化为时间轴 + 健康度趋势线，让 CSM 与数据分析师快速定位。
+**FR Coverage：** FR-JOURNEY-01..04
+**Maps to PRD §：** 1（价值主张 1）· 4.1 step 1, 3 · 4.3 step 2 · 8.2
+**Acceptance：** 旅程画布 e2e 性能与功能测试全通过
+
+### Story EP-02-01 — 旅程画布主视图
+
+**FR mapped:** FR-JOURNEY-01
+**Persona:** CSM
+**Acceptance Criteria:**
+
+- 单客户旅程画布首屏加载 ≤ 2.5 秒（满足 NFR-PERF-02）
+- 时间轴显示 12 个月，事件类型用颜色区分
+- 健康度趋势线叠加在时间轴上方
+- 缩放与平移操作流畅（60fps，前端 RUM 验证）
+
+### Story EP-02-02 — 事件类型筛选与跳转
+
+**FR mapped:** FR-JOURNEY-02, FR-JOURNEY-03
+**Persona:** CSM
+**Acceptance Criteria:**
+
+- 4 类事件可独立勾选筛选（合同 / 客服 / 产品使用 / IM）
+- 点击任意事件跳转到源系统详情（钉钉 / 飞书 / Salesforce / 销售易），新标签页打开
+- 跳转 URL 前缀按租户配置（FR-TENANT-02 提供）
+
+### Story EP-02-03 — 画布默认配置（Admin）
+
+**FR mapped:** FR-JOURNEY-04
+**Persona:** Admin
+**Acceptance Criteria:**
+
+- Admin 可在租户管理后台勾选"默认显示事件类型"
+- 配置变更对租户内所有用户生效
+- 用户可在自己 session 中临时覆盖（不持久化）
+
+---
+
+## EP-03 风险预警
+
+**Goal：** 自动识别高风险客户并通过双通道通知 CSM，预警附 top-3 触发因子。
+**FR Coverage：** FR-RISK-01..04
+**Maps to PRD §：** 1（愿景）· 4.1 step 2, 4 · 8.3
+**Acceptance：** 风险评分准确率 ≥ 85%（与人工标注对比）；触达率达 SC-01 目标
+
+### Story EP-03-01 — 健康度评分引擎
+
+**FR mapped:** FR-RISK-01
+**Persona:** 系统（每日批量任务）
+**Acceptance Criteria:**
+
+- 每日凌晨 02:00 全租户全客户健康度评分批量更新
+- 评分计算覆盖 5 类信号：合同状态、客服记录、产品使用、IM 互动、付款行为
+- 评分写入审计日志（包含计算时间戳与版本号）
+- 评分异常（如 > 100 或 < 0）触发监控告警
+
+### Story EP-03-02 — 预警通知与可解释性
+
+**FR mapped:** FR-RISK-02, FR-RISK-03
+**Persona:** CSM
+**Acceptance Criteria:**
+
+- 健康度 < 40 或硬规则触发时生成预警
+- 预警附 top-3 触发因子（事件类型 + 时间 + 权重）
+- 通知通过工作台 + 钉钉/飞书 IM 双通道
+- 预警在 IM 中点击直达工作台对应客户详情
+
+### Story EP-03-03 — 健康度规则查看（Admin）
+
+**FR mapped:** FR-RISK-04
+**Persona:** Admin
+**Acceptance Criteria:**
+
+- Admin 在租户管理后台可查看当前健康度规则配置（MVP 只读）
+- 规则项含：信号源、权重、阈值、最近修改时间
+- "申请调校"按钮提交工单到客户成功团队（Growth 阶段开放调校）
+
+---
+
+## EP-04 AI 摘要
+
+**Goal：** 用 LLM 为客户对话生成结构化摘要与触达建议，缩短 CSM 处理时间。
+**FR Coverage：** FR-SUMMARY-01..04
+**Maps to PRD §：** 1（价值主张 2-3）· 4.1 step 3, 4 · 8.4
+**Acceptance：** 摘要质量基线 ≥ 4.2/5（人工 100 样本）；采纳率达 SC-03 目标
+
+### Story EP-04-01 — 30 天对话摘要
+
+**FR mapped:** FR-SUMMARY-01
+**Persona:** CSM
+**Acceptance Criteria:**
+
+- CSM 触发后 ≤ 8 秒返回摘要（含 LLM 调用时间，p95）
+- 摘要包含三段：关键事件、客户情绪、待办建议
+- 每段附原文链接（点击展开对应客服记录）
+- 摘要不包含原文涉及的隐私字段（手机号、身份证、银行卡）
+
+### Story EP-04-02 — 摘要反馈与触达建议
+
+**FR mapped:** FR-SUMMARY-02, FR-SUMMARY-03
+**Personas:** CSM, 系统
+**Acceptance Criteria:**
+
+- CSM 可标记摘要"采用"或"拒绝"，反馈写入质量监控数据
+- 高风险预警（FR-RISK-03）自动附触达建议（话术 + 时点）
+- 触达建议含建议通道（IM / 邮件 / 电话）和建议时机（工作日 9:00-18:00）
+
+### Story EP-04-03 — 配额监控与通知
+
+**FR mapped:** FR-SUMMARY-04
+**Persona:** Admin
+**Acceptance Criteria:**
+
+- Admin 工作台显示本月 LLM 摘要配额使用进度条
+- 配额剩余 < 20% 时触发邮件 + IM 通知
+- 配额耗尽后摘要功能禁用，UI 显示明确升级引导
+
+---
+
+## EP-05 工单整合
+
+**Goal：** CSM 可一键从客户档案 / 风险预警创建工单，工单在外部工单系统同步。
+**FR Coverage：** FR-TICKET-01..04
+**Maps to PRD §：** 1（价值主张 3）· 4.1 step 5, 7, 失败路径 · 8.5
+**Acceptance：** 工单创建 e2e 流畅；超时提醒覆盖率 100%
+
+### Story EP-05-01 — 工单一键创建
+
+**FR mapped:** FR-TICKET-01
+**Persona:** CSM
+**Acceptance Criteria:**
+
+- 从客户档案 / 风险预警 / 旅程画布均可一键创建工单
+- 工单自动填充上下文摘要（FR-SUMMARY-01 输出）
+- 创建对话框支持优先级、分配 CSM、截止时间编辑
+
+### Story EP-05-02 — 外部工单系统同步
+
+**FR mapped:** FR-TICKET-02
+**Persona:** 系统
+**Acceptance Criteria:**
+
+- 工单在 ≤ 30 秒内同步到目标系统（钉钉/飞书/Salesforce）
+- 同步失败重试 3 次，仍失败时写入失败队列并通知 Admin
+- 同步状态在工作台可见（pending / synced / failed）
+
+### Story EP-05-03 — 工单状态与超时提醒
+
+**FR mapped:** FR-TICKET-03, FR-TICKET-04
+**Personas:** CSM, 客服主管
+**Acceptance Criteria:**
+
+- CSM 工作台显示本人创建工单的状态（开放 / 进行中 / 已完成 / 超时）
+- 高风险工单超过 24 小时未触达时，主管收到 IM 提醒（含工单链接）
+- 超时提醒命中率 100%（基于审计日志校验）
+
+---
+
+## EP-06 租户与权限
+
+**Goal：** 多租户隔离 + 4 角色 RBAC + 集成凭据管理。
+**FR Coverage：** FR-TENANT-01..04
+**Maps to PRD §：** 5.1（合规）· 7（项目类型需求）· 8.6
+**Acceptance：** 跨租户隔离测试 100% 通过；RBAC 矩阵 e2e 全覆盖
+**Sprint 1 优先：** 本 Epic 是其他 Epic 的基础，必须 Sprint 1 完成
+
+### Story EP-06-01 — 用户邀请与角色分配
+
+**FR mapped:** FR-TENANT-01
+**Persona:** Admin
+**Acceptance Criteria:**
+
+- Admin 通过邮箱邀请用户加入租户
+- 邀请链接 7 天内有效，过期需重新邀请
+- 用户接受邀请后分配 4 角色之一（Admin / Manager / Operator / Viewer）
+- 角色变更立即生效（next request 起）
+
+### Story EP-06-02 — 集成凭据管理与失效通知
+
+**FR mapped:** FR-TENANT-02, FR-TENANT-04
+**Persona:** Admin
+**Acceptance Criteria:**
+
+- Admin 可配置 CRM / IM / Webhook 凭据，凭据加密存储（AES-256）
+- 凭据校验失败或限流时通知 Admin（IM + 邮件）
+- 通知含错误码与排查指引链接（指向产品文档）
+
+### Story EP-06-03 — 数据导出申请
+
+**FR mapped:** FR-TENANT-03
+**Persona:** Admin
+**Acceptance Criteria:**
+
+- Admin 可在管理后台申请租户全量数据导出
+- 系统在 30 天内（NFR-COMP-02）生成 AES-256 加密压缩包
+- 解压密码通过独立通道（短信 + 邮件双因素）发送给申请人
+- 导出申请记录入审计日志（NFR-COMP-01）
+
+---
+
+## Sprint 排期建议
+
+| Sprint   | 周期        | 内容                                       | 关键里程碑                  |
+| -------- | ----------- | ------------------------------------------ | --------------------------- |
+| Sprint 1 | 2 周        | EP-06 全部 · EP-01 Story 01                | 租户骨架可用                |
+| Sprint 2 | 2 周        | EP-01 Story 02-03 · EP-02 Story 01         | 客户档案 + 旅程画布 demo    |
+| Sprint 3 | 2 周        | EP-02 Story 02-03 · EP-03 Story 01         | 旅程画布完整 + 健康度评分    |
+| Sprint 4 | 2 周        | EP-03 Story 02-03 · EP-04 Story 01         | 风险预警闭环 + LLM 摘要 v1  |
+| Sprint 5 | 2 周        | EP-04 Story 02-03 · EP-05 Story 01         | AI 摘要完整 + 工单创建      |
+| Sprint 6 | 2 周        | EP-05 Story 02-03                          | MVP 全功能 e2e                |
+| Sprint 7 | 1 周缓冲    | 性能优化 · 安全审计 · 等保二级测评          | MVP 上线候选                |
+
+---
+
+## Story 数量校验
+
+| Epic   | FR 数 | Story 数 | 1 FR ↔ Story 比例     |
+| ------ | ----- | -------- | --------------------- |
+| EP-01  | 4     | 3        | 1.33（合并 FR-03+04） |
+| EP-02  | 4     | 3        | 1.33                  |
+| EP-03  | 4     | 3        | 1.33                  |
+| EP-04  | 4     | 3        | 1.33                  |
+| EP-05  | 4     | 3        | 1.33                  |
+| EP-06  | 4     | 3        | 1.33                  |
+| **总** | 24    | 18       | 1.33（符合 1:1-3 规则）|
+
+每个 Story 平均 ≤ 5 个验收标准，Sprint 内可消化。

package/demo/xiaoma-prd-saas-zh/market-research-2026-q1.md

@@ -0,0 +1,183 @@
+---
+workflowType: 'research'
+research_type: 'market'
+research_topic: '国内中型企业客户成功 SaaS 市场'
+research_goals: '产品定位 · 竞品差异化 · 用户痛点'
+date: '2026-04-15'
+author: 林晓彤
+web_research_enabled: true
+source_verification: true
+---
+
+# Research Report: Market
+
+**Date:** 2026-04-15
+**Author:** 林晓彤
+**Research Type:** Market
+
+---
+
+## Research Overview
+
+围绕"国内中型企业（年营收 5 亿-50 亿）客户成功 SaaS"展开市场研究。本次调研覆盖 12 个目标客户访谈、6 款国内同类 SaaS 产品分析、3 份国内 CS 行业报告。研究目标：识别客户痛点、决策因素、竞争格局，为灵协 Linkly 产品定位提供输入。
+
+## Customer Behavior
+
+### 当前工作流
+
+中型企业 CSM 日常使用系统平均 5.4 个：
+
+- CRM（Salesforce / 销售易 / Zoho 居多，渗透率 78%）
+- 客服系统（钉钉客服 / Salesforce Service / 网易七鱼，60%）
+- 数据看板（自研 BI / Tableau / FineReport，54%）
+- IM（钉钉 / 飞书，91%）
+- 工单系统（Jira Service Management / 自研，43%）
+- 合同管理（自研 / 用友，29%）
+
+CSM 每日工作分布（12 人样本平均）：
+
+- 信息汇集：90 分钟（手动跨系统切换、复制、整理）
+- 客户沟通：120 分钟
+- 复盘与计划：60 分钟
+- 团队协作与汇报：90 分钟
+
+### 高频操作
+
+每日 ≥ 3 次执行的操作：
+
+- 跨系统切换查找客户最新状态
+- 在 IM 中接收预警并回查 CRM/客服记录
+- 手动汇总周/月报告
+
+每周 ≥ 1 次执行：
+
+- 召开客户健康度会议（人工拉数据）
+- 识别"沉默客户"并主动触达
+
+## Customer Pain Points
+
+按提及频次排序（12 人样本）：
+
+| 痛点                       | 提及次数 | 严重度 | 当前应对                         |
+| -------------------------- | -------- | ------ | -------------------------------- |
+| 多系统切换效率低           | 12/12    | 高     | 接受现状 / 自建脚本爬取          |
+| 流失预警滞后（5-7 天）     | 11/12    | 高     | 依赖人工识别 / 偶发性运气        |
+| 客户对话内容回看耗时       | 10/12    | 高     | 仅看最近 1 条 / 找客服同事问     |
+| CSM 服务客户数量受限       | 9/12     | 中     | 增加人手 / 砍服务深度            |
+| 健康度评分缺乏依据         | 8/12     | 中     | 凭经验主观打分                   |
+| 触达策略缺少数据支撑       | 7/12     | 中     | 流程化模板 / 经验复用            |
+| 团队 KPI 数据滞后 1-2 周   | 6/12     | 中     | 月初手工汇总                     |
+
+### 核心痛点深挖：流失预警滞后
+
+11/12 受访者表示"识别到客户流失风险时，往往已是事后"。常见原因：
+
+- 触发流失风险的信号分散在 4-5 个系统中
+- 没有统一的"高风险"定义
+- IM 中预警噪音多，CSM 默认忽略
+- 客服记录缺乏结构化标签，无法用规则触发
+
+CSM 的期望：在风险发生 24 小时内被触达（而非现状的 5-7 天），且预警附带"为什么风险"和"建议怎么做"。
+
+## Customer Decisions
+
+### 采购决策因素（按权重）
+
+| 因素                | 权重 | 评判方式                            |
+| ------------------- | ---- | ----------------------------------- |
+| 与现有系统集成能力  | 25%  | API 完整度 · 现有 CRM/客服适配      |
+| 功能完整度          | 20%  | 是否覆盖 80% 工作场景               |
+| 数据安全与本地化    | 18%  | 等保资质 · IDC 位置 · 数据出境合规  |
+| 价格与 TCO          | 15%  | 单 CSM 月费 · 实施成本 · 培训成本   |
+| 试点效果            | 12%  | 30-60 天 PoC 后的客户健康度变化     |
+| 厂商背景与服务      | 10%  | 行业案例 · 售后响应 SLA             |
+
+### 决策周期
+
+- 中型企业平均决策周期 14-22 周（含 PoC 阶段）
+- 关键决策人：CS VP / CIO / 财务
+- 否决人：法务（合规）· IT 安全（数据安全）
+
+### 触发采购的事件
+
+按提及频次：
+
+- 客户流失率突破内部阈值（流失率 > 4% 触发评估）
+- CSM 团队人均效能下降（人均服务客户数 < 25）
+- 现有系统改造需求（如 CRM 升级，顺带评估 CS 工具）
+- 新业务线启动（如开拓行业客户，需要新工具）
+
+## Competitive Analysis
+
+国内同类 SaaS 产品（按市场覆盖度排序）：
+
+### 聚客云
+
+- **定位：** 客户健康度看板 + 触达执行
+- **优势：** 集成生态成熟（与销售易、Salesforce 集成深度好）；触达自动化能力强
+- **劣势：** 旅程画布弱（仅时间轴列表）；无 LLM 摘要；价格偏高（单 CSM ¥800/月）
+- **客户：** 200-500 人 SaaS 公司居多
+
+### 客成 Pro
+
+- **定位：** 数据看板 + 客户健康度
+- **优势：** BI 集成强；行业分析报告专业
+- **劣势：** 无对话摘要 / IM 整合；定位偏数据分析师而非 CSM
+- **客户：** 100-300 人企业
+
+### 销售易 CS 模块
+
+- **定位：** 销售易内嵌的 CS 功能
+- **优势：** 与销售易 CRM 无缝集成；价格捆绑友好
+- **劣势：** 只能服务销售易 CRM 客户；功能浅
+- **客户：** 销售易现有客户附带使用
+
+### 灵客通
+
+- **定位：** 客服与 CS 一体化
+- **优势：** 客服+CS 协同好；多渠道客户对话整合
+- **劣势：** 偏客服重于 CS；旅程视角弱
+- **客户：** 中小企业 50-150 人
+
+### 海外产品（仅参考）
+
+- **Gainsight：** 全球 CS SaaS 龙头；本土化弱、价格 3-5 倍国内
+- **Catalyst：** 美国新锐；产品现代化但本土化弱
+- **ChurnZero：** 美国客户健康度专家；目前未进入国内
+
+### 灵协 Linkly 差异化机会
+
+基于上述分析：
+
+- **唯一组合：** 旅程画布 + LLM 摘要 + 风险评分三能力的整合，国内市场为首
+- **价格定位：** 中端（单 CSM ¥500-600/月，介于聚客云与客成 Pro 之间）
+- **目标空白：** 200-500 人企业客户成功团队，同时需要"画布视角"和"AI 提效"
+- **集成壁垒：** 投入资源做钉钉 / 飞书 / 销售易的深度集成
+
+## Trends
+
+### 行业趋势（2025-2026）
+
+- **AI 渗透加速：** 73% 的国内 CS 团队在 2025 年评估或试用 LLM 工具，但落地率仅 12%
+- **客户健康度可解释性需求上升：** 41% 的中型企业拒绝"黑盒"评分，要求可调校规则
+- **数据本地化合规收紧：** 个保法 + 行业专项合规对 SaaS 数据存储位置要求提高
+
+### 技术趋势
+
+- LLM 摘要质量在客服场景达到可用阈值（人工评测 > 4.0/5）
+- 国产 LLM 厂商（通义、文心、智谱）API 价格 12 个月内下降 70%，可商用门槛降低
+- 客户健康度模型从纯统计转向"规则 + 机器学习"混合架构
+
+## Conclusion
+
+灵协 Linkly 在以下三点形成有效差异化：
+
+1. **能力组合：** 旅程画布 + LLM 摘要 + 风险评分的整合是国内独家
+2. **定位精准：** 200-500 人 SaaS / 服务型企业的 CSM 团队（决策周期相对短、付费意愿强、对 AI 接受度高）
+3. **集成壁垒：** 钉钉/飞书深度集成 + 主流 CRM 适配是中长期护城河
+
+风险点：
+
+- 国内 LLM 厂商策略变化（缓解：抽象层 + 多厂商）
+- 同类产品快速跟进（缓解：尽快建立头部客户案例 + 集成生态）
+- 中型企业付费转化慢（缓解：试点期 30-60 天 PoC 收紧到 30 天）