4. 文档关联模块需求分析：文档类型定义、关联关系模型、关联规则与业务场景

文档关联模块是运维数据移交接口中连接“设备实体”与“非结构化文档”的核心枢纽。该模块需要解决三个核心问题：文档是什么类型（类型定义）、文档与设备如何连接（关系模型）、在什么条件下建立/断开连接（关联规则）。本章从需求层面逐层拆解，为后续接口设计奠定业务基础。

4.1 文档类型定义

运维移交场景中，文档并非单一类型。根据文档的生成阶段、法律效力和技术用途，可将文档划分为以下五大基础类型。类型定义决定了文档元数据字段的差异，也影响关联规则的触发时机。

4.2 关联关系模型

文档与设备之间的关联并非简单的“一对一”或“一对多”，而是存在多种语义关系。根据运维移交的实际业务，定义以下四种核心关联关系模型：

• 1:1 归属关系：一份文档唯一归属于一台设备。例如：某台服务器的唯一序列号标签扫描件。文档与设备生命周期严格绑定。
• 1:N 引用关系：一份文档被多台设备共同引用。例如：一份《核心交换机配置基线》被同型号的 10 台交换机引用。文档独立于设备存在。
• M:N 组合关系：多份文档与多台设备形成组合。例如：一个业务系统包含 3 台应用服务器和 2 台数据库服务器，对应 5 份部署文档和 2 份数据备份策略文档。
• N:1 聚合关系：多份文档聚合到一台设备。例如：一台核心路由器关联了设计图、配置文件、测试报告、操作手册共 4 份文档。

4.3 关联规则

关联规则定义了文档与设备在什么条件下建立、变更或解除关联。规则分为三类：自动规则、半自动规则和手动规则。规则配置是模块灵活性的关键。

4.4 业务场景分析

以下四个典型业务场景覆盖了文档关联模块 90% 以上的使用需求。每个场景都对应一组明确的接口调用链和规则触发逻辑。

1. 场景一：新设备上线移交
   • 触发条件：设备编码在 CMDB 中创建，状态变为“待移交”。
   • 关联动作：自动规则触发，系统根据设备型号和机房位置，自动关联预置的设计文档和配置基线。
   • 输出：设备与 3~5 份文档自动建立 1:N 引用关系。
2. 场景二：变更后文档更新
   • 触发条件：变更工单关闭，涉及设备列表已确认。
   • 关联动作：半自动规则触发，系统将变更后的配置文件、测试报告推送给设备负责人，负责人确认后建立关联。
   • 输出：旧文档关联解除，新文档关联建立，变更历史可追溯。
3. 场景三：设备退役解关联
   • 触发条件：设备状态变为“退役”，或设备编码从 CMDB 中删除。
   • 关联动作：自动规则触发，系统批量解除该设备的所有文档关联，并将文档状态标记为“游离”。
   • 输出：关联关系表删除对应记录，文档保留在文档库中供后续复用。
4. 场景四：批量历史文档导入
   • 触发条件：运维人员通过 Excel 或 CSV 批量导入文档元数据。
   • 关联动作：手动规则触发，系统逐行解析设备编码，建立 N:1 聚合关系。
   • 输出：一次导入建立 100+ 条关联记录，支持失败回滚和错误日志导出。

4.5 关联关系数据模型（接口层）

基于以上需求分析，接口层的数据模型设计如下。该模型同时支持四种关联关系和三类规则，是后续接口开发的核心数据结构。

{
  "relation_id": "REL-20250321-001",
  "document_id": "DOC-20250320-045",
  "document_type": "CONFIG",
  "device_codes": ["SW-01", "SW-02", "SW-03"],
  "relation_type": "1:N",
  "rule_type": "AUTO",
  "rule_trigger": "document_upload",
  "status": "ACTIVE",
  "effective_time": "2025-03-21T10:00:00Z",
  "expire_time": null,
  "created_by": "system",
  "created_at": "2025-03-21T10:00:00Z",
  "metadata": {
    "source_system": "CMDB",
    "change_order": "CHG-20250320-010"
  }
}