3. 核心功能边界：导出模块的职责范围

报表导出模块并非一个简单的“文件另存为”功能，而是一个职责清晰、边界明确的子系统。明确其核心功能边界与非功能边界，是避免模块腐化、保障系统可维护性的关键。本章将围绕“数据获取、格式转换、文件生成、传输分发”四大核心职责，以及“权限、日志、监控”三大非功能约束，构建导出模块的职责全景图。

3.1 核心功能边界：四大职责域

导出模块的职责范围可划分为四个连续的阶段，每个阶段都有明确的输入、输出和边界约束。下表总结了各阶段的职责与关键设计点：

以下SVG图展示了导出模块的四大核心职责域及其数据流转关系：

3.2 各职责域的详细设计要点

3.2.1 数据获取

• 职责边界： 只负责根据传入的查询参数（如时间范围、部门ID、分页信息）从数据源获取原始数据。不进行数据聚合、计算或格式化。
• 典型实现： 通过DAO层或Feign客户端调用数据服务，返回统一的数据结构（如 List<Map<String, Object>>）。
• 避坑指南： 避免在数据获取层进行模板相关的字段映射，否则会导致数据层与模板层耦合。

3.2.2 格式转换

• 职责边界： 将原始数据转换为模板引擎可识别的上下文对象。例如，将数据库中的 dept_id 转换为模板中的 departmentName。
• 典型实现： 使用策略模式，根据模板类型（如PDF、Excel）选择不同的转换器。
• 关键设计： 转换逻辑应支持字段映射、类型转换、默认值填充等能力。

3.2.3 文件生成

• 职责边界： 调用模板引擎（如Apache POI、iText、JasperReports），将上下文与模板合并，生成文件字节流。
• 典型实现： 模板引擎的调用应封装在独立的 TemplateRenderer 接口中，支持多种引擎的切换。
• 关键设计： 文件生成过程应支持超时控制，避免大报表导致线程阻塞。

3.2.4 传输分发

• 职责边界： 将生成的文件投递到目标端，如浏览器下载、邮件附件、FTP服务器或对象存储（如OSS）。
• 典型实现： 使用策略模式，根据分发策略选择不同的 Dispatcher 实现。
• 关键设计： 分发过程应支持重试机制和幂等性，避免重复投递。

3.3 非功能边界：权限、日志、监控

非功能边界是导出模块的“安全护栏”与“可观测性”保障，贯穿所有核心阶段。下表总结了三大非功能约束的设计要点：

以下SVG图展示了非功能边界如何贯穿核心功能阶段：

3.4 边界设计的核心原则

1. 单一职责： 每个模块只做一件事，且做好。数据获取模块不关心模板格式，文件生成模块不关心分发方式。
2. 依赖倒置： 核心模块依赖抽象接口，而非具体实现。例如，文件生成模块依赖 TemplateRenderer 接口，而非具体的POI或iText实现。
3. 开闭原则： 对扩展开放，对修改关闭。新增一种分发方式（如WebSocket推送）时，只需新增一个 Dispatcher 实现，无需修改现有代码。
4. 非功能前置： 权限、日志、监控等非功能约束应在架构设计阶段就纳入考虑，而非在开发后期“打补丁”。