HANDOFF.md

@@ -4,6 +4,47 @@
> **每天结束时**：把当天进展、踩过的坑、新需求、未完成事项更新到本文件，然后可以放心开新对话。
> **协作约定（2026-08-31）**：说「提交」= 本地 commit + 推送到远端 git（origin main，Gitblit），不再只做本地 commit。

## 最新（2026-10-07 上午，新开会话交接）

### 10-07：每日客流构成图右侧标签布局修复（验收通过）

- **问题**：`image13`「每日客流构成变化」右侧外置百分比标签在相邻日期之间重叠 4 处；改为两列后引线交错，个别引线压住绿色块内数值。
- **最终规则**：只有色块内放不下的标签进入右侧外置区；外置标签按原始图例序号排序，即道路→铁路→民航→水路；最多 2 列，按“先行后列、每行从左到右”填充；1 个标签整体居中，2 个标签两列各居中，3 个标签下排单标签跨两列居中，4 个标签为 2×2 格居中；两列布局不画引线，颜色对应色块。
- **实现**：`HolidayTrendChartService` 将右侧标签带从 74 加宽到 140；`HorizontalStackCallout` 记录原始 `seriesIndex` 并按其排序；仅对每日客流构成图启用两列居中布局；公路出行结构仍走原单列带引线逻辑。
- **验证**：真实库只读生成 2026-10-07 走势图；与原版相比 15 张图中仅 `image13` 变化，其余 14 张 SHA-256 完全一致；右侧标签区 OCR 重叠从 4 降为 0；无引线。后端全量 `mvn -q test -f traffic-audit-server\pom.xml` 通过。
- **验收**：用户 2026-10-07 验收 `(12).docx` 通过。
- **后续**：10-07 数据齐全后，按系统配置的假期天数（7 天）生成最终版走势图，用于分析报告；本轮不调整假日天数来源。
- **数据边界**：未导入、覆盖或重导任何业务数据。

### 10-07：普通国省道 2025-10-05 调整值更正（已核对）

- **背景**：10-05 剔除 3 个环比降幅超过 50% 的站点（郑店、樊家庄、上津站）和 3 个 10-05 缺失站点（龙泉、华鲁交调站、大典河）。
- **站点编号**：郑店 `S101L110420115`、樊家庄 `S120L105420702`、上津站 `G242L104420322`、龙泉 `S216L103420506`、华鲁交调站 `S223L117421024`、大典河 `S464L105422828`。
- **各日剔除合计（中小客流量，辆次）**：2026-10-04 `16,484`；2026-10-05 `4,398`；2025-10-05 `14,239`；2024-10-05 `11,907`。调整时缺失站点按 0 处理。
- **系统更正**：`holiday_vehicle_adjustment` 的 2025-10-05 调整值已由 `322.7801` 改为 `332.7801`（更新时间 2026-10-07 08:45:52）；2024-10-05 `289.5557`、2025-10-04 `337.5009`、2024-10-04 `322.5277` 不变。
- **工作簿更正**：`C:\Users\jcxiong\Downloads\2026年十一数据 (4).xlsx`（修改时间 08:46:52）中 `普通国省道!F7=332.7801`。联动结果已正确重算：`普通国省道!G7=-4.8%`；`人员流动量汇总` 的 `E7=1460.97`、`F7=-0.3%`、`K7=1372.85`、`Q7=1290.04`、`R7=-1.0%`、`V7=-4.28%`。
- **公式更正已核实**：`普通国省道!E8=(D8-D7)/D7`、`G8=D8/F8-1`、`I8=D8/H8-1`、`E9=(D9-D8)/D8`。
- **10-06 边界（重要）**：工作簿目前只有铁路 `C9=96.2`、水路 `C8=5.4932`、高速公路 `C8=206.1206`；民航 `C9`、道路 `C8`、普通国省道 `D8` 仍为空。因此 `人员流动量汇总!C8=596.38264` 只是部分合计，`D8=-59.06%` 以及各 `-100%/#DIV/0!` 都不可用于快报；补齐三项后重算。
- **数据边界**：本轮只读核对，未导入、覆盖或重导任何业务数据。

### 10-07：Codex 输入卡顿排查与交接建议

- 当前线程从 10-05 连续使用至今，rollout 约 `32.17 MB`，含 `3,751` 条 `response_item`、`3,469` 条 `event_msg`、`10` 次 compaction；用户已决定新开对话继续。
- 已排除 `codex-plus-plus-manager --show-update`（未运行）；重试风暴 guard 已安装，`dropped=859` 且连续 10 秒不增长，当前没有持续重试风暴。
- 观测到 Codex 主进程累计约 `4.34 h` CPU、渲染进程约 `1.28 h`；短时峰值主进程约 `116%` 单核、渲染约 `44%`，属于间歇高负载。建议新对话继续；若仍卡，完全退出并重启 Codex。
- **新对话接手**：先读根目录 `AGENTS.md` + 本文件。当前 git `HEAD` 与 `origin/main` 均为 `9b56330`，已跟踪文件无改动；dev 前端 `8080`、后端 `8090` 正在运行。

