# CSP 数据字典（Data Dictionary）

| 项 | 值 |
|---|---|
| 文档名称 | CSP 数据字典 |
| 类型 | 数据字典 |
| 上级 | [需求分析总纲](../需求分析总纲.md) |

> 本字典汇总各模块设计文档（`ldd/M*-设计.md`）中已写明的实体字段，为字段的**单一事实源**；字段随各模块设计细化持续更新。概念级 ER 见总纲 §6。
>
> 说明：仅收录设计文档中已写明的字段；仅有概念、尚无字段清单的实体标注「（字段待详设）」，不臆造字段名。派生字段标注 `(derived)`。

---

## 域 A · 基座（M1 / M2）

### Customer（客户，Nexus 只读同步）
| 字段 | 说明 | 来源模块 |
|---|---|---|
| account_id | 账户 ID（IBG-…） | M1 |
| account_uid | 账户 UID（001…） | M1 |
| jsm_org_id | 关联 TiDB Support(Jira/JSM) 工单的键（M12） | M1 |
| name / alias | 全称（Full Name）/ 别名 | M1 |
| level | 战略分层（KA/SKA/…），与服务等级独立 | M1 |
| technical_support_level | 服务等级（如 Premium），与 level 独立 | M1 |
| region | 所属区域 | M1 |
| country | 国家 | M1 |
| time_zone | 时区 | M1 |

### Contact（联系人）
| 字段 | 说明 | 来源模块 |
|---|---|---|
| —（字段待详设） | 设计文档仅有关系（Customer 1──* Contact）与干系人图谱概念，未列字段 schema | M1 |

### Contract（合同）
| 字段 | 说明 | 来源模块 |
|---|---|---|
| id | 合同 ID | M1 |
| customer_id | 所属客户 | M1 |
| type | 类型：Product / Premium_Support / PS_Service | M1 |
| source | 来源：nexus / virtual | M1 |
| nexus_contract_id? | Nexus 合同 ID（source=nexus 时） | M1 |
| start / end | 生效 / 到期日 | M1 |
| unit_price | 单价 | M1 |
| amount | 合同金额（总额；NRR/GRR 与金额展示用，M5） | M1 |
| arr | 年度经常性收入（ARR，可派生或录入；权益核定 M9、留存 M5 用） | M1 |
| pending_formalization | 待补签正式合同标记（如 Dedicated 客户有 Committed Plan/高 ARR 但**未单独签 PS Contract** → 建 virtual PS_Service 合同兜底、置 true，并提醒 CSM/商务补签；不阻断 PS 交付） | M1 |
| status | 状态 | M1 |

> 三类合同（Product/Premium_Support/PS_Service）为 `type` 枚举，不建独立实体；分别驱动 CSM(M5)/TAM(M3·M4)/PS(M6) 域。
> **Dedicated（大客户专属 PS）无正式 PS Contract 时**：建 `type=PS_Service, source=virtual` 虚拟合同，挂 `source=Dedicated, amount_type=unlimited` 的 Quota，关联其 Committed Plan（Product 合同，高 ARR 为核定依据，M9 FR-APR-05），`pending_formalization=true`。

### ARRSnapshot（ARR 周期快照，留存指标用）
| 字段 | 说明 | 来源模块 |
|---|---|---|
| customer_id | 客户 | M5 |
| period | 快照周期（如月/季，YYYY-MM） | M5 |
| arr | 该周期客户 ARR（= 该客户在效合同 arr 汇总） | M5 |

> 定期快照每客户 ARR；**NRR/GRR/流失率/cohort（M5 FR-REN-06、M10 FR-RPT-07）基于期初/期末快照计算**。避免只存当前 ARR 导致时序指标不可算。

### Quota（Man-days 额度，按授权来源一份）
| 字段 | 说明 | 来源模块 |
|---|---|---|
| id | 额度 ID | M1 |
| customer_id | 所属客户（M:N 绑定的项目须同此客户） | M1 |
| contract_id | 发放该额度的 PS_Service 合同（一个 Paid 合同 / Sponsored / Dedicated 授权 → 一份 Quota） | M1 |
| **source** | 额度来源：`Paid`（付费）/ `Sponsored`（赠予：免费+Justification+酌情核定）/ `Dedicated`（大客户专属 retainer） | M1 |
| **amount_type** | `finite`（有限）/ `unlimited`（仅 Dedicated） | M1 |
| mandays_total | 约定总人天（`unlimited` 时为 ∞、不设上限） | M1 |
| used (derived) | 已消耗 = Σ（绑定本 Quota 的项目）工时，不可手改（Unlimited 也照记 used 供成本/利用率） | M1 |
| remaining (derived) | 剩余 = total − used；`unlimited` 时恒 = ∞ | M1 |

