BK-CI 支撑模块架构指南，涵盖凭证管理(Ticket)、构建机环境(Environment)、通知服务(Notify)、构建日志(Log)、质量红线(Quality)、开放接口(OpenAPI)等支撑性服务模块。当用户开发这些模块功能或需要理解支撑服务架构时使用。
本 Skill 涵盖了 BK-CI 的 6 大支撑模块，这些模块为核心业务提供支撑性服务，不直接参与流水线核心执行逻辑，但提供凭证、环境、通知、日志、质量检查、API 开放等关键能力。
| 模块 | 说明 | 文档 |
|---|---|---|
| Ticket | 凭证管理模块 | 1-ticket-module.md |
| Environment | 构建机环境模块 | 2-environment-module.md |
| Notify | 通知服务模块 | 3-notify-module.md |
| Log | 构建日志模块 | 4-log-module.md |
| Quality | 质量红线模块 | 5-quality-module.md |
| OpenAPI | 开放接口模块 | 6-openapi-module.md |
BK-CI 模块架构
├── 核心业务模块 (直接参与流水线执行)
│ ├── Process (流水线引擎)
│ ├── Auth (权限中心)
│ ├── Project (项目管理)
│ ├── Repository (代码库)
│ ├── Store (研发商店)
│ ├── Artifactory (制品库)
│ ├── Dispatch (构建调度)
│ ├── Worker (构建执行器)
│ └── Agent (构建机)
│
└── 支撑服务模块 (提供支撑能力)
├── Ticket (凭证管理) ⭐
├── Environment (环境管理) ⭐
├── Notify (通知服务) ⭐
├── Log (日志服务) ⭐
├── Quality (质量检查) ⭐
└── OpenAPI (API 网关) ⭐
| 维度 | 核心业务模块 | 支撑服务模块 |
|---|---|---|
| 职责 | 流水线编排、执行、调度、存储 | 提供凭证、环境、通知、日志、质量、API 能力 |
| 耦合度 | 强耦合，相互依赖 | 松耦合，被动提供服务 |
| 调用方向 | 相互调用，协同执行 | 被核心模块调用 |
| 复杂度 | 高 (流程复杂) | 中低 (功能单一) |
| 独立性 | 低 (需协作) | 高 (独立服务) |
┌─────────────────────────────────────────────────────────────┐
│ 核心业务层 │
│ Process / Auth / Project / Repository / Store / │
│ Artifactory / Dispatch / Worker / Agent │
└─────────────────────────────────────────────────────────────┘
│ │ │ │ │
↓ ↓ ↓ ↓ ↓
┌──────────┬──────────┬──────────┬──────────┬──────────┐
│ Ticket │ Env │ Notify │ Log │ Quality │
│ 凭证管理 │ 环境管理 │ 通知服务 │ 日志服务 │ 质量检查 │
└──────────┴──────────┴──────────┴──────────┴──────────┘
│
↓
┌──────────────┐
│ OpenAPI │
│ API 网关 │
└──────────────┘
│
↓
第三方系统
详见 reference/1-ticket-module.md
负责管理各类凭证（Credential）和证书（Cert），为代码库、构建机、部署等场景提供安全的凭证存储和访问服务。
详见 reference/2-environment-module.md
负责管理构建节点（Node）、构建环境（Env）、第三方构建机（Agent）的注册、状态监控、分组等功能。
详见 reference/3-notify-module.md
负责向用户发送各类通知消息，支持多种通知渠道（邮件/企微/RTX/短信）。
负责接收、存储和查询流水线构建过程中产生的日志数据。
详见 reference/5-quality-module.md
负责在流水线执行过程中进行质量检查和拦截，确保只有符合质量标准的构建才能继续执行或发布。
详见 reference/6-openapi-module.md
对外暴露的 API 网关服务，负责将内部微服务的能力通过标准化的 API 对外开放，供第三方系统集成调用。
1. Process (启动流水线)
↓
2. Ticket (获取 Git 凭证)
↓
3. Dispatch (分配构建机)
↓
4. Environment (获取节点信息)
↓
5. Worker (执行构建任务)
↓
6. Log (上报构建日志)
↓
7. Quality (质量检查)
↓ (失败)
8. Notify (发送失败通知)
第三方系统
↓
OpenAPI (接口鉴权)
↓
Process (触发流水线)
↓
支撑模块 (Ticket/Env/Log/Quality/Notify)
↓
OpenAPI (返回结果)
用户需求
↓
需要开发/理解哪个模块？
├─ 凭证管理 → supporting-modules (reference/1-ticket)
├─ 构建机环境 → supporting-modules (reference/2-environment)
├─ 通知服务 → supporting-modules (reference/3-notify)
├─ 构建日志 → supporting-modules (reference/4-log)
├─ 质量红线 → supporting-modules (reference/5-quality)
├─ 开放 API → supporting-modules (reference/6-openapi)
└─ 核心业务 → 查找对应核心模块 Skill
| 需求 | 模块 | 参考文档 |
|---|---|---|
| 添加新凭证类型 | Ticket | reference/1-ticket-module.md |
| 管理构建机节点 | Environment | reference/2-environment-module.md |
| 添加通知渠道 | Notify | reference/3-notify-module.md |
| 实现日志存储 | Log | reference/4-log-module.md |
| 配置质量规则 | Quality | reference/5-quality-module.md |
| 开放新 API | OpenAPI | reference/6-openapi-module.md |
