@zeyue0329/xiaoma-cli 1.11.0 → 1.13.0

package/demo/xiaoma-prd-saas-zh/prd-bad-examples.md

@@ -0,0 +1,268 @@
+# PRD 反模式片段集
+
+本文件汇集对应 [prd.md](./prd.md) 各章节的反模式坏例，每条标注 AP 编号（参见 `src/core/tasks/xiaoma-create-prd/data/prd-purpose.md` "Chinese PRD Anti-Patterns"），并附修复后好例与所在好版本行号。
+
+> 用途：作为 `xiaoma-validate-prd` rubric 校准用例。把本文件片段拼接为"坏 PRD"跑校验，预期命中 ≥ 3 个 blocker（D05 Measurability / D06 Traceability / D10 SMART）。
+
+---
+
+## 反模式 1 — Executive Summary 口号化（AP-01）
+
+**Section：** §1 Executive Summary
+**Rubric 维度：** D03 Information Density · D11 Holistic Quality
+
+### ❌ 坏例
+
+> **愿景：** 打造业界领先的、智能化、一站式客户成功平台，赋能企业数字化转型。我们的使命是通过创新科技，为千行百业的客户成功团队提供全方位的解决方案。
+>
+> **价值主张：**
+>
+> - 智能化客户洞察
+> - 一站式管理
+> - 卓越用户体验
+
+### 问题
+
+- 命中 AP-01 关键词：打造、业界领先、一站式、赋能、数字化转型、智能化、全方位、千行百业、卓越
+- 无可量化目标
+- "智能化客户洞察"等价值主张无法翻译为 §2 Success Criteria
+- 无差异化、无目标用户
+
+### ✅ 修复后（对应 [prd.md §1](./prd.md) 行 24-39）
+
+> **愿景：** 让中型企业的客户成功（CS）团队在统一画布上看见、解读并干预客户旅程，把流失预警的"发现到触达"从平均 7 天压到 24 小时内。
+>
+> **价值主张：**
+>
+> - 跨系统聚合的客户旅程视图，单页可视化 ≥ 12 个月历史
+> - LLM 自动摘要近 30 天高风险对话，CSM 单客户处理时间从 18 分钟降至 6 分钟
+> - 风险评分与触达建议同源，CSM 单人服务客户数从 30 提升至 40
+
+每条价值主张对应 §2 中至少一条可量化指标（SC-02 / SC-02 / 目标客户数 SC-05）。
+
+---
+
+## 反模式 2 — Functional Requirement 模糊主语（AP-02）
+
+**Section：** §8 Functional Requirements
+**Rubric 维度：** D05 Measurability · D10 SMART
+
+### ❌ 坏例
+
+> **FR-X：** 系统应支持客户档案的查询和管理。
+>
+> **FR-Y：** 应当能够实现风险预警的自动通知。
+
+### 问题
+
+- 命中 AP-02 信号：系统应支持、应当能够、可以实现
+- 无具体 Actor（CSM？Admin？Manager？）
+- "查询和管理"过于笼统，无法测试
+- "自动通知"未明确通道与触发条件
+
+### ✅ 修复后（对应 [prd.md §8.1](./prd.md) 行 226-228）
+
+> **FR-PROFILE-01：** CSM 可以按公司名 · 标签 · 客户健康度区间检索客户档案，支持组合筛选与排序。
+>
+> **FR-RISK-03：** CSM 可以接收高风险客户预警通知（健康度 < 40 或触发硬规则），通过工作台与 IM 双通道。
+
+每条 FR 单一 Actor，单一动作，包含可测试的触发条件与通道。
+
+---
+
+## 反模式 3 — Functional Requirement 实现泄漏（AP-03）
+
+**Section：** §8 Functional Requirements / §1 Executive Summary
+**Rubric 维度：** D07 Implementation Leakage · D05 Measurability
+
+### ❌ 坏例
+
+> **FR-X：** 系统使用 Redis 缓存客户档案查询结果，TTL 30 分钟，命中率 ≥ 90%。
+>
+> **FR-Y：** CSM 通过 React 前端访问 Spring Boot 后端的 RESTful API 检索客户档案，使用 PostgreSQL 持久化。
+
+### 问题
+
+- 命中 AP-03 信号：Redis、React、Spring Boot、PostgreSQL、RESTful API
+- "TTL 30 分钟" / "命中率 ≥ 90%"是 NFR 与架构决策，不是 FR
+- FR 应描述能力，不描述如何实现
+
+### ✅ 修复（拆分为 FR + NFR）
+
+**§8 FR：**
+
+> **FR-PROFILE-01：** CSM 可以按公司名 · 标签 · 客户健康度区间检索客户档案，支持组合筛选与排序。
+
+**§9 NFR：**
+
+> **NFR-PERF-01：** API 接口在正常负载下 p95 < 500ms · p99 < 1.5s（APM 监控统计，30 天滚动）。
+
+技术栈选型由架构设计阶段（`xiaoma-create-architecture`）决定，PRD 不指定。
+
+---
+
+## 反模式 4 — Functional Requirement 复合需求（AP-04）
+
+**Section：** §8 Functional Requirements
+**Rubric 维度：** D10 SMART · D05 Measurability
+
+### ❌ 坏例
+
+> **FR-X：** CSM 可以查询客户、添加标签并导出 Excel 报告，同时接收高风险客户的实时通知，且能在客户档案上添加跟进备注。
+
+### 问题
+
+- 命中 AP-04 信号：且、并、同时
+- 单条 FR 包含 ≥ 5 个独立动作
+- 1 FR ↔ 1-3 story 映射规则被破坏（这条会拆出 5 个 story）
+- 无法独立测试
+
+### ✅ 修复（按 FR-to-Story Heuristics 拆分为 5 条 FR）
+
+> **FR-PROFILE-01：** CSM 可以按公司名 · 标签 · 客户健康度区间检索客户档案。
+>
+> **FR-PROFILE-03：** Admin 可以为客户档案添加自定义标签（每客户最多 20 个）。
+>
+> **FR-EXPORT-01：** CSM 可以导出本人责任客户的健康度数据（CSV 格式，单次上限 10,000 行）。
+>
+> **FR-RISK-03：** CSM 可以接收高风险客户预警通知，通过工作台与 IM 双通道。
+>
+> **FR-PROFILE-05：** CSM 可以在客户档案上添加跟进备注，单条 ≤ 500 字符。
+
+按 Actor / 动作 / 数据对象拆分。
+
+---
+
+## 反模式 5 — Success Criteria 量词缺失（AP-05）
+
+**Section：** §2 Success Criteria
+**Rubric 维度：** D05 Measurability · D10 SMART
+
+### ❌ 坏例
+
+> **SC-X：** 客户满意度显著提升，流失率明显下降，CSM 工作效率有效改善。
+>
+> **SC-Y：** 系统响应快速，稳定可靠。
+
+### 问题
+
+- 命中 AP-05 信号：显著、明显、有效、快速、稳定可靠
+- 无 baseline、无 target、无测量方法、无时间窗
+- 多个指标合并在一句中（也命中 AP-04）
+- "稳定可靠"属于 NFR，不应放 §2
+
+### ✅ 修复（对应 [prd.md §2](./prd.md) 行 49-69）
+
+**§2 Success Criteria：**
+
+> **SC-01 流失预警触达率：** 从 30%（2025 Q4 客服日志抽样）提升至 ≥ 95%；测量 = 工单系统 risk_alert_acknowledged 数 ÷ 同期 risk_alert 数；滚动窗口 30 天；6 个月内达标。
+>
+> **SC-04 试点客户 NPS：** ≥ 45；测量 = 季度调研 N ≥ 100；上线后第二个完整季度达标。
+
+**§9 NFR（NFR-PERF-01 / NFR-AVAIL-01）：**
+
+> **NFR-PERF-01：** API 接口在正常负载下 p95 < 500ms · p99 < 1.5s（APM 监控统计，30 天滚动）。
+>
+> **NFR-AVAIL-01：** 月度 SLA ≥ 99.9%（工作时间 8:00-22:00），双源校验：云厂商 SLA + 内部 SLO 监控。
+
+---
+
+## 反模式 6 — NFR 不可测量（NFR 反模式）
+
+**Section：** §9 Non-Functional Requirements
+**Rubric 维度：** D05 Measurability · D10 SMART
+
+### ❌ 坏例
+
+> **NFR-X：** 系统应具备良好的扩展性和稳定性。
+>
+> **NFR-Y：** 接口响应迅速。
+
+### 问题
+
+- 形容词代替指标
+- 无阈值、无测量方法、无前置条件
+- "扩展性"和"稳定性"应拆为 Scalability 和 Availability 两个独立 NFR
+
+### ✅ 修复（对应 [prd.md §9](./prd.md) 行 285-310）
+
+> **NFR-SCALE-01：** 单租户支持 1000 并发用户（季度压测报告，95 分位响应时间不超出 NFR-PERF-01 阈值）。
+>
+> **NFR-SCALE-02：** 应用节点横向扩容触发到完成 ≤ 5 分钟（K8s HPA 监控记录）。
+>
+> **NFR-AVAIL-01：** 月度 SLA ≥ 99.9%（工作时间 8:00-22:00），双源校验：云厂商 SLA + 内部 SLO 监控。
+>
+> **NFR-PERF-01：** API 接口在正常负载下 p95 < 500ms · p99 < 1.5s（APM 监控统计，30 天滚动）。
+
+---
+
+## 反模式 7 — 缺失可追溯链（违反 D06 Traceability）
+
+**Section：** §8 Functional Requirements + §4 User Journeys
+**Rubric 维度：** D06 Traceability
+
+### ❌ 坏例
+
+> **FR-X（孤立 FR）：** CSM 可以为客户档案上传附件，单文件 ≤ 50MB。
+
+### 问题
+
+- §1 愿景未提及附件管理
+- §3 Product Scope 未列入 MVP
+- §4 User Journeys 无任何旅程步骤涉及附件
+- 这条 FR 无可追溯来源 — 是工程师的"想到顺便加一下"
+
+### ✅ 修复方案
+
+两个选择：
+
+1. **删除：** 既无来源，且 MVP 范围已明确不含附件管理 → 删
+2. **补全溯源：** 把附件需求加入 §1（来源）、§3（MVP 范围）、§4（旅程步骤），FR 才能保留
+
+不允许"FR 没有来源"的 PRD 进入下游。
+
+---
+
+## 反模式 8 — Domain Requirements 形式化（违反 D08 Domain Compliance）
+
+**Section：** §5 Domain Requirements
+**Rubric 维度：** D08 Domain Compliance
+
+### ❌ 坏例
+
+> ## 5. Domain Requirements
+>
+> 系统满足相关法规要求，符合行业标准，保护用户隐私和数据安全。
+
+### 问题
+
+- 无具体法规名（GB/T 28448 / 个保法 / 等保 2.0 ?）
+- 无具体条款映射
+- "保护用户隐私"是承诺，不是可验证条款
+
+### ✅ 修复（对应 [prd.md §5.1](./prd.md) 行 165-176）
+
+写出 6 条具体可验证条款：
+
+> - **5.1.1 跨租户隔离：** 客户对话原文与档案数据不跨租户可见，租户级行级隔离强制启用
+> - **5.1.3 审计日志：** 覆盖登录、查询、导出、配置变更、API 调用 5 类行为；保留 ≥ 180 天
+> - **5.1.6 数据删除：** 客户解约后 90 天内完成数据删除（含备份回收），删除日志记录入合规链
+
+每条对应一个可测试场景。
+
+---
+
+## 校准目标
+
+把本文件的 8 个坏例片段拼接成一份"坏 PRD"喂给 `xiaoma-validate-prd`，预期 rubric 输出：
+
+| 维度 | 状态     | 触发原因                          |
+| ---- | -------- | --------------------------------- |
+| D03  | partial  | AP-01 关键词命中（口号化）        |
+| D05  | **fail** | 形容词代替指标 / NFR 缺测量方法   |
+| D06  | **fail** | 孤立 FR（无溯源）                 |
+| D07  | major    | 实现泄漏（Redis / React 等技术栈）|
+| D08  | **fail** | 合规承诺无具体条款                |
+| D10  | **fail** | 复合 FR / 主语模糊                |
+
+至少命中 4 个 blocker（D05 / D06 / D08 / D10），verdict = reject。

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

