4、报表模块核心接口设计原则：单一职责、接口隔离、依赖倒置在报表模块中的应用

在构建企业级报表模块时，接口是模块与外部系统、模块内部各组件之间最关键的契约。如果接口设计混乱，报表模块将迅速退化为难以维护的“大泥球”。本章聚焦三大面向对象设计原则——单一职责原则（SRP）、接口隔离原则（ISP）和依赖倒置原则（DIP），阐述它们在 Go 报表模块边界接口中的具体落地方式。

4.1 单一职责原则：接口只做一件事

单一职责原则要求一个接口只包含一组高度相关的行为，变化原因只有一个。在报表模块中，常见的错误是将数据获取、格式转换、输出发送全部塞进同一个接口。

正确的做法是让每个接口只描述一个明确的职责边界：

// 只负责提供原始数据
type DataProvider interface {
    Fetch(ctx context.Context, params QueryParams) ([]Record, error)
}

// 只负责将数据转换为特定格式
type ReportFormatter interface {
    Format(records []Record) ([]byte, error)
}

// 只负责输出或发送
type ReportSender interface {
    Send(ctx context.Context, report []byte, destination string) error
}

4.2 接口隔离原则：客户端不应依赖它不需要的方法

接口隔离原则强调“胖接口”要拆分为多个“瘦接口”。报表模块的典型场景是：不同的调用方（Web 前端、定时任务、API 网关）只需要报表模块功能的一个子集。

通过接口隔离，每个客户端只看到自己需要的契约：

// Web 前端只需要生成和导出
type ReportGenerator interface {
    Generate(ctx context.Context, params ReportParams) (*Report, error)
    ExportPDF(report *Report) ([]byte, error)
    ExportExcel(report *Report) ([]byte, error)
}

// 定时任务只需要调度和发送
type ReportDispatcher interface {
    SendEmail(ctx context.Context, report *Report, recipients []string) error
    SendWebhook(ctx context.Context, report *Report, url string) error
}

// 管理后台只需要归档操作
type ReportArchive interface {
    GetHistory(ctx context.Context, reportID string) ([]ArchiveEntry, error)
    Delete(ctx context.Context, reportID string) error
}

4.3 依赖倒置原则：依赖抽象，不依赖具体实现

依赖倒置原则要求高层模块不应依赖低层模块，两者都应依赖抽象。在报表模块中，这意味着业务编排层（如生成报表的用例）不应直接依赖具体的数据库、文件系统或邮件服务。

在 Go 代码中，依赖倒置通过构造函数注入实现：

// 高层用例只依赖接口
type ReportUseCase struct {
    provider  DataProvider
    formatter ReportFormatter
    sender    ReportSender
}

// 构造函数注入抽象依赖
func NewReportUseCase(p DataProvider, f ReportFormatter, s ReportSender) *ReportUseCase {
    return &ReportUseCase{
        provider:  p,
        formatter: f,
        sender:    s,
    }
}

// 业务逻辑完全面向接口编程
func (uc *ReportUseCase) GenerateAndSend(ctx context.Context, params QueryParams, dest string) error {
    records, err := uc.provider.Fetch(ctx, params)
    if err != nil {
        return fmt.Errorf("fetch data: %w", err)
    }
    report, err := uc.formatter.Format(records)
    if err != nil {
        return fmt.Errorf("format report: %w", err)
    }
    return uc.sender.Send(ctx, report, dest)
}

4.4 三大原则在报表模块中的协同

单一职责、接口隔离、依赖倒置并非孤立存在，它们在报表模块中形成一套完整的接口设计体系：

三者结合后的典型模块结构如下：

// 1. 接口定义（抽象层）—— 遵循 SRP + ISP
type DataProvider interface { Fetch(ctx, params) ([]Record, error) }
type ReportFormatter interface { Format([]Record) ([]byte, error) }
type ReportSender interface { Send(ctx, []byte, string) error }

// 2. 高层用例（业务编排层）—— 遵循 DIP
type ReportOrchestrator struct {
    provider  DataProvider
    formatter ReportFormatter
    sender    ReportSender
}

// 3. 低层实现（具体实现层）—— 可替换
type MySQLProvider struct { /* ... */ }
func (m *MySQLProvider) Fetch(ctx, params) ([]Record, error) { /* 具体SQL */ }

type PDFFormatter struct { /* ... */ }
func (p *PDFFormatter) Format(records []Record) ([]byte, error) { /* PDF生成 */ }

type SMTPSender struct { /* ... */ }
func (s *SMTPSender) Send(ctx, data []byte, dest string) error { /* 发送邮件 */ }