3. 报表导出领域建模（一）：识别核心领域概念

报表导出模块在大多数企业应用中看似简单——接收请求、查询数据、生成文件、返回下载。然而，当数据量达到百万级、格式要求复杂、调度策略多样时，缺乏领域建模的导出模块会迅速退化为难以维护的“大泥球”。本章开始，我们将从领域驱动设计（DDD）的视角，对报表导出进行核心领域概念识别与建模。

3.1 核心领域概念总览

通过事件风暴与业务专家访谈，我们提炼出报表导出领域的四个核心概念：报表模板、数据源、导出格式、调度任务。这四个概念构成了导出模块的“四梁八柱”，它们之间的关系如下表所示：

3.2 报表模板：导出模块的“蓝图”

报表模板是导出模块中最具业务价值的领域概念。它不仅仅是“一个文件”，而是包含了布局结构、数据占位符、样式规则、条件显示逻辑等复杂信息的领域模型。一个典型的报表模板包含以下组成部分：

• 元信息：模板名称、描述、创建人、版本号、生效时间范围。
• 布局定义：页眉、页脚、主体区域、分栏结构、表格/图表占位。
• 数据占位符：标记数据注入位置，如 {{sales_total}}、{{table:order_list}}。
• 样式规则：字体、颜色、边框、对齐方式、条件格式（如负值标红）。
• 关联数据源：每个占位符绑定一个数据源查询或API调用。

3.3 数据源：统一的数据访问抽象

数据源是连接报表模板与底层存储的桥梁。在领域模型中，数据源不应暴露具体的数据库连接细节或API调用方式，而是提供一个统一的查询契约：

// 数据源领域接口（Python 伪代码）
class DataSource(ABC):
    @abstractmethod
    def query(self, params: dict, context: ExecutionContext) -> DataSet:
        """执行查询，返回统一的数据集"""
        pass

    @abstractmethod
    def validate(self) -> bool:
        """验证数据源配置是否可用"""
        pass

    @property
    @abstractmethod
    def schema(self) -> DataSchema:
        """返回数据源的结构定义（字段名、类型）"""
        pass

数据源的类型通常包括：

3.4 导出格式：渲染策略的封装

导出格式是报表导出的“输出端”核心概念。不同的格式（PDF、Excel、CSV、HTML）具有截然不同的渲染引擎和性能特征。在领域模型中，导出格式应封装为策略模式：

# 导出格式策略接口
class ExportFormat(ABC):
    @abstractmethod
    def render(self, template: ReportTemplate, data: DataSet) -> bytes:
        """将模板与数据渲染为指定格式的字节流"""
        pass

    @abstractmethod
    def get_file_extension(self) -> str:
        """返回文件扩展名，如 .pdf, .xlsx"""
        pass

    @abstractmethod
    def get_mime_type(self) -> str:
        """返回 MIME 类型"""
        pass

3.5 调度任务：导出请求的生命周期管理

调度任务是导出模块的“执行引擎”。它负责接收导出请求、协调数据源查询与格式渲染、处理失败重试、记录执行日志。调度任务的状态机是领域建模的关键：

调度任务的核心属性包括：

• 任务标识：全局唯一ID，用于追踪和幂等控制。
• 关联模板：指定使用哪个报表模板进行导出。
• 执行参数：时间范围、过滤条件、输出路径等。
• 触发方式：即时触发、定时触发（Cron）、事件触发。
• 执行记录：开始时间、结束时间、耗时、错误信息、输出文件路径。

3.6 领域概念关系图

将上述四个核心概念整合在一起，形成报表导出模块的领域模型关系图：