125 lines
4.0 KiB
Markdown
125 lines
4.0 KiB
Markdown
# 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 与审计日志 |
|