@@ -0,0 +1,409 @@
+---
+stepsCompleted:
+  - step-01-init
+  - step-02-discovery
+  - step-02b-vision
+  - step-02c-executive-summary
+  - step-03-success
+  - step-04-journeys
+  - step-05-domain
+  - step-06-innovation
+  - step-07-project-type
+  - step-08-scoping
+  - step-09-functional
+  - step-10-nonfunctional
+  - step-11-polish
+  - step-12-complete
+inputDocuments:
+  - ./product-brief.md
+  - ./market-research-2026-q1.md
+  - ./domain-research.md
+workflowType: 'prd'
+templateVersion: '2.0-m1'
+densityLevel: 'high'
+domainTier: 'medium'
+projectType: 'saas_b2b'
+version: '1.0.0'
+---
+
+# 产品需求文档（PRD） — 灵协 Linkly
+
+**作者：** 张明远　**日期：** 2026-04-30　**版本：** 1.0.0
+
+## 1. Executive Summary
+
+**愿景：** 让中型企业的客户成功（CS）团队在统一画布上看见、解读并干预客户旅程，把流失预警的"发现到触达"从平均 7 天压到 24 小时内。
+
+**问题：** 中型企业 CS 团队同时使用 4-6 个系统（CRM、客服、IM、工单、看板、合同），客户信号分散，CSM 平均每天花 90 分钟手动汇集信息，流失预警延迟 5-7 天，单人服务客户数受限于信息处理瓶颈。
+
+**目标用户：**
+
+- 客户成功经理（CSM）— 直接对客户健康度负责，每日检视并介入高风险客户
+- 客服主管 — 团队 KPI、SLA、人力调度责任人
+- 数据分析师 — 季度健康度报告与流失预测模型迭代
+- 租户管理员（Admin）— 配置权限、订阅、外部集成
+
+**价值主张：**
+
+- 跨系统聚合的客户旅程视图，单页可视化 ≥ 12 个月历史
+- LLM 自动摘要近 30 天高风险对话，CSM 单客户处理时间从 18 分钟降至 6 分钟
+- 风险评分与触达建议同源，CSM 单人服务客户数从 30 提升至 40
+
+### What Makes This Special
+
+灵协 Linkly 是国内首个同时整合"旅程画布 + LLM 摘要 + 风险评分"的客户成功 SaaS。国内同类产品（聚客云、客成 Pro、销售易 CS、灵客通）只覆盖其中 1-2 项能力。差异化的核心壁垒：
+
+- 旅程画布的多源聚合管线（≥ 12 个月历史，分钟级 CDC 同步）
+- 可解释风险评分模型（每条预警附 top-3 触发因子）
+- LLM 摘要质量基线 ≥ 4.2/5（人工标注 100 样本）
+
+## Project Classification
+
+| 维度       | 取值                                         |
+| ---------- | -------------------------------------------- |
+| 项目类型   | saas_b2b（多租户 · B2B 订阅 · Web 优先）    |
+| 领域       | general（含轻度 fintech/healthcare 客户合规） |
+| 复杂度     | medium                                       |
+| 项目阶段   | greenfield · MVP 计划 2026 H2                |
+
+## 2. Success Criteria
+
+### User Success
+
+- **SC-01 流失预警触达率：** 从 30%（2025 Q4 客服日志抽样）提升至 ≥ 95%；测量 = `工单系统 risk_alert_acknowledged 数 ÷ 同期 risk_alert 数`；滚动窗口 30 天；6 个月内达标。链接 §1 愿景"24 小时内触达"。
+- **SC-02 CSM 单客户处理时间：** 从 18 分钟（2025 Q4 内部计时）降至 ≤ 6 分钟；测量 = LLM 摘要采纳后到工单创建的时长中位数；滚动窗口 30 天；上线后 90 天达标。链接 §1 价值主张第二条。
+- **SC-03 LLM 摘要采纳率：** 上线后 ≥ 80%；测量 = `CSM 标记 "采用" 的摘要数 ÷ 总生成摘要数`；滚动窗口 7 天；上线后 60 天达标。
+
+### Business Success
+
+- **SC-04 试点客户 NPS：** ≥ 45；测量 = 季度调研 N ≥ 100；上线后第二个完整季度达标。
+- **SC-05 12 个月内付费客户数：** ≥ 80；测量 = 财务系统在册付费租户数；GA 后 12 个月内达标。
+- **SC-06 单客户平均合同金额（ACV）：** ≥ ¥180,000/年；测量 = 财务系统月度 ACV 中位数；上线后 6 个月达标。
+
+### Technical Success
+
+- **SC-07 月度 SLA：** ≥ 99.9%（工作日 8:00-22:00）；测量 = 云厂商 + 内部 SLO 监控双源校验；MVP 上线即达标。
+- **SC-08 平台并发：** 单租户支持 1000 并发用户；测量 = 季度压测报告；MVP 上线即达标。
+
+## 3. Product Scope
+
+### MVP — Minimum Viable Product（2026 H2 上线）
+
+按 capability area 分组，每条对应 §8 中的 FR：
+
+- **客户档案管理：** 多源数据聚合 · 标签 · 检索（FR-PROFILE-01..04）
+- **旅程画布：** 单租户视图 · 12 个月历史 · 时间轴（FR-JOURNEY-01..04）
+- **风险预警：** 3 类规则引擎 · 工单系统单向集成（FR-RISK-01..04）
+- **AI 摘要：** 近 30 天对话摘要 · 触达建议（FR-SUMMARY-01..04）
+- **工单整合：** 钉钉 / 飞书 / Salesforce 单向同步（FR-TICKET-01..04）
+- **租户与权限：** 4 角色 RBAC · 基础订阅层级（FR-TENANT-01..04）
+
+### Out-of-Scope（明确不做，原因附后）
+
+- 海外多语：首期客户均为国内中型企业，海外需求量 < 5%
+- 自营客服坐席系统：与现有合作伙伴（Salesforce/钉钉客服）重叠，避免市场冲突
+- 自营 CRM：仅消费现有 CRM 数据，不替代销售易 / Salesforce
+- 移动原生 App：MVP 仅 Web，移动需求由 PWA 满足
+- 客户健康度模型客户自调校：MVP 用平台默认模型，调校能力留给 Growth 阶段
+- 自动触达执行（自动外呼 / 自动 IM）：MVP 仅生成建议，CSM 手动确认后执行
+
+### Growth Features（2027 Q1）
+
+- 客户健康度模型可调校（租户管理员可定制规则 + 权重）
+- 移动 PWA（CSM 端简化版 — 高风险预警 + 触达确认）
+- 多 LLM 厂商抽象层（通义 / 文心 / 智谱 ≥ 2 家）
+- 跨租户行业基准对比（匿名）
+
+### Vision Phase（2027 H2+）
+
+- 自动触达执行（IM 推送 / 邮件，需客户授权）
+- 客户健康度模型 ML 增强（规则 + 机器学习混合）
+- 海外多语支持（英语 + 日语优先）
+- 客户成功知识库（行业最佳实践沉淀）
+
+## 4. User Journeys
+
+### 4.1 CSM 日检视旅程
+
+**Persona：** 客户成功经理（CSM）
+**触发：** 工作日上午 9:00 进入工作台
+
+| #   | 动作                            | 触点                  | 情绪   | 痛点 / 当前差距          |
+| --- | ------------------------------- | --------------------- | ------ | ------------------------ |
+| 1   | 打开客户旅程工作台              | Web 工作台首页         | 期待   | 当前需手动多系统切换     |
+| 2   | 查看高风险客户列表（按健康度排序）| 风险预警面板          | 警觉   | 当前用 Excel 凭经验维护   |
+| 3   | 点击客户卡片查看 30 天摘要       | 客户档案 · 摘要 Tab    | 专注   | 当前需翻看客服记录 18 分钟 |
+| 4   | 查看推荐触达策略与触发因子       | 触达建议面板          | 紧迫   | 当前凭经验拍板           |
+| 5   | 一键创建工单并触达客户           | 工单 + IM 集成        | 满足   | 当前需手动跳转工单系统   |
+| 6   | 在 IM 中跟进客户回复             | 钉钉 / 飞书           | 投入   | -                        |
+| 7   | 标记触达结果（采纳 / 拒绝建议）  | 触达建议面板（回填）   | 反思   | 当前无反馈回路           |
+
+**成功路径：** 触达后 24 小时内客户回复，工单标记 `acknowledged`。
+**失败路径：** 工单进入 24 小时超时队列，触发主管复盘提醒。
+
+### 4.2 客服主管周复盘旅程
+
+**Persona：** 客服主管
+**触发：** 每周一上午查看上周团队数据
+
+| #   | 动作                                | 触点                  | 情绪   |
+| --- | ----------------------------------- | --------------------- | ------ |
+| 1   | 打开团队 KPI 看板                   | 主管工作台 · KPI Tab   | 评估   |
+| 2   | 查看上周触达率 / 处理时长 / 工单 SLA | 团队 KPI 卡片          | 关注   |
+| 3   | 下钻到 CSM 个人维度                 | KPI 看板 · 人员视图    | 分析   |
+| 4   | 识别需调度的工单或人力              | 工单系统视图          | 决策   |
+| 5   | 在 IM 与 CSM 沟通调度方案            | 钉钉群                | 协作   |
+| 6   | 标记复盘问题进入下周改进项          | 复盘记录              | 投入   |
+
+**成功路径：** 上周问题在本周内被改进项覆盖。
+
+### 4.3 数据分析师季度报告旅程
+
+**Persona：** 数据分析师
+**触发：** 每季度末对管理层产出健康度报告
+
+| #   | 动作                                  | 触点                | 情绪   |
+| --- | ------------------------------------- | ------------------- | ------ |
+| 1   | 导出本季度全量客户健康度数据          | 数据导出 · 高级 Tab  | 准备   |
+| 2   | 在外部 BI 工具中分析趋势              | 自有 BI（如 FineReport）| 分析   |
+| 3   | 提取 top 10 流失客户的触发因子分布    | 风险评分明细        | 洞察   |
+| 4   | 与产品团队评审是否调整健康度规则       | 评审会               | 协作   |
+| 5   | 给管理层提交季度健康度报告            | 报告导出            | 完成   |
+
+### 4.4 Admin 集成配置旅程
+
+**Persona：** 租户管理员
+**触发：** 新租户开通后的首次配置
+
+| #   | 动作                          | 触点                  | 情绪   |
+| --- | ----------------------------- | --------------------- | ------ |
+| 1   | 登录管理后台                  | 管理后台首页          | 期待   |
+| 2   | 配置 CRM（销售易 / Salesforce）连接 | 集成中心            | 专注   |
+| 3   | 验证连接并触发首次数据同步     | 集成中心 · 同步状态   | 等待   |
+| 4   | 配置钉钉 / 飞书 IM 应用        | 集成中心 · IM Tab     | 专注   |
+| 5   | 邀请 CSM 加入租户              | 用户管理              | 推进   |
+| 6   | 配置 RBAC 角色与订阅层级        | 用户管理 · 角色 Tab    | 决策   |
+
+**失败路径：** CRM API 凭据错误时给出明确错误指引（FR-TENANT-04）。
+
+## 5. Domain Requirements
+
+### 5.1 数据合规（强制）
+
+合规依据：[domain-research.md §3](./domain-research.md)
+
+- **5.1.1 跨租户隔离：** 客户对话原文与档案数据不跨租户可见，租户级行级隔离强制启用
+- **5.1.2 LLM 调用合规：** LLM API 调用不存储客户原始对话于第三方，仅缓存生成的摘要文本（缓存有效期 ≤ 30 天）
+- **5.1.3 审计日志：** 覆盖登录、查询、导出、配置变更、API 调用 5 类行为；字段含操作者、时间戳、目标资源、IP、结果；保留 ≥ 180 天
+- **5.1.4 数据备份：** 日全量 + 小时增量，备份保留 30 天，跨可用区冗余
+- **5.1.5 数据导出：** 租户管理员可申请租户全量数据导出，承诺 30 天内交付加密压缩包
+- **5.1.6 数据删除：** 客户解约后 90 天内完成数据删除（含备份回收），删除日志记录入合规链
+
+### 5.2 行业术语表
+
+| 术语          | 英文                       | 本产品内定义                                                       |
+| ------------- | -------------------------- | ------------------------------------------------------------------ |
+| 健康度        | Customer Health Score      | 0-100 综合评分，由 5 类信号加权计算（详见 FR-RISK-02）             |
+| 流失预警      | Churn Risk Alert           | 健康度 < 40 或触发任一硬性规则时生成的通知                         |
+| 触达          | Outreach                   | CSM 主动联系客户的动作（含工单创建 + IM 消息推送）                  |
+| 旅程画布      | Journey Canvas             | 客户全生命周期事件的时间轴可视化（≥ 12 个月，分钟级 CDC 同步）     |
+| 触达建议      | Outreach Recommendation    | 系统基于客户当前状态生成的下一步行动建议                            |
+| LLM 摘要      | LLM-Generated Summary      | 系统对客户近期对话内容生成的中文摘要，含关键事件、情绪、待办        |
+
+### 5.3 外部依赖
+
+| 依赖系统     | 用途                  | 接入方式             | 限流约束                  |
+| ------------ | --------------------- | -------------------- | ------------------------- |
+| 钉钉开放平台 | IM 应用 + 工单同步    | 自建应用 + Webhook   | 100 QPS                   |
+| 飞书开放平台 | IM 应用 + 工单同步    | 自建应用 + Webhook   | 100 QPS                   |
+| Salesforce   | CRM 数据消费          | REST API + Bulk API  | 单租户日 100k API call    |
+| 销售易       | CRM 数据消费          | OpenAPI              | 单租户日 50k API call     |
+| 国产 LLM API | 摘要 / 触达建议生成   | OpenAI 兼容层        | 单租户月 100k token       |
+
+## 6. Innovation Analysis
+
+### 6.1 核心差异化
+
+灵协 Linkly 是国内**唯一**整合"旅程画布 + LLM 摘要 + 风险评分"三能力的客户成功 SaaS：
+
+| 能力      | 灵协 Linkly | 聚客云 | 客成 Pro | 销售易 CS | 灵客通 |
+| --------- | ----------- | ------ | -------- | --------- | ------ |
+| 旅程画布  | ✅ 多源 12 月 | ⚠️ 时间轴列表 | ❌ | ❌ | ⚠️ 简版 |
+| LLM 摘要  | ✅ 4.2/5 基线 | ❌ | ❌ | ❌ | ❌ |
+| 风险评分  | ✅ 可解释    | ✅ | ✅ | ⚠️ 简版 | ❌ |
+
+详见 [market-research-2026-q1.md §3](./market-research-2026-q1.md)。
+
+### 6.2 技术新颖度
+
+- **LLM 摘要质量基线：** 人工标注 100 样本，平均 ≥ 4.2/5（5 = 完全可用）
+- **风险评分可解释性：** 每条预警附 top-3 触发因子（事件 + 权重 + 时间）
+- **旅程画布性能：** 12 个月历史数据首次加载 ≤ 2.5 秒（FR-JOURNEY-01 + NFR-PERF-02）
+
+### 6.3 风险与缓解
+
+| 风险                            | 等级 | 缓解策略                                                     |
+| ------------------------------- | ---- | ------------------------------------------------------------ |
+| LLM 输出稳定性下降              | 中   | 提示词回归测试集（≥ 50 用例）+ 摘要重生成机制 + 质量监控     |
+| 国内 LLM 厂商策略变化（限流/涨价）| 中   | LLM 适配层抽象，Growth 阶段引入第二家厂商作为备份             |
+| 同类产品快速跟进                | 中   | 12 个月内建立 ≥ 10 个头部客户案例 + 钉钉/飞书深度集成壁垒    |
+| 客户对 AI 信任度低              | 低   | 摘要附原文链接 · 评分附触发因子 · 提供"建议而非自动执行"模式 |
+
+## 7. Project-Type Requirements
+
+### 7.1 多租户模型
+
+- 行级隔离（tenant_id 列强制存在于所有客户数据表）
+- 租户级配置覆盖（每租户可独立配置健康度规则、订阅层级、集成凭据）
+- 数据导出 / 删除按租户粒度（FR-TENANT-03）
+
+### 7.2 RBAC 角色矩阵（4 角色 × 8 类资源）
+
+| 资源           | Admin | Manager | Operator | Viewer |
+| -------------- | ----- | ------- | -------- | ------ |
+| 客户档案       | RW    | RW      | RW       | R      |
+| 风险预警       | RW    | RW      | RW       | R      |
+| 工单           | RW    | RW      | RW       | R      |
+| LLM 摘要       | RW    | RW      | RW       | R      |
+| 团队 KPI       | RW    | RW      | -        | R      |
+| 集成凭据       | RW    | -       | -        | -      |
+| 用户与角色     | RW    | -       | -        | -      |
+| 审计日志       | R     | R       | -        | -      |
+
+R = Read，RW = Read+Write，- = 无权限。
+
+### 7.3 订阅层级
+
+| 层级       | 用户数上限 | 客户档案上限 | LLM 摘要月配额 | 集成数 |
+| ---------- | ---------- | ------------ | -------------- | ------ |
+| Starter    | ≤ 10       | 200          | 5,000 次       | 2      |
+| Team       | ≤ 50       | 2,000        | 30,000 次      | 5      |
+| Business   | ≤ 200      | 20,000       | 200,000 次     | 不限   |
+
+### 7.4 集成清单（MVP）
+
+- 钉钉开放平台（IM + 工单）
+- 飞书开放平台（IM + 工单）
+- Salesforce REST API（CRM 数据消费）
+- 销售易 OpenAPI（CRM 数据消费）
+- Webhook 出口（标准 HTTP POST，租户自定义触发条件）
+
+### 7.5 性能与扩容目标
+
+详见 §9 NFR；本节列出 saas_b2b 场景特有的扩容要求：
+
+- 单租户支持 1000 并发用户（NFR-SCALE-01）
+- 横向扩容（添加应用节点）触发到完成 ≤ 5 分钟（NFR-SCALE-02）
+- 跨可用区高可用部署（NFR-AVAIL-02）
+
+### 7.6 合规需求摘要
+
+- 等保二级（MVP 上线前完成测评）
+- 个保法授权链（参见 §5.1）
+- 数据本地化：仅中国大陆 IDC（参见 §5.1.1）
+
+## 8. Functional Requirements
+
+### 8.1 客户档案管理
+
+- **FR-PROFILE-01：** CSM 可以按公司名 · 标签 · 客户健康度区间检索客户档案，支持组合筛选与排序
+- **FR-PROFILE-02：** CSM 可以查看单个客户的 12 个月聚合活动时间轴，含 CRM 字段变更、客服记录、合同事件、IM 历史
+- **FR-PROFILE-03：** Admin 可以为客户档案添加自定义标签（每客户最多 20 个），标签可作为检索维度
+- **FR-PROFILE-04：** Manager 可以批量更新客户档案的责任 CSM 归属，单次操作上限 200 客户
+
+### 8.2 旅程画布
+
+- **FR-JOURNEY-01：** CSM 可以查看单客户的旅程画布视图（时间轴 + 事件类型聚类 + 健康度趋势线）
+- **FR-JOURNEY-02：** CSM 可以在旅程画布上按事件类型筛选（合同 / 客服 / 产品使用 / IM）
+- **FR-JOURNEY-03：** CSM 可以从旅程画布上的任意事件跳转到对应源系统的详情页
+- **FR-JOURNEY-04：** Admin 可以配置旅程画布默认显示的事件类型范围，租户级生效
+
+### 8.3 风险预警
+
+- **FR-RISK-01：** 系统可以基于规则引擎对每个客户生成 0-100 健康度评分，每日更新
+- **FR-RISK-02：** 系统可以为每条风险预警附带 top-3 触发因子（事件类型 + 时间 + 权重），CSM 可见
+- **FR-RISK-03：** CSM 可以接收高风险客户预警通知（健康度 < 40 或触发硬规则），通过工作台与 IM 双通道
+- **FR-RISK-04：** Admin 可以查看本租户健康度规则配置（MVP 只读，Growth 阶段可调校）
+
+### 8.4 AI 摘要
+
+- **FR-SUMMARY-01：** CSM 可以为单客户生成近 30 天对话摘要，摘要含关键事件、情绪、待办三段
+- **FR-SUMMARY-02：** CSM 可以标记摘要为"采用"或"拒绝"，反馈进入摘要质量监控数据
+- **FR-SUMMARY-03：** 系统可以为高风险预警自动附带 LLM 触达建议（包含建议话术与时点）
+- **FR-SUMMARY-04：** Admin 可以查看本租户 LLM 摘要月配额使用情况，剩余配额低于 20% 时收到通知
+
+### 8.5 工单整合
+
+- **FR-TICKET-01：** CSM 可以从客户档案 / 风险预警一键创建工单并填充上下文摘要
+- **FR-TICKET-02：** 系统可以将创建的工单同步到外部工单系统（钉钉 / 飞书 / Salesforce），单向出口
+- **FR-TICKET-03：** CSM 可以在工作台查看本人创建工单的当前状态（开放 / 进行中 / 已完成 / 超时）
+- **FR-TICKET-04：** 系统可以对超过 24 小时未触达的高风险工单触发主管复盘提醒
+
+### 8.6 租户与权限
+
+- **FR-TENANT-01：** Admin 可以邀请用户加入租户并分配角色（4 角色：Admin / Manager / Operator / Viewer）
+- **FR-TENANT-02：** Admin 可以配置租户级集成凭据（CRM / IM / Webhook），凭据加密存储
+- **FR-TENANT-03：** Admin 可以申请租户级数据完整导出，系统在 30 天内生成加密压缩包
+- **FR-TENANT-04：** 系统可以在集成凭据失效或限流时通知 Admin，包含错误码与排查指引
+
+## 9. Non-Functional Requirements
+
+### 9.1 Performance（profile = saas_b2b）
+
+- **NFR-PERF-01：** API 接口在正常负载下 p95 < 500ms · p99 < 1.5s（APM 监控统计，30 天滚动）
+- **NFR-PERF-02：** 旅程画布首屏（12 个月数据）p95 加载时间 ≤ 2.5 秒（前端 RUM 上报，正常网络）
+
+### 9.2 Availability
+
+- **NFR-AVAIL-01：** 月度 SLA ≥ 99.9%（工作时间 8:00-22:00），双源校验：云厂商 SLA + 内部 SLO 监控
+- **NFR-AVAIL-02：** RTO ≤ 4 小时；RPO ≤ 15 分钟（季度故障演练验证）
+
+### 9.3 Security
+
+- **NFR-SEC-01：** 客户对话与档案数据传输强制 TLS 1.2+；静态加密 AES-256（架构评审条目 + 季度渗透测试）
+- **NFR-SEC-02：** 登录失败 ≥ 5 次锁定账户 30 分钟；可疑 IP 触发二次验证（安全规则引擎日志）
+
+### 9.4 Scalability
+
+- **NFR-SCALE-01：** 单租户支持 1000 并发用户（季度压测报告，95 分位响应时间不超出 NFR-PERF-01 阈值）
+- **NFR-SCALE-02：** 应用节点横向扩容触发到完成 ≤ 5 分钟（K8s HPA 监控记录）
+
+### 9.5 Observability
+
+- **NFR-OBS-01：** 关键链路 distributed trace 覆盖率 ≥ 95%（核心 API + LLM 调用 + 工单同步）；错误率告警延迟 < 5 分钟（告警系统统计）
+
+### 9.6 Compliance
+
+- **NFR-COMP-01：** 审计日志保留 ≥ 180 天，覆盖 §5.1.3 所列 5 类行为（数据归档策略 + 抽样审计）
+- **NFR-COMP-02：** 数据备份保留 30 天，跨可用区冗余；客户可申请历史时点恢复（备份策略文档 + 恢复演练）
+
+---
+
+## Traceability Matrix
+
+| FR ID            | Capability Area | Maps to Vision (§1)              | Maps to Success Criteria  | Maps to Journey Step           |
+| ---------------- | --------------- | -------------------------------- | ------------------------- | ------------------------------ |
+| FR-PROFILE-01    | 客户档案管理    | §1 价值主张 1（统一画布）        | SC-02                     | §4.1 step 2                    |
+| FR-PROFILE-02    | 客户档案管理    | §1 价值主张 1                    | SC-01, SC-02              | §4.1 step 3                    |
+| FR-PROFILE-03    | 客户档案管理    | §1 价值主张 1                    | SC-02                     | §4.1 step 2                    |
+| FR-PROFILE-04    | 客户档案管理    | §1 目标用户（Manager）           | -                         | §4.2 step 4                    |
+| FR-JOURNEY-01    | 旅程画布        | §1 价值主张 1                    | SC-02                     | §4.1 step 1, §4.3 step 2       |
+| FR-JOURNEY-02    | 旅程画布        | §1 价值主张 1                    | SC-02                     | §4.1 step 3                    |
+| FR-JOURNEY-03    | 旅程画布        | §1 价值主张 1                    | SC-02                     | §4.1 step 3                    |
+| FR-JOURNEY-04    | 旅程画布        | §1 目标用户（Admin）             | -                         | §4.4 step 6                    |
+| FR-RISK-01       | 风险预警        | §1 愿景（24 小时内触达）         | SC-01, SC-04              | §4.1 step 2                    |
+| FR-RISK-02       | 风险预警        | §1 What Makes Special（可解释）  | SC-01, SC-03              | §4.1 step 4                    |
+| FR-RISK-03       | 风险预警        | §1 愿景                          | SC-01                     | §4.1 step 2                    |
+| FR-RISK-04       | 风险预警        | §1 目标用户（Admin）             | -                         | §4.4 step 6                    |
+| FR-SUMMARY-01    | AI 摘要         | §1 价值主张 2                    | SC-02, SC-03              | §4.1 step 3                    |
+| FR-SUMMARY-02    | AI 摘要         | §1 What Makes Special            | SC-03                     | §4.1 step 7                    |
+| FR-SUMMARY-03    | AI 摘要         | §1 价值主张 3（触达建议）        | SC-01, SC-03              | §4.1 step 4                    |
+| FR-SUMMARY-04    | AI 摘要         | §1 目标用户（Admin）             | -                         | §4.4 step 6                    |
+| FR-TICKET-01     | 工单整合        | §1 愿景（24 小时内触达）         | SC-01                     | §4.1 step 5                    |
+| FR-TICKET-02     | 工单整合        | §1 价值主张 3                    | SC-01                     | §4.1 step 5                    |
+| FR-TICKET-03     | 工单整合        | §1 目标用户（CSM）               | SC-01                     | §4.1 step 7                    |
+| FR-TICKET-04     | 工单整合        | §1 目标用户（客服主管）          | SC-01                     | §4.1 fail path, §4.2 step 4    |
+| FR-TENANT-01     | 租户与权限      | §7.2 RBAC                        | -                         | §4.4 step 5                    |
+| FR-TENANT-02     | 租户与权限      | §5.3 外部依赖                    | SC-07                     | §4.4 step 2, step 4            |
+| FR-TENANT-03     | 租户与权限      | §5.1.5 数据导出                  | -                         | §4.4 step 1                    |
+| FR-TENANT-04     | 租户与权限      | §1 目标用户（Admin）             | SC-07                     | §4.4 step 3 (failure path)     |