### ProjectQuota（项目↔额度绑定，M:N）
| 字段 | 说明 | 来源模块 |
|---|---|---|
| project_id | 绑定的项目 | M6 |
| quota_id | 绑定的 Quota | M1 |
| seq | 该项目多份 Quota 时的**扣减顺序**（用尽前一份再扣下一份） | M7 |

> **统一模型**：Quota 按**授权来源**发放——一个 Paid 合同 / 一个 Sponsored / 一个 Dedicated = **一份 Quota**。**项目 ↔ Quota = M:N，限同一客户**（`ProjectQuota` 绑定，跨客户禁止）：一份 Quota 可被同客户多个项目共用；一个项目可绑定多份 Quota（某份用尽后由续费 Paid / 新 Sponsored 补充，绑多份时按 `seq` 依次扣减）。项目工时**一律 draw-down** 其绑定 Quota 的 `used`——`finite` 跟踪 remaining + 超支预警；**`unlimited`（Dedicated）照记 used、remaining=∞、不预警超支**。「扣多少」看额度**来源与量**，与 `billable`（是否计投入）是两个维度。

<!-- Order 实体已废除（2026-09-07）：以 Contract 为立项/预算单位，Service Package 降为 Project 属性、范围由 SOW 约定，不再单列订单。Nexus 同步以 Contract 为准。 -->

### 虚拟合同签署记录
| 字段 | 说明 | 来源模块 |
|---|---|---|
| signed_by_contact_id | 签署方（引用 Contact） | M1 |
| signed_at | 签署时间 | M1 |
| signed_version | 签署版本 | M1 |

> 是否强制签署可配：默认 Exceptional Premium_Support 与付费 PS 需签，Sponsored 可选；复用 M8 签署能力。

### User（用户）
| 字段 | 说明 | 来源模块 |
|---|---|---|
| email | 唯一键（Google + 飞书 SSO 按 email 合并） | M2 |
| scope_attributes.region | 所属 Region（Leader/Manager 按此见本 Region） | M2 |
| scope_attributes.own_customers[] | 绑定客户（TAM/CSM 可见范围） | M2 |
| scope_attributes.joined_projects[] | 参与项目（PSE/SA 可见范围） | M2 |
| scope_attributes.own_opportunities[] | 自己商机/客户（Sales 可见范围） | M2 |
| roles[] | 多角色（权限取并集）；枚举对齐总纲 §1.4 | M2 |

> Customer_External 数据范围限定为其相关的项目/交付物（受限只读 + 签署）。**PM = 项目级负责人指派**（`Project.pm`，叠加项目数据范围，非全局角色）；**Manager = Leader 角色 + Region**。

### Role（角色）
| 字段 | 说明 | 来源模块 |
|---|---|---|
| name | 角色名（`CS_Director/TAM/TAM_Leader/PSE/PS_Leader/CSM/Sales/SA/Admin/Ops/Customer_External`） | M2 |
| actions[] | RBAC 动作字典条目（`模块:对象:操作`，基线矩阵见 M2 LDD §3b） | M2 |

> 角色集合动态可配，不 hard-code。

### Permission / DataScopePolicy（权限 / 数据范围策略）
| 字段 | 说明 | 来源模块 |
|---|---|---|
| Permission | = 动作字典条目 `模块:对象:操作`（如 `M6:project:create`）；挂在 Role.actions[] | M2 |
| DataScopePolicy | 由用户属性（角色/Region/own_customers/joined_projects/own_opportunities/项目 PM）计算的可见数据集（范围表见 M2 LDD §3） | M2 |

> **每请求服务端实时解析**（JWT 仅身份），权限变更即时生效；可缓存 + 主动失效。

### UsageMetric（用量 / 采用度）
| 字段 | 说明 | 来源模块 |
|---|---|---|
| —（字段待详设） | 总纲概念为 orgs/clusters/adoption，来自 Clinic/Ops 遥测；设计文档仅列集成来源，未列字段 schema | M1 |