## 历史（2026-10-07 早间关机快照）

### 10-07 关机快照

- **当前状态**：本轮仅做关机交接，无代码、测试口径或业务数据变更。上一任务“折线图纵向间距加高 20%”已于 10-06 验收，提交为 `54e10ae fix(holiday): 加大折线图纵向间距并同步 Word 尺寸`。
- **Git**：`main` 的 `HEAD` 与 `origin/main` 均为 `54e10aee11aa4a10926df02782ca07d41eeb9b98`；无未提交的已跟踪文件，工作区仅有按约定不入库的 `_tmp_*` 临时目录/文件、`_tmp_pack_smoke_trend.docx` 和一份观测站原始 XLS。
- **运行状态**：关机前本机 dev 前后端仍可访问（前端 8080、后端 8090 均返回 200）；随计算机关机会自动停止，重启后按 `AGENTS.md` 用 `start-dev.ps1` 启动。
- **本地留存**：折线图纵向间距的测试报告和工作日结已写入 `docs/功能测试报告/`、`docs/工作日结/`，均按约定不入库。
- **下次接手**：先读根目录 `AGENTS.md` + 本文件；仓库级待办仍见第七节，本轮无新增待办。
- **数据边界**：未导入、覆盖或重导任何业务数据。

## 最新（2026-10-06）

### 10-06：折线图纵向间距加高（验收通过）

 traffic-audit-server/src/main/java/com/trafficaudit/holiday/service/HolidayTrendChartService.java

@@ -74,7 +74,7 @@
    private static final Color AXIS_COLOR = Color.BLACK;
    private static final Color MUTED_TEXT_COLOR = new Color(102, 102, 102);
    private static final double UNIT_LABEL_BAND = 58.0;
    private static final double RIGHT_LABEL_BAND = 74.0;
    private static final double RIGHT_LABEL_BAND = 140.0;
    private static final double ITEM_LABEL_GAP = 10.0;
    private static final float HALO_OUTLINE_WIDTH = 4.0f;
    private static final int PERCENT_ITEM_LABEL_DECIMALS = 1;
