4. 数据结构设计原则：高内聚低耦合、可扩展性、可追溯性、版本控制原则

在构建“决策记录驱动的项目组合管控多项目视图”数据结构时，必须遵循四项核心设计原则。这些原则确保数据结构能够适应组织级项目管理的复杂性，并在长期演进中保持清晰、稳定与可控。以下分别阐述每项原则的内涵、实施要点及在多项目视图场景下的具体应用。

4.1 高内聚低耦合

高内聚要求每个数据实体（如决策记录、项目卡片、里程碑节点）内部字段紧密围绕单一职责，避免无关属性混杂。低耦合要求实体之间的依赖关系最小化，通过唯一标识符（ID）而非嵌套对象进行关联。

4.2 可扩展性

数据结构必须支持在不破坏现有视图和查询逻辑的前提下，新增字段、实体或关联关系。可扩展性体现在三个层面：

• 字段级扩展：允许为实体添加自定义属性（如扩展属性映射表或 JSON 字段），无需修改核心表结构。
• 实体级扩展：新增实体类型（如“风险登记册”“干系人清单”）时，能够通过标准关联方式与现有决策记录、项目卡片建立连接。
• 视图级扩展：新增多项目视图（如“资源负载视图”“财务健康视图”）时，底层数据结构无需重构，仅需组合已有实体和关联。

// 可扩展的数据模型示例（TypeScript 接口）
interface DecisionRecord {
  id: string;
  title: string;
  context: string;
  options: DecisionOption[];
  conclusion: string;
  timestamp: Date;
  // 扩展属性：允许任意键值对，不破坏核心结构
  extensions?: Record<string, unknown>;
}

interface ProjectCard {
  id: string;
  name: string;
  decisionIds: string[];  // 低耦合引用
  // 新增实体类型可通过类似方式关联
  riskIds?: string[];
  stakeholderIds?: string[];
}

4.3 可追溯性

可追溯性确保从任意一个数据元素（如决策结论、项目状态）能够反向追踪到其来源、变更历史及影响范围。在多项目管控场景中，可追溯性是审计合规和问题定位的基础。

4.4 版本控制原则

数据结构本身及其承载的数据内容都需要版本控制。版本控制原则包含两个层面：

• 数据模式版本（Schema Version）：数据结构定义（如字段名称、类型、约束）的版本管理，确保不同时期的数据能够被正确解析。
• 数据实例版本（Data Version）：每条决策记录或项目卡片在生命周期内的版本演进，支持回滚、对比和审计。

// 版本控制数据结构示例
interface VersionedEntity {
  entityId: string;
  version: number;          // 数据实例版本号，从1递增
  schemaVersion: string;    // 数据模式版本，如 "2.1.0"
  data: Record<string, unknown>;  // 实际业务数据
  previousVersionId?: string;     // 指向上一个版本的ID，形成版本链
  createdAt: Date;
  createdBy: string;
}

4.5 原则综合应用矩阵

在实际设计多项目视图数据结构时，四项原则需要综合权衡。以下矩阵展示了不同视图类型对各项原则的侧重程度：