### Cluster（客户集群，一等对象）
| 字段 | 说明 | 来源模块 |
|---|---|---|
| cluster_id / cluster_name | 集群 ID / 名称 | M1 |
| region / tier | 区域 / 等级 | M1 |
| 环境 / 用途 | 环境（生产/测试等）/ 用途 | M1 |
| 关键风险 | 该集群关键风险 | M1 |

> 来源 Ops/Clinic；用于连接问题（M4）、告警（M12）、维护窗口与容量规划；呈现到 360° 集群列表（FR-CUST-14）。

---

## 域 B · TAM 经营（M3 / M4）

### LifecycleStage（生命周期阶段，可配，内置 6 阶段）
| 字段 | 说明 | 来源模块 |
|---|---|---|
| name | 阶段名（默认：Onboarding/Adoption/Value Realization/Renewal/Expansion/Advocacy） | M3 |
| seq | 顺序 | M3 |
| entry_cond | 进入条件（Admin 维护） | M3 |
| exit_cond | 退出条件（Admin 维护） | M3 |
| dwell_threshold | 阶段停留阈值（超时触发告警，FR-LC-01；值待业务） | M3 |
| stall_threshold | Onboarding 停滞阈值（超时提醒 + 喂 M4 阶段停滞线索，FR-LC-04/FR-ENG-12；值待业务） | M3 |

> 阶段停留阈值触发告警；阶段变更事件写入客户时间线。

### OnboardingChecklist / OnboardingItem（M3 轻量清单，FR-LC-02/04）
| 字段 | 说明 | 来源模块 |
|---|---|---|
| checklist.customer_id | 所属客户（Premium 购买/特批触发生成） | M3 |
| item.title | 清单项（默认项见 M3 设计 §2） | M3 |
| item.status | 完成情况（待办/完成） | M3 |
| item.owner / done_at | 负责人 / 完成时间 | M3 |

> 轻量清单（**各模块自建 todo，不建平台级通用任务**）；完成度 = 已完成项/总项（FR-LC-04）。

### Handover（TAM 交接）
| 字段 | 说明 | 来源模块 |
|---|---|---|
| from_TAM | 交接人（当前 TAM） | M3 |
| to_TAM | 接收人（新 TAM） | M3 |
| checklist | 交接 Checklist（见下） | M3 |
| signoff | 双方签字（复用 M8 签署） | M3 |

### Handover Checklist 项
| 字段 | 说明 | 来源模块 |
|---|---|---|
| 交接项 | 交接内容项（默认项从客户 360° 自动带出：Customer Profile / Org Chart / Task·Project / Incident / Meeting Record / FRM&Bug / Cluster Change History / 其他文档） | M3 |
| 情况描述 | 该项现状说明 | M3 |
| 完成情况 | 是否完成 | M3 |
| 完成时间 | 完成时间 | M3 |
| 接收人 | 接收人 | M3 |
| 交接人 | 交接人 | M3 |

### HealthScore（健康度评分，可配加权模型）
| 字段 | 说明 | 来源模块 |
|---|---|---|
| score (derived) | 加权得分 = Σ(因子得分 × 因子权重)，权重 Admin 可配 | M4 |
| level (derived) | 红 / 黄 / 绿分级（阈值 Admin 可配） | M4 |
| 因子：使用量/采用 | ← M1 遥测 / 采用度 | M4 |
| 因子：支持信号 | ← M12（未闭合 P0 Bug / 高频 Incident / 高 ARR FRM） | M4 |
| 因子：满意度 | ← M11（NPS / CSAT） | M4 |
| 因子：参与度/情绪 | ← 触点活动、干系人经营 | M4 |
| trend (derived) | 趋势与关注列表输出 | M4 |

### Risk（风险登记册 Risk Register）
| 字段 | 说明 | 来源模块 |
|---|---|---|
| 描述 | 风险描述 | M4 |
| 来源 | 风险来源（含自动线索） | M4 |
| 严重度 × 可能性 | 严重度与可能性评估 | M4 |
| 责任人 | 责任人 | M4 |
| 缓解措施 | 缓解措施 | M4 |
| 状态 | 状态机：Open → Mitigating → Closed | M4 |
| type | 类型（可配，默认：竞品进入/价格预算/负面声音/赞助人变动/采用不足/技术事故/续约风险） | M4 |
| is_customer_visible | 是否客户可见（外部周报仅含可见项，内部版含全部） | M4 |

