# SSTC 唯一事实链路架构设计

> **Single Source of Truth Chain (SSTC)** — 从「信息唯一入口」升级为「唯一事实链路」，由规则约束升级为系统强制，彻底杜绝认知差。

---

## 一、核心理念

| 维度 | 原「真理节点」 | 升级后 SSTC |
|------|----------------|-------------|
| 定位 | 信息关联 | 链式数据结构，不可篡改、全链路强绑定、上下游溯源 |
| 约束方式 | 规则建议 | 系统强制 |
| 游离信息 | 允许存在 | **不允许**，任何有效信息必须纳入链路 |
| 竞品对标 | 信息聚合 | 信息闭环强制约束 |

---

## 二、完整链路定义

```
信号源 (Signal)
    ↓ 强制绑定
需求宪章 (Charter)
    ↓ 强制绑定
任务拆解 (Task)
    ↓ 强制绑定
执行落地 (Code/Commit)
    ↓ 强制绑定
发布验证 (Release)
    ↓ 强制绑定
复盘沉淀 (Retrospective)
```

- 每个节点有**唯一 ID**
- 上下游**强制绑定**，不允许断点
- 游离在链路外的信息**不具备执行效力**

---

## 三、核心落地能力

### 3.1 全链路强绑定，无断点闭环

**约束**：任何项目相关操作，必须纳入完整链路。

| 场景 | 规则 | 违规后果 |
|------|------|----------|
| 修改代码逻辑 | 必须关联任务 → 任务关联宪章 → 宪章关联信号源 | 链路缺失时**锁定代码合并权限**，触发对齐提醒 |
| 会议决策 | 必须生成宪章节点才能转化为任务 | 未纳入链路的决策**不具备执行效力** |
| 微信群/口头需求 | 必须先创建宪章再分配任务 | 从根源杜绝「一句话改需求」 |

### 3.2 变更自动溯源，全员同步对齐

**机制**：任一节点变更 → 自动向上溯源 → 全链路对齐校验。

**示例**：
- 底层模型重大更新 → 触发信号节点变更
- 系统自动扫描：所有绑定该模型的宪章、任务
- 自动评估影响 → 生成变更草案 → 推给全员对齐
- 对齐通过后自动调整所有下游节点
- 全程无手动操作，无信息遗漏

### 3.3 不可篡改的版本链

| 属性 | 说明 |
|------|------|
| 版本记录 | 谁改的、改了什么、为什么改，全链路可追溯 |
| 一致性 | 全员看到的永远是对齐后的最新版本 |
| 消除分叉 | 杜绝「有人看旧版、有人看新版」的认知差 |

---

## 四、数据模型（truth_nodes）

对应表结构见 `scripts/pmflow_schema.sql`：

```text
truth_nodes
├── id (BIGSERIAL, 唯一)
├── tenant_id
├── node_type: signal | charter | task | model_update | risk | review | meeting
├── parent_id (上一跳，形成完整链路)
├── project_id
├── created_by
├── title
├── content (JSONB, 节点结构化内容)
├── version (版本号)
└── status: draft | aligned | in_progress | done | archived
```

任务表 `tasks` 通过 `truth_node_id` 强绑定到 truth_nodes，形成 SSTC 闭环。

---

## 五、强制校验规则（系统级）

1. **提交/合并前**：校验 commit 是否绑定有效 task，task 是否绑定有效 charter，charter 是否绑定有效 signal。
2. **宪章创建**：必须关联至少一个 signal；否则无法进入任务拆解。
3. **任务创建**：必须关联至少一个 charter；否则无法进入执行。
4. **版本更新**：仅允许追加版本记录，不允许覆盖或删除历史版本。

---

## 六、竞争力价值

| 竞品 | PMFlow SSTC |
|------|-------------|
| 信息聚合 | 信息闭环强制约束 |
| 靠团队自觉 | 靠系统规则 |
| 信息碎片化 | 底层杜绝碎片化 |
| 易复制的 UI/功能 | 难以快速复制的架构壁垒 |

---

## 七、实施阶段建议

| 阶段 | 内容 |
|------|------|
| P0 | 定义 SSTC 数据模型与版本链结构 |
| P0 | 实现 commit → task → charter 链路校验与合并门禁 |
| P1 | 变更溯源与影响评估引擎 |
| P1 | 全员对齐流程与自动化调整 |
| P2 | 宪章创建强制关联 signal，任务创建强制关联 charter |
| P2 | 版本链 UI 与审计日志 |