2、接口契约概念：什么是接口契约、契约驱动设计(CDD)原则、Go中接口契约的体现方式

2.1 接口契约的定义

接口契约（Interface Contract）是软件组件之间的一种正式约定，它明确规定了调用方（Client）与提供方（Provider）各自的权利与义务。在 Go 语言中，接口契约由三部分构成：

2.2 契约驱动设计（CDD）原则

契约驱动设计（Contract-Driven Design, CDD）是一种以接口契约作为系统架构核心的软件设计方法论。它与测试驱动开发（TDD）互补，但更强调边界定义而非实现细节。

CDD 的三大核心原则：

1. 先契约，后实现：在编写任何业务逻辑之前，先定义模块之间的接口契约。
2. 契约即文档：接口签名 + 行为约束构成可执行的文档，替代传统 Word/PDF 设计文档。
3. 双向验证：调用方按契约调用，提供方按契约实现，任何一方违反契约都能被快速发现。

2.3 Go 中接口契约的体现方式

Go 语言通过以下四种机制实现接口契约：

// 典型的 Go 接口契约示例
type ReportGenerator interface {
    // 前置条件：ctx 不能为 nil，params 必须包含 ReportID
    // 后置条件：返回 Report 或具体错误
    Generate(ctx context.Context, params ReportParams) (Report, error)
}

// 调用方按契约使用
func HandleReportRequest(ctx context.Context, gen ReportGenerator, id string) {
    params := ReportParams{ReportID: id}
    report, err := gen.Generate(ctx, params)
    // 调用方依赖契约，不关心具体实现
}

2.4 接口契约的层次结构

在报表模块中，接口契约呈现为清晰的层次结构，从顶层业务到底层基础设施逐级细化：

2.5 契约的演化与版本管理

接口契约不是一成不变的，在报表模块的迭代过程中，契约演化需要遵循以下规则：

• 向后兼容：新增方法时使用接口组合，不修改已有接口定义
• 废弃标记：使用 // Deprecated: 注释标记即将移除的契约
• 版本化接口：如 ReportGeneratorV1、ReportGeneratorV2，避免破坏性变更
• 契约测试：每个接口都应有对应的契约测试，验证前置/后置条件

// 契约演化示例：向后兼容的接口扩展
// v1 版本
type ReportGenerator interface {
    Generate(ctx context.Context, params ReportParams) (Report, error)
}

// v2 版本：通过组合扩展，不破坏 v1 调用方
type ReportGeneratorV2 interface {
    ReportGenerator  // 嵌入 v1 契约
    GenerateAsync(ctx context.Context, params ReportParams) (<-chan ReportResult, error)
}