> 严重风险触发升级（Escalation）：默认分级 高/中/低，默认升级链 `TAM → TAM Leader → CS Director`（等级与链可配）。自动风险线索由信号（M11/M12/采用度/阶段停滞/长期无触点/续约临近+低健康）生成，TAM 确认后转正式风险或忽略。

### EngagementActivity（经营活动）
| 字段 | 说明 | 来源模块 |
|---|---|---|
| id / customer_id | 主键 / 所属客户 | M4 |
| type | 触点类型（关系维护/答疑/Review/QBR…） | M4 |
| occurred_at / owner | 时间 / 负责人（TAM/CSM） | M4 |
| summary | 纪要/内容 | M4 |
| time_entry_ref | 关联工时（M7 TimeEntry 挂 EngagementActivity；billable 计投入、不耗额度） | M4 |

> **Issue/Todo（并入经营活动，FR-ENG-13）**：客户问题/待跟进事项 = `概述 / 优先级 / 影响 / 状态 / 下一步 / owner / 来源证据链接`；本期手动录入 + 手工贴来源，**各模块自建轻量 todo、不另起平台级通用任务**。
>
> **ResourceCoordinationRequest（资源协调，FR-ENG-06/07）**：TAM 协调 PS/Support/SA 并跟踪闭环——**走 M9 统一 Request（`type=资源协调`）**，复用待办/通知/闭环，M4 只引用、不建独立实体（见 Request）。

### SuccessPlan / Objective / PlaybookTask（FR-ENG-05）
| 字段 | 说明 | 来源模块 |
|---|---|---|
| plan.customer_id | 所属客户 | M4 |
| objective.title / outcome | 客户业务目标 / 成功标准（Objectives/Outcomes） | M4 |
| objective.progress | 目标达成度 | M4 |
| task.title / status / owner | Playbook 动作项（Onboarding/QBR/风险挽回模板实例化）/ 完成情况 / 负责人 | M4 |

> Success Plan 挂客户，跟踪目标达成与 Playbook 任务完成（默认 Playbook 清单见 M4 设计）。

---

## 域 C · CSM 商业（M5）

### Renewal（续约）
| 字段 | 说明 | 来源模块 |
|---|---|---|
| state | 可配状态机：续约识别 → 风险评估 → 续约计划 → 报价/谈判 →（如折扣/特殊条款）审批 → 客户签署 → 完成(Closed-Won) / 流失(Closed-Lost) | M5 |
| owner | 负责人（可配） | M5 |
| 时限 | 各阶段时限（可配） | M5 |
| 看板列 | 看板列映射（可配） | M5 |
| 流失原因 | Closed-Lost 时记录 | M5 |

> 续约识别按到期日 T-90 / T-60 / T-30 分级触发；风险评估依赖 M4 健康度。

---

## 域 D · PS 交付（M6 / M7 / M8）

### Project（交付项目）
| 字段 | 说明 | 来源模块 |
|---|---|---|
| id | 项目 ID | M6 |
| customer_id | 所属客户（立项必选；须有 remaining>0 的 Quota） | M6 |
| contract_id | 所属合同（立项授权来源） | M6 |
| service_package | Service Package（6 类之一；范围由合同 SOW 约定） | M6 |
| mode | 交付模式：project（项目型）/ continuous（持续型） | M6 |
| name | 项目名 | M6 |
| code | 项目编码 | M6 |
| timeline | 时间线 | M6 |
| status | 状态（项目型状态机：Draft → Kickoff Scheduled → In Progress → Deliverable Review → Customer Sign-off → Closed） | M6 |
| product | 产品 | M6 |
| version | 版本 | M6 |
| PS_Leader / PM / PSE[] / TAM | 责任人 | M6 |
| secondary_owner | **备份负责人**（每项目必配，覆盖负责人角色；热备参与者） | M6 |
| coverage | 缺席交接：`start, end, delegate(=secondary)` + 交接便签（休假期委托，走 M9 FR-APR-06） | M6 |

> 项目附带：Baseline(schedule/effort)、EAC(derived)、RAGStatus(schedule/scope/budget/risk)。

