1. 课程导论：GoDAG 调度系统概述、边界接口契约的定义与重要性、课程目标与学习路径

1.1 GoDAG 调度系统概述

GoDAG 是一个基于 Go 语言实现的 有向无环图（DAG）任务调度引擎，专为高并发、低延迟、可观测的分布式工作流场景设计。它通过将复杂业务拆解为多个具有依赖关系的原子任务节点，以 DAG 结构描述执行顺序，从而在微服务编排、数据管道、CI/CD 流水线、AI 推理链路等场景中提供确定性调度能力。

核心设计理念包括：

• 声明式 DAG 定义：用户通过 YAML/JSON 或 Go 结构体描述任务依赖，引擎自动解析拓扑排序。
• 并发安全与状态机：每个节点拥有独立状态（Pending → Ready → Running → Success/Failed），通过 Go channel 和 sync 原语保证并发安全。
• 插件化执行器：支持 HTTP、gRPC、Shell、容器等执行方式，通过统一接口扩展。
• 可观测性：内置 OpenTelemetry 链路追踪、Prometheus 指标暴露、结构化日志。

1.2 边界接口契约的定义与重要性

边界接口契约 是 GoDAG 调度系统中 模块之间、组件之间、以及系统与外部调用方之间 所约定的输入/输出格式、行为语义、错误码、超时策略、重试规则等正式规范。它不是一份简单的 API 文档，而是一套可验证、可测试、可版本管理的接口协议。

为什么边界接口契约如此重要？

• 防止“隐式耦合”：没有契约，模块之间会依赖内部实现细节，导致一处改动引发连锁故障。
• 支撑并行开发：前端、后端、调度引擎、执行器团队可基于契约独立开发，通过 mock 测试验证。
• 保障系统演进：契约版本化（如 v1.0.0 → v1.1.0）允许向后兼容，降低升级风险。
• 可测试性与可观测性：契约是自动化集成测试的基准，也是链路追踪中判断调用是否异常的标尺。

1.3 GoDAG 调度系统核心架构

下图展示了 GoDAG 调度系统的核心模块及其边界接口关系。每个箭头代表一组明确的接口契约。

1.4 课程目标与学习路径

本课程旨在帮助学员系统掌握 GoDAG 调度系统中 边界接口契约的设计、实现、测试与演进 全流程。完成本课程后，你将能够：

1. 理解 DAG 调度核心模型：掌握拓扑排序、状态机、并发安全等基础概念。
2. 定义与版本化接口契约：使用 Protobuf / OpenAPI / Go 接口类型定义语法、语义、性能契约。
3. 实现契约驱动的模块：在调度引擎、执行器、可观测性组件之间实现可替换、可测试的接口。
4. 编写契约测试与集成测试：通过 mock 和契约测试框架保障接口兼容性。
5. 应对契约演进与兼容性：掌握向后兼容、废弃策略、多版本共存等实战技巧。

1.5 学习路径与章节地图

课程分为四个阶段，共 30 章。下表展示了各阶段的核心主题与产出物：

下图展示了课程四个阶段的递进关系与核心交付物：

1.6 预备知识与环境要求

• Go 语言基础：熟悉 goroutine、channel、interface、错误处理。
• 分布式系统常识：了解微服务、RPC、消息队列等基本概念。
• 工具链：Go 1.21+、Docker、protoc (≥3.21)、grpcurl、OpenTelemetry Collector。
• 可选：Kubernetes 基础（用于实战篇部署）。