2. 标准模板总体架构：模板分层设计、核心组件介绍、输入输出规范

标准模板总体架构是《平台工程自助目录Collector管道移植适配标准模板》的核心骨架。它通过清晰的分层设计、可复用的核心组件以及严格的输入输出规范，确保不同数据源（如Jenkins、GitLab CI、Argo Workflows）的管道定义能够以统一的方式被采集、解析并输出为标准化的资源模型。本章将详细阐述该架构的三个核心维度：分层设计、组件构成与接口契约。

2.1 模板分层设计

标准模板采用经典的三层架构，自底向上分为：基础适配层、管道解析层和资源输出层。每一层职责单一，层间通过明确定义的接口进行通信，从而降低耦合度，提升模板的可移植性与可维护性。

2.2 核心组件介绍

在分层架构的基础上，标准模板定义了六个核心组件，它们协同工作以完成从原始数据到标准资源的完整转换。下表列出了每个组件的名称、所属层级及核心职责。

2.3 输入输出规范

为了保证模板的可移植性和可测试性，标准模板对每一层的输入输出都制定了严格的规范。这些规范以接口契约的形式定义，所有组件实现都必须遵守。

2.3.1 输入规范

标准模板的输入分为两个层次：适配器输入和解析器输入。

• 适配器输入（AdapterInput）： 包含连接目标系统所需的全部配置信息。

  {
    "sourceType": "gitlab",          // 数据源类型标识
    "endpoint": "https://gitlab.example.com",
    "authToken": "${GITLAB_}",  // 支持环境变量引用
    "projectId": "12345",
    "pipelineId": "67890",
    "options": {                     // 可选参数，如超时、分页大小
      "timeoutSeconds": 30,
      "pageSize": 100
    }
  }

• 解析器输入（ParserInput）： 经过标准化的数据源上下文，包含原始管道定义和元数据。

  {
    "rawDefinition": "stages:\n  - build\n  - test\n...",  // 原始YAML/JSON字符串
    "sourceMetadata": {
      "projectName": "my-service",
      "branch": "main",
      "commitSha": "abc123def456",
      "triggerType": "push"
    },
    "contextId": "ctx-20250321-001"
  }

2.3.2 输出规范

标准模板的最终输出是平台工程目录可消费的标准资源实体列表。每个实体必须包含以下核心字段：

2.4 架构优势与适用场景

标准模板的总体架构设计带来了以下关键优势：

• 高可移植性： 分层设计使得适配新CI/CD系统时，只需关注基础适配层和管道解析层的定制开发，其余部分可直接复用。
• 强一致性： 严格的输入输出规范确保了无论数据源如何变化，最终输出的资源实体结构一致，平台工程目录无需感知底层差异。
• 可测试性： 每一层都有明确的接口契约，可以针对每一层独立编写单元测试和集成测试，提升整体交付质量。
• 可观测性： 核心组件均内置日志和指标埋点，便于在移植适配过程中进行问题定位和性能分析。