### Milestone（里程碑关卡）
| 字段 | 说明 | 来源模块 |
|---|---|---|
| id | 里程碑 ID | M6 |
| project_id | 所属项目 | M6 |
| name | 名称 | M6 |
| seq | 顺序 | M6 |
| doc_template_id | 关联文档模板（关卡三要素之一） | M6 |
| signoff_config | 签署配置（内审/客户，串/并） | M6 |
| entry_cond | 进入条件 | M6 |
| exit_cond | 退出条件 | M6 |
| status | 状态 | M6 |

### Task / Sub-task（任务 / 子任务，严格三层，Sub-task 经 parent_task_id 表达）
| 字段 | 说明 | 来源模块 |
|---|---|---|
| id | 任务 ID | M6 |
| milestone_id | 所属里程碑 | M6 |
| parent_task_id | 父任务（子任务时填写） | M6 |
| title | 标题 | M6 |
| owner | 责任人 | M6 |
| reviewer | 审核人 | M6 |
| est_mandays | 估算人天 | M6 |
| actual_mandays (derived) | 实际人天（来自 TimeEntry 汇总） | M6 |
| due_date | 截止日 | M6 |
| status | 状态 | M6 |
| depends_on[] | 依赖任务（DAG 禁环，仅项目内） | M6 |

### RAID（Risk / Issue / Assumption / Dependency）
| 字段 | 说明 | 来源模块 |
|---|---|---|
| type | 类型：Risk / Issue / Assumption / Dependency | M6 |
| owner | 责任人 | M6 |
| status | 状态 | M6 |

### TimeEntry（工时记录）
| 字段 | 说明 | 来源模块 |
|---|---|---|
| id | 记录 ID | M7 |
| owner | 记录人（TAM/PS/CSM 等，全员） | M7 |
| attach_type | 挂载对象：`项目`（记 Task→汇总到 Project，或直接记 Project）/ `经营活动`(EngagementActivity) / `内部非项目`(学习/市场活动/内部事务等) | M7 |
| attach_ref | 挂载对象引用（依 attach_type：Task/Project · EngagementActivity · 内部类别）；`项目`时可挂 Task 亦可直挂 Project | M7 |
| activity_type | **活动类型（防赖通用桶，FR-RES-10）**：`运维型`(答疑/on-call/巡检，可挂通用桶) / `交付型`(Migration/Upgrade/… 必挂具体项目)；retainer/Dedicated 下必选 | M7 |
| internal_category | 内部非项目类别（学习/培训/内部事务；attach_type=内部非项目 时用，FR-RES-09） | M7 |
| hours | 工时（0.5h 步长） | M7 |
| content | 活动内容（自由文本） | M7 |
| activity_date | 活动日期 | M7 |
| billable (bool) | **是否计入客户人力投入（成本核算）**：`项目`/`经营活动` = true；`内部非项目` = false（overhead，计利用率分母） | M7 |
| submitted_at | 提交时间 | M7 |
| editable_until | 可编辑截止（= submitted_at + 24h，超期需 PM 审批） | M7 |

> 换算：1 人天 = 8h（可配，按 CRM Time Zone）。
> **两维正交**：① `billable` = 计入客户投入（`项目`/`经营活动`=是，`内部非项目`=否）；② **Man-days 额度消耗（draw-down）发生在挂载=`项目`**——挂项目的工时一律 draw-down 项目 Quota.used：`finite` → 跟踪 used/remaining + 超支预警；**`unlimited`（Dedicated 持续型项目）→ 照记 used、remaining=∞、不预警超支**；`经营`/`内部`不 draw-down。二者互不等同。

### Deliverable（交付物）
| 字段 | 说明 | 来源模块 |
|---|---|---|
| Template | 由模板生成（变量自动填充：客户名/产品/版本）；默认模板：Kickoff Deck/调研/方案/上线报告/验收单/复盘 | M8 |

> 交付物本体其余字段待详设；版本与签署见下两表。

### DeliverableVersion（交付物版本）
| 字段 | 说明 | 来源模块 |
|---|---|---|
| version | 版本号（签署版本不可变） | M8 |
| file_hash | 文件哈希 | M8 |
| uploader | 上传人 | M8 |
| uploaded_at | 上传时间 | M8 |
| diff_summary | 变更摘要 | M8 |

