PMFlow/docs/SSTC_ARCHITECTURE.md

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：

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 与审计日志