@zeyue0329/xiaoma-cli 1.13.0 → 1.15.0

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

@@ -1,303 +0,0 @@
----
-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

@@ -1,183 +0,0 @@
----
-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 天）