### Signoff（客户签署记录）
| 字段 | 说明 | 来源模块 |
|---|---|---|
| signed_version | 签署的版本 | M8 |
| signed_at | 签署时间 | M8 |
| signer | 签署方 | M8 |

> 交付客户前须至少一位 Senior/Manager 审核（可配审核流），审核通过方可进入客户签署。

### Review（内审记录，交付物对客发布前，M8 FR-DEL-03）
| 字段 | 说明 | 来源模块 |
|---|---|---|
| deliverable_version_ref | 被审的交付物版本 | M8 |
| reviewer | 审核人（Senior/Manager/PS Leader，可配审核流） | M8 |
| result | 审核结果（通过/驳回） | M8 |
| comment | 审核意见 | M8 |
| reviewed_at | 审核时间 | M8 |

> 内审留痕是"未经审核对客发布阻断率=100%"（FR-DEL-03 验收）的依据。

### StatusUpdate（项目周期状态更新 / Check-in）
| 字段 | 说明 | 来源模块 |
|---|---|---|
| id / project_id | 主键 / 所属项目 | M6 |
| period | 周期（周次 / 起止日） | M6 |
| rag | 本周健康 RAG（接 FR-PROJ-19） | M6 |
| progress | 本周进展 | M6 |
| next | 下周计划 | M6 |
| risk_refs[] | 关联 RAID 项 | M6 |
| ask | 需支持/升级事项 | M6 |
| mandays_week / burn / milestone_changes | 本周工时/burn/里程碑变化 (derived，自动带出) | M6 |
| submitted_by / submitted_at | 提交人 / 提交时间 | M6 |

> 每项目每周期一条（非单字段累积）；cadence 默认每周、对齐周会、可配。

### EngagementRequest（持续型需求 → 立项 triage）
| 字段 | 说明 | 来源模块 |
|---|---|---|
| id / customer_id / contract_id | 主键 / 客户 / retainer 合同 | M6 |
| source | 来源（客户/TAM/Support） | M6 |
| summary | 需求摘要 | M6 |
| type | 运维型 / 交付型 | M6 |
| triage_by | 把关人（TAM/PS Leader） | M6 |
| decision | 立项 / 并入通用桶 | M6 |
| project_id | 立项后关联项目（可空） | M6 |

> 持续型/Dedicated 立项由 TAM/PS Leader triage 把关（D-P14），执行工程师无立项决定权。

---

## 域 E · 平台通用（M9 / M10 / M11）

### Request（审批请求）
| 字段 | 说明 | 来源模块 |
|---|---|---|
| id | 请求 ID | M9 |
| type | 类型：complimentary / 立项 / 超支 / 状态跳转 / 交付签署 / 续约 / 项目关闭 / **资源协调（FR-ENG-06/07，可非审批仅跟踪闭环）**… | M9 |
| subject_ref | 关联业务对象 | M9 |
| applicant | 申请人 | M9 |
| payload (json) | 载荷 | M9 |
| arr_input | ARR 输入（权益核定用） | M9 |
| status | pending / approved / rejected / withdrawn | M9 |
| current_node | 当前节点 | M9 |
| audit_log[] | 审计日志 | M9 |

### ApprovalNode / ApprovalStep（审批节点）
| 字段 | 说明 | 来源模块 |
|---|---|---|
| seq | 顺序 | M9 |
| mode | serial（串行）/ parallel（并行，可配全签/或签） | M9 |
| approvers[] | 审批人 | M9 |
| condition | 条件表达式（分支，如 amount > $X → VP 节点） | M9 |
| result | 结果 | M9 |
| comment | 意见 | M9 |
| decided_by | 决策人 | M9 |
| decided_at | 决策时间 | M9 |

> ApprovalChain：每个 request_type 绑定一条可配审批链（由 ApprovalNode 模板组成）。

### Automation（自动化规则引擎）
| 字段 | 说明 | 来源模块 |
|---|---|---|
| trigger | 触发：状态变更/字段变更/到期前 N 天/定时/事件（合同生效/审批通过、告警） | M9 |
| condition | 条件 | M9 |
| actions[] | 动作：指派/建任务/发通知加急/状态流转/生成 Request | M9 |