@@ -615,7 +615,7 @@
                        occupied.add(new Rectangle2D.Double(textX, baseline - metrics.getAscent(),
                                width, metrics.getHeight()));
                    } else {
                        horizontalCallouts.add(new HorizontalStackCallout(Math.min(startX, endX),
                        horizontalCallouts.add(new HorizontalStackCallout(row, Math.min(startX, endX),
                                Math.max(startX, endX), centerY, text, seriesColor(row)));
                    }
                } else {
@@ -645,7 +645,8 @@
            }
        }
        if (horizontal) {
            drawHorizontalStackCallouts(graphics, horizontalCallouts, dataArea, metrics, occupied);
            drawHorizontalStackCallouts(graphics, horizontalCallouts, dataArea, metrics, occupied,
                    rows >= 3);
        } else {
            for (int column = 0; column < columns; column++) {
                drawStackCalloutColumn(graphics, image, callouts.get(column), column, columns,
@@ -657,7 +658,8 @@
    private void drawHorizontalStackCallouts(Graphics2D graphics,
                                              List<HorizontalStackCallout> items,
                                              Rectangle2D dataArea, FontMetrics metrics,
                                              List<Rectangle2D> occupied) {
                                              List<Rectangle2D> occupied,
                                              boolean packIntoColumns) {
        if (items.isEmpty()) return;
        Map<Long, List<HorizontalStackCallout>> rows = new LinkedHashMap<>();
        for (HorizontalStackCallout item : items) {
@@ -673,36 +675,82 @@
            Collections.sort(row, new Comparator<HorizontalStackCallout>() {
                @Override
                public int compare(HorizontalStackCallout first, HorizontalStackCallout second) {
                    return Double.compare(first.getStartX(), second.getStartX());
                    return Integer.compare(first.getSeriesIndex(), second.getSeriesIndex());
                }
            });
            int widest = 0;
            double columnX = 0.0;
            for (HorizontalStackCallout item : row) {
                widest = Math.max(widest, metrics.stringWidth(item.getText()));
                columnX = Math.max(columnX, item.getEndX() + 8.0);
            if (!packIntoColumns) {
                int widest = 0;
                double columnX = 0.0;
                for (HorizontalStackCallout item : row) {
                    widest = Math.max(widest, metrics.stringWidth(item.getText()));
                    columnX = Math.max(columnX, item.getEndX() + 8.0);
                }
                // Keep the label column inside the reserved right margin.
                columnX = Math.min(columnX, dataArea.getMaxX() + RIGHT_LABEL_BAND - widest);
                int height = metrics.getHeight();
                double step = height + 3.0;
                double centerY = row.get(0).getY();
                double top = centerY - (step * row.size()) / 2.0 + (step - height) / 2.0;
                for (int i = 0; i < row.size(); i++) {
                    HorizontalStackCallout item = row.get(i);
                    int width = metrics.stringWidth(item.getText());
                    double x = columnX;
                    double y = top + i * step;
                    graphics.setColor(item.getColor());
                    graphics.setStroke(new BasicStroke(1.4f, BasicStroke.CAP_ROUND,
                            BasicStroke.JOIN_ROUND));
                    graphics.drawLine((int) Math.round(item.getEndX()), (int) Math.round(item.getY()),
                            (int) Math.round(x - 3.0), (int) Math.round(y + height / 2.0));
                    drawLabelWithHalo(graphics, item.getText(),
                            new Rectangle2D.Double(x, y, width, height), metrics, item.getColor());
                    occupied.add(new Rectangle2D.Double(x - 2.0, y - 2.0,
                            width + 4.0, height + 4.0));
                }
                continue;
            }
            // Keep the label column inside the reserved right margin.
            columnX = Math.min(columnX, dataArea.getMaxX() + RIGHT_LABEL_BAND - widest);
            // Small slices are labelled outside the bar. Packing those labels
            // into two columns keeps each day's callouts inside its own row.
            int columnCount = row.size() <= 1 ? 1 : 2;
            int rowCount = (int) Math.ceil(row.size() / (double) columnCount);
            double[] columnWidths = new double[columnCount];
            for (int i = 0; i < row.size(); i++) {
                int column = columnCount == 1 ? 0 : i % columnCount;
                columnWidths[column] = Math.max(columnWidths[column],
                        metrics.stringWidth(row.get(i).getText()));
            }
            double columnGap = 10.0;
            double blockWidth = columnGap * (columnCount - 1);
            for (double columnWidth : columnWidths) blockWidth += columnWidth;
            double blockLeft = dataArea.getMaxX() + 8.0;
            double blockRight = dataArea.getMaxX() + RIGHT_LABEL_BAND;
            blockLeft += Math.max(0.0, (blockRight - blockLeft - blockWidth) / 2.0);
            double[] columnCenters = new double[columnCount];
            double cursor = blockLeft;
            for (int column = 0; column < columnCount; column++) {
                columnCenters[column] = cursor + columnWidths[column] / 2.0;
                cursor += columnWidths[column] + columnGap;
            }
            int height = metrics.getHeight();
            double step = height + 3.0;
            double centerY = row.get(0).getY();
            double top = centerY - (step * row.size()) / 2.0 + (step - height) / 2.0;
            double rowStep = height + 3.0;
            double totalHeight = rowCount * height + (rowCount - 1) * (rowStep - height);
            double top = row.get(0).getY() - totalHeight / 2.0;
            for (int i = 0; i < row.size(); i++) {
                HorizontalStackCallout item = row.get(i);
                int column = columnCount == 1 ? 0 : i % columnCount;
                int rowIndex = columnCount == 1 ? i : i / columnCount;
                int itemsInRow = Math.min(columnCount, row.size() - rowIndex * columnCount);
                int width = metrics.stringWidth(item.getText());
                double x = columnX;
                double y = top + i * step;
                graphics.setColor(item.getColor());
                graphics.setStroke(new BasicStroke(1.4f, BasicStroke.CAP_ROUND,
                        BasicStroke.JOIN_ROUND));
                graphics.drawLine((int) Math.round(item.getEndX()), (int) Math.round(item.getY()),
                        (int) Math.round(x - 3.0), (int) Math.round(y + height / 2.0));
                double centerX = itemsInRow == 1 && columnCount > 1
                        ? blockLeft + blockWidth / 2.0
                        : columnCenters[column];
                double x = centerX - width / 2.0;
                double y = top + rowIndex * rowStep;
                drawLabelWithHalo(graphics, item.getText(),
                        new Rectangle2D.Double(x, y, width, height), metrics, item.getColor());
                occupied.add(new Rectangle2D.Double(x - 2.0, y - 2.0,
                        width + 4.0, height + 4.0));
            }

        }
    }

@@ -796,14 +844,16 @@
    }

    private static class HorizontalStackCallout {
        private final int seriesIndex;
        private final double startX;
        private final double endX;
        private final double y;
        private final String text;
        private final Color color;

        private HorizontalStackCallout(double startX, double endX, double y,
        private HorizontalStackCallout(int seriesIndex, double startX, double endX, double y,
                                       String text, Color color) {
            this.seriesIndex = seriesIndex;
            this.startX = startX;
            this.endX = endX;
            this.y = y;
@@ -811,6 +861,7 @@
            this.color = color;
        }

        private int getSeriesIndex() { return seriesIndex; }
        private double getStartX() { return startX; }
        private double getEndX() { return endX; }
        private double getY() { return y; }