| | |
| | | > **每天结束时**:把当天进展、踩过的坑、新需求、未完成事项更新到本文件,然后可以放心开新对话。 |
| | | > **协作约定(2026-08-31)**:说「提交」= 本地 commit + 推送到远端 git(origin main,Gitblit),不再只做本地 commit。 |
| | | |
| | | ## 最新(2026-10-02) |
| | | |
| | | - **新模块(用户已验收,本次提交/推送)**:新增“专项统计-重要节假日”模块,含节假日配置、营业性客流、非营业性车流、客运系数 4 张表;系统配置菜单仅 admin 可维护,专项统计-节假日支持导入、导出、模板下载和 Word 快报下载。 |
| | | - **数据初始化**:从 `docs/专项统计/重要节假日/2026年十一数据.xlsx` 初始化 2024/2025 年十一客流、车流和 2024-2026 年客运系数;源表 90 个数据单元格入库逐项比对差异 0。 |
| | | - **日常导入口径**:只读取所选年份的当年列(2026 年为各客流工作表 C 列、普通国省道 D 列);历史年份不要求日常重导。 |
| | | - **历史数据保护**:导入时先检查更早历史日期是否被修改。有变化则先不写库,返回差异清单,前端弹窗让用户选择“允许导入/不允许”;确认后才覆盖。接口参数 `allowHistoricalOverwrite=true`。 |
| | | - **快报**:默认下载系统日期前一天的《湖北省国庆假期综合运输客流快报(10月X日).docx》,用户可自选日期;环比/同比按增长、下降、持平输出。 |
| | | - **Excel 浮点精度(2026-10-02 追加)**:参考 `docs/Excel浮点数存储.txt`,新增 `HolidayNumberUtils`(`NumberToTextConverter.toText` + `BigDecimal`,`MathContext(15, HALF_UP)`);节假日模块由 `Double` 全面改 `BigDecimal`;三张表数值列改 `DECIMAL(30,15)`;库内 6 条客运系数由 2.3999999999999995 校正为 2.4。迁移脚本 `docs/sql_holiday_decimal_migration.sql`。 |
| | | - **菜单顺序**:“专项统计”已移到“报表生成”之后,当前为 报表生成 -> 专项统计 -> 规则管理 -> 用户管理 -> 系统配置。 |
| | | - **节假日删除复活修复(2026-10-02 追加)**:原初始化逻辑每次启动补齐缺失的第 N 日,导致 admin 删除 2026-10-08 后被重新插入;现改为仅 `holiday_calendar` 整表为空时首次初始化。重启后 2026 年十一保持 10-01 至 10-07 共 7 天。 |
| | | - **普通国省道环比基期(2026-10-02 追加)**:普通国省道 C 列为可选环比基期,仅 2026 年启用;填写后只影响普通国省道车流量自身环比 `当日 / 基期 - 1`,未填写按前一日。`holiday_vehicle_flow.comparison_base` 已入库,导入导出与历史变更确认均已接入;折算人员流动量、总人员流动量和 Word 快报继续按 Excel 原公式,不受基期影响。2024/2025 不使用。 |
| | | - **快报首日口径(2026-10-02 追加)**:假期第1天没有前一日环比基数,正文不输出“环比增长/下降/持平”短语,表格当日环比列为“—”;第2天起仍按实际前一日输出环比。已用 2025-10-01/02 快报回归验证。 |
| | | - **快报百分比精度(2026-10-02 追加)**:Word 快报中同比/环比百分比统一保留1位小数(如6.79%显示6.8%、11.46%显示11.5%);人次、车流等业务数值仍保留2位小数。 |
| | | - **验证结果**:后端编译、前端构建、权限/CRUD/负向导入、历史变更两阶段导入、Excel 导出、Word 快报、前端 admin/非 admin 烟测均通过;菜单顺序、客运系数 2.4 展示(系统配置页 + 节假日统计页)、`decimal(30,15)` 列型、历史变更两阶段导入回归均已实测;功能测试报告与工作日结按 2026-09-27 提交规范仅本地留存(不入库):`docs/功能测试报告/功能测试报告_重要节假日专项统计_2026-10-02.md`、`docs/工作日结/工作日结_2026-10-02.md`。 |
| | | - **运行状态**:后端 8090、前端 8080 已启动;数据库 `127.0.0.1:3305/traffic_audit`。测试产生的 2026 临时数据和导入批次已清理。 |
| | | - **Git**:用户已于 2026-10-02 明确验收通过;本次按要求合并远端 `origin/main` 后提交并推送,不覆盖远端同事提交。 |
| | | - **部署模板同步**:节假日 4 张表已同步到 `deploy-templates/db/init.sql`;`sql_holiday.sql` 及两个旧库迁移脚本随部署包发布,避免新包缺表。 |
| | | |
| | | ## 最新(2026-09-28) |
| | | |
| | | - **用户用 WPS 编辑母版**:改《班线包车》边框、《道路运输周转量》字号,并删除《中口径明细》`AW` 列(手工定稿同删)。已验证生成端正常:中口径明细 2024 及更早块整体左移(跨页/同页公式自动改引用,`#REF!` 2→0)、中口径排名块 J..R → A..I 均正确带入产物。 |
| | |
| | | - **验证**:生成两次(约 15 秒/次),第二次相对第一次**仅 78 格 0→空**,错误值数量不变;`公交!S5=98460.97` 等缓存值抽查保留。 |
| | | - **运行状态**:后端已按 `start-dev.ps1` 重启(新 PID,8090/8080 在跑);本机库仍为 `localhost:3308/traffic_audit`。 |
| | | - **✅ 班线包车回补完成(09-28 下午)**:用户确认后按 09-27 母版备份(`_bak_202608母版文本数字转数值前_20260927.xlsx`)XML 精准回补《班线包车》2019/2020 块 —— **该页与 09-27 母版逐格一致(0 差异)**,错误值回到 `#REF!` 8 / `#DIV/0!` 228;母版其它页未受影响。验收生成:与 09-27 生成件 (6) 比对错误值逐页一致,差异仅剩既定改动(` 货运` 78 格清 0、中口径明细 4915 格删列位移、中口径排名 672 格块位移、班线包车 82 格浮点尾差/0-空)。 |
| | | - **新增差异清单工具(09-28)**:`docs/工具/汇总大表差异比对.py`(逐页按行标签/列表头序列对齐,可处理多列/多行/重复表头),产物 `docs/问题汇总/汇总大表_差异明细_2026-08_20260928.md` + `.csv`(1401 条明细,按 实质数值差异|仅手工有|仅程序有|取整尾差|文本型数字|文本不同|错误值 分类)。 |
| | | - 结论:` 货运` 实质数值差异 **10 条**(2022 年各市州累计同比,业务已确认软件对);`公交/城市客运/中口径明细/中口径客运量` 的"仅手工有"即手工侧**草稿列**(72/36/90/180 格);`公交/轨道轮渡` 的"文本型数字"= 值相同仅类型不同;`货运量排名/货运周转量排名/班线包车` 的差异含**行块错位假差异**(已在该清单"阅读提示"中标注,需按行标签核对)。 |
| | | - 更正:09-28 上午一度认为"2020 累计/累计同比"有差异,实为对齐脚本误配列所致——按位置逐格核对两边一致,未做改动。 |
| | | - **差异清单已实跑(09-28 晚)**:按当前母版重新生成 2026-08(生成件存 `docs/生成汇总大表/输出/_复核生成_2026-08_20260928.xlsx`,该目录被忽略不入库),产出两份清单: |
| | | - `docs/问题汇总/汇总大表_差异明细_2026-08_20260928.md/.csv`(母版最新生成件 vs 手工定稿,1401 条) |
| | | - `docs/问题汇总/汇总大表_差异明细_2026-08_20260928_桌面导出版.md/.csv`(桌面导出版 vs 手工定稿,1333 条;该份导出较早、` 货运` 单边格少 74 格,复核以母版最新生成件为准) |
| | | - **差异清单口径更新(09-28,用户确认)**:① ` 货运` 新增的「规上+规下货运量」「规下货运量」各 17 行(母版设计,共 34 行)不计差异;② ` 货运!U5:U112` 无表头草稿列不计;③ 排名表「当月块」为母版设计不计;④ 市州短名/全名不影响(工具归一化);⑤ 小差异(取整尾差/文本型数字)只计数,只列差异大的并附原因。工具 `docs/工具/汇总大表差异比对.py` 已按此更新,两份清单已重生成。 |
| | | - **新发现(待核对)**:`班线包车!EO36/FN36/FO36`(荆门 客运量 2020 累计/累计同比)**程序生成时重算为 -2731.41 / -1.0008 / -1.0002**,而母版与手工定稿均为 0.181777 / 2312.2199 / -0.586419 → 疑母版 2020 年块分母为 0,需核对公式与数据。 |
| | | - **汇总大表差异比对(09-28,工具已固化口径)**:`docs/工具/汇总大表差异比对.py`(逐页按行/列标签序列对齐,可处理多列/多行/重复表头)。**清单属过程产物只留本地**(`docs/问题汇总/_清单_*.md/.csv`,已 gitignore 不入库)。 |
| | | - 已确认口径(不再重复确认/上报):① 货运每市州 6 行 vs 手工 4 行(新增「规上+规下货运量」「规下货运量」各 17 行)属母版设计,行号偏移按"地区+指标"对齐后一致;② ` 货运` U 列(U2:U118)为人工草稿;③ 仅手工有且**无表头**的列 = 草稿;④ 浮点尾差、文本型数字忽略;⑤ 排名表「当月块」为母版设计;⑥ 市州短名/全名不影响。 |
| | | - **需处理(数值)**:`班线包车!EO36/FN36/FO36`(荆门 客运量 2020 累计/累计同比)——程序生成时重算为 -2731.41 / -1.0008 / -1.0002,母版与手工定稿均为 0.181777 / 2312.2199 / -0.586419(疑母版 2020 年块分母为 0),待核对;` 货运` 2022 年各市州「累计同比」10 条(业务已确认**软件对**,不改)。 |
| | | - 其余待办:手工侧 4 处脏数据(`班线包车!IL4/IL5` 断链、`IL50` 反引号、` 货运!EA93/EA111` 的 `#DIV/0!`)、286 格文本型数字、304 格草稿列;母版 11 个 `#REF!` + 356 个 `#DIV/0!`;`城市客运` 第 2 行第 3 个月起表头为日期序列号;缺 2026-09 母版;导出前基数体检(P0-3)。 |
| | | - **09-28 收尾:`班线包车` 3 格重算问题已修**:`EO36`/`FN36`/`FO36` 在母版里改为**静态值**(0.181777001400256 / 2312.2199 / -0.586418964965219,与手工定稿一致),并把受影响的共享公式组孤儿子格(35 格)一并静态化(值零变化)。重新生成验证:生成件/母版/定稿三边一致,与上一版生成件仅 34 格为精度表示差异、无数值变化。 |
| | | - **当前"需处理"仅剩 16 条**(均属手工侧/业务已确认,非程序问题):` 货运` EA92~EA112 共 12 条(2022 各市州累计同比,2021 年基数口径不同,业务已确认软件对;含手工 `#DIV/0!` 2 条)、`班线包车` IL4/IL5(手工 `#REF!`)/IL50(手工反引号)3 条、`城市汇总!G20` 表头措辞 1 条。其余全部按口径忽略(草稿列/行号偏移/当月块/浮点尾差/文本型数字)。 |
| | | - **未清项(有意保留)**:母版 11 个 `#REF!` + 356 个 `#DIV/0!` 历史错误值未清——手工定稿同类约 15 + 358,单清一边会凭空多出单边差异;要清需两边一起。 |
| | | - **确认差异清单(本地)**:`docs/问题汇总/_已确认差异清单_2026-08_20260928.md`(不入库)。 |
| | | - **09-28 口径全部落地,差异清单"需处理"归零**: |
| | | - ① 按软件:手工定稿《 货运》EB64~EB78 等 12 格 2022 累计同比 + 《班线包车》IL4/IL5/IL50 已按软件值同步(备份 `2026年8月客运量、货运量定稿_同步软件前_20260928.xlsx`)。 |
| | | - ② 按手工统一措辞:母版《城市汇总!G20》改为手工写法"2025年1-12月全省累计完成城市客运量情况"(备份 `_bak_202608母版_0928措辞前.xlsx`)。 |
| | | - ③ 历史错误值留白:母版 363 格(`_bak_202608母版_0928留白前.xlsx`)、手工定稿 379 + 尾列 6 格(`..._留白尾列前_20260928.xlsx`)→ 两边现均为 0 个 `#REF!`/`#DIV/0!`。 |
| | | - 结果:按当前母版重新生成 2026-08 后,与手工定稿的**需处理差异 = 0**,其余全部落在"已忽略(约定差异)"。清单:`docs/问题汇总/_清单_母版最新生成件_20260928.md/.csv`(本地,不入库)。 |
| | | - 注意:桌面那份 `生成_道路运输量汇总表_2026-08.xlsx` 是旧导出(含旧错误值/旧基数),与更新后的定稿比对会显示较多差异,以"母版重新生成件"为准。 |
| | | - **无表头草稿列清单(9 处,共 539 格)**:`公交/出租/网约车!U`(各 72)、`城市客运!U`(36)、`班线包车!DU`(55,表头"1-3月累计")、`中口径明细!U`(90)、`中口径客运量!AB`(180)、` 货运!V` 与 ` 货运!AX`(各 74,用户所指 U 列在手工那份右移一列)。母版/生成件**已全部清空**,手工定稿仍保留 → 对比时归入「已知设计(无表头草稿列)」。其余"无表头列"是合并表头的正常列(` 货运!C…Q` 月份值列、各年块尾部累计/累计同比列、排名页 R 列等),两边都有、非草稿。明细见 `docs/问题汇总/_已确认差异清单_2026-08_20260928.md`。 |
| | | - **待办**:① 排名页结构(块顺序、标题措辞、市州名短名/全名、周转量排名多 7 行);② 排名页结构(块顺序、标题措辞、市州名短名/全名、周转量排名多 7 行);③ 缺 2026-09 母版、导出前基数体检(P0-3)。 |
| | | |
| | | ## 最新(2026-09-27) |