+ * 前端传参示例： + *
{@code
+ * POST /qgcExport/exportData
+ * {
+ * "tmDimension": "month",
+ * "dataField": "v,q,z",
+ * "months": "2026-08,2026-07",
+ * "stcd": "00001,00002",
+ * "sysId": "qgc",
+ * "isDailyDimension": true,
+ * "isCalcQec": true
+ * }
+ * }
+ */
+@RestController
+@RequestMapping("/qgcExport")
+@Tag(name = "综合导出")
+public class QgcExportController {
+
+ @Resource
+ private IQgcExportService qgcExportService;
+
+ @PostMapping("/exportData")
+ @Operation(summary = "综合数据导出（ZIP 含多 Sheet Excel）")
+ public void exportData(@RequestParam(required = false) String tmDimension,
+ @RequestParam(required = false) String dataField,
+ @RequestParam(required = false) String months,
+ @RequestParam(required = false) String stcd,
+ @RequestParam(required = false) String sysId,
+ @RequestParam(defaultValue = "true") boolean isDailyDimension,
+ @RequestParam(defaultValue = "false") boolean isCalcQec,
+ HttpServletResponse response) {
+
+ // 解析逗号分隔参数
+ List
+ * 新增指标时：实现本接口 + 在 QgcExportServiceImpl 中注入即可。
+ */
+public interface ExportIndicatorProcessor {
+
+ /**
+ * 指标字段名，与前端 dataField 中的值对应（如 "v", "q", "z"）
+ */
+ String getFieldName();
+
+ /**
+ * Excel Sheet 页中文标题（如 "流速(m/s)"）
+ */
+ String getSheetName();
+
+ /**
+ * 查询原始数据
+ *
+ * @param stcds 测站编码列表（已从电站编码转换）
+ * @param startTime 起始时间
+ * @param endTime 结束时间
+ * @param isDaily 是否查询日表（true=SD_RIVERDAY_S, false=SD_RIVER_R）
+ * @return 原始数据行列表
+ */
+ List
+ * 子类（VProcessor/QProcessor/ZProcessor）需标注 @Component 并提供 getFieldName/getSheetName
+ */
+public abstract class RiverIndicatorProcessor implements ExportIndicatorProcessor {
+
+ protected SdRiverRMapper sdRiverRMapper;
+ protected SdRiverdaySMapper sdRiverdaySMapper;
+
+ private static final SimpleDateFormat SDF_DATETIME = new SimpleDateFormat("yyyy-MM-dd HH:mm:ss");
+
+ public void setMappers(SdRiverRMapper rMapper, SdRiverdaySMapper sMapper) {
+ this.sdRiverRMapper = rMapper;
+ this.sdRiverdaySMapper = sMapper;
+ }
+
+ @Override
+ public List
+ * 格式：每月一个 Excel 文件 → ZIP 下载。
+ * 每个 Excel 含多个 Sheet（每个指标一个 Sheet），每行是一个统计指标。
+ *
+ * 返回的每一行 = [指标名, station1值, station2值, ...]
+ */
+ private List
+ * 每个 GroupedSheetData 作为一个 .xlsx 文件打入 ZIP。
+ */
+ public static void exportGroupedToStream(OutputStream os, List
+ * 日期 | 电站A | 电站B
+ * 日均最低 | 0.523 | 0.612
+ * 日均最高 | 1.234 | 1.456
+ * 月内最低 | 0.412 | 0.523
+ * 月内最低时间 | 2026-08-15 03:00:00 | 2026-08-14 05:30:00
+ * 月内最高 | 2.156 | 2.345
+ * 月内最高时间 | 2026-08-03 12:00:00 | 2026-08-20 18:45:00
+ *
+ */
+@Service
+public class QgcExportServiceImpl implements IQgcExportService {
+
+ private static final Logger log = LoggerFactory.getLogger(QgcExportServiceImpl.class);
+
+ @Resource
+ private StationMappingMapper stationMappingMapper;
+
+ @Resource
+ private SdRiverRMapper sdRiverRMapper;
+ @Resource
+ private SdRiverdaySMapper sdRiverdaySMapper;
+
+ @Resource
+ private VProcessor vProcessor;
+ @Resource
+ private QProcessor qProcessor;
+ @Resource
+ private ZProcessor zProcessor;
+
+ private static final SimpleDateFormat SDF_DATETIME = new SimpleDateFormat("yyyy-MM-dd HH:mm:ss");
+
+ /** 行标题：6 个统计指标 */
+ private static final List使用示例
+ * {@code
+ * GroupedSheetData sheet = new GroupedSheetData("流速(m/s)", "日期",
+ * Arrays.asList("XX水电站", "YY水电站"),
+ * Arrays.asList("日均最低", "日均最高", "月内最低", "月内最低时间", "月内最高", "月内最高时间"));
+ * // 每行：[rowLabel, g0_sub0, g0_sub1, ..., g0_sub5, g1_sub0, ...]
+ * sheet.getRows().add(Arrays.asList("2026-08", 0.5, 1.2, 0.3, "2026-08-15 03:00:00", 2.1, "...", ...));
+ * }
+ */
+ @Data
+ @NoArgsConstructor
+ public static class GroupedSheetData {
+ /** Sheet 页名称 */
+ private String sheetName;
+ /** 行标题列名（如"日期"，该列在 Row0+Row1 纵向合并） */
+ private String rowHeaderLabel;
+ /** 分组名称列表（如["XX水电站","YY水电站"]） */
+ private List