### Delegation（缺席委托 / Out-of-Office）
| 字段 | 说明 | 来源模块 |
|---|---|---|
| user_id | 缺席人 | M9 |
| delegate_id | 代理人 | M9 |
| start / end | 缺席期起止（到期自动回退） | M9 |
| scope | 委托范围（可按类型/模块限定，默认全部待办/审批） | M9 |

> 共有能力，供各模块复用（M6 交付负责人/Secondary 休假顶岗、审批人缺席）。

### Dashboard（看板）
| 字段 | 说明 | 来源模块 |
|---|---|---|
| owner_role | 绑定角色 | M10 |
| name | 名称 | M10 |
| layout | 布局（Widget 拼装） | M10 |

### Widget（看板组件）
| 字段 | 说明 | 来源模块 |
|---|---|---|
| type | 类型：卡片/趋势线/排行/漏斗/热力 | M10 |
| data_source | 数据来源（各模块只读消费） | M10 |
| filter | 过滤条件 | M10 |
| viz | 可视化形式 | M10 |

> Portfolio 为跨对象组合视图（多 Dashboard 聚合）。

### Survey（问卷）
| 字段 | 说明 | 来源模块 |
|---|---|---|
| version | 版本：Leadership 版 / DBA·技术版 | M11 |
| audience | 受众 | M11 |
| cycle | 周期（半年发放，配置化） | M11 |
| questions[] | 题目（Survey 1──* Question） | M11 |

### SurveyRun（周期发放实例）
| 字段 | 说明 | 来源模块 |
|---|---|---|
| 对象 | 发放对象 | M11 |
| 渠道 | 发放渠道（TAM/Sales 发放链接） | M11 |

### SurveyResponse（答卷）
| 字段 | 说明 | 来源模块 |
|---|---|---|
| customer | 所属客户 | M11 |
| answers | 答案 | M11 |
| ts | 时间戳 | M11 |
| Score (derived) | 派生 NPS/CSAT 分 | M11 |

> 机密可见性（默认）：原始答卷 → Leadership + 归属 TAM；聚合分 → 团队/管理层；调研事件 → 客户 360° 相关角色（与 M2 字段级 ABAC 联动）。SatisfactionView 为聚合的全客户单一满意度视图，喂 M4 健康度。

---

## 域 F · 客户支持集成聚合（M12，外部真源，只读投影，字段映射待 OQ-S3 确认）

### Incident（事故，源：tidb.support）
| 字段 | 说明 | 来源模块 |
|---|---|---|
| 分级 | 事故分级 | M12 |
| 发生/发现/解决时间 | 用于 MTTR | M12 |
| 状态 | 状态 | M12 |
| RCA 链接 | 根因分析链接 | M12 |
| 客户侧响应人 | 客户侧响应人 | M12 |

### FRM（源：Jira）
| 字段 | 说明 | 来源模块 |
|---|---|---|
| ARR 影响 | ARR 影响 | M12 |
| 优先级 | 优先级 | M12 |
| 状态 | 状态 | M12 |
| 关联研发单 | 关联 Jira 研发单 | M12 |

### Bug（源：Jira / GitHub）
| 字段 | 说明 | 来源模块 |
|---|---|---|
| 修复版本 | 修复版本 | M12 |
| 目标日期 | 目标日期 | M12 |
| 状态 | 状态 | M12 |

### SLA（源：Support Plan）
| 字段 | 说明 | 来源模块 |
|---|---|---|
| 响应时限与达成 | Premium 5×8 群 / 7×24 Ticket 响应时限与达成 | M12 |

### Alarm（告警，源：告警 bot）
| 字段 | 说明 | 来源模块 |
|---|---|---|
| 事件类型 | 事件类型 | M12 |
| 时间 | 时间 | M12 |
| 严重度 | 严重度（Lark/Slack/Email） | M12 |

---

## 域 E · 流程与资源中心（M13）

### HubEntry（流程/资源目录条目）
| 字段 | 说明 | 来源模块 |
|---|---|---|
| name | 名称 | M13 |
| category | 分类（可扩展） | M13 |
| summary | 摘要 | M13 |
| wiki_link | 飞书 Wiki 说明链接（不复制内容） | M13 |
| apply_method | 申请方式：form / redirect / automation / guidance_only | M13 |
| owner | 负责人 | M13 |
| sla | SLA | M13 |