trafficAudit.git

			@@ -13,6 +13,7 @@
			import com.trafficaudit.dataimport.entity.PassengerEnterpriseMonthly;
			import com.trafficaudit.dataimport.entity.PassengerIndividualMonthly;
			import com.trafficaudit.dataimport.entity.ScaleSplitTransport;
			import com.trafficaudit.dataimport.entity.WycOrderMonthly;
			import com.trafficaudit.auditengine.entity.AuditResult;
			import com.trafficaudit.auditengine.entity.AuditRun;
			import com.trafficaudit.auditengine.mapper.AuditResultMapper;
			@@ -29,6 +30,11 @@
			import com.trafficaudit.dataimport.mapper.PassengerEnterpriseMonthlyMapper;
			import com.trafficaudit.dataimport.mapper.PassengerIndividualMonthlyMapper;
			import com.trafficaudit.dataimport.mapper.ScaleSplitTransportMapper;
			import com.trafficaudit.dataimport.mapper.WycOrderMonthlyMapper;
			import com.trafficaudit.reportexport.calc.MidCalc;
			import com.trafficaudit.reportexport.calc.PaxCalc;
			import com.trafficaudit.reportexport.calc.SummaryWorkbookFiller;
			import com.trafficaudit.reportexport.calc.WycSplitCalc;
			import lombok.extern.slf4j.Slf4j;
			import org.apache.poi.ss.usermodel.Cell;
			import org.apache.poi.ss.usermodel.CellStyle;
			@@ -50,6 +56,7 @@
			import org.springframework.stereotype.Service;

			import javax.annotation.Resource;
			import java.io.ByteArrayInputStream;
			import java.io.ByteArrayOutputStream;
			import java.io.File;
			import java.io.FileInputStream;
			@@ -92,6 +99,12 @@
			private CityBusMonthlyMapper cityBusMapper;
			@Resource
			private CityTaxiMonthlyMapper cityTaxiMapper;
			@Resource
			private SummaryWorkbookFiller summaryWorkbookFiller;
			@Resource
			private WycSplitCalc wycSplitCalc;
			@Resource
			private WycOrderMonthlyMapper wycOrderMapper;
			@Resource
			private AuditResultMapper auditResultMapper;
			@Resource
			@@ -211,6 +224,36 @@
			rows = 0;
			notes.add("母版定位失败：" + ex.getMessage());
			}
			break;
			}
			case "investPassengerDetail":
			case "investLogisticsDetail": {
			boolean paxDetail = "investPassengerDetail".equals(t);
			String catName = paxDetail ? "客运站场" : "物流园区";
			String catLabel = paxDetail ? "客运站场投资月报" : "物流园区投资月报";
			List<InvestmentProject> catProjects = investProjectMapper.selectList(
			new LambdaQueryWrapper<InvestmentProject>().eq(InvestmentProject::getCategory, catName));
			final List<Long> catIds = new ArrayList<>();
			for (InvestmentProject cp : catProjects) catIds.add(cp.getId());
			if (catIds.isEmpty()) {
			rows = 0;
			notes.add("缺数据：" + catLabel);
			} else {
			rows = addReadyCount(() -> investMonthlyMapper.selectCount(
			periodQw(period, mode, InvestmentMonthly::getReportPeriod)
			.in(InvestmentMonthly::getProjectId, catIds)), catLabel, notes);
			}
			String detTpl = paxDetail ? "模板_X月客运站投资明细表.xlsx" : "模板_X月物流站场投资明细.xls";
			try {
			if (resolveAnyTemplate(investTemplateDir, detTpl) == null) {
			rows = 0;
			notes.add("docs/投资/模板下缺少《" + detTpl + "》");
			}
			} catch (Exception ex) {
			rows = 0;
			notes.add("母版定位失败：" + ex.getMessage());
			}
			auditTypes.add("INVEST");
			break;
			}
			default:
			@@ -334,12 +377,7 @@
			if (resolveSummaryMother(period, mode) == null) {
			problems.add("docs/生成汇总大表下缺少可复制的母版汇总表");
			} else {
			Map<Integer, Map<String, double[]>> busM = loadCityBusByMonth(yearPrefix, month);
			Map<Integer, Map<String, double[]>> taxiM = loadCityTaxiByMonth(yearPrefix, month);
			Map<String, double[]> bc = busM.get(month);
			Map<String, double[]> tc = taxiM.get(month);
			if (bc != null && bc.get("全省") != null) addSum(summary, "城市公交客运量（全省当月）", bc.get("全省")[0], "万人");
			if (tc != null && tc.get("全省") != null) addSum(summary, "巡游出租客运量（全省当月）", tc.get("全省")[0], "万人");
			summaryWorkbookPreview(period, yearNum, month, summary, problems);
			}
			} catch (Exception ex) {
			problems.add(ex.getMessage());
			@@ -373,7 +411,9 @@
			coverage.addAll(investCover);
			// 投资为当月报表（无 1..N 累计口径），只提示当月缺失
			if (!investCover.contains(month)) missing.add(month);
			investPreview(period, mode, summary, problems);
			if ("investPassengerDetail".equals(t)) investPreview(period, mode, "客运站场", summary, problems);
			else if ("investLogisticsDetail".equals(t)) investPreview(period, mode, "物流园区", summary, problems);
			else investPreview(period, mode, summary, problems);
			} else if ("energySummary".equals(t)) {
			Long ec = energyMapper.selectCount(periodQw(period, mode, EnergyVehicleQuarterly::getReportPeriod));
			if (ec != null && ec > 0) coverage.add(month);
			@@ -404,7 +444,8 @@
			}

			private boolean isInvestType(String t) {
			return "investPlan".equals(t) \|\| "investFiveYearLogistics".equals(t) \|\| "investBillion".equals(t) \|\| "investCounty".equals(t);
			return "investPlan".equals(t) \|\| "investFiveYearLogistics".equals(t) \|\| "investBillion".equals(t) \|\| "investCounty".equals(t)
			\|\| "investPassengerDetail".equals(t) \|\| "investLogisticsDetail".equals(t);
			}

			private boolean isEnergyType(String t) {
			@@ -441,6 +482,118 @@
			sb.append(m).append("月");
			}
			return sb.toString();
			}

			/** 汇总整本关键指标预览：货运量/周转量、城市客运、中口径的当月、1..M 累计、当月同比、累计同比（同比取库内去年同期，缺则显示—） */
			private void summaryWorkbookPreview(String period, int year, int month,
			List<Map<String, Object>> summary, List<String> problems) {
			String yearPrefix = year + "-";
			// ---- 货运（量=模板_货运量周转量全省行；周转量=规上规下拆分表全省行） ----
			FreightTurnoverImport ft = loadFreightTurnover(period).get("湖北省");
			Double fm = ft == null ? null : freightMonth(ft, month);
			Double fcum = ft == null ? null : freightCum(ft, month);
			Double fy = ft == null ? null : freightYoy(ft, month);
			Double fcy = ft == null ? null : freightCumYoy(ft, month);
			addKpi(summary, "全省货运量", fm, fcum, fy, fcy, "万吨");
			if (fm != null && fy == null) {
			problems.add((year - 1) + "-" + String.format("%02d", month) + " 同期货运量数据未导入库，货运量当月/累计同比暂不显示，待 2025 年定稿数据导入后自动出现");
			}
			ScaleSplitTransport tm = loadProvinceMonthMap(period).get(month);
			ScaleSplitTransport tc = getProvinceCumulative(period);
			Double tvM = tm == null ? null : tm.getTotalTurnover();
			Double tvC = tc == null ? null : tc.getTotalTurnover();
			Double tvMY = tm == null ? null : getYoyMetric(tm, "turnover", "total");
			Double tvCY = tc == null ? null : getYoyMetric(tc, "turnover", "total");
			addKpi(summary, "全省货物周转量", tvM, tvC, tvMY, tvCY, "万吨公里");
			if (fm == null) problems.add("模板_货运量周转量缺 " + period + " 当月数据，货运量仅能提供截至最近导入月的累计");
			if (tvM == null) problems.add("规上规下拆分缺 " + period + " 当月数据，周转量/规上规下当月缺，累计为截至最近导入月");

			// ---- 城市客运（公交+出租+轨道+轮渡全省小计；指标位 0/2/4/6=客运，1/3/5/7=周转） ----
			double[] cumM = cityCumProv(yearPrefix, month);
			double[] cumPrev = cityCumProv(yearPrefix, month - 1);
			double[] monthVec = diff8(cumM, cumPrev);
			double cityPaxM = sumIdx(monthVec, new int[]{0, 2, 4, 6});
			double cityTurnM = sumIdx(monthVec, new int[]{1, 3, 5, 7});
			double cityPaxC = sumIdx(cumM, new int[]{0, 2, 4, 6});
			double cityTurnC = sumIdx(cumM, new int[]{1, 3, 5, 7});
			double[] lastCumM = cityCumProv((year - 1) + "-", month);
			double[] lastCumPrev = cityCumProv((year - 1) + "-", month - 1);
			double[] lastVec = diff8(lastCumM, lastCumPrev);
			double lastPaxM = sumIdx(lastVec, new int[]{0, 2, 4, 6});
			double lastPaxC = sumIdx(lastCumM, new int[]{0, 2, 4, 6});
			double lastTurnM = sumIdx(lastVec, new int[]{1, 3, 5, 7});
			double lastTurnC = sumIdx(lastCumM, new int[]{1, 3, 5, 7});
			addKpiRaw(summary, "城市客运量", cityPaxM, cityPaxC, lastPaxM, lastPaxC, "万人次");
			addKpiRaw(summary, "城市客运周转量", cityTurnM, cityTurnC, lastTurnM, lastTurnC, "万人公里");

			// ---- 中口径（公路旅客企业 H203-1 全省，单位换算 /10000） ----
			Map<Integer, Map<String, PassengerAgg>> data = loadPassengerAggMap();
			double paxM = 0.0, paxC = 0.0, turnM = 0.0, turnC = 0.0;
			double lastPaxM2 = 0.0, lastPaxC2 = 0.0, lastTurnM2 = 0.0, lastTurnC2 = 0.0;
			for (int m = 1; m <= month; m++) {
			PassengerAgg agg = aggOf(data, year, m, "湖北省");
			if (agg != null) {
			double pax = agg.passengerTotal / 10000.0;
			double turn = agg.turnoverTotal / 10000.0;
			if (m == month) { paxM = pax; turnM = turn; }
			paxC += pax;
			turnC += turn;
			}
			PassengerAgg last = aggOf(data, year - 1, m, "湖北省");
			if (last != null) {
			double lp = last.passengerTotal / 10000.0;
			double lt = last.turnoverTotal / 10000.0;
			if (m == month) { lastPaxM2 = lp; lastTurnM2 = lt; }
			lastPaxC2 += lp;
			lastTurnC2 += lt;
			}
			}
			addKpiRaw(summary, "中口径客运量", paxM, paxC, lastPaxM2, lastPaxC2, "万人次");
			addKpiRaw(summary, "中口径周转量", turnM, turnC, lastTurnM2, lastTurnC2, "万人公里");

			if (paxM <= 0 && paxC <= 0 && cityPaxC <= 0 && fm == null) {
			problems.add("货运量周转量/规上规下/公路旅客/城市客运当月数据均缺失");
			}
			if (cityPaxC > 0 && lastPaxC <= 0) {
			problems.add((year - 1) + "-" + String.format("%02d", month) + " 同期城市客运数据未导入库，城市客运同比暂不显示，待 2025 年定稿数据导入后自动出现");
			}
			if (paxC > 0 && lastPaxC2 <= 0) {
			problems.add((year - 1) + "-" + String.format("%02d", month) + " 同期公路旅客数据未导入库，中口径同比暂不显示，待 2025 年定稿数据导入后自动出现");
			}
			}

			/** 城市客运全省累计向量（8 指标：公交客运/周转、出租客运/周转、轨道客运/周转、轮渡客运/周转） */
			private double[] cityCumProv(String yearPrefix, int month) {
			if (month <= 0) return new double[8];
			return loadCityPassengerCumulative(yearPrefix, month).getOrDefault("全省", new double[8]);
			}

			private double[] diff8(double[] a, double[] b) {
			double[] out = new double[8];
			for (int i = 0; i < 8; i++) out[i] = a[i] - b[i];
			return out;
			}

			private double sumIdx(double[] arr, int[] idx) {
			double sum = 0.0;
			for (int i : idx) sum += (i < arr.length ? arr[i] : 0.0);
			return sum;
			}

			/** 百分比同比（值已为比率 0.xx）：输出四行当月/累计/当月同比/累计同比 */
			private void addKpi(List<Map<String, Object>> summary, String name, Double m, Double cum, Double yoyM, Double yoyC, String unit) {
			if (m != null) addSum(summary, name + "·当月", round(m, 2), unit);
			if (cum != null) addSum(summary, name + "·累计", round(cum, 2), unit);
			if (yoyM != null) addSum(summary, name + "·当月同比", round(yoyM * 100.0, 1), "%");
			if (yoyC != null) addSum(summary, name + "·累计同比", round(yoyC * 100.0, 1), "%");
			}

			/** 原始数值版（月/累计为 0 视为无数据不出行） */
			private void addKpiRaw(List<Map<String, Object>> summary, String name, double m, double cum, double lastM, double lastC, String unit) {
			if (m > 0) addSum(summary, name + "·当月", round(m, 2), unit);
			if (cum > 0) addSum(summary, name + "·累计", round(cum, 2), unit);
			if (m > 0 && lastM > 0) addSum(summary, name + "·当月同比", round((m - lastM) / lastM * 100.0, 1), "%");
			if (cum > 0 && lastC > 0) addSum(summary, name + "·累计同比", round((cum - lastC) / lastC * 100.0, 1), "%");
			}

			private void addSum(List<Map<String, Object>> summary, String label, Double value, String unit) {
			@@ -548,9 +701,23 @@
			if (allZero) problems.add("全省累计值全为 0（公交/出租月报可能未导入）");
			}

			/** 投资摘要：项目数 + 本月完成/自年初/自开始累计 */
			/** 投资摘要：项目数 + 本月完成/自年初/自开始累计（全投资月报合计，不分类别） */
			private void investPreview(String period, String mode, List<Map<String, Object>> summary, List<String> problems) {
			List<InvestmentMonthly> list = investMonthlyMapper.selectList(periodQw(period, mode, InvestmentMonthly::getReportPeriod));
			investPreview(period, mode, null, summary, problems);
			}

			/** 投资摘要（category 非空时只统计该类别，如客运站场/物流园区投资明细表） */
			private void investPreview(String period, String mode, String category, List<Map<String, Object>> summary, List<String> problems) {
			LambdaQueryWrapper<InvestmentMonthly> qw = periodQw(period, mode, InvestmentMonthly::getReportPeriod);
			if (category != null) {
			List<InvestmentProject> ps = investProjectMapper.selectList(
			new LambdaQueryWrapper<InvestmentProject>().eq(InvestmentProject::getCategory, category));
			List<Long> ids = new ArrayList<>();
			for (InvestmentProject p : ps) ids.add(p.getId());
			if (ids.isEmpty()) { problems.add("缺数据：库内没有「" + category + "」项目主档"); return; }
			qw.in(InvestmentMonthly::getProjectId, ids);
			}
			List<InvestmentMonthly> list = investMonthlyMapper.selectList(qw);
			Set<Long> proj = new HashSet<>();
			double monthDone = 0.0, yearCum = 0.0, startCum = 0.0;
			for (InvestmentMonthly m : list) {
			@@ -720,36 +887,36 @@
			for (Double v : h2032FreightCum.values()) {
			if (v != null) provAbove += v;
			}
			Double provAboveWan = round(provAbove / 10000.0, 4);
			Double provAboveWan = provAbove / 10000.0;
			Double provTotal = freightCum(ftMap.get("湖北省"), month);
			Double provBelow = provTotal == null ? null : round(provTotal - provAboveWan, 4);
			Double provBelow = provTotal == null ? null : provTotal - provAboveWan;
			Double provTotalYoy = freightCumYoy(ftMap.get("湖北省"), month);
			double provAboveLast = 0.0;
			for (Double v : h2032FreightCumLast.values()) {
			if (v != null) provAboveLast += v;
			}
			Double provAboveYoy = provAboveLast == 0.0 ? null : round((provAbove - provAboveLast) / provAboveLast, 4);
			Double provAboveYoy = provAboveLast == 0.0 ? null : (provAbove - provAboveLast) / provAboveLast;
			Double provTotalLast = lastFreightCum(ftMap.get("湖北省"), month);
			Double provBelowLast = provTotalLast == null ? null : round(provTotalLast - provAboveLast / 10000.0, 4);
			Double provBelowLast = provTotalLast == null ? null : provTotalLast - provAboveLast / 10000.0;
			Double provBelowYoy = provBelowLast == null \|\| provBelowLast == 0.0 ? null
			: round((provBelow - provBelowLast) / provBelowLast, 4);
			: (provBelow - provBelowLast) / provBelowLast;

			for (String city : RegionUtil.cityList()) {
			Double a = h2032FreightCum.get(city);
			double aWan = a == null ? 0.0 : round(a / 10000.0, 4);
			double aWan = a == null ? 0.0 : a / 10000.0;
			Double t = freightCum(ftMap.get(city), month);
			above.put(city, aWan);
			total.put(city, t);
			below.put(city, t == null ? null : round(t - aWan, 4));
			below.put(city, t == null ? null : t - aWan);
			aboveYoy.put(city, h2032FreightYoy.get(city));
			// 规下同比 = (规下今年 - 规下去年) / 规下去年；规下去年 = 模板去年合计 - H2032去年规上
			Double tLast = lastFreightCum(ftMap.get(city), month);
			Double aLast = h2032FreightCumLast.get(city);
			double aLastWan = aLast == null ? 0.0 : round(aLast / 10000.0, 4);
			Double belowLast = tLast == null ? null : round(tLast - aLastWan, 4);
			double aLastWan = aLast == null ? 0.0 : aLast / 10000.0;
			Double belowLast = tLast == null ? null : tLast - aLastWan;
			Double b = below.get(city);
			belowYoy.put(city, belowLast == null \|\| belowLast == 0.0 \|\| b == null
			? null : round((b - belowLast) / belowLast, 4));
			? null : (b - belowLast) / belowLast);
			totalYoy.put(city, freightCumYoy(ftMap.get(city), month));
			}

			@@ -774,20 +941,20 @@
			if (maLast != null) provMonthAboveLast += maLast;
			monthAbove.put(city, ma);
			monthTotal.put(city, mt);
			monthBelow.put(city, mt == null ? null : round(mt - (ma == null ? 0.0 : ma), 4));
			monthBelow.put(city, mt == null ? null : mt - (ma == null ? 0.0 : ma));
			monthAboveYoy.put(city, growthYoy(ma, maLast));
			Double mb = monthBelow.get(city);
			Double mbLast = mtLast == null ? null : round(mtLast - (maLast == null ? 0.0 : maLast), 4);
			Double mbLast = mtLast == null ? null : mtLast - (maLast == null ? 0.0 : maLast);
			monthBelowYoy.put(city, growthYoy(mb, mbLast));
			monthTotalYoy.put(city, freightYoy(ftMap.get(city), month));
			}
			Double provMonthAboveWan = provMonthAbove == 0.0 ? null : round(provMonthAbove, 4);
			Double provMonthAboveWan = provMonthAbove == 0.0 ? null : provMonthAbove;
			Double provMonthTotal = freightMonth(ftMap.get("湖北省"), month);
			Double provMonthBelow = provMonthTotal == null ? null : round(provMonthTotal - provMonthAbove, 4);
			Double provMonthBelow = provMonthTotal == null ? null : provMonthTotal - provMonthAbove;
			Double provMonthAboveYoy = growthYoy(provMonthAbove == 0.0 ? null : provMonthAbove, provMonthAboveLast);
			Double provMonthTotalLast = lastFreightMonth(ftMap.get("湖北省"), month);
			Double provMonthBelowLast = provMonthTotalLast == null ? null
			: round(provMonthTotalLast - provMonthAboveLast, 4);
			: provMonthTotalLast - provMonthAboveLast;
			Double provMonthBelowYoy = growthYoy(provMonthBelow, provMonthBelowLast);
			Double provMonthTotalYoy = freightYoy(ftMap.get("湖北省"), month);

			@@ -1066,25 +1233,15 @@
			return lv == 0.0 ? null : (v - lv) / lv;
			}

			/** 中口径月同比：k=-1 表示总行（班线+公交之和，出租/网约车无源数据按 0）；无去年数据留空 */
			/** 中口径月同比：k=-1 表示总行（班线+公交+出租城乡+网约车城乡四项之和）；无去年数据留空 */
			private void fillMidYoyCell(Cell c, Map<Integer, Map<String, double[][]>> mid, int year, int month,
			String area, int k, boolean volume) {
			double v = 0.0, lv = 0.0;
			if (k == -1) {
			for (int kk = 1; kk <= 4; kk++) {
			if (kk >= 3) continue;
			v += midClassVal(mid, year, month, area, kk, volume);
			lv += midClassVal(mid, year - 1, month, area, kk, volume);
			}
			} else if (k <= 2) {
			v = midClassVal(mid, year, month, area, k, volume);
			lv = midClassVal(mid, year - 1, month, area, k, volume);
			}
			Double y = midMonthYoy(mid, year, month, area, k, volume);
			c.setBlank();
			if (v != 0.0 && lv != 0.0) c.setCellValue(round((v - lv) / lv, 4));
			if (y != null) c.setCellValue(y);
			}

			/** 中口径累计同比列（1..months 月累计；k=-1 总行 = 班线+公交） */
			/** 中口径累计同比列（1..months 月累计；四维齐全） */
			private void fillMidCumYoyColumn(Sheet sheet, Map<Integer, Map<String, double[][]>> mid, int year,
			int months, int colIdx) {
			List<String> areas = midTemplateAreas();
			@@ -1102,19 +1259,13 @@
			if (blockOffset < 0 \|\| blockOffset % 5 == 0) continue;
			int k = blockOffset % 5;
			String area = areas.get(blockOffset / 5);
			double v = 0.0, lv = 0.0;
			for (int m = 1; m <= months; m++) {
			if (k <= 2) {
			v += midClassVal(mid, year, m, area, k, volume);
			lv += midClassVal(mid, year - 1, m, area, k, volume);
			}
			}
			Double y = midCumYoy(mid, year, area, months, k, volume);
			Row row = sheet.getRow(r0);
			if (row == null) continue;
			Cell c = row.getCell(colIdx);
			if (c == null) c = row.createCell(colIdx);
			c.setBlank();
			if (v != 0.0 && lv != 0.0) c.setCellValue(round((v - lv) / lv, 4));
			if (y != null) c.setCellValue(y);
			}
			}

			@@ -1140,7 +1291,7 @@
			private Double monthFreightWan(Map<String, Map<Integer, Double>> byCityMonth, String city, int month) {
			Map<Integer, Double> byMonth = byCityMonth == null ? null : byCityMonth.get(city);
			Double v = byMonth == null ? null : byMonth.get(month);
			return v == null ? null : round(v / 10000.0, 4);
			return v == null ? null : v / 10000.0;
			}

			/** 同比 = (本期-基期)/基期；任一期缺失或基期为 0 返回 null */
			@@ -1242,12 +1393,12 @@
			}
			}

			/** 周转量排名 Q/R 占比：模板为缓存值，按新数据重算（规上占比 1 位小数） */
			/** 周转量排名 Q/R 占比：模板为缓存值，按新数据重算（全精度写入，两位小数展示交给单元格格式） */
			private void setFreightShare(Row row, Double above, Double total) {
			if (total != null && total > 0 && above != null) {
			double share = round(above * 10.0 / total, 1);
			double share = above * 10.0 / total;
			setFreightCell(row, 16, share);
			setFreightCell(row, 17, round(10.0 - share, 1));
			setFreightCell(row, 17, 10.0 - share);
			} else {
			setFreightCell(row, 16, (Double) null);
			setFreightCell(row, 17, (Double) null);
			@@ -1457,9 +1608,9 @@
			setNumeric(row, 15, isProvince ? null : yoyRankOfMap(totalYoy, city));

			if (t != null && t > 0 && a != null) {
			double share = round(a * 10.0 / t, 1);
			double share = a * 10.0 / t;
			setNumeric(row, 16, share);
			setNumeric(row, 17, round(10.0 - share, 1));
			setNumeric(row, 17, 10.0 - share);
			}
			return rowIdx + 1;
			}
			@@ -1500,9 +1651,9 @@
			setNumeric(row, 15, isProvince \|\| cum == null ? null : yoyRankOfTurnover(cumMap, city, 2));

			if (total != null && total > 0 && above != null) {
			double share = round(above * 10.0 / total, 1);
			double share = above * 10.0 / total;
			setNumeric(row, 16, share);
			setNumeric(row, 17, round(10.0 - share, 1));
			setNumeric(row, 17, 10.0 - share);
			}
			return rowIdx + 1;
			}
			@@ -1522,7 +1673,7 @@
			Double v = byMonth == null ? null : byMonth.get(month);
			if (v != null) sum += v;
			}
			return round(sum / 10000.0, 4);
			return sum / 10000.0;
			}
			Double total = freightMonth(ft, month);
			Double above = getProvinceMonthValue(provinceMonthMap, ft, month, "freight", "above", h2032Freight);
			@@ -1553,7 +1704,7 @@
			for (Double v : h2032FreightCum.values()) {
			if (v != null) sum += v;
			}
			return round(sum / 10000.0, 4);
			return sum / 10000.0;
			}
			Double total = freightCum(ft, monthCount);
			Double above = getProvinceCumValue(provinceCum, ft, "freight", "above", h2032FreightCum, monthCount);
			@@ -1583,7 +1734,7 @@
			if ("above".equals(scale)) {
			Map<Integer, Double> byMonth = h2032Freight.get(city);
			Double v = byMonth == null ? null : byMonth.get(month);
			return v == null ? 0.0 : round(v / 10000.0, 4);
			return v == null ? 0.0 : v / 10000.0;
			}
			Double total = freightMonth(ft, month);
			Double above = getCityMonthValue(monthData, ft, city, month, "freight", "above", h2032Freight);
			@@ -1612,7 +1763,7 @@
			if ("total".equals(scale)) return freightCum(ft, monthCount);
			if ("above".equals(scale)) {
			Double v = h2032FreightCum.get(city);
			return v == null ? 0.0 : round(v / 10000.0, 4);
			return v == null ? 0.0 : v / 10000.0;
			}
			Double total = freightCum(ft, monthCount);
			Double above = getCityCumValue(cum, ft, "freight", "above", h2032FreightCum, city, monthCount);
			@@ -1849,20 +2000,20 @@
			double v = passengerMonthVal(data, indi, currentYear, m, region, metricIdx);
			if (!keepFormula) {
			if (c == null) c = row.createCell(col);
			if (v == 0.0) c.setBlank(); else c.setCellValue(round(v, 4));
			if (v == 0.0) c.setBlank(); else c.setCellValue(v);
			}
			// 同比列：库内去年同月同比（模板 #REF! 公式替换为数值，公式行也覆写）
			double lv = passengerMonthVal(data, indi, currentYear - 1, m, region, metricIdx);
			Cell yc = row.getCell(col + 1);
			if (yc == null) yc = row.createCell(col + 1);
			if (v == 0.0 \|\| lv == 0.0) yc.setBlank(); else yc.setCellValue(round((v - lv) / lv, 4));
			if (v == 0.0 \|\| lv == 0.0) yc.setBlank(); else yc.setCellValue((v - lv) / lv);
			}
			// 累计同比列（模板 #REF! → 库内去年 1..N 月累计同比数值）
			int cumCol = extended ? 26 : 14;
			Double cumYoy = passengerCumYoy(data, indi, currentYear, fillMonths, region, metricIdx);
			Cell yc2 = row.getCell(cumCol + 1);
			if (yc2 == null) yc2 = row.createCell(cumCol + 1);
			if (cumYoy == null) yc2.setBlank(); else yc2.setCellValue(round(cumYoy, 4));
			if (cumYoy == null) yc2.setBlank(); else yc2.setCellValue(cumYoy);
			}
			recalc(wb);
			return toBytes(wb);
			@@ -1943,7 +2094,7 @@

			private Double yoy(Double cur, Double base) {
			if (cur == null \|\| base == null \|\| base == 0.0) return null;
			return round((cur - base) / base, 4);
			return (cur - base) / base;
			}

			/** 指标取值（已换算为万人/万人公里/公里；无数据返回 null） */
			@@ -2068,20 +2219,15 @@
			boolean extended = fillMonths > 6;
			if (extended) extendMonthlyColumns(sheet, 2, currentYear, 4, sheet.getLastRowNum());
			List<String> areas = midTemplateAreas();
			// 2026-09-18：改为「按单元格类型无关」遍历——扩列（7~12 月）出来的值列在模板里是空格，
			// 旧实现只处理 CellType.FORMULA 的格，导致 7 月及以后月份永远填不上（8 月整列 0、累计只到 6 月）。
			for (Row row : sheet) {
			if (row == null) continue;
			for (Cell c : row) {
			if (c.getCellType() != CellType.FORMULA) continue;
			String f = c.getCellFormula();
			if (f == null) continue;
			boolean crossBook = f.contains("[");
			if (!crossBook && !isYoyMonthCol(c.getColumnIndex() + 1)) continue; // 内部公式（合计/累计）保留重算；同比列 #REF! 覆写为数值
			if (crossBook && !is2026MonthCol(c.getColumnIndex() + 1)) {
			keepCached(c); // 2025 年列保留模板缓存值
			continue;
			}
			for (int c0 = 0; c0 < Math.max(row.getLastCellNum(), 0); c0++) {
			Cell c = row.getCell(c0);
			if (c == null) continue;
			int r = c.getRowIndex() + 1;
			int col = c.getColumnIndex() + 1;
			int col = c0 + 1;
			int blockOffset = -1;
			boolean volume = false;
			if (r >= 5 && r <= 94) {
			@@ -2092,33 +2238,65 @@
			volume = false;
			}
			if (blockOffset < 0) {
			keepCached(c); // r1/r2 备注等
			if (c.getCellType() == CellType.FORMULA) keepCached(c); // r1/r2 备注、页外跨簿引用等
			continue;
			}
			if (blockOffset % 5 == 0) {
			if (isYoyMonthCol(col)) {
			fillMidYoyCell(c, mid, currentYear, monthOfCol(col), areas.get(blockOffset / 5), -1, volume);
			} else {
			keepCached(c); // 总行内部公式（防御）
			boolean isVal = is2026MonthCol(col);
			boolean isYoy = isYoyMonthCol(col);
			if (!isVal && !isYoy) {
			// 2025 年列等：跨簿公式取缓存值断链；内部公式（合计/累计）保留，稍后 recalc 重算
			if (c.getCellType() == CellType.FORMULA) {
			String f = c.getCellFormula();
			if (f != null && f.contains("[")) keepCached(c);
			}
			continue;
			}
			int k = blockOffset % 5; // 1=班线 2=公交 3=出租 4=网约车
			String area = areas.get(blockOffset / 5);
			if (is2026MonthCol(col)) {
			if (blockOffset % 5 == 0) {
			if (isYoy) {
			fillMidYoyCell(c, mid, currentYear, monthOfCol(col), area, -1, volume);
			}
			// 总行值列：一律保留模板公式（1~6 月原公式 + 扩列克隆出来的公式），
			// 由生成收尾的 recalcWorkbookFormulas 求值写回缓存。早期版本这里 keepCached
			// 会把刚克隆出来的公式清成空格，导致 7 月及以后总行永远空白。
			continue;
			}
			int k = blockOffset % 5; // 1=班线 2=公交 3=出租城乡 4=网约车城乡
			if (isVal) {
			fillMidCell(c, mid, currentYear, monthOfCol(col), area, k, volume);
			} else if (isYoyMonthCol(col)) {
			fillMidYoyCell(c, mid, currentYear, monthOfCol(col), area, k, volume);
			} else {
			keepCached(c); // 2025 年列保留模板缓存值
			fillMidYoyCell(c, mid, currentYear, monthOfCol(col), area, k, volume);
			}
			}
			}
			// 累计同比列（模板 #REF! → 库内去年 1..N 月累计同比数值）
			fillMidCumYoyColumn(sheet, mid, currentYear, fillMonths, extended ? 27 : 15);
			recalc(wb);
			// evaluateAll 会在跨簿公式（Sheet2 的 [1]xx!A1）处整本中断，累计列 AA 就永远拿不到新缓存值，
			// 改用逐格容错的 recalcWorkbookFormulas：坏格跳过、好格照算。
			int[] recalc = recalcWorkbookFormulas(wb);
			log.info("中口径明细公式重算完成：成功 {} 格，失败 {} 格", recalc[0], recalc[1]);
			clearFormulaErrorsAll(wb); // 去年同期明细页残留 #REF! 同比公式 → 清空
			blankFutureMonthColumns(sheet, fillMonths); // 报表期之后的月份列不保留克隆公式/0 值
			return toBytes(wb);
			}
			}

			/**
			* 清空「报表期之后」的月份列（扩列克隆出来的 7~12 月里、尚未到期的月份）。
			* 不清的话，克隆出来的总行公式会算出 0，报表上会出现"9~12 月全是 0"的假数据；
			* 累计列（AA）的公式/缓存值已在重算阶段算好，清空格子不影响它（空 = 0）。
			*/
			private void blankFutureMonthColumns(Sheet sheet, int filledMonths) {
			for (int m = filledMonths + 1; m <= 12; m++) {
			int col = 2 * m; // 0 基：1 月=2(C)、7 月=14(O)、12 月=24(Y)
			for (int r = 4; r <= sheet.getLastRowNum(); r++) { // 0 基第 4 行 = 第 5 行（首个数据行），表头不动
			Row row = sheet.getRow(r);
			if (row == null) continue;
			Cell val = row.getCell(col);
			if (val != null) val.setBlank();
			Cell yoy = row.getCell(col + 1);
			if (yoy != null) yoy.setBlank();
			}
			}
			}

			@@ -2143,16 +2321,19 @@
			return (col - 1) / 2;
			}

			/** 填中口径数据单元格：出租/网约车(3/4)显式 0，班线/公交填库内值（无值清空） */
			/**
			* 填中口径数据单元格：班线/公交/出租城乡/网约车城乡四维统一取库内值。
			* 库内该月该维无源（取值为 0）时保留母版/模板原值——绝不写空、也不写 0。
			* 依据：模板的城市级城乡行是「台账页总量 − 城市内」的引用、并已业务定稿；
			* 用库内缺失值覆盖会把定稿数清掉（如 2026-01~06 网约车订单缺失时，
			* 全省网约车城乡 333.39 与各市州值会被清空）。
			*/
			private void fillMidCell(Cell c, Map<Integer, Map<String, double[][]>> mid, int year, int month, String area, int k, boolean volume) {
			if (k == 3 \|\| k == 4) {
			writeExplicitZero(c); // 出租/网约车暂无数据源，显式 0
			return;
			}
			double v = midClassVal(mid, year, month, area, k, volume);
			if (v == 0.0) return; // 库内无源：保留母版/定稿原值，缺数据不覆盖
			// POI setCellValue(double) 对公式单元格只更新缓存不移除公式，必须先 setBlank 再写值
			c.setBlank();
			if (v != 0.0) c.setCellValue(round(v, 4));
			c.setCellValue(v);
			}

			/** 显式写入 0（POI setCellValue(0.0) 会转 blank，需操作底层 XML） */
			@@ -2177,6 +2358,56 @@
			return volume ? arr[k][0] : arr[k][1];
			}

			/** B3：登记「该期该市州该维度有源行」。判据是源表有没有这一行，而不是算出来的值是否非 0
			* ——因为「值为 0」可能是真实业务（如武汉市巡游出租全部为城市内，城际城乡恒为 0）。 */
			private void markMid(Map<Integer, Map<String, boolean[]>> pres, int key, String city, int k) {
			pres.computeIfAbsent(key, kk -> new HashMap<>())
			.computeIfAbsent(city, kk -> new boolean[5])[k] = true;
			}

			/**
			* B3：该月该维度是否「有源」（同比完备性校验用）。
			* k <= 0 表示「总量行」，要求四维（班线/公交/出租/网约车）都有源才算齐全。
			*/
			private boolean midMonthHas(Map<Integer, Map<String, double[][]>> mid, int year, int month, String area, int k, boolean volume) {
			Map<String, boolean[]> pm = midPresence.get().get(year * 100 + month);
			if (pm == null) return false;
			boolean[] b = pm.get(area);
			if (b == null) return false;
			if (k <= 0) {
			for (int kk = 1; kk <= 4; kk++) {
			if (!b[kk]) return false;
			}
			return true;
			}
			return k < b.length && b[k];
			}

			/** B3：去年 1..monthCount 月的命中月份数（用于判定同比基数是否齐全） */
			private int midCumHitMonths(Map<Integer, Map<String, double[][]>> mid, int year, String area, int monthCount, int k, boolean volume) {
			int n = 0;
			for (int m = 1; m <= monthCount; m++) {
			if (midMonthHas(mid, year, m, area, k, volume)) n++;
			}
			return n;
			}

			/** B3：当月同比——去年同月基数缺失则留空（缺数据不再当 0 计算） */
			private Double midMonthYoy(Map<Integer, Map<String, double[][]>> mid, int year, int month, String area, int k, boolean volume) {
			if (!midMonthHas(mid, year - 1, month, area, k, volume)) return null;
			double v = midClassVal(mid, year, month, area, k, volume);
			if (v == 0.0) return null;
			return yoyOf(v, midClassVal(mid, year - 1, month, area, k, volume));
			}

			/** B3：累计同比——去年 1..monthCount 各月齐全才计算，缺任何一月一律留空 */
			private Double midCumYoy(Map<Integer, Map<String, double[][]>> mid, int year, String area, int monthCount, int k, boolean volume) {
			if (midCumHitMonths(mid, year - 1, area, monthCount, k, volume) < monthCount) return null;
			double v = midCumClass(mid, year, area, monthCount, k, volume);
			if (v == 0.0) return null;
			return yoyOf(v, midCumClass(mid, year - 1, area, monthCount, k, volume));
			}

			/** 公式单元格替换为缓存数值（避免跨簿引用断链；非数值缓存置空） */
			private void keepCached(Cell c) {
			try {
			@@ -2197,7 +2428,20 @@
			* 中口径分类月度数据：年*100+月 -> (市州/全省 -> double[5][2])
			* 维度 0=总量 1=公路班线(h2031+个体) 2=城际城乡公交(cityBus) 3=巡游出租 4=网约车；[客运量(万人), 周转量(万人公里)]
			*/
			/** B3：最近一次 loadMidClassMap 的「维度是否有源行」登记表（key -> city -> boolean[5]），用于同比完备性校验 */
			private final ThreadLocal<Map<Integer, Map<String, boolean[]>>> midPresence =
			ThreadLocal.withInitial(HashMap::new);

			/** B4/B5：最近一次 loadMidClassMap 的数据问题清单（线程内，随导出体检输出/写生成件） */
			private final ThreadLocal<java.util.List<String>> midIssues = ThreadLocal.withInitial(java.util.ArrayList::new);

			/** B4/B5：取最近一次中口径数据加载的问题清单（只读副本） */
			public java.util.List<String> getLastMidIssues() { return new java.util.ArrayList<>(midIssues.get()); }

			private Map<Integer, Map<String, double[][]>> loadMidClassMap() {
			midIssues.get().clear(); // B5：本次加载的问题清单
			Map<Integer, Map<String, boolean[]>> pres = new HashMap<>();
			midPresence.set(pres); // B3：本次加载的维度有源登记
			Map<Integer, Map<String, double[][]>> mid = new HashMap<>();
			for (PassengerEnterpriseMonthly e : passengerMapper.selectList(null)) {
			if (e.getReportPeriod() == null) continue;
			@@ -2219,6 +2463,8 @@
			+ nz(e.getTurnoverClass4()) + nz(e.getTurnoverCharter())) / 10000.0;
			addMidClass(mid, key, city, 1, pass, turn);
			addMidClass(mid, key, "湖北省", 1, pass, turn);
			markMid(pres, key, city, 1);
			markMid(pres, key, "湖北省", 1);
			}
			for (PassengerIndividualMonthly e : passengerIndividualMapper.selectList(null)) { // 个体并入公路班线/总量（09-03 口径）
			if (e.getReportPeriod() == null) continue;
			@@ -2238,6 +2484,8 @@
			double turn = nz(e.getTurnover()) / 10000.0;
			addMidClass(mid, key, city, 1, pass, turn);
			addMidClass(mid, key, "湖北省", 1, pass, turn);
			markMid(pres, key, city, 1);
			markMid(pres, key, "湖北省", 1);
			}
			for (CityBusMonthly b : cityBusMapper.selectList(null)) {
			if (b.getReportPeriod() == null \|\| b.getCity() == null) continue;
			@@ -2253,10 +2501,73 @@
			String city = RegionUtil.normalizeCityName(b.getCity());
			if (city == null) continue;
			int key = y * 100 + m;
			addMidClass(mid, key, city, 2, nz(b.getPassengerChengxiang()), nz(b.getTurnoverChengxiang()));
			addMidClass(mid, key, "湖北省", 2, nz(b.getPassengerChengxiang()), nz(b.getTurnoverChengxiang()));
			// 口径统一（2026-09-19，用户核对「中口径排名」周转量 vs 人工列）：城际城乡一律用「总量 − 城市内」现算。
			// 原逻辑「存储的城际城乡 > 0 就优先取字段值，<=0 才回退到差额法」会在个别企业行上与差额法差 ±0.01
			// （源报表里总量/城市内/城际城乡各自两位小数舍入，2026 年 1-8 月全省共 72 行），累加后
			// 「中口径排名」页比「中口径明细」/人工口径多 0.32 万人公里。改为差额法后与台账页、明细页、四页合成口径一致。
			double cxPass = nz(b.getPassengerVolume()) - nz(b.getPassengerCity());
			double cxTurn = nz(b.getTurnover()) - nz(b.getTurnoverCity());
			if (cxPass < 0) cxPass = 0.0;
			if (cxTurn < 0) cxTurn = 0.0;
			addMidClass(mid, key, city, 2, cxPass, cxTurn);
			addMidClass(mid, key, "湖北省", 2, cxPass, cxTurn);
			markMid(pres, key, city, 2);
			markMid(pres, key, "湖北省", 2);
			}
			// 维度3：城际城乡巡游出租 = 台账页「出租!总量 − 出租!城市内」（源 city_taxi_monthly）
			for (CityTaxiMonthly t : cityTaxiMapper.selectList(null)) {
			if (t.getReportPeriod() == null \|\| t.getCity() == null) continue;
			int key = midPeriodKey(t.getReportPeriod());
			if (key <= 0) continue;
			String city = RegionUtil.normalizeCityName(t.getCity());
			if (city == null) continue;
			double pass = nz(t.getPassengerVolume()) - nz(t.getPassengerCity());
			double turn = nz(t.getTurnover()) - nz(t.getTurnoverCity());
			addMidClass(mid, key, city, 3, pass, turn);
			addMidClass(mid, key, "湖北省", 3, pass, turn);
			markMid(pres, key, city, 3);
			markMid(pres, key, "湖北省", 3);
			}
			// 维度4：城际城乡网约车 = 网约车拆分结果（与台账「网约车」页同源同法）
			for (WycOrderMonthly o : wycOrderMapper.selectList(null)) {
			String per = o.getReportPeriod();
			if (per == null) continue;
			int key = midPeriodKey(per);
			if (key <= 0) continue;
			WycSplitCalc.WycResult wr;
			try {
			wr = wycSplitCalc.calc(per);
			} catch (Exception e) {
			// B5：不再静默跳过——记录「期 + 原因」并写日志，随导出体检一并输出
			String msg = per + " 网约车城际城乡维度缺失：" + e.getMessage();
			midIssues.get().add(msg);
			log.warn("loadMidClassMap {}", msg);
			continue;
			}
			for (Map.Entry<String, WycSplitCalc.WycMetrics> en : wr.getByCity().entrySet()) {
			WycSplitCalc.WycMetrics wm = en.getValue();
			addMidClass(mid, key, en.getKey(), 4, wm.getSuburbanPax(), wm.getSuburbanTurnover());
			addMidClass(mid, key, "湖北省", 4, wm.getSuburbanPax(), wm.getSuburbanTurnover());
			markMid(pres, key, en.getKey(), 4);
			markMid(pres, key, "湖北省", 4);
			}
			}
			return mid;
			}

			/** "yyyy-MM" -> yyyy100+MM；非法返回 0（与 loadMidClassMap 的 key 口径一致） /
			private int midPeriodKey(String period) {
			if (period == null) return 0;
			String[] parts = period.trim().split("-");
			if (parts.length != 2) return 0;
			try {
			int y = Integer.parseInt(parts[0]);
			int m = Integer.parseInt(parts[1]);
			if (y <= 0 \|\| m < 1 \|\| m > 12) return 0;
			return y * 100 + m;
			} catch (NumberFormatException e) {
			return 0;
			}
			}

			/** 写入分类值并累加总量（维度0） */
			@@ -2318,12 +2629,12 @@
			int monthCount = (y == currentYear) ? maxMonth : 12;
			for (int m = 1; m <= monthCount; m++) {
			Double cur = midMetricValue(aggOf(data, y, m, region), i, volume);
			setNumeric(row, col++, cur == null ? null : round(cur, 4));
			setNumeric(row, col++, cur);
			Double base = midMetricValue(aggOf(data, y - 1, m, region), i, volume);
			setNumeric(row, col++, yoy(cur, base));
			}
			Double cum = midCumOf(data, y, region, monthCount, i, volume);
			setNumeric(row, col++, cum == null ? null : round(cum, 4));
			setNumeric(row, col++, cum);
			Double cumBase = midCumOf(data, y - 1, region, monthCount, i, volume);
			setNumeric(row, col++, yoy(cum, cumBase));
			}
			@@ -2392,15 +2703,11 @@
			title.getCell(10).setCellValue(currentYear + "年" + maxMonth + "月全省分市州完成道路客运生产情况");
			}
			// 全省行 r3：B3/F3 为 SUM 公式保留；D3/H3 同比填值（0-based 列 3/7）
			setValOrBlank(sheet, 2, 3, yoyOf(midCumClass(mid, currentYear, "湖北省", maxMonth, 0, true),
			midCumClass(mid, currentYear - 1, "湖北省", maxMonth, 0, true)));
			setValOrBlank(sheet, 2, 7, yoyOf(midCumClass(mid, currentYear, "湖北省", maxMonth, 0, false),
			midCumClass(mid, currentYear - 1, "湖北省", maxMonth, 0, false)));
			setValOrBlank(sheet, 2, 3, midCumYoy(mid, currentYear, "湖北省", maxMonth, 0, true));
			setValOrBlank(sheet, 2, 7, midCumYoy(mid, currentYear, "湖北省", maxMonth, 0, false));
			// 右块全省行 N3/R3：当月同比（L3/P3 为 SUM 公式保留）
			setValOrBlank(sheet, 2, 13, yoyOf(midClassVal(mid, currentYear, maxMonth, "湖北省", 0, true),
			midClassVal(mid, currentYear - 1, maxMonth, "湖北省", 0, true)));
			setValOrBlank(sheet, 2, 17, yoyOf(midClassVal(mid, currentYear, maxMonth, "湖北省", 0, false),
			midClassVal(mid, currentYear - 1, maxMonth, "湖北省", 0, false)));
			setValOrBlank(sheet, 2, 13, midMonthYoy(mid, currentYear, maxMonth, "湖北省", 0, true));
			setValOrBlank(sheet, 2, 17, midMonthYoy(mid, currentYear, maxMonth, "湖北省", 0, false));
			// 市州行 r4-20：B/F 累计值、D/H 同比；C/E/G/I 排名公式保留
			List<String> cities = RegionUtil.CITY_LIST;
			for (int i = 0; i < cities.size(); i++) {
			@@ -2410,19 +2717,19 @@
			double turn = midCumClass(mid, currentYear, city, maxMonth, 0, false);
			double lastPass = midCumClass(mid, currentYear - 1, city, maxMonth, 0, true);
			double lastTurn = midCumClass(mid, currentYear - 1, city, maxMonth, 0, false);
			setValOrBlank(sheet, r0, 1, pass == 0 ? null : round(pass, 4));
			setValOrBlank(sheet, r0, 3, yoyOf(pass, lastPass));
			setValOrBlank(sheet, r0, 5, turn == 0 ? null : round(turn, 4));
			setValOrBlank(sheet, r0, 7, yoyOf(turn, lastTurn));
			setValOrBlank(sheet, r0, 1, pass == 0 ? null : pass);
			setValOrBlank(sheet, r0, 3, midCumYoy(mid, currentYear, city, maxMonth, 0, true));
			setValOrBlank(sheet, r0, 5, turn == 0 ? null : turn);
			setValOrBlank(sheet, r0, 7, midCumYoy(mid, currentYear, city, maxMonth, 0, false));
			// 右块当月：L/P 值、N/R 当月同比（M/O/Q/S 排名公式保留）
			double mPass = midClassVal(mid, currentYear, maxMonth, city, 0, true);
			double mTurn = midClassVal(mid, currentYear, maxMonth, city, 0, false);
			double mLastPass = midClassVal(mid, currentYear - 1, maxMonth, city, 0, true);
			double mLastTurn = midClassVal(mid, currentYear - 1, maxMonth, city, 0, false);
			setValOrBlank(sheet, r0, 11, mPass == 0 ? null : round(mPass, 4));
			setValOrBlank(sheet, r0, 13, mPass == 0 ? null : yoyOf(mPass, mLastPass));
			setValOrBlank(sheet, r0, 15, mTurn == 0 ? null : round(mTurn, 4));
			setValOrBlank(sheet, r0, 17, mTurn == 0 ? null : yoyOf(mTurn, mLastTurn));
			setValOrBlank(sheet, r0, 11, mPass == 0 ? null : mPass);
			setValOrBlank(sheet, r0, 13, mPass == 0 ? null : midMonthYoy(mid, currentYear, maxMonth, city, 0, true));
			setValOrBlank(sheet, r0, 15, mTurn == 0 ? null : mTurn);
			setValOrBlank(sheet, r0, 17, mTurn == 0 ? null : midMonthYoy(mid, currentYear, maxMonth, city, 0, false));
			}
			recalc(wb);
			return toBytes(wb);
			@@ -2441,7 +2748,7 @@

			private Double yoyOf(double cur, double base) {
			if (base == 0.0) return null;
			return round((cur - base) / base, 4);
			return (cur - base) / base;
			}

			/** 中口径分类累计（1..monthCount 月求和） */
			@@ -2483,10 +2790,10 @@
			double turn = midCumClass(mid, currentYear, "湖北省", maxMonth, dims[i], false);
			double lastPass = midCumClass(mid, currentYear - 1, "湖北省", maxMonth, dims[i], true);
			double lastTurn = midCumClass(mid, currentYear - 1, "湖北省", maxMonth, dims[i], false);
			setValOrBlank(sheet, r0, 1, pass == 0 ? null : round(pass, 4));
			setValOrBlank(sheet, r0, 2, yoyOf(pass, lastPass));
			setValOrBlank(sheet, r0, 5, turn == 0 ? null : round(turn, 4));
			setValOrBlank(sheet, r0, 6, yoyOf(turn, lastTurn));
			setValOrBlank(sheet, r0, 1, pass == 0 ? null : pass);
			setValOrBlank(sheet, r0, 2, midCumYoy(mid, currentYear, "湖北省", maxMonth, dims[i], true));
			setValOrBlank(sheet, r0, 5, turn == 0 ? null : turn);
			setValOrBlank(sheet, r0, 6, midCumYoy(mid, currentYear, "湖北省", maxMonth, dims[i], false));
			}
			// 下半块（当月）：标题行9、数据行11-15（0-based 8、10-14）
			Row bottomTitle = sheet.getRow(8);
			@@ -2499,10 +2806,10 @@
			double turn = midClassVal(mid, currentYear, maxMonth, "湖北省", dims[i], false);
			double lastPass = midClassVal(mid, currentYear - 1, maxMonth, "湖北省", dims[i], true);
			double lastTurn = midClassVal(mid, currentYear - 1, maxMonth, "湖北省", dims[i], false);
			setValOrBlank(sheet, r0, 1, pass == 0 ? null : round(pass, 4));
			setValOrBlank(sheet, r0, 2, pass == 0 ? null : yoyOf(pass, lastPass));
			setValOrBlank(sheet, r0, 5, turn == 0 ? null : round(turn, 4));
			setValOrBlank(sheet, r0, 6, turn == 0 ? null : yoyOf(turn, lastTurn));
			setValOrBlank(sheet, r0, 1, pass == 0 ? null : pass);
			setValOrBlank(sheet, r0, 2, pass == 0 ? null : midMonthYoy(mid, currentYear, maxMonth, "湖北省", dims[i], true));
			setValOrBlank(sheet, r0, 5, turn == 0 ? null : turn);
			setValOrBlank(sheet, r0, 6, turn == 0 ? null : midMonthYoy(mid, currentYear, maxMonth, "湖北省", dims[i], false));
			}
			// 下半块占比公式由样例指向上半块（B$3/F$3），改写为本块总行（B$11/F$11），行12-15
			for (int i = 1; i < names.length; i++) {
			@@ -2919,7 +3226,7 @@
			Cell c = row.getCell(colIdx);
			if (c != null && c.getCellType() == org.apache.poi.ss.usermodel.CellType.FORMULA) return;
			if (c == null) c = row.createCell(colIdx);
			if (v == 0) c.setBlank(); else c.setCellValue(round(v, 2));
			if (v == 0) c.setBlank(); else c.setCellValue(v);
			}

			/** 显式写入 0（setDataCell 对 0 置空；汇总表网约车行需要显示 0） */
			@@ -3200,7 +3507,7 @@
			* 保留全部页签/版式/公式/2025 年缓存值，仅把表头年份动态化为目标年；数据填充按 P2 起逐步接入。
			*/
			public byte[] exportSummaryWorkbook(String period, String mode) throws Exception {
			return exportSummaryWorkbook(period, mode, null);
			return exportSummaryWorkbook(period, mode, null, null);
			}

			/** 生成_道路运输量汇总表.xlsx（P0-P1 骨架，支持 toMonth 裁剪）：
			@@ -3208,6 +3515,13 @@
			* toMonth 非空且小于 M 时，把 8 个台账/合成页裁到 toMonth 月（toMonth+1..M 的当月值/同比列清空、保留表头，
			* 累计与累计同比公式改为按 toMonth 月重算），用于“先生成 1-6 月、1-7 月扩列”验证。 */
			public byte[] exportSummaryWorkbook(String period, String mode, Integer toMonth) throws Exception {
			return exportSummaryWorkbook(period, mode, toMonth, null);
			}

			/** 同上，额外通过 progress 回调报告进度（异步导出任务用：步骤百分比 + 步骤文案） */
			public byte[] exportSummaryWorkbook(String period, String mode, Integer toMonth,
			java.util.function.BiConsumer<Integer, String> progress) throws Exception {
			reportProgress(progress, 2, "校验报表期与母版");
			int year = Integer.parseInt(period.contains("-") ? period.split("-")[0] : period);
			int month = period.contains("-") ? monthOf(period, mode) : 12;
			File template = resolveSummaryMother(period, mode);
			@@ -3215,9 +3529,11 @@
			throw new RuntimeException("未找到汇总表母版《" + year + "年" + month + "月道路运输量汇总表.xlsx》（docs/生成汇总大表）");
			}
			double savedZipRatio = ZipSecureFile.getMinInflateRatio();
			reportProgress(progress, 6, "读取母版工作簿");
			ZipSecureFile.setMinInflateRatio(0.0001); // 新版母版 styles.xml 由 openpyxl 高压缩（0.0099<0.01）触发 POI Zip-bomb 误报，读取后还原
			try (InputStream in = new FileInputStream(template);
			XSSFWorkbook wb = new XSSFWorkbook(in)) {
			reportProgress(progress, 12, "还原同期月度块");
			File donor = resolveSummaryDonor(year, month);
			if (donor != null) {
			try (InputStream din = new FileInputStream(donor); XSSFWorkbook dwb = new XSSFWorkbook(din)) {
			@@ -3232,13 +3548,915 @@
			log.info("汇总工作簿裁剪至 {} 月完成，清空/改写单元格数={}", toMonth, trimmed);
			}
			dynamicSummaryYear(wb, year);
			applyTwoDecimalFormat(wb); // 汇总大表保留人工母版列宽/版式：不做 autoFit（长公式会把列宽顶爆）
			cleanSummarySheetPresentation(wb); // 取消各页筛选、还原隐藏行（否则“班线包车”等页看起来像缺数据）
			int effMonth = (toMonth != null && toMonth > 0 && toMonth < month) ? toMonth : month;
			List<String> dbProblems = new ArrayList<>();
			String effPeriod = String.format("%04d-%02d", year, effMonth);
			reportProgress(progress, 22, "回填当月数据");
			int dbFilled = summaryWorkbookFiller.fillMonthlyLedger(wb, effPeriod, year, effMonth, dbProblems);
			int yoyFilled = summaryWorkbookFiller.ensureMonthYoyFormulas(wb, year, effMonth);
			int monthFormulaFilled = summaryWorkbookFiller.ensureMonthFormulas(wb, year, effMonth);
			// 累计同比分母修正：母版把「去年各月」与「去年1-M月累计」辅助列同时计入（重复计/漏当月）
			int cumYoyFixed = summaryWorkbookFiller.repairCumulativeYoyFormulas(wb, year, effMonth);
			reportProgress(progress, 45, "刷新排名页与跨页合成页");
			int rankRefreshed = refreshSummaryRankSheets(wb, effPeriod, "month");
			int cumulativeRefreshed = refreshSummaryCumulativeSheets(wb, year, effMonth); // 四张跨页合成页随报表期刷新
			int widthApplied = applySummaryReferenceLayout(wb);
			log.info("汇总工作簿数据驱动回填完成：写入当月值格数={}，补写当月同比公式格数={}，补写当月合计公式格数={}，"
			+ "修正累计同比分母格数={}，刷新排名页数值格数={}，刷新四页（城市汇总/城市分市州/中口径分析/道路运输周转量）数值格数={}，"
			+ "按《生成_道路运输量汇总表》对齐列宽列数={}，缺数提示={}",
			dbFilled, yoyFilled, monthFormulaFilled, cumYoyFixed, rankRefreshed, cumulativeRefreshed, widthApplied, dbProblems);
			applyTwoDecimalFormat(wb); // 数值显示两位小数（保留全精度）；% / 日期等既有样式不改变
			int inlineFixed = normalizeStaleInlineStrings(wb); // 清掉「非 inlineStr 却残留 <is>」的非法格，否则 Excel 拒绝打开
			if (inlineFixed > 0) log.warn("汇总工作簿清掉残留 inlineStr 非法格 {} 个（母版由 openpyxl 写出时的典型问题）", inlineFixed);
			reportProgress(progress, 70, "重算整本公式（约 4 万格）");
			int[] recalc = recalcWorkbookFormulas(wb); // 公式重算并写回缓存值：全省行(Σ市州)/累计列/排名 SUM 才能被预览与二次处理读到
			log.info("汇总工作簿公式重算完成：成功 {} 格，失败 {} 格（失败格保留母版旧缓存值，打开时按 fullCalcOnLoad 重算）", recalc[0], recalc[1]);
			if (!wb.getCTWorkbook().isSetCalcPr()) wb.getCTWorkbook().addNewCalcPr();
			wb.getCTWorkbook().getCalcPr().setFullCalcOnLoad(true); // 还原/改写公式后打开即重算
			reportProgress(progress, 95, "写出文件");
			return toBytes(wb);
			} finally {
			ZipSecureFile.setMinInflateRatio(savedZipRatio);
			}
			}

			/** 导出进度回调（异步导出任务用）：回调自身异常不影响导出 */
			private static void reportProgress(java.util.function.BiConsumer<Integer, String> progress, int percent, String step) {
			if (progress == null) return;
			try {
			progress.accept(percent, step);
			} catch (Exception ignore) {
			// 进度回调失败不影响导出
			}
			}

			/**
			* 汇总工作簿公式重算：POI 写文件不带缓存值，导致「全省行（Σ17市州）」「累计列」「排名 SUM」
			* 在预览/二次处理里只看到母版上一期的旧值（2026-09-18 用户报“8月没数据 / 全省行停在上一期”的根因之一）。
			* 逐格 evaluate 并把结果写回缓存值；个别不支持函数/外部引用格失败则跳过并计数，不阻塞导出。
			*/
			private int[] recalcWorkbookFormulas(XSSFWorkbook wb) {
			if (wb == null) return new int[]{0, 0};
			org.apache.poi.ss.usermodel.FormulaEvaluator ev;
			try {
			ev = wb.getCreationHelper().createFormulaEvaluator();
			} catch (Exception e) {
			log.warn("汇总工作簿公式重算：创建求值器失败，跳过（{}）", e.getMessage());
			return new int[]{0, 0};
			}
			try {
			// 跨簿公式（[1]出租!C13 之类）在外部工作簿缺失时默认抛异常，会让引用它的
			// 总行/累计/派生公式连锁失败（表现为「公式还在但没有缓存值」）。
			// 置 true 后改用公式格自身的缓存值（即定稿值）参与计算。
			ev.setIgnoreMissingWorkbooks(true);
			} catch (Exception ignore) {
			// 个别实现不支持该开关，忽略即可
			}
			int ok = 0, fail = 0;
			java.util.List<String> samples = new java.util.ArrayList<>();
			for (int i = 0; i < wb.getNumberOfSheets(); i++) {
			Sheet sh = wb.getSheetAt(i);
			if (sh == null) continue;
			for (Row row : sh) {
			if (row == null) continue;
			for (Cell c : row) {
			if (c == null \|\| c.getCellType() != CellType.FORMULA) continue;
			try {
			ev.evaluateFormulaCell(c); // 注意：evaluate() 无副作用，必须用 evaluateFormulaCell 才会把结果写回缓存值
			ok++;
			} catch (Exception ex) {
			fail++;
			if (samples.size() < 10) {
			samples.add(sh.getSheetName() + "!" + c.getAddress() + " :: " + ex.getClass().getSimpleName());
			}
			}
			}
			}
			}
			if (!samples.isEmpty()) log.warn("汇总工作簿公式重算失败样例：{}", samples);
			return new int[]{ok, fail};
			}

			/**
			* 清掉「非 inlineStr 却残留 <is>」的非法单元格。
			*
			* 母版若由 openpyxl 写出，文本单元格用 <is>（inlineStr）存储；POI 的 setCellValue 只改写 t 与 <v>，
			* 不会清掉旧 <is>，于是产出 <c t="n"><v>67.0</v><is><t>67.00</t></is></c> 这种非法格，
			* Excel 判定为「无法读取的内容」而直接拒绝打开（COM 表现为「不能取得类 Workbooks 的 Open 属性」）。
			* 2026-07 导出件即因此打不开（《公交》17 格 +《轨道、轮渡》2 格）。落盘前统一清理，幂等。
			*/
			private int normalizeStaleInlineStrings(XSSFWorkbook wb) {
			int fixed = 0;
			for (int i = 0; i < wb.getNumberOfSheets(); i++) {
			org.openxmlformats.schemas.spreadsheetml.x2006.main.CTWorksheet ctw = wb.getSheetAt(i).getCTWorksheet();
			if (ctw == null \|\| ctw.getSheetData() == null) continue;
			for (org.openxmlformats.schemas.spreadsheetml.x2006.main.CTRow row : ctw.getSheetData().getRowArray()) {
			for (org.openxmlformats.schemas.spreadsheetml.x2006.main.CTCell c : row.getCArray()) {
			if (!c.isSetIs()) continue;
			STCellType.Enum t = c.getT();
			if (t == null \|\| !STCellType.INLINE_STR.equals(t)) {
			c.unsetIs();
			fixed++;
			}
			}
			}
			}
			return fixed;
			}

			/**
			* 版式对齐：按 docs/生成汇总大表/《生成_道路运输量汇总表.xlsx》（用户提供的版式参照）逐列套用列宽与隐藏标记，
			* 使生成件与参照件“格式完全一致”，并让母版没定义宽度的“后续扩列”（如 8 月列）也有与 8 月一致的列宽。
			* 参照件缺失时静默跳过（返回 0），不影响原有导出。
			*/
			private int applySummaryReferenceLayout(XSSFWorkbook wb) {
			File ref;
			try {
			ref = resolveSummaryLayoutRef();
			} catch (Exception e) {
			return 0;
			}
			if (ref == null) return 0;
			double savedZipRatio = ZipSecureFile.getMinInflateRatio();
			ZipSecureFile.setMinInflateRatio(0.0001);
			int applied = 0;
			try (InputStream in = new FileInputStream(ref); XSSFWorkbook rwb = new XSSFWorkbook(in)) {
			for (int i = 0; i < rwb.getNumberOfSheets(); i++) {
			org.apache.poi.xssf.usermodel.XSSFSheet rs = rwb.getSheetAt(i);
			if (rs == null) continue;
			org.apache.poi.xssf.usermodel.XSSFSheet ts = wb.getSheet(rs.getSheetName());
			if (ts == null) continue;
			int maxCol = Math.min(usedColumnCount(rs), usedColumnCount(ts) + 4);
			if (maxCol <= 0) continue;
			double[] width = new double[maxCol];
			boolean[] hasWidth = new boolean[maxCol];
			boolean[] hidden = new boolean[maxCol];
			for (org.openxmlformats.schemas.spreadsheetml.x2006.main.CTCols cols : rs.getCTWorksheet().getColsArray()) {
			for (org.openxmlformats.schemas.spreadsheetml.x2006.main.CTCol col : cols.getColArray()) {
			long min = col.getMin();
			long max = col.getMax();
			for (long c = min; c <= max; c++) {
			int idx = (int) (c - 1);
			if (idx < 0 \|\| idx >= maxCol) {
			if (idx >= maxCol) break;
			continue;
			}
			if (col.isSetWidth()) {
			width[idx] = col.getWidth();
			hasWidth[idx] = true;
			}
			hidden[idx] = col.isSetHidden() && col.getHidden();
			}
			}
			}
			for (int c = 0; c < maxCol; c++) {
			if (hasWidth[c]) {
			int w = (int) Math.round(width[c] * 256d);
			if (ts.getColumnWidth(c) != w) {
			ts.setColumnWidth(c, w);
			applied++;
			}
			}
			if (hidden[c] != ts.isColumnHidden(c)) ts.setColumnHidden(c, hidden[c]);
			}
			}
			log.info("汇总工作簿版式对齐《生成_道路运输量汇总表》完成：套用列宽 {} 列（参照件：{}）", applied, ref.getName());
			} catch (Exception e) {
			log.warn("汇总工作簿版式对齐失败（忽略，继续按母版版式输出）：{}", e.getMessage());
			return 0;
			} finally {
			ZipSecureFile.setMinInflateRatio(savedZipRatio);
			}
			return applied;
			}

			/** 一页已用到的最大列数（0 基计数） */
			private int usedColumnCount(org.apache.poi.ss.usermodel.Sheet sh) {
			int max = 0;
			for (int r = sh.getFirstRowNum(); r <= sh.getLastRowNum(); r++) {
			org.apache.poi.ss.usermodel.Row row = sh.getRow(r);
			if (row == null) continue;
			if (row.getLastCellNum() > max) max = row.getLastCellNum();
			}
			return max;
			}

			// ==================== 汇总工作簿内的排名页刷新 ====================

			/**
			* 汇总工作簿里的「货运量排名 / 货运周转量排名 / 中口径排名」在母版里是上一报表期的静态值，
			* 导出时用独立排名表（《生成_货运量排名》《生成_周转量排名》《生成_中口径排名》，与用户日常核对的口径一致）
			* 的结果刷新数值，避免汇总表里的排名页停留在旧月份。
			* 数值格搬值、公式格按偏移平移公式后写入；目标格本身已是公式的（SUM/RANK/占比/补数）保留不动，打开时按新数据重算。
			*/
			private int refreshSummaryRankSheets(XSSFWorkbook wb, String period, String mode) throws Exception {
			int n = 0;
			n += copyRankValues(wb, "货运量排名", exportFreightRank(period, mode), new int[][]{{0, 0}, {22, 0}});
			n += copyRankValues(wb, "货运周转量排名", exportTurnoverRank(period, mode), new int[][]{{0, 0}, {22, 0}});
			n += copyRankValues(wb, "中口径排名", exportPassengerMidRank(period, mode), new int[][]{{0, 0}, {0, 10}});
			return n;
			}

			/**
			* 把独立排名表的各个块按标题对齐搬进汇总大表对应页。
			* srcBlocks[i] = 源块 i 的起始 {行, 列}（0 基）；目标块按标题顺序（累计块在前、当月块在后）对应。
			* 数值格直接搬值；源侧是公式的（排名/占比等）按目标块偏移整体平移后写入公式，打开时按汇总表自身数据重算。
			*/
			private int copyRankValues(XSSFWorkbook dstWb, String dstSheetName, byte[] srcBytes, int[][] srcBlocks) throws Exception {
			XSSFSheet dst = dstWb.getSheet(dstSheetName);
			if (dst == null) return 0;
			List<XSSFCell> dstTitles = rankTitleCells(dst);
			if (dstTitles.isEmpty()) return 0;
			int copied = 0;
			FormulaEvaluator dstEv = dstWb.getCreationHelper().createFormulaEvaluator();
			try (InputStream sin = new ByteArrayInputStream(srcBytes);
			XSSFWorkbook srcWb = new XSSFWorkbook(sin)) {
			XSSFSheet src = srcWb.getSheetAt(0);
			FormulaEvaluator ev = srcWb.getCreationHelper().createFormulaEvaluator();
			int blocks = Math.min(srcBlocks.length, dstTitles.size());
			for (int b = 0; b < blocks; b++) {
			int sr0 = srcBlocks[b][0];
			int sc0 = srcBlocks[b][1];
			XSSFCell dstTitle = dstTitles.get(b);
			int rowOff = dstTitle.getRowIndex() - sr0;
			int colOff = dstTitle.getColumnIndex() - sc0;
			int h = rankBlockHeight(src, sr0, sc0);
			int w = rankBlockWidth(src, sr0, sc0);
			for (int r = 0; r < h; r++) {
			Row srcRow = src.getRow(sr0 + r);
			if (srcRow == null) continue;
			Row dstRow = dst.getRow(sr0 + r + rowOff);
			if (dstRow == null) dstRow = dst.createRow(sr0 + r + rowOff);
			for (int c = 0; c < w; c++) {
			Cell sc = srcRow.getCell(sc0 + c);
			if (sc == null) continue;
			int dc = sc0 + c + colOff;
			if (r == 0) {
			// 标题行：同步块标题文案。母版标题是 inlineStr，POI 的 setCellValue 只写 <v>、
			// 不更新 <is>，Excel 会继续显示旧月份，必须先 setBlank 清掉再写。
			Cell dt = dstRow.getCell(dc);
			if (dt == null) dt = rankCell(dstRow, dc);
			if (sc.getCellType() == CellType.STRING && dt.getCellType() != CellType.FORMULA) {
			String text = sc.getStringCellValue();
			String old = dt.getCellType() == CellType.STRING ? dt.getStringCellValue() : null;
			if (text != null && !text.equals(old)) {
			dt.setBlank();
			dt.setCellValue(text);
			}
			}
			continue;
			}
			Cell dcCell = dstRow.getCell(dc);
			if (dcCell != null && dcCell.getCellType() == CellType.FORMULA) continue; // 保留母版自己的公式
			if (sc.getCellType() == CellType.FORMULA) {
			// 源侧公式（排名/占比）：按目标块偏移平移后原样写入，再按汇总表自身数据求值缓存。
			// 不直接搬 POI 对源表的求值结果（如 RANK 对手工留空的同比一律返回 1）。
			String f = sc.getCellFormula();
			if (f == null \|\| f.isEmpty()) continue;
			String shifted = shiftFormula(f, colOff, rowOff);
			if (dcCell == null) dcCell = rankCell(dstRow, dc);
			dcCell.setCellFormula(shifted);
			try {
			dstEv.evaluateFormulaCell(dcCell);
			} catch (Exception ignore) {
			// 求值失败不阻塞导出：打开时由 Excel/WPS 重算
			}
			copied++;
			continue;
			}
			Double v = rankNumeric(sc, ev);
			if (v == null) continue;
			if (dcCell == null) dcCell = rankCell(dstRow, dc);
			dcCell.setCellValue(v);
			copied++;
			}
			}
			}
			}
			return copied;
			}

			/** 目标块缺格时新建，并沿用同行左邻格样式（防新格丢边框/百分数格式） */
			private Cell rankCell(Row row, int col) {
			Cell c = row.createCell(col);
			Cell left = col > 0 ? row.getCell(col - 1) : null;
			if (left != null) c.setCellStyle(left.getCellStyle());
			return c;
			}

			/** 公式内所有 A1 引用整体平移：列 +dCol、行 +dRow（SUM/RANK 等函数名后接括号不会被匹配） */
			private String shiftFormula(String formula, int dCol, int dRow) {
			if (formula == null \|\| (dCol == 0 && dRow == 0)) return formula;
			java.util.regex.Matcher m = java.util.regex.Pattern
			.compile("(?<![A-Za-z0-9_$])([$]?)([A-Z]{1,3})([$]?)([0-9]+)")
			.matcher(formula);
			StringBuffer sb = new StringBuffer();
			while (m.find()) {
			String col = m.group(2);
			int idx = 0;
			for (int i = 0; i < col.length(); i++) idx = idx * 26 + (col.charAt(i) - 'A' + 1);
			int nidx = Math.max(1, idx + dCol);
			StringBuilder nc = new StringBuilder();
			while (nidx > 0) {
			int rem = (nidx - 1) % 26;
			nc.insert(0, (char) ('A' + rem));
			nidx = (nidx - 1) / 26;
			}
			int nrow = Math.max(1, Integer.parseInt(m.group(4)) + dRow);
			m.appendReplacement(sb, java.util.regex.Matcher.quoteReplacement(m.group(1) + nc + m.group(3) + nrow));
			}
			m.appendTail(sb);
			return sb.toString();
			}

			/** 排名页里的“块标题”单元格（含“全省分市州”的说明文字），按行、列顺序返回 */
			private List<XSSFCell> rankTitleCells(Sheet sh) {
			List<XSSFCell> out = new ArrayList<>();
			for (int r = sh.getFirstRowNum(); r <= sh.getLastRowNum(); r++) {
			Row row = sh.getRow(r);
			if (row == null) continue;
			for (int c = row.getFirstCellNum(); c < row.getLastCellNum(); c++) {
			Cell cell = row.getCell(c);
			if (cell == null \|\| cell.getCellType() != CellType.STRING) continue;
			String t = cell.getStringCellValue();
			if (t != null && t.contains("全省分市州")) out.add((XSSFCell) cell);
			}
			}
			return out;
			}

			/** 块高度：从起始行向下直到整行为空（在块列范围内） */
			private int rankBlockHeight(Sheet sh, int r0, int c0) {
			int h = 0;
			for (int r = r0; r <= sh.getLastRowNum(); r++) {
			Row row = sh.getRow(r);
			boolean any = false;
			if (row != null) {
			int last = row.getLastCellNum();
			for (int c = c0; c < last; c++) {
			if (rankHasContent(row.getCell(c))) { any = true; break; }
			}
			}
			if (!any) break;
			h++;
			}
			return h;
			}

			/** 块宽度：从起始列向右直到整列为空（在块行范围内，扫描上限 40 列） */
			private int rankBlockWidth(Sheet sh, int r0, int c0) {
			int w = 0;
			for (int c = c0; c < c0 + 40; c++) {
			boolean any = false;
			for (int r = r0; r < r0 + 30; r++) {
			Row row = sh.getRow(r);
			if (row != null && rankHasContent(row.getCell(c))) { any = true; break; }
			}
			if (!any) break;
			w++;
			}
			return w;
			}

			private boolean rankHasContent(Cell c) {
			if (c == null) return false;
			CellType t = c.getCellType();
			if (t == CellType.BLANK) return false;
			if (t == CellType.STRING) {
			String v = c.getStringCellValue();
			return v != null && !v.trim().isEmpty();
			}
			return true;
			}

			/** 取单元格数值（公式取求值结果，纯数字文本按数值解析），取不到返回 null */
			private Double rankNumeric(Cell c, FormulaEvaluator ev) {
			try {
			CellType t = c.getCellType();
			if (t == CellType.NUMERIC) return c.getNumericCellValue();
			if (t == CellType.FORMULA) {
			org.apache.poi.ss.usermodel.CellValue cv = ev.evaluate(c);
			return cv != null && cv.getCellType() == CellType.NUMERIC ? cv.getNumberValue() : null;
			}
			if (t == CellType.STRING) {
			String v = c.getStringCellValue();
			if (v == null) return null;
			String x = v.replace(",", "").trim();
			if (x.isEmpty()) return null;
			try { return Double.parseDouble(x); } catch (NumberFormatException ignore) { return null; }
			}
			} catch (Exception ignore) {
			return null;
			}
			return null;
			}

			/** 定位版式参照件 docs/生成汇总大表/生成_道路运输量汇总表.xlsx（优先级同母版：配置目录 → user.dir 相对 → 上级） */
			// ==================== 汇总大表：四张“跨页合成”页随报表期刷新 ====================
			// 城市汇总 / 城市分市州 / 中口径分析 / 道路运输周转量此前整页沿用母版静态值（标题停在 1-7 月）。
			// 本段按 2026-09-13 已验证口径（与 8 月母版逐格 0 差异）从母版台账页现算：
			// 城市客运量 = 城市内公交 + 城市内巡游出租 + 城市内网约车 + 轨道 + 轮渡
			// 道路客运周转量 = 公路班线 + 城际城乡公交 + 城际城乡巡游出租 + 城际城乡网约车
			// 道路货运周转量 = 货运页市州规上货物周转量 + 规下货物周转量
			// 2026 年 1..N 月取台账页 2026 列（C/E/G…），去年同期取母版缓存 2025 列（V/X/Z…）——库里没有 2025 年城市客运数据。

			/** 城市客运口径指标位（0..17 城市客运，18 货运周转量） */
			private static final int SM_BUS_PAX = 0, SM_BUS_TURN = 1;
			private static final int SM_TAXI_PAX = 2, SM_TAXI_TURN = 3;
			private static final int SM_WYC_PAX = 4, SM_WYC_TURN = 5;
			private static final int SM_RAIL_PAX = 6, SM_RAIL_TURN = 7;
			private static final int SM_FERRY_PAX = 8, SM_FERRY_TURN = 9;
			private static final int SM_BX_PAX = 10, SM_BX_TURN = 11;
			private static final int SM_BUS_CX_PAX = 12, SM_BUS_CX_TURN = 13;
			private static final int SM_TAXI_CX_PAX = 14, SM_TAXI_CX_TURN = 15;
			private static final int SM_WYC_CX_PAX = 16, SM_WYC_CX_TURN = 17;
			private static final int SM_FREIGHT_TURN = 18;
			private static final int SM_DIM = 19;
			/** 2026 年 1 月当月值列（0 基，C 列）；2025 年 1 月当月值列（0 基，V 列） */
			private static final int SM_CUR_COL0 = 2;
			private static final int SM_LAST_COL0 = 21;

			/**
			* 刷新四张跨页合成页：当年累计（1..month 月）、当月（month 月）及对应同比；
			* 2026 与 2025 同期都取自母版台账页缓存，返回写入单元格数。
			*/
			private int refreshSummaryCumulativeSheets(XSSFWorkbook wb, int year, int month) {
			if (wb == null \|\| month <= 0) return 0;
			int[] cumMonths = new int[month];
			for (int m = 1; m <= month; m++) cumMonths[m - 1] = m;
			int[] oneMonth = new int[]{month};
			Map<String, double[]> curCum = smReadLedgerMetrics(wb, true, cumMonths);
			Map<String, double[]> lastCum = smReadLedgerMetrics(wb, false, cumMonths);
			Map<String, double[]> curMon = smReadLedgerMetrics(wb, true, oneMonth);
			Map<String, double[]> lastMon = smReadLedgerMetrics(wb, false, oneMonth);
			if (curCum.isEmpty()) {
			log.warn("汇总大表四页刷新：台账页未读到市州数据，跳过（保持母版原值）");
			return 0;
			}
			double[] pCurCum = smProvinceSum(curCum);
			double[] pLastCum = smProvinceSum(lastCum);
			double[] pCurMon = smProvinceSum(curMon);
			double[] pLastMon = smProvinceSum(lastMon);
			int n = 0;
			n += smWriteCitySummary(wb, year, month, pCurCum, pLastCum, pCurMon, pLastMon);
			n += smWriteCityByRegion(wb, month, curCum, lastCum, curMon, lastMon);
			n += smWriteMidAnalysis(wb, month, pCurCum, pLastCum, pCurMon, pLastMon);
			n += smWriteTurnoverSheets(wb, year, month, curCum, lastCum, curMon, lastMon);
			return n;
			}

			/** 17 市州合计（不含台账页“全省”公式行） */
			private double[] smProvinceSum(Map<String, double[]> m) {
			double[] p = new double[SM_DIM];
			for (String c : RegionUtil.cityList()) {
			double[] a = m.get(c);
			if (a == null) continue;
			for (int i = 0; i < SM_DIM; i++) p[i] += a[i];
			}
			return p;
			}

			/** 台账页累计取数：市州规范名 -> 19 维指标 */
			private Map<String, double[]> smReadLedgerMetrics(XSSFWorkbook wb, boolean curYear, int[] months) {
			Map<String, double[]> out = new LinkedHashMap<>();
			smReadCityPaxPage(wb, "公交", curYear, months, out, SM_BUS_PAX, SM_BUS_TURN, SM_BUS_CX_PAX, SM_BUS_CX_TURN);
			smReadCityPaxPage(wb, "出租", curYear, months, out, SM_TAXI_PAX, SM_TAXI_TURN, SM_TAXI_CX_PAX, SM_TAXI_CX_TURN);
			smReadCityPaxPage(wb, "网约车", curYear, months, out, SM_WYC_PAX, SM_WYC_TURN, SM_WYC_CX_PAX, SM_WYC_CX_TURN);
			smReadRailFerry(wb, curYear, months, out);
			smReadBanxian(wb, curYear, months, out);
			smReadFreightTurnover(wb, curYear, months, out);
			return out;
			}

			/** 公交/出租/网约车页：每市州 4 行（客运量/旅客周转量/其中城市内客运量/其中城市内旅客周转量） */
			private void smReadCityPaxPage(XSSFWorkbook wb, String sheetName, boolean curYear, int[] months,
			Map<String, double[]> out, int paxIdx, int turnIdx, int cxPaxIdx, int cxTurnIdx) {
			Sheet sh = wb.getSheet(sheetName);
			if (sh == null) return;
			int last = sh.getLastRowNum();
			for (int r = sh.getFirstRowNum(); r <= last; r++) {
			Row row = sh.getRow(r);
			if (row == null) continue;
			String city = smCityOf(row.getCell(0));
			if (city == null) continue;
			int paxRow = -1, turnRow = -1, cxPaxRow = -1, cxTurnRow = -1;
			for (int k = r; k <= Math.min(last, r + 4); k++) {
			Row kr = sh.getRow(k);
			if (kr == null) continue;
			String b = smText(kr.getCell(1));
			if (b == null \|\| b.contains("个体")) continue;
			boolean inner = b.contains("城市内");
			boolean turn = b.contains("周转量");
			if (inner) {
			if (turn) { if (cxTurnRow < 0) cxTurnRow = k; }
			else if (cxPaxRow < 0) cxPaxRow = k;
			} else {
			if (turn) { if (turnRow < 0) turnRow = k; }
			else if (paxRow < 0) paxRow = k;
			}
			}
			double totalPax = smSumMonths(sh, paxRow, curYear, months);
			double totalTurn = smSumMonths(sh, turnRow, curYear, months);
			double cityPax = smSumMonths(sh, cxPaxRow, curYear, months);
			double cityTurn = smSumMonths(sh, cxTurnRow, curYear, months);
			double[] arr = out.computeIfAbsent(city, k -> new double[SM_DIM]);
			arr[paxIdx] += cityPax; // 城市客运口径取“城市内”
			arr[turnIdx] += cityTurn;
			arr[cxPaxIdx] += totalPax - cityPax; // 城际城乡 = 总量 - 城市内
			arr[cxTurnIdx] += totalTurn - cityTurn;
			}
			}

			/** 轨道、轮渡页：轨道块（武汉/黄石）+ 轮渡块（武汉） */
			private void smReadRailFerry(XSSFWorkbook wb, boolean curYear, int[] months, Map<String, double[]> out) {
			Sheet sh = wb.getSheet("轨道、轮渡");
			if (sh == null) return;
			int last = sh.getLastRowNum();
			int ferryTitle = -1;
			for (int r = sh.getFirstRowNum(); r <= last; r++) {
			Row row = sh.getRow(r);
			if (row == null) continue;
			String a = smText(row.getCell(0));
			if (a != null && a.contains("轮渡客运量")) { ferryTitle = r; break; }
			}
			smReadRailFerryBlock(sh, curYear, months, out, sh.getFirstRowNum(),
			ferryTitle < 0 ? last : ferryTitle - 1, SM_RAIL_PAX);
			if (ferryTitle >= 0) smReadRailFerryBlock(sh, curYear, months, out, ferryTitle, last, SM_FERRY_PAX);
			}

			private void smReadRailFerryBlock(Sheet sh, boolean curYear, int[] months, Map<String, double[]> out,
			int start, int end, int baseIdx) {
			for (int r = start; r <= end; r++) {
			Row row = sh.getRow(r);
			if (row == null) continue;
			String city = smCityOf(row.getCell(0));
			if (city == null) continue;
			int paxRow = -1, turnRow = -1;
			for (int k = r; k <= Math.min(end, r + 3); k++) {
			Row kr = sh.getRow(k);
			if (kr == null) continue;
			String b = smText(kr.getCell(1));
			if (b == null) continue;
			if (b.contains("周转量")) { if (turnRow < 0) turnRow = k; }
			else if (paxRow < 0) paxRow = k;
			}
			double[] arr = out.computeIfAbsent(city, k -> new double[SM_DIM]);
			arr[baseIdx] += smSumMonths(sh, paxRow, curYear, months);
			arr[baseIdx + 1] += smSumMonths(sh, turnRow, curYear, months);
			}
			}

			/** 班线包车页：每市州客运量 / 旅客周转量（“其中个体”行不重复计入） */
			private void smReadBanxian(XSSFWorkbook wb, boolean curYear, int[] months, Map<String, double[]> out) {
			Sheet sh = wb.getSheet("班线包车");
			if (sh == null) return;
			int last = sh.getLastRowNum();
			for (int r = sh.getFirstRowNum(); r <= last; r++) {
			Row row = sh.getRow(r);
			if (row == null) continue;
			String city = smCityOf(row.getCell(0));
			if (city == null) continue;
			int paxRow = -1, turnRow = -1;
			for (int k = r; k <= Math.min(last, r + 4); k++) {
			Row kr = sh.getRow(k);
			if (kr == null) continue;
			String b = smText(kr.getCell(1));
			if (b == null \|\| b.contains("个体")) continue;
			if (b.contains("周转量")) { if (turnRow < 0) turnRow = k; }
			else if (b.contains("客运量") && paxRow < 0) paxRow = k;
			}
			double[] arr = out.computeIfAbsent(city, k -> new double[SM_DIM]);
			arr[SM_BX_PAX] += smSumMonths(sh, paxRow, curYear, months);
			arr[SM_BX_TURN] += smSumMonths(sh, turnRow, curYear, months);
			}
			}

			/** 货运页：每市州规上货物周转量 + 规下货物周转量（“规上+规下”行本身是求和公式，不直接取） */
			private void smReadFreightTurnover(XSSFWorkbook wb, boolean curYear, int[] months, Map<String, double[]> out) {
			Sheet sh = wb.getSheet(" 货运");
			if (sh == null) sh = wb.getSheet("货运");
			if (sh == null) return;
			int last = sh.getLastRowNum();
			for (int r = sh.getFirstRowNum(); r <= last; r++) {
			Row row = sh.getRow(r);
			if (row == null) continue;
			String city = smCityOf(row.getCell(0));
			if (city == null) continue;
			int above = -1, below = -1;
			for (int k = r; k <= Math.min(last, r + 6); k++) {
			Row kr = sh.getRow(k);
			if (kr == null) continue;
			String b = smText(kr.getCell(1));
			if (b == null \|\| b.contains("其中")) continue;
			if (b.contains("规上货物周转量")) { if (above < 0) above = k; }
			else if (b.contains("规下货物周转量")) { if (below < 0) below = k; }
			}
			double[] arr = out.computeIfAbsent(city, k -> new double[SM_DIM]);
			arr[SM_FREIGHT_TURN] += smSumMonths(sh, above, curYear, months) + smSumMonths(sh, below, curYear, months);
			}
			}

			private double smSumMonths(Sheet sh, int rowIdx, boolean curYear, int[] months) {
			if (sh == null \|\| rowIdx < 0) return 0;
			Row row = sh.getRow(rowIdx);
			if (row == null) return 0;
			double s = 0;
			for (int m : months) {
			int col = (curYear ? SM_CUR_COL0 : SM_LAST_COL0) + 2 * (m - 1);
			s += smNum(row.getCell(col));
			}
			return s;
			}

			/** 台账页单元格取数（数字 / 数字文本 / 公式缓存） */
			private double smNum(Cell c) {
			if (c == null) return 0;
			try {
			CellType t = c.getCellType();
			if (t == CellType.NUMERIC) return c.getNumericCellValue();
			if (t == CellType.FORMULA) {
			return c.getCachedFormulaResultType() == CellType.NUMERIC ? c.getNumericCellValue() : 0;
			}
			if (t == CellType.STRING) {
			String s = c.getStringCellValue();
			if (s == null) return 0;
			s = s.replace(",", "").replace("%", "").trim();
			if (s.isEmpty()) return 0;
			return Double.parseDouble(s);
			}
			} catch (Exception ignore) {
			return 0;
			}
			return 0;
			}

			private String smText(Cell c) {
			if (c == null) return null;
			try {
			return c.getCellType() == CellType.STRING ? c.getStringCellValue() : null;
			} catch (Exception e) {
			return null;
			}
			}

			/** 列 A 文案 -> 规范市州名（“全省/湖北省”与非市州行返回 null） */
			private String smCityOf(Cell a) {
			String t = smText(a);
			if (t == null \|\| t.trim().isEmpty()) return null;
			String norm = RegionUtil.normalizeCityName(t.trim());
			if (norm == null) return null;
			return RegionUtil.cityList().contains(norm) ? norm : null;
			}

			private double smYoy(double cur, double last) {
			return last == 0.0 ? 0.0 : (cur - last) / last;
			}

			/** 写值：公式格不动（保留母版公式，打开即重算）；0 且原为空格则不新增 */
			private int smSetVal(Sheet sh, int r0, int c0, double v) {
			Row row = sh.getRow(r0);
			if (row == null) return 0;
			Cell c = row.getCell(c0);
			if (c != null && c.getCellType() == CellType.FORMULA) return 0;
			if (c == null) {
			if (v == 0.0) return 0;
			c = row.createCell(c0);
			Cell left = row.getCell(c0 - 1);
			if (left != null) c.setCellStyle(left.getCellStyle());
			} else if (v == 0.0 && c.getCellType() == CellType.BLANK) {
			return 0;
			}
			c.setBlank();
			c.setCellValue(v);
			return 1;
			}

			private void smSetTitle(Sheet sh, int r0, int c0, String text) {
			if (sh == null) return;
			Row row = sh.getRow(r0);
			if (row == null) return;
			Cell c = row.getCell(c0);
			if (c == null \|\| c.getCellType() == CellType.FORMULA) return;
			c.setBlank();
			c.setCellValue(text);
			}

			/** 城市汇总页：块1（1..N 月累计）行 3-9，块2（当月）行 14-20；列 B/C/D/E = 客运量/同比/周转量/同比 */
			private int smWriteCitySummary(XSSFWorkbook wb, int year, int month,
			double[] pCurCum, double[] pLastCum, double[] pCurMon, double[] pLastMon) {
			Sheet sh = wb.getSheet("城市汇总");
			if (sh == null) return 0;
			smSetTitle(sh, 0, 0, year + "年1-" + month + "月全省累计完成城市客运量情况");
			smSetTitle(sh, 11, 0, year + "年" + month + "月全省完成城市客运量情况");
			int n = 0;
			int[] rows = {2, 3, 4, 5, 6, 7, 8};
			for (int i = 0; i < rows.length; i++) {
			double[] v = smCitySummaryRow(pCurCum, pLastCum, i);
			n += smSetVal(sh, rows[i], 1, v[0]);
			n += smSetVal(sh, rows[i], 2, v[2]);
			n += smSetVal(sh, rows[i], 3, v[1]);
			n += smSetVal(sh, rows[i], 4, v[3]);
			}
			for (int i = 0; i < rows.length; i++) {
			double[] v = smCitySummaryRow(pCurMon, pLastMon, i);
			n += smSetVal(sh, rows[i] + 11, 1, v[0]);
			n += smSetVal(sh, rows[i] + 11, 2, v[2]);
			n += smSetVal(sh, rows[i] + 11, 3, v[1]);
			n += smSetVal(sh, rows[i] + 11, 4, v[3]);
			}
			return n;
			}

			/** i=0 总客运量 1 公交 2 出租车 3 巡游出租 4 网约车 5 轨道 6 轮渡；返回 [客运量, 周转量, 客运量同比, 周转量同比] */
			private double[] smCitySummaryRow(double[] p, double[] pl, int i) {
			double pax, turn, lPax, lTurn;
			if (i == 0) {
			pax = p[SM_BUS_PAX] + p[SM_TAXI_PAX] + p[SM_WYC_PAX] + p[SM_RAIL_PAX] + p[SM_FERRY_PAX];
			turn = p[SM_BUS_TURN] + p[SM_TAXI_TURN] + p[SM_WYC_TURN] + p[SM_RAIL_TURN] + p[SM_FERRY_TURN];
			lPax = pl[SM_BUS_PAX] + pl[SM_TAXI_PAX] + pl[SM_WYC_PAX] + pl[SM_RAIL_PAX] + pl[SM_FERRY_PAX];
			lTurn = pl[SM_BUS_TURN] + pl[SM_TAXI_TURN] + pl[SM_WYC_TURN] + pl[SM_RAIL_TURN] + pl[SM_FERRY_TURN];
			} else if (i == 1) {
			pax = p[SM_BUS_PAX]; turn = p[SM_BUS_TURN]; lPax = pl[SM_BUS_PAX]; lTurn = pl[SM_BUS_TURN];
			} else if (i == 2) {
			pax = p[SM_TAXI_PAX] + p[SM_WYC_PAX]; turn = p[SM_TAXI_TURN] + p[SM_WYC_TURN];
			lPax = pl[SM_TAXI_PAX] + pl[SM_WYC_PAX]; lTurn = pl[SM_TAXI_TURN] + pl[SM_WYC_TURN];
			} else if (i == 3) {
			pax = p[SM_TAXI_PAX]; turn = p[SM_TAXI_TURN]; lPax = pl[SM_TAXI_PAX]; lTurn = pl[SM_TAXI_TURN];
			} else if (i == 4) {
			pax = p[SM_WYC_PAX]; turn = p[SM_WYC_TURN]; lPax = pl[SM_WYC_PAX]; lTurn = pl[SM_WYC_TURN];
			} else if (i == 5) {
			pax = p[SM_RAIL_PAX]; turn = p[SM_RAIL_TURN]; lPax = pl[SM_RAIL_PAX]; lTurn = pl[SM_RAIL_TURN];
			} else {
			pax = p[SM_FERRY_PAX]; turn = p[SM_FERRY_TURN]; lPax = pl[SM_FERRY_PAX]; lTurn = pl[SM_FERRY_TURN];
			}
			return new double[]{pax, turn, smYoy(pax, lPax), smYoy(turn, lTurn)};
			}

			/** 城市分市州页：4 块（累计客运量/累计周转量/当月客运量/当月周转量），每块全省 1 行 + 17 市州 */
			private int smWriteCityByRegion(XSSFWorkbook wb, int month,
			Map<String, double[]> curCum, Map<String, double[]> lastCum,
			Map<String, double[]> curMon, Map<String, double[]> lastMon) {
			Sheet sh = wb.getSheet("城市分市州");
			if (sh == null) return 0;
			smSetTitle(sh, 0, 0, "城市客运客运量分市州1-" + month + "月累计情况");
			smSetTitle(sh, 22, 0, "城市客运客运周转量分市州1-" + month + "月累计情况");
			smSetTitle(sh, 45, 0, "城市客运客运量分市州" + month + "月情况");
			smSetTitle(sh, 67, 0, "城市客运客运周转量分市州" + month + "月情况");
			int n = 0;
			n += smWriteCityByRegionBlock(sh, 4, true, curCum, lastCum);
			n += smWriteCityByRegionBlock(sh, 26, false, curCum, lastCum);
			n += smWriteCityByRegionBlock(sh, 49, true, curMon, lastMon);
			n += smWriteCityByRegionBlock(sh, 71, false, curMon, lastMon);
			return n;
			}

			private int smWriteCityByRegionBlock(Sheet sh, int provRow, boolean pax,
			Map<String, double[]> cur, Map<String, double[]> last) {
			int n = 0;
			double[] provCur = smProvinceSum(cur);
			double[] provLast = smProvinceSum(last);
			List<String> cities = RegionUtil.cityList();
			for (int i = -1; i < cities.size(); i++) {
			int r = provRow + i + 1;
			double[] c = i < 0 ? provCur : cur.get(cities.get(i));
			double[] l = i < 0 ? provLast : last.get(cities.get(i));
			if (c == null) c = new double[SM_DIM];
			if (l == null) l = new double[SM_DIM];
			double[] g = smCityGroupValues(c, l, pax);
			n += smSetVal(sh, r, 1, g[0]);
			n += smSetVal(sh, r, 4, g[6]);
			n += smSetVal(sh, r, 6, g[1]);
			n += smSetVal(sh, r, 9, g[7]);
			n += smSetVal(sh, r, 11, g[2]);
			n += smSetVal(sh, r, 14, g[8]);
			n += smSetVal(sh, r, 16, g[3]);
			n += smSetVal(sh, r, 19, g[9]);
			n += smSetVal(sh, r, 21, g[4]);
			n += smSetVal(sh, r, 22, g[10]);
			n += smSetVal(sh, r, 23, g[5]);
			n += smSetVal(sh, r, 24, g[11]);
			}
			return n;
			}

			/** 6 组值 + 6 组增速：[总量, 公交, 出租, 网约车, 轨道, 轮渡, 总量增速, 公交…, 轮渡] */
			private double[] smCityGroupValues(double[] c, double[] l, boolean pax) {
			int busI = pax ? SM_BUS_PAX : SM_BUS_TURN;
			int taxiI = pax ? SM_TAXI_PAX : SM_TAXI_TURN;
			int wycI = pax ? SM_WYC_PAX : SM_WYC_TURN;
			int railI = pax ? SM_RAIL_PAX : SM_RAIL_TURN;
			int ferryI = pax ? SM_FERRY_PAX : SM_FERRY_TURN;
			double bus = c[busI], taxi = c[taxiI], wyc = c[wycI], rail = c[railI], ferry = c[ferryI];
			double lBus = l[busI], lTaxi = l[taxiI], lWyc = l[wycI], lRail = l[railI], lFerry = l[ferryI];
			double total = bus + taxi + wyc + rail + ferry;
			double lTotal = lBus + lTaxi + lWyc + lRail + lFerry;
			return new double[]{total, bus, taxi, wyc, rail, ferry,
			smYoy(total, lTotal), smYoy(bus, lBus), smYoy(taxi, lTaxi), smYoy(wyc, lWyc),
			smYoy(rail, lRail), smYoy(ferry, lFerry)};
			}

			/** 中口径分析页：块1（累计）行 3-7，块2（当月）行 12-16；列 B/C/F/G = 客运量/同比/周转量/同比 */
			private int smWriteMidAnalysis(XSSFWorkbook wb, int month,
			double[] pCurCum, double[] pLastCum, double[] pCurMon, double[] pLastMon) {
			Sheet sh = wb.getSheet("中口径分析");
			if (sh == null) return 0;
			smSetTitle(sh, 0, 0, "1-" + month + "月中口径客运量及周转量");
			smSetTitle(sh, 9, 0, month + "月中口径客运量及周转量");
			int n = 0;
			int[] rows = {2, 3, 4, 5, 6};
			for (int i = 0; i < rows.length; i++) {
			double[] v = smMidRow(pCurCum, pLastCum, i);
			n += smSetVal(sh, rows[i], 1, v[0]);
			n += smSetVal(sh, rows[i], 2, v[2]);
			n += smSetVal(sh, rows[i], 5, v[1]);
			n += smSetVal(sh, rows[i], 6, v[3]);
			}
			for (int i = 0; i < rows.length; i++) {
			double[] v = smMidRow(pCurMon, pLastMon, i);
			n += smSetVal(sh, rows[i] + 9, 1, v[0]);
			n += smSetVal(sh, rows[i] + 9, 2, v[2]);
			n += smSetVal(sh, rows[i] + 9, 5, v[1]);
			n += smSetVal(sh, rows[i] + 9, 6, v[3]);
			}
			return n;
			}

			/** i=0 总 1 公路班线 2 城际城乡公交 3 城际城乡巡游出租 4 城际城乡网约车；返回 [客运量, 周转量, 客运量同比, 周转量同比] */
			private double[] smMidRow(double[] p, double[] pl, int i) {
			int[] paxIdx = {SM_BX_PAX, SM_BX_PAX, SM_BUS_CX_PAX, SM_TAXI_CX_PAX, SM_WYC_CX_PAX};
			int[] turnIdx = {SM_BX_TURN, SM_BX_TURN, SM_BUS_CX_TURN, SM_TAXI_CX_TURN, SM_WYC_CX_TURN};
			double pax, turn, lPax, lTurn;
			if (i == 0) {
			pax = p[SM_BX_PAX] + p[SM_BUS_CX_PAX] + p[SM_TAXI_CX_PAX] + p[SM_WYC_CX_PAX];
			turn = p[SM_BX_TURN] + p[SM_BUS_CX_TURN] + p[SM_TAXI_CX_TURN] + p[SM_WYC_CX_TURN];
			lPax = pl[SM_BX_PAX] + pl[SM_BUS_CX_PAX] + pl[SM_TAXI_CX_PAX] + pl[SM_WYC_CX_PAX];
			lTurn = pl[SM_BX_TURN] + pl[SM_BUS_CX_TURN] + pl[SM_TAXI_CX_TURN] + pl[SM_WYC_CX_TURN];
			} else {
			pax = p[paxIdx[i]]; turn = p[turnIdx[i]];
			lPax = pl[paxIdx[i]]; lTurn = pl[turnIdx[i]];
			}
			return new double[]{pax, turn, smYoy(pax, lPax), smYoy(turn, lTurn)};
			}

			/** 道路运输周转量页：块1（累计）行 4-21，块2（当月）行 26-43；只写值列（B/E/V 等公式保留） */
			private int smWriteTurnoverSheets(XSSFWorkbook wb, int year, int month,
			Map<String, double[]> curCum, Map<String, double[]> lastCum,
			Map<String, double[]> curMon, Map<String, double[]> lastMon) {
			Sheet sh = wb.getSheet("道路运输周转量");
			if (sh == null) return 0;
			smSetTitle(sh, 0, 0, year + "年1-" + month + "月全省累计完成交通周转量情况");
			smSetTitle(sh, 22, 0, year + "年" + month + "月全省完成交通周转量情况");
			int n = 0;
			n += smWriteTurnoverBlock(sh, 3, curCum, lastCum);
			n += smWriteTurnoverBlock(sh, 25, curMon, lastMon);
			return n;
			}

			private int smWriteTurnoverBlock(Sheet sh, int provRow, Map<String, double[]> cur, Map<String, double[]> last) {
			int n = 0;
			double[] provCur = smProvinceSum(cur);
			double[] provLast = smProvinceSum(last);
			List<String> cities = RegionUtil.cityList();
			for (int i = -1; i < cities.size(); i++) {
			int r = provRow + i + 1;
			double[] c = i < 0 ? provCur : cur.get(cities.get(i));
			double[] l = i < 0 ? provLast : last.get(cities.get(i));
			if (c == null) c = new double[SM_DIM];
			if (l == null) l = new double[SM_DIM];
			double freight = c[SM_FREIGHT_TURN], lFreight = l[SM_FREIGHT_TURN];
			double pax = c[SM_BUS_PAX] + c[SM_TAXI_PAX] + c[SM_WYC_PAX] + c[SM_RAIL_PAX] + c[SM_FERRY_PAX];
			double lPax = l[SM_BUS_PAX] + l[SM_TAXI_PAX] + l[SM_WYC_PAX] + l[SM_RAIL_PAX] + l[SM_FERRY_PAX];
			double road = c[SM_BX_TURN] + c[SM_BUS_CX_TURN] + c[SM_TAXI_CX_TURN] + c[SM_WYC_CX_TURN];
			double lRoad = l[SM_BX_TURN] + l[SM_BUS_CX_TURN] + l[SM_TAXI_CX_TURN] + l[SM_WYC_CX_TURN];
			n += smSetVal(sh, r, 6, freight);
			n += smSetVal(sh, r, 9, smYoy(freight, lFreight));
			n += smSetVal(sh, r, 11, pax);
			n += smSetVal(sh, r, 14, smYoy(pax, lPax));
			n += smSetVal(sh, r, 16, road);
			n += smSetVal(sh, r, 19, smYoy(road, lRoad));
			n += smSetVal(sh, r, 22, lFreight);
			n += smSetVal(sh, r, 23, lPax);
			n += smSetVal(sh, r, 24, lRoad);
			}
			return n;
			}


			private File resolveSummaryLayoutRef() {
			String rel = summaryTemplateDir;
			while (rel != null && rel.startsWith("./")) rel = rel.substring(2);
			String[] roots = {
			summaryTemplateDir,
			System.getProperty("user.dir") + "/" + rel,
			System.getProperty("user.dir") + "/../" + rel
			};
			for (String root : roots) {
			if (root == null \|\| root.trim().isEmpty()) continue;
			File f = new File(root, "生成_道路运输量汇总表.xlsx");
			if (f.isFile()) return f;
			}
			return null;
			}

			/** 汇总表母版定位：仅精确匹配 {year}年{month}月…（P0-P1 骨架期不允许跨月/跨年静默回退，
			@@ -3497,8 +4715,8 @@
			if (r.getAvgDistanceCity() != null && r.getAvgDistanceCity() > 0) a[5] = r.getAvgDistanceCity();
			}
			for (double[] a : map.values()) {
			if (a[4] <= 0 && a[0] > 0) a[4] = round(a[1] / a[0], 2);
			if (a[5] <= 0 && a[2] > 0) a[5] = round(a[3] / a[2], 2);
			if (a[4] <= 0 && a[0] > 0) a[4] = a[1] / a[0];
			if (a[5] <= 0 && a[2] > 0) a[5] = a[3] / a[2];
			}
			return map;
			}
			@@ -3533,6 +4751,9 @@
			if (bs == null) continue;
			// 中口径排名页 A..H 陈旧左块已于 2026-09-09 拍板整块删除：该区域永不从备份母版回填，避免“生成又复活”
			boolean skipMidRankLeftBlock = "中口径排名".equals(ds.getSheetName());
			// 《货运》页 2025..2021 年度块（T 列起，含各年累计/累计同比列）在母版里是「市州派生公式」，
			// 备份母版同区仍是旧的写死常量（全省规下等），回填会让 2021/2022/2023 累计又对不上（“生成又复活”），故该区不回填。
			boolean skipFreightHistoryBlocks = " 货运".equals(ds.getSheetName());
			for (int r = ds.getFirstRowNum(); r <= ds.getLastRowNum(); r++) {
			Row dr = ds.getRow(r);
			if (dr == null) continue;
			@@ -3540,6 +4761,7 @@
			for (Cell dc : dr) {
			if (dc == null) continue;
			if (skipMidRankLeftBlock && dc.getColumnIndex() < 8) continue;
			if (skipFreightHistoryBlocks && dc.getColumnIndex() >= 19) continue; // T 列及以后 = 2025..2021 年度块
			CellType t = dc.getCellType();
			if (t == CellType.BLANK) continue;
			String dtx = summaryCellText(dc);
			@@ -3739,6 +4961,8 @@
			case "investFiveYearLogistics": return investFiveYearLogistics(period, mode);
			case "investBillion": return investBillion(period, mode);
			case "investCounty": return investCounty(period, mode);
			case "investPassengerDetail": return exportInvestPassengerDetail(period, mode);
			case "investLogisticsDetail": return exportInvestLogisticsDetail(period, mode);
			case "cityBusDetail": return exportCityBusDetail(period, mode);
			case "cityTaxiDetail": return exportCityTaxiDetail(period, mode);
			case "cityRailFerryDetail": return exportCityRailFerryDetail(period, mode);
			@@ -3764,6 +4988,8 @@
			REPORT_FILE_NAMES.put("investFiveYearLogistics", "生成_十五五规划物流项目进展情况.xls");
			REPORT_FILE_NAMES.put("investBillion", "生成_湖北省（客货站场）亿元投资项目.xls");
			REPORT_FILE_NAMES.put("investCounty", "生成_经济强县交通物流基础设施投资统计报表.xls");
			REPORT_FILE_NAMES.put("investPassengerDetail", "生成_客运站投资明细表.xlsx");
			REPORT_FILE_NAMES.put("investLogisticsDetail", "生成_物流站场投资明细.xls");
			REPORT_FILE_NAMES.put("cityBusDetail", "生成_城市公交客运量分市州明细.xlsx");
			REPORT_FILE_NAMES.put("cityTaxiDetail", "生成_巡游出租客运量分市州明细.xlsx");
			REPORT_FILE_NAMES.put("cityRailFerryDetail", "生成_轨道轮渡客运量分市州明细.xlsx");
			@@ -3806,19 +5032,19 @@
			Row row = sheet.getRow(rowIdx);
			if (row == null) row = sheet.createRow(rowIdx);
			if (a > 0) {
			// 2026年 1..N 月：库内有值则填（2位小数），无值清空模板样例
			// 2026年 1..N 月：库内有值则填（全精度写入，两位小数由单元格格式展示），无值清空模板样例
			for (int m = 1; m <= month; m++) {
			double v = cityVal(monthCity, area, m, k);
			Cell c = row.getCell(2 + (m - 1) * 2);
			if (c == null) c = row.createCell(2 + (m - 1) * 2);
			if (v == 0) c.setBlank(); else c.setCellValue(round(v, 2));
			if (v == 0) c.setBlank(); else c.setCellValue(v);
			}
			// 2025年 1..12 月：库内有去年数据则填，否则清空模板样例
			for (int m = 1; m <= 12; m++) {
			double v = cityVal(lastYearMonthCity, area, m, k);
			Cell c = row.getCell(19 + (m - 1) * 2);
			if (c == null) c = row.createCell(19 + (m - 1) * 2);
			if (v == 0) c.setBlank(); else c.setCellValue(round(v, 2));
			if (v == 0) c.setBlank(); else c.setCellValue(v);
			}
			}
			rowIdx++;
			@@ -4227,6 +5453,7 @@
			hssfText(row, 0, "合计");
			InvestAgg prov = new InvestAgg();
			for (InvestmentMonthly m : monthlies) prov.add(m, pmap.get(m.getProjectId()));
			addProjectsWithoutMonthly(prov, projects, mByProject, null, null);
			writeInvestAggHssf(row, prov);
			continue;
			}
			@@ -4239,6 +5466,7 @@
			InvestmentProject p = pmap.get(m.getProjectId());
			if (p != null && blockCategory.equals(p.getCategory())) agg.add(m, p);
			}
			addProjectsWithoutMonthly(agg, projects, mByProject, blockCategory, null);
			writeInvestAggHssf(row, agg);
			seq = 0;
			continue;
			@@ -4267,6 +5495,7 @@
			if (p != null && city.equals(p.getCity())
			&& (blockCategory == null \|\| blockCategory.equals(p.getCategory()))) agg.add(m, p);
			}
			addProjectsWithoutMonthly(agg, projects, mByProject, blockCategory, city);
			writeInvestAggHssf(row, agg);
			continue;
			}
			@@ -4311,9 +5540,376 @@
			hssfNum(row, 8, agg.startCum == 0 ? null : agg.startCum);
			hssfNum(row, 9, agg.yearPlan == 0 ? null : agg.yearPlan);
			hssfNum(row, 22, agg.yearCum == 0 ? null : agg.yearCum);
			if (agg.yearPlan > 0) hssfNum(row, 23, round(agg.yearCum / agg.yearPlan, 4));
			if (agg.yearPlan > 0) hssfNum(row, 23, agg.yearCum / agg.yearPlan);
			}

			/**
			* 补计「本期没有月度记录、但项目主档有总投资」的项目（只计总投资这一列）。
			* 场景：某市州本月未报送单表（如武汉 8 月物流），主档里项目仍在，若不补计，该市州小计/合计会整块为空。
			*
			* @param category 块类别（客运站场/物流园区）；null 表示不限
			* @param city 市州全称（如武汉市）；null 表示不限
			*/
			private void addProjectsWithoutMonthly(InvestAgg agg, List<InvestmentProject> projects,
			Map<Long, InvestmentMonthly> mByProject,
			String category, String city) {
			for (InvestmentProject p : projects) {
			if (p == null \|\| mByProject.containsKey(p.getId())) continue;
			if (category != null && !category.equals(p.getCategory())) continue;
			if (city != null && !city.equals(p.getCity())) continue;
			if (p.getTotalInvestment() != null) agg.total += p.getTotalInvestment();
			}
			}



			// ==================== 投资模块：客运站投资明细表 / 物流站场投资明细（模板底稿原位替换） ====================

			/** 物流站场明细表模板中的市州小节短名 -> 库内规范全名 */
			private static final Map<String, String> LOGI_CITY_LABELS = new LinkedHashMap<>();
			static {
			LOGI_CITY_LABELS.put("武汉", "武汉市");
			LOGI_CITY_LABELS.put("黄石", "黄石市");
			LOGI_CITY_LABELS.put("十堰", "十堰市");
			LOGI_CITY_LABELS.put("宜昌", "宜昌市");
			LOGI_CITY_LABELS.put("襄阳", "襄阳市");
			LOGI_CITY_LABELS.put("鄂州", "鄂州市");
			LOGI_CITY_LABELS.put("荆门", "荆门市");
			LOGI_CITY_LABELS.put("孝感", "孝感市");
			LOGI_CITY_LABELS.put("荆州", "荆州市");
			LOGI_CITY_LABELS.put("黄冈", "黄冈市");
			LOGI_CITY_LABELS.put("咸宁", "咸宁市");
			LOGI_CITY_LABELS.put("随州", "随州市");
			LOGI_CITY_LABELS.put("恩施", "恩施州");
			LOGI_CITY_LABELS.put("仙桃", "仙桃市");
			LOGI_CITY_LABELS.put("潜江", "潜江市");
			LOGI_CITY_LABELS.put("天门", "天门市");
			LOGI_CITY_LABELS.put("林区", "神农架林区");
			}

			/** 该期各项目月度数据：projectId -> InvestmentMonthly */
			private Map<Long, InvestmentMonthly> investMonthlyOf(String period) {
			Map<Long, InvestmentMonthly> map = new HashMap<>();
			for (InvestmentMonthly m : investMonthlyMapper.selectList(
			new LambdaQueryWrapper<InvestmentMonthly>().eq(InvestmentMonthly::getReportPeriod, period))) {
			map.put(m.getProjectId(), m);
			}
			return map;
			}

			/** 写单元格数值（保留样式/合并）：null 清空 */
			private void putNum(Row row, int idx, Double v) {
			if (row == null) return;
			Cell c = row.getCell(idx);
			if (c == null) c = row.createCell(idx);
			c.setBlank();
			if (v != null) c.setCellValue(v);
			}

			/** 写单元格文本（保留样式/合并）：空串清空 */
			private void putText(Row row, int idx, String v) {
			if (row == null) return;
			Cell c = row.getCell(idx);
			if (c == null) c = row.createCell(idx);
			c.setBlank();
			if (v != null && !v.trim().isEmpty()) c.setCellValue(v.trim());
			}

			/** 读单元格数值（空/非数值/公式无缓存一律 0） */
			private double numOf(Cell c) {
			if (c == null) return 0.0;
			try {
			if (c.getCellType() == CellType.NUMERIC \|\| c.getCellType() == CellType.FORMULA) {
			return c.getNumericCellValue();
			}
			String s = cellText(c);
			if (s == null) return 0.0;
			s = s.replace(",", "").trim();
			return s.isEmpty() ? 0.0 : Double.parseDouble(s);
			} catch (Exception e) {
			return 0.0;
			}
			}

			/** 模板标题里的「（N月月报）」「（N月）」改为报表期月份 */
			private void fixInvestMonthTitle(Sheet sheet, int rowIdx, int colIdx, int month) {
			Row row = sheet.getRow(rowIdx);
			if (row == null) return;
			String t = cellText(row.getCell(colIdx));
			if (t == null) return;
			String nv = t.replaceAll("（\\d+月月报）", "（" + month + "月月报）")
			.replaceAll("（\\d+月）", "（" + month + "月）");
			if (!nv.equals(t)) putText(row, colIdx, nv);
			}

			/** 模板行 A 列是否为「一二三四、」渠道分组标题 */
			private boolean isInvestChannelLabel(String a) {
			return a != null && a.matches("^[一二三四五六七八九十]+、.*");
			}

			/**
			* 生成_X月客运站投资明细表.xlsx（模板：docs/投资/模板/模板_X月客运站投资明细表.xlsx，sheet：明细 + 汇总）。
			* 口径：模板即上月台账底稿；本月只覆盖「库内有该期数据」的项目行
			* （H自开始建设累计 / I本年计划 / J自年初累计 / K本月完成 / L建设阶段 / M形象进度），
			* 库内无该期的项目行保留母版原值（等同人工「上月结转 + 本月更新」）；
			* 城市/渠道/合计行沿用模板 SUM 公式，随表内数值自动重算。
			*/
			public byte[] exportInvestPassengerDetail(String period, String mode) throws Exception {
			int year = Integer.parseInt(period.split("-")[0]);
			int month = monthOf(period, mode);
			List<InvestmentProject> projects = investProjectMapper.selectList(
			new LambdaQueryWrapper<InvestmentProject>().eq(InvestmentProject::getCategory, "客运站场"));
			Map<Long, InvestmentMonthly> mByProject = investMonthlyOf(period);
			File tpl = resolveAnyTemplate(investTemplateDir, "模板_X月客运站投资明细表.xlsx");
			try (InputStream in = new FileInputStream(tpl);
			XSSFWorkbook wb = new XSSFWorkbook(in)) {
			Sheet sheet = wb.getSheet("明细");
			if (sheet == null) throw new RuntimeException("模板《模板_X月客运站投资明细表.xlsx》缺少「明细」工作表");
			fixInvestMonthTitle(sheet, 0, 1, month);
			String curCity = null;
			Set<Long> used = new HashSet<>();
			int filled = 0, kept = 0, dup = 0;
			for (int r = 8; r <= sheet.getLastRowNum(); r++) {
			Row row = sheet.getRow(r);
			if (row == null) continue;
			String a = nvl(cellText(row.getCell(0)));
			String b = nvl(cellText(row.getCell(1)));
			if (isCityLabel(a)) { curCity = templateCityFull(a); continue; }
			if (isInvestChannelLabel(a)) continue;
			if (a.contains("合计") \|\| a.contains("总计")) continue;
			if (!a.matches("\\d+(\\.\\d+)?")) continue;
			if (b.isEmpty() \|\| curCity == null) continue;
			InvestmentProject p = matchInvest(projects, b, curCity, "客运站场", used);
			InvestmentMonthly m = p == null ? null : mByProject.get(p.getId());
			if (p == null \|\| m == null) {
			kept++;
			// 有库内项目但当月无数据 → 记为待核对；无匹配项目 → 结转上月
			if (p != null) dup++;
			continue;
			}
			used.add(p.getId());
			// 口径（用户 2026-09-18 确认）：只覆盖人工会随月报更新的四列——
			// H 自开始建设累计 / J 自年初累计 / K 本月完成 / M 形象进度；
			// I 本年计划投资、L 建设阶段、G 计划总投资为省定/母版口径，一律不动；库内为空则保留母版原值
			if (m.getStartCum() != null) putNum(row, 7, m.getStartCum());
			if (m.getYearCum() != null) putNum(row, 9, m.getYearCum());
			if (m.getMonthDone() != null) putNum(row, 10, m.getMonthDone());
			if (m.getProgressDesc() != null && !m.getProgressDesc().trim().isEmpty()) putText(row, 12, m.getProgressDesc());
			filled++;
			}
			Sheet sumSheet = wb.getSheet("汇总");
			if (sumSheet != null) {
			Row r2 = sumSheet.getRow(1);
			if (r2 != null) {
			Cell c = r2.getCell(0);
			if (c == null) c = r2.createCell(0);
			c.setBlank();
			c.setCellValue(java.time.LocalDate.of(year, month, 1).atStartOfDay());
			}
			}
			try {
			wb.getCreationHelper().createFormulaEvaluator().evaluateAll();
			} catch (Exception e) {
			log.warn("客运站投资明细表公式求值失败: {}", e.getMessage());
			}
			log.info("客运站投资明细表 {}：写入 {} 行，结转母版原值 {} 行（其中库内有项目但当月无数据 {} 行）",
			period, filled, kept, dup);
			return toBytes(wb);
			}
			}

			/**
			* 生成_X月物流站场投资明细.xls（模板：docs/投资/模板/模板_X月物流站场投资明细.xls）。
			* 覆盖「分项目投资完成情况」项目行（口径同客运站明细表），并按表内数值重算
			* 渠道行 / 市州行 / 合计行，同步刷新「分市州规划内外项目完成情况」「市州汇总」两张汇总页。
			*/
			public byte[] exportInvestLogisticsDetail(String period, String mode) throws Exception {
			int year = Integer.parseInt(period.split("-")[0]);
			int month = monthOf(period, mode);
			List<InvestmentProject> projects = investProjectMapper.selectList(
			new LambdaQueryWrapper<InvestmentProject>().eq(InvestmentProject::getCategory, "物流园区"));
			Map<Long, InvestmentMonthly> mByProject = investMonthlyOf(period);
			HSSFWorkbook wb = loadInvestTemplate("模板_X月物流站场投资明细.xls");
			HSSFSheet sheet = wb.getSheet(" 分项目投资完成情况");
			if (sheet == null) throw new RuntimeException("模板《模板_X月物流站场投资明细.xls》缺少「分项目投资完成情况」工作表");
			fixInvestMonthTitle(sheet, 0, 0, month);
			Row head = sheet.getRow(3);
			if (head != null) {
			String t = cellText(head.getCell(0));
			if (t != null) {
			String nv = t.replaceAll("\\d{4}年\\d+月", year + "年" + month + "月");
			if (!nv.equals(t)) putText(head, 0, nv);
			}
			}
			// 1) 结构扫描：市州小节行
			List<Integer> cityRows = new ArrayList<>();
			for (int r = 7; r <= sheet.getLastRowNum(); r++) {
			HSSFRow row = sheet.getRow(r);
			if (row == null) continue;
			String a = nvl(cellText(row.getCell(0)));
			String b = nvl(cellText(row.getCell(1)));
			if (LOGI_CITY_LABELS.containsKey(a) && b.isEmpty()) cityRows.add(r);
			}
			Map<String, double[]> citySums = new LinkedHashMap<>(); // 全名 -> G,H,I,J,K
			Map<String, double[]> cityStats = new LinkedHashMap<>(); // 全名 -> {总数, 累计, 规划内数, 规划内累计, 规划外数, 规划外累计}
			Set<Long> used = new HashSet<>();
			int filled = 0, kept = 0;
			for (int i = 0; i < cityRows.size(); i++) {
			int cr = cityRows.get(i);
			String cityLabel = nvl(cellText(sheet.getRow(cr).getCell(0)));
			String city = LOGI_CITY_LABELS.getOrDefault(cityLabel, cityLabel);
			int start = cr + 1;
			int end = (i + 1 < cityRows.size() ? cityRows.get(i + 1) : sheet.getLastRowNum() + 1) - 1;
			List<Integer> chRows = new ArrayList<>();
			for (int r = start; r <= end; r++) {
			HSSFRow row = sheet.getRow(r);
			if (row == null) continue;
			if (isInvestChannelLabel(nvl(cellText(row.getCell(0))))) chRows.add(r);
			}
			// (1) 先按项目名+市州覆盖有库内当期数据的项目行
			for (int r = start; r <= end; r++) {
			HSSFRow row = sheet.getRow(r);
			if (row == null) continue;
			String a = nvl(cellText(row.getCell(0)));
			String b = nvl(cellText(row.getCell(1)));
			if (isInvestChannelLabel(a)) continue;
			if (!a.matches("\\d+(\\.\\d+)?")) continue;
			if (b.isEmpty()) continue;
			InvestmentProject p = matchInvest(projects, b, city, "物流园区", used);
			InvestmentMonthly m = p == null ? null : mByProject.get(p.getId());
			if (p == null \|\| m == null) { kept++; continue; }
			used.add(p.getId());
			// 口径同客运站明细表：只覆盖 H 自开始建设累计 / J 自年初累计 / K 本月完成 / M 形象进度
			if (m.getStartCum() != null) putNum(row, 7, m.getStartCum());
			if (m.getYearCum() != null) putNum(row, 9, m.getYearCum());
			if (m.getMonthDone() != null) putNum(row, 10, m.getMonthDone());
			if (m.getProgressDesc() != null && !m.getProgressDesc().trim().isEmpty()) putText(row, 12, m.getProgressDesc());
			filled++;
			}
			// (2) 再按渠道块汇总，并写回渠道行 / 市州行
			double[] citySum = new double[5];
			double[] stat = new double[6];
			for (int j = 0; j < chRows.size(); j++) {
			int r0 = chRows.get(j);
			int r1 = (j + 1 < chRows.size() ? chRows.get(j + 1) : end + 1) - 1;
			boolean planned = !nvl(cellText(sheet.getRow(r0).getCell(0))).startsWith("四、");
			double[] s = new double[5];
			for (int r = r0 + 1; r <= r1; r++) {
			HSSFRow row = sheet.getRow(r);
			if (row == null) continue;
			String a = nvl(cellText(row.getCell(0)));
			String b = nvl(cellText(row.getCell(1)));
			if (isInvestChannelLabel(a) \|\| !a.matches("\\d+(\\.\\d+)?")) continue;
			if (b.isEmpty()) continue;
			for (int k = 0; k < 5; k++) s[k] += numOf(row.getCell(6 + k));
			stat[0] += 1;
			stat[1] += numOf(row.getCell(9));
			if (planned) { stat[2] += 1; stat[3] += numOf(row.getCell(9)); }
			else { stat[4] += 1; stat[5] += numOf(row.getCell(9)); }
			}
			HSSFRow crow = sheet.getRow(r0);
			for (int k = 0; k < 5; k++) putNum(crow, 6 + k, s[k] == 0 ? null : s[k]);
			for (int k = 0; k < 5; k++) citySum[k] += s[k];
			}
			// 渠道块之外的游离项目行（模板未分组时）也计入市州合计
			for (int r = start; r <= end; r++) {
			HSSFRow row = sheet.getRow(r);
			if (row == null) continue;
			String a = nvl(cellText(row.getCell(0)));
			String b = nvl(cellText(row.getCell(1)));
			if (isInvestChannelLabel(a) \|\| !a.matches("\\d+(\\.\\d+)?")) continue;
			if (b.isEmpty()) continue;
			boolean inChannel = false;
			for (int j = 0; j < chRows.size(); j++) {
			int r0 = chRows.get(j);
			int r1 = (j + 1 < chRows.size() ? chRows.get(j + 1) : end + 1) - 1;
			if (r > r0 && r <= r1) { inChannel = true; break; }
			}
			if (inChannel) continue;
			for (int k = 0; k < 5; k++) citySum[k] += numOf(row.getCell(6 + k));
			stat[0] += 1;
			stat[1] += numOf(row.getCell(9));
			}
			HSSFRow cityRow = sheet.getRow(cr);
			for (int k = 0; k < 5; k++) putNum(cityRow, 6 + k, citySum[k] == 0 ? null : citySum[k]);
			citySums.put(city, citySum);
			cityStats.put(city, stat);
			}
			// 2) 合计行（第 7 行）
			double[] total = new double[5];
			for (double[] s : citySums.values()) {
			for (int k = 0; k < 5; k++) total[k] += s[k];
			}
			for (int k = 0; k < 5; k++) putNum(sheet.getRow(6), 6 + k, total[k] == 0 ? null : total[k]);

			// 3) 分市州规划内外项目完成情况
			HSSFSheet citySheet = wb.getSheet("分市州规划内外项目完成情况");
			if (citySheet != null) {
			Row t1 = citySheet.getRow(0);
			if (t1 != null) {
			String t = cellText(t1.getCell(0));
			if (t != null) {
			String nv = t.replaceAll("\\d{4}年", year + "年");
			if (!nv.equals(t)) putText(t1, 0, nv);
			}
			}
			double[] st = new double[6];
			for (int r = 3; r <= citySheet.getLastRowNum(); r++) {
			HSSFRow row = citySheet.getRow(r);
			if (row == null) continue;
			String a = nvl(cellText(row.getCell(0)));
			String b = nvl(cellText(row.getCell(1)));
			if (a.contains("合计") \|\| b.contains("合计")) {
			for (int k = 0; k < 6; k++) putNum(row, 2 + k, st[k] == 0 ? null : st[k]);
			continue;
			}
			double[] s = cityStats.get(LOGI_CITY_LABELS.getOrDefault(b, b));
			if (s == null) continue;
			for (int k = 0; k < 6; k++) {
			putNum(row, 2 + k, s[k] == 0 ? null : s[k]);
			st[k] += s[k];
			}
			}
			}

			// 4) 市州汇总（B 年度计划投资为官方口径，保持模板原值；C/D/E 按分项目页重算）
			HSSFSheet sumSheet = wb.getSheet("市州汇总");
			if (sumSheet != null) {
			HSSFRow r2 = sumSheet.getRow(1);
			if (r2 != null) {
			putNum(r2, 0, (double) org.apache.poi.ss.usermodel.DateUtil.getExcelDate(
			java.time.LocalDate.of(year, month, 1).atStartOfDay()));
			}
			double cT = 0.0, dT = 0.0;
			for (int r = 7; r <= 23; r++) {
			HSSFRow row = sumSheet.getRow(r);
			if (row == null) continue;
			String a = nvl(cellText(row.getCell(0)));
			double[] s = citySums.get(LOGI_CITY_LABELS.getOrDefault(a, a));
			if (s == null) continue;
			putNum(row, 2, s[3] == 0 ? null : s[3]);
			putNum(row, 3, s[4] == 0 ? null : s[4]);
			double b = numOf(row.getCell(1));
			putNum(row, 4, b > 0 ? s[3] / b * 100 : null);
			cT += s[3];
			dT += s[4];
			}
			HSSFRow tot = sumSheet.getRow(6);
			if (tot != null) {
			putNum(tot, 2, cT == 0 ? null : cT);
			putNum(tot, 3, dT == 0 ? null : dT);
			double b = numOf(tot.getCell(1));
			putNum(tot, 4, b > 0 ? cT / b * 100 : null);
			}
			}
			try {
			wb.getCreationHelper().createFormulaEvaluator().evaluateAll();
			} catch (Exception e) {
			log.warn("物流站场投资明细公式求值失败: {}", e.getMessage());
			}
			log.info("物流站场投资明细 {}：写入 {} 行，结转母版原值 {} 行", period, filled, kept);
			return toBytesHssf(wb);
			}

			private static class InvestAgg {
			double total, startCum, yearPlan, yearCum;
			@@ -4524,7 +6120,7 @@
			for (InvestmentMonthly m : monthlies) provinceYearPlan += nz(m.getYearPlan());
			HSSFRow rowOther = s1.getRow(9);
			for (int c = 1; c <= 5; c++) hssfNum(rowOther, c, null);
			hssfNum(rowOther, 5, provinceYearPlan == 0 ? null : round(provinceYearPlan / 10000, 2));
			hssfNum(rowOther, 5, provinceYearPlan == 0 ? null : provinceYearPlan / 10000);
			// ---- sheet2 规上项目表：表头年份 + 合计 + 项目行 ----
			HSSFSheet s2 = wb.getSheetAt(1);
			hssfText(s2.getRow(0), 0, year + "年交通建设项目储备情况（规模以上项目）");
			@@ -4756,6 +6352,8 @@
			private double nz(Double v) {
			return v == null ? 0.0 : v;
			}
			/** 数值格式里 3 位及以上的小数部分（如 0.0000 / 0.000_ ） */
			private static final java.util.regex.Pattern DEC_MORE_THAN_TWO = java.util.regex.Pattern.compile("\\.0{3,}");
			/** 生成表数值列统一样式：保留全精度数值，显示两位小数；整数值与 %/日期/科学计数等既有样式不改变 */
			private void applyTwoDecimalFormat(org.apache.poi.ss.usermodel.Workbook wb) {
			if (wb == null) return;
			@@ -4772,24 +6370,32 @@
			CellType ct = cell.getCellType();
			if (ct != CellType.NUMERIC && ct != CellType.FORMULA) continue;
			if (org.apache.poi.ss.usermodel.DateUtil.isCellDateFormatted(cell)) continue;
			boolean integral = false;
			if (ct == CellType.NUMERIC) {
			integral = Math.rint(cell.getNumericCellValue()) == cell.getNumericCellValue();
			} else if (cell.getCachedFormulaResultType() == CellType.NUMERIC) {
			integral = Math.rint(cell.getNumericCellValue()) == cell.getNumericCellValue();
			}
			if (integral) continue; // 整数不显示 .00（含公式结果为整数的格）
			org.apache.poi.ss.usermodel.CellStyle cs = cell.getCellStyle();
			if (cs == null) continue;
			String f = cs.getDataFormatString();
			if (f == null) f = "";
			if (f.contains("%") \|\| f.contains("E") \|\| f.contains("0.00")) continue;
			boolean plain = f.isEmpty() \|\| "General".equals(f) \|\| "general".equals(f)
			\|\| "0".equals(f) \|\| "#,##0".equals(f) \|\| "0.0".equals(f) \|\| "#,##0.0".equals(f);
			if (!plain) continue;
			if (f.contains("%") \|\| f.contains("E") \|\| f.contains("@")) continue;
			String normalized = null;
			if (DEC_MORE_THAN_TWO.matcher(f).find()) {
			// 母版个别格带 3~4 位小数格式（如 0.000_ 、0.0000_);[Red]$0.0000$）：数值仍全精度，
			// 展示统一收敛到两位。这类格本就按数值格式展示，故不受「整数不显示 .00」保护影响。
			normalized = DEC_MORE_THAN_TWO.matcher(f).replaceAll(".00");
			} else {
			boolean integral = false;
			if (ct == CellType.NUMERIC) {
			integral = Math.rint(cell.getNumericCellValue()) == cell.getNumericCellValue();
			} else if (cell.getCachedFormulaResultType() == CellType.NUMERIC) {
			integral = Math.rint(cell.getNumericCellValue()) == cell.getNumericCellValue();
			}
			if (integral) continue; // 整数不显示 .00（含公式结果为整数的格）
			if (f.contains("0.00")) continue;
			boolean plain = f.isEmpty() \|\| "General".equals(f) \|\| "general".equals(f)
			\|\| "0".equals(f) \|\| "#,##0".equals(f) \|\| "0.0".equals(f) \|\| "#,##0.0".equals(f);
			if (!plain) continue;
			}
			org.apache.poi.ss.usermodel.CellStyle ns = wb.createCellStyle();
			ns.cloneStyleFrom(cs);
			ns.setDataFormat(fmtTwo);
			ns.setDataFormat(normalized == null ? fmtTwo : df.getFormat(normalized));
			cell.setCellStyle(ns);
			} catch (Exception ignore) {
			// 个别单元格格式异常不阻塞导出
			@@ -4800,59 +6406,26 @@
			}

			/** 汇总表导出后按内容自动加宽列宽（只加宽不缩窄；跳过合并单元格标题，防长标题把单列撑爆） */
			private void autoFitContentColumns(org.apache.poi.ss.usermodel.Workbook wb) {
			/** 汇总大表输出前清理母版残留下来的筛选与行隐藏：筛选箭头/隐藏行会让整页看起来“缺数据” */
			private void cleanSummarySheetPresentation(org.apache.poi.ss.usermodel.Workbook wb) {
			if (wb == null) return;
			org.apache.poi.ss.usermodel.DataFormatter dfmt = new org.apache.poi.ss.usermodel.DataFormatter();
			for (int s = 0; s < wb.getNumberOfSheets(); s++) {
			org.apache.poi.ss.usermodel.Sheet sh = wb.getSheetAt(s);
			if (sh == null) continue;
			java.util.Set<String> merged = new java.util.HashSet<>();
			for (org.apache.poi.ss.util.CellRangeAddress ra : sh.getMergedRegions()) {
			for (int r = ra.getFirstRow(); r <= ra.getLastRow(); r++) {
			for (int c = ra.getFirstColumn(); c <= ra.getLastColumn(); c++) {
			merged.add(r + ":" + c);
			}
			if (sh instanceof org.apache.poi.xssf.usermodel.XSSFSheet) {
			org.apache.poi.xssf.usermodel.XSSFSheet xs = (org.apache.poi.xssf.usermodel.XSSFSheet) sh;
			if (xs.getCTWorksheet().isSetAutoFilter()) xs.getCTWorksheet().unsetAutoFilter();
			for (org.apache.poi.ss.usermodel.Row row : xs) {
			if (row == null) continue;
			org.apache.poi.xssf.usermodel.XSSFRow xr = (org.apache.poi.xssf.usermodel.XSSFRow) row;
			if (xr.getCTRow().isSetHidden()) xr.getCTRow().unsetHidden();
			}
			}
			int maxCol = -1;
			for (org.apache.poi.ss.usermodel.Row row : sh) {
			if (row == null) continue;
			maxCol = Math.max(maxCol, (int) row.getLastCellNum() - 1);
			}
			if (maxCol < 0) continue;
			int[] need = new int[maxCol + 1];
			for (org.apache.poi.ss.usermodel.Row row : sh) {
			if (row == null) continue;
			for (org.apache.poi.ss.usermodel.Cell cell : row) {
			int c = cell.getColumnIndex();
			if (c > maxCol \|\| merged.contains(row.getRowNum() + ":" + c)) continue;
			String txt;
			try {
			txt = dfmt.formatCellValue(cell);
			} catch (Exception ignore) {
			continue;
			}
			if (txt == null \|\| txt.isEmpty()) continue;
			int units = 0;
			for (int i = 0; i < txt.length(); i++) {
			units += isWideChar(txt.charAt(i)) ? 2 : 1;
			}
			if (units > need[c]) need[c] = Math.min(units, 34); // 长文本不把单列撑爆
			}
			}
			for (int c = 0; c <= maxCol; c++) {
			if (need[c] <= 0) continue;
			int target = Math.min(need[c] + 2, 46) * 256;
			if (target > sh.getColumnWidth(c)) sh.setColumnWidth(c, target);
			} else {
			sh.setAutoFilter(null);
			}
			}
			}

			/** CJK / 全角字符按两倍宽度计（近似 Excel 显示列宽） */
			private boolean isWideChar(char ch) {
			return (ch >= 0x2E80 && ch <= 0x9FFF) \|\| (ch >= 0xF900 && ch <= 0xFAFF)
			\|\| (ch >= 0xFF00 && ch <= 0xFFEF);
			}

			private byte[] toBytes(XSSFWorkbook wb) throws Exception {
			applyTwoDecimalFormat(wb);