trafficAudit.git

			@@ -2,8 +2,27 @@

			> 用法：新对话开始后，先读本文件 + 项目根目录 `AGENTS.md`，即可无缝接力。
			> 每天结束时：把当天进展、踩过的坑、新需求、未完成事项更新到本文件，然后可以放心开新对话。
			> 协作约定（2026-08-31）：说「提交」= 本地 commit + 推送到远端 git（origin main，Gitblit），不再只做本地 commit。

			## 今日（2026-08-28）
			## 今日（2026-09-01，含 08-31 起积累记录）

			### 9. 2026-09-01：同事年报功能开发中 + 新版本打包发布（已发布到用户环境）
			- git 进展（今天 4 个新提交）：
			- `92528d9`（同事）：数据导入页模板名/下载路径对齐实际模板文件（.xls→.xlsx、补个体客运模板路径）
			- `b1be169`（我方）：2 个模板文件入库推送（docs/城市客运/导入模板_出租车信息(运政车辆信息).xlsx、docs/公路旅客/个体客运量汇总.xlsx；同事本地放好后我方核对后按惯例入库）
			- `053ebfe`（同事）：数据导入页分组改名（道路货运/站场投资/货运能耗季报）+ 新增「年报」分组 11 类选项
			- `0c16e56`（同事）：6 个年报模板入库（docs/年报/，.xls）
			- ⚠️ 年报功能只有 UI 壳，同事开发中，我方约定不动：前端 groups 有 11 个 annual* 选项，但 importApiMap 无 URL、后端 DataImportController 无 annual* 端点、templateName/templateUrl 无映射、模板只有 6/11 类 → 选了年报类型无法上传/下载。同事继续开发，后续拉取即可。
			- 打包发布（已完成，用户已发布到用户环境）：后端 mvn clean package（jar 57MB）+ 前端 npm run build（dist 38 文件）；部署到 D:\trafficAudit：app.jar 替换（旧包备份 app.jar.bak_20260901）、web/ 重建、docs 单向同步（新增 docs/年报 + 2 个新模板，保留 ai_demo/usage_screenshots）；本机启动验证 8090：Started TrafficAuditApplication、首页 200、/api/auth/captcha-config required=false，验证后已停。
			- 待办不变：正式发布前 app.captcha.required 改回 true；浏览器崩溃如在新包再现看 logs/access.*.log + 客户端 F12；态势图/AI RAG/经济指标试算仅记录未实现。

			### 10. 关机交接快照（09-01 晚）
			- 当前运行状态：dev 前后端未运行；D:\trafficAudit 的 app.jar（PID 28976，14:40 用户自己启动）在 8090 运行，关机自然停止、不需处理；MySQL80(3305)、MySQL57(3306) 均 Running，按惯例保留。
			- git：工作区干净，HEAD=`9b97b92`，已同步 origin/main。
			- 今日交付：拉取同事代码（92528d9/053ebfe/0c16e56）、模板入库（b1be169）、打包发布到 D:\trafficAudit 并本机验证通过（旧包备份 app.jar.bak_20260901），用户已发布到用户环境；版本号咨询已答复（SemVer，首次正式发布定 1.0.0）。
			- 待办（不变）：①正式发布前 app.captcha.required 改回 true；②浏览器崩溃如再现看 logs/access.*.log + 客户端 F12；③同事年报功能开发中（我方不动）；④态势图/AI RAG/经济指标试算仅记录未实现；⑤每日反思自动化未创建。

			## 历史（2026-08-31，含 08-28 起积累记录）

			### 1. 登录验证码：测试阶段可跳过（已完成并验证）
			- 后端新增 `app.captcha.required` 开关（缺省 `true`=启用）；本机 application.yml 与 example 现为 `false`（测试阶段跳过，正式发布前改回 `true`）。
			@@ -90,6 +109,30 @@
			h204_、investment_、city_bus_monthly、city_taxi_monthly、city_taxi_auth、passenger_individual_monthly、audit_run；
			sys_user 已加 modules 列；admin 密码已重置为 BCrypt（admin/admin123）。
			- 无已知阻塞性问题。

			### 6. 08-31：菜单高亮间歇性根因修复（实锤）+ 修改密码功能（已完成并验证）
			- 菜单高亮根因实锤：不是 el-tabs 遗留问题，而是 Element UI `el-menu` 的 `handleItemClick` 在同路由导航（vue-router NavigationDuplicated）时，`routeToItem` 的 onError 回调把 `activeIndex` 恢复为点击前旧值（其只排除了 push 抛异常路径，未排除同路由回调路径）。触发场景：上一次菜单导航未完成时快速点另一个菜单（如「数据导入」未切完就点「审核结果」）→ 页面已是目标页但高亮停留在旧菜单，间歇性、时好时坏（复现：puppeteer 快速连点，puppeteer 用 node24：`C:\Users\jcxiong\.cache\codex-runtimes\codex-primary-runtime\dependencies\node\bin\node.exe`）。
			- 修复：8 个页面 el-menu 统一改为 `ref="sideMenu"` + `:default-active="$route.path"` + `@select="onMenuSelect"`；`onMenuSelect` 加在 main.js 全局 mixin（setTimeout 宏任务强制纠正 activeIndex，宏任务晚于 push 的微任务 onError 回调，保证最终高亮正确）。验证：6 轮×3 场景（顺序点/快速连点/同路由往返）全部高亮正确。
			- 修改密码：后端 `POST /api/auth/change-password`（用户改自己密码，需旧密码校验、新密码≥6位、新旧不同）+ `POST /api/user/reset-password`（仅 admin，重置他人为 123456，admin 自身禁止重置）；JwtUtils 新增 `resolveUsername(Authorization头)`。前端 AppHeader 公共顶栏加「修改密码」弹窗（旧/新/确认），UserManage 操作列加「重置密码」按钮（`isAdmin` 控制显示，非 admin 隐藏+后端 403 双保险）。API 与 UI（admin/非admin 双视角）均已验证，测试后数据库密码已恢复原状（admin/admin123 有效，chenzj 等原 hash 未变）。
			- 测试脚本：`D:\Codex\_tools\pptr-core\menu_audit_rounds.js`（高亮回归）、`pwd_ui_test.js`（改密 UI）。

			### 7. 08-31 下班前：数据导入页重构（验收通过，commit 791e70f，已推送）
			- 需求（用户 4 轮提出，全部验收通过）：①「选择类型并挂载文件」→「选择数据类型」，删除报表期卡片说明文字；②删除「加入队列」、目录导入（粘贴路径「导入该目录」/「浏览…」/「跳过已导入文件」/目录进度列表）、目录浏览弹窗；③模板名+「下载模板」移到类型选择框旁并排（单行省略），删除各类型说明文字；④「导入记录」→「导入结果」：默认空白（「暂无导入失败记录」），仅失败批次平铺明细表（列：导入类型/报表期/文件名/失败位置/失败原因，「第 X 行（企业名）」来自后端 import_batch.error_detail，无需新接口）；⑤「本月导入进度」改为右侧抽屉式边栏（非卡片、左右收起/展开、默认收起；展开后内部滚动 overscroll-behavior: contain，不带动整页滚动）。
			- 实现：仅改 `traffic-audit-web/src/views/DataImport.vue`（累计 +119/-380）。前端 dev 编译 ✅ + puppeteer 双场景验证 ✅（真实无失败数据→空态；拦截 mock 失败数据→明细表渲染；侧栏 34px⇄342px 往返、5 组 18 项、内部滚动独立）。
			- 踩坑：①新方法 `parseFailDetails` 曾误加在 methods 对象外面（mounted 前），Vue 不识别 → 展开行渲染时抛 TypeError、el-table 展开行不渲染（现象像 Element UI expand 失效），报错是 [Vue warn] 只在 console 出现、pageerror 抓不到（puppeteer 须监听 console 事件）；移入 methods 后恢复。②puppeteer 验证 el-table 展开行不要用合成 click 点图标（时灵时不灵），直接拦截接口 mock 数据验证渲染更可靠。
			- 测试脚本：`D:\Codex\_tools\pptr-core\_tmp_import_ui_final.js`（mock 拦截验证）、`_tmp_import_ui_check.js`；项目根 `_tmp_patch.py`/`_tmp_probe.py`/`_tmp_fix*.py`（改造脚本，按约定未删）。

			### 8. 关机交接快照（08-31 晚更新，用户关机前）
			- 当前运行状态：dev 前后端均在运行——后端 8090（spring-boot:run，含今日改动）、前端 8080（vue-cli-service serve）。访问 http://localhost:8080，admin/admin123 登录正常。
			- 数据库：本机 MySQL 8.0.29（localhost:3305，traffic_audit）。4 个账号 admin/yangb/wangq/chenzj 密码哈希均未改动（admin 密码经今日改密测试后已恢复 admin123；chenzj 原哈希已恢复）。
			- git：工作区干净；远端 Gitblit origin main 已同步到 `791e70f`（数据导入页重构）。
			- 今日交付（验收通过）：①菜单高亮间歇性失效根因修复（el-menu 同路由导航回滚，见第 6 节）；②修改密码功能（用户自改 + admin 重置他人为 123456，见第 6 节）；③数据导入页重构（选择数据类型/模板并排/失败明细表格/进度抽屉侧栏，见第 7 节）。
			- 待办：
			1. 重新打包发布测试环境——`D:\trafficAudit` 的 app.jar/web 还是 08-27 旧包，不包含：el-tabs 修复（d42a044）、超时保护、菜单高亮修复（b051f00）、修改密码、验证码跳过、数据导入页重构（791e70f）。打包方法见 `docs/打包部署说明.md`（SpringBoot 托管 web/ + docs/，单端口 8090）。
			2. 正式发布前把 `app.captcha.required` 改回 `true`（现在 application.yml 为 false 测试跳过）。
			3. 浏览器崩溃问题若在新包上仍出现：看服务器 jar 同级 `logs/access.*.log`（%D 耗时）+ 客户端 F12 Network（chunk/batches 状态），此前 el-tabs 根因（684da41/d42a044）应已消除。
			4. 态势图构想 + AI 助手 RAG 需求仍只记录未实现（见文档归档），后续排期。
			- 测试脚本：`D:\Codex\_tools\pptr-core\` 下 `menu_audit_rounds.js`（菜单高亮回归）、`pwd_ui_test.js`（改密 UI）、`prod_server.js`（打包静态+代理 8091）。puppeteer 用 node24 跑：`C:\Users\jcxiong\.cache\codex-runtimes\codex-primary-runtime\dependencies\node\bin\node.exe`。

			## 二、快速启动
			统一用一键脚本（必须沙箱外/提权运行）：
			@@ -185,3 +228,6 @@
			sql 的规则 INSERT 改写为 INSERT IGNORE VALUES（兼容 MySQL 5.7/8.0，原派生表写法在 8.0.29 报 Unknown column t.rule_code）。
			⑥ 验证：后端 mvn compile ✅、前端 npm run build ✅。坑：链接工作区 .git 是文件，robocopy /MIR 会把它删掉导致"not a git
			repository"，需重建 gitdir 文件；PowerShell 的 -e "..." 字符串里 $ 会被当变量展开，写 SQL 密码哈希要用 SQL 文件。


			- 2026-08-31（下班前）：数据导入页重构验收通过（commit 791e70f 已推送，详见第 7 节）。改造全用 Python 替换写文件（apply_patch 本机必败）；关键坑：Vue 新方法误放 methods 外 → render TypeError、el-table 展开行不渲染，[Vue warn] 只在 console 不在 pageerror；验证用 puppeteer 拦截 /api/import/batches 返回 mock 失败数据直接验明细表，真实无失败数据验「暂无导入失败记录」空态。

			@@ -2,8 +2,27 @@

			> 用法：新对话开始后，先读本文件 + 项目根目录 `AGENTS.md`，即可无缝接力。
			> 每天结束时：把当天进展、踩过的坑、新需求、未完成事项更新到本文件，然后可以放心开新对话。
			> 协作约定（2026-08-31）：说「提交」= 本地 commit + 推送到远端 git（origin main，Gitblit），不再只做本地 commit。

			## 今日（2026-08-28）
			## 今日（2026-09-01，含 08-31 起积累记录）

			### 9. 2026-09-01：同事年报功能开发中 + 新版本打包发布（已发布到用户环境）
			- git 进展（今天 4 个新提交）：
			- `92528d9`（同事）：数据导入页模板名/下载路径对齐实际模板文件（.xls→.xlsx、补个体客运模板路径）
			- `b1be169`（我方）：2 个模板文件入库推送（docs/城市客运/导入模板_出租车信息(运政车辆信息).xlsx、docs/公路旅客/个体客运量汇总.xlsx；同事本地放好后我方核对后按惯例入库）
			- `053ebfe`（同事）：数据导入页分组改名（道路货运/站场投资/货运能耗季报）+ 新增「年报」分组 11 类选项
			- `0c16e56`（同事）：6 个年报模板入库（docs/年报/，.xls）
			- ⚠️ 年报功能只有 UI 壳，同事开发中，我方约定不动：前端 groups 有 11 个 annual* 选项，但 importApiMap 无 URL、后端 DataImportController 无 annual* 端点、templateName/templateUrl 无映射、模板只有 6/11 类 → 选了年报类型无法上传/下载。同事继续开发，后续拉取即可。
			- 打包发布（已完成，用户已发布到用户环境）：后端 mvn clean package（jar 57MB）+ 前端 npm run build（dist 38 文件）；部署到 D:\trafficAudit：app.jar 替换（旧包备份 app.jar.bak_20260901）、web/ 重建、docs 单向同步（新增 docs/年报 + 2 个新模板，保留 ai_demo/usage_screenshots）；本机启动验证 8090：Started TrafficAuditApplication、首页 200、/api/auth/captcha-config required=false，验证后已停。
			- 待办不变：正式发布前 app.captcha.required 改回 true；浏览器崩溃如在新包再现看 logs/access.*.log + 客户端 F12；态势图/AI RAG/经济指标试算仅记录未实现。

			### 10. 关机交接快照（09-01 晚）
			- 当前运行状态：dev 前后端未运行；D:\trafficAudit 的 app.jar（PID 28976，14:40 用户自己启动）在 8090 运行，关机自然停止、不需处理；MySQL80(3305)、MySQL57(3306) 均 Running，按惯例保留。
			- git：工作区干净，HEAD=`9b97b92`，已同步 origin/main。
			- 今日交付：拉取同事代码（92528d9/053ebfe/0c16e56）、模板入库（b1be169）、打包发布到 D:\trafficAudit 并本机验证通过（旧包备份 app.jar.bak_20260901），用户已发布到用户环境；版本号咨询已答复（SemVer，首次正式发布定 1.0.0）。
			- 待办（不变）：①正式发布前 app.captcha.required 改回 true；②浏览器崩溃如再现看 logs/access.*.log + 客户端 F12；③同事年报功能开发中（我方不动）；④态势图/AI RAG/经济指标试算仅记录未实现；⑤每日反思自动化未创建。

			## 历史（2026-08-31，含 08-28 起积累记录）

			### 1. 登录验证码：测试阶段可跳过（已完成并验证）
			- 后端新增 `app.captcha.required` 开关（缺省 `true`=启用）；本机 application.yml 与 example 现为 `false`（测试阶段跳过，正式发布前改回 `true`）。
			@@ -90,6 +109,30 @@
			h204_、investment_、city_bus_monthly、city_taxi_monthly、city_taxi_auth、passenger_individual_monthly、audit_run；
			sys_user 已加 modules 列；admin 密码已重置为 BCrypt（admin/admin123）。
			- 无已知阻塞性问题。

			### 6. 08-31：菜单高亮间歇性根因修复（实锤）+ 修改密码功能（已完成并验证）
			- 菜单高亮根因实锤：不是 el-tabs 遗留问题，而是 Element UI `el-menu` 的 `handleItemClick` 在同路由导航（vue-router NavigationDuplicated）时，`routeToItem` 的 onError 回调把 `activeIndex` 恢复为点击前旧值（其只排除了 push 抛异常路径，未排除同路由回调路径）。触发场景：上一次菜单导航未完成时快速点另一个菜单（如「数据导入」未切完就点「审核结果」）→ 页面已是目标页但高亮停留在旧菜单，间歇性、时好时坏（复现：puppeteer 快速连点，puppeteer 用 node24：`C:\Users\jcxiong\.cache\codex-runtimes\codex-primary-runtime\dependencies\node\bin\node.exe`）。
			- 修复：8 个页面 el-menu 统一改为 `ref="sideMenu"` + `:default-active="$route.path"` + `@select="onMenuSelect"`；`onMenuSelect` 加在 main.js 全局 mixin（setTimeout 宏任务强制纠正 activeIndex，宏任务晚于 push 的微任务 onError 回调，保证最终高亮正确）。验证：6 轮×3 场景（顺序点/快速连点/同路由往返）全部高亮正确。
			- 修改密码：后端 `POST /api/auth/change-password`（用户改自己密码，需旧密码校验、新密码≥6位、新旧不同）+ `POST /api/user/reset-password`（仅 admin，重置他人为 123456，admin 自身禁止重置）；JwtUtils 新增 `resolveUsername(Authorization头)`。前端 AppHeader 公共顶栏加「修改密码」弹窗（旧/新/确认），UserManage 操作列加「重置密码」按钮（`isAdmin` 控制显示，非 admin 隐藏+后端 403 双保险）。API 与 UI（admin/非admin 双视角）均已验证，测试后数据库密码已恢复原状（admin/admin123 有效，chenzj 等原 hash 未变）。
			- 测试脚本：`D:\Codex\_tools\pptr-core\menu_audit_rounds.js`（高亮回归）、`pwd_ui_test.js`（改密 UI）。

			### 7. 08-31 下班前：数据导入页重构（验收通过，commit 791e70f，已推送）
			- 需求（用户 4 轮提出，全部验收通过）：①「选择类型并挂载文件」→「选择数据类型」，删除报表期卡片说明文字；②删除「加入队列」、目录导入（粘贴路径「导入该目录」/「浏览…」/「跳过已导入文件」/目录进度列表）、目录浏览弹窗；③模板名+「下载模板」移到类型选择框旁并排（单行省略），删除各类型说明文字；④「导入记录」→「导入结果」：默认空白（「暂无导入失败记录」），仅失败批次平铺明细表（列：导入类型/报表期/文件名/失败位置/失败原因，「第 X 行（企业名）」来自后端 import_batch.error_detail，无需新接口）；⑤「本月导入进度」改为右侧抽屉式边栏（非卡片、左右收起/展开、默认收起；展开后内部滚动 overscroll-behavior: contain，不带动整页滚动）。
			- 实现：仅改 `traffic-audit-web/src/views/DataImport.vue`（累计 +119/-380）。前端 dev 编译 ✅ + puppeteer 双场景验证 ✅（真实无失败数据→空态；拦截 mock 失败数据→明细表渲染；侧栏 34px⇄342px 往返、5 组 18 项、内部滚动独立）。
			- 踩坑：①新方法 `parseFailDetails` 曾误加在 methods 对象外面（mounted 前），Vue 不识别 → 展开行渲染时抛 TypeError、el-table 展开行不渲染（现象像 Element UI expand 失效），报错是 [Vue warn] 只在 console 出现、pageerror 抓不到（puppeteer 须监听 console 事件）；移入 methods 后恢复。②puppeteer 验证 el-table 展开行不要用合成 click 点图标（时灵时不灵），直接拦截接口 mock 数据验证渲染更可靠。
			- 测试脚本：`D:\Codex\_tools\pptr-core\_tmp_import_ui_final.js`（mock 拦截验证）、`_tmp_import_ui_check.js`；项目根 `_tmp_patch.py`/`_tmp_probe.py`/`_tmp_fix*.py`（改造脚本，按约定未删）。

			### 8. 关机交接快照（08-31 晚更新，用户关机前）
			- 当前运行状态：dev 前后端均在运行——后端 8090（spring-boot:run，含今日改动）、前端 8080（vue-cli-service serve）。访问 http://localhost:8080，admin/admin123 登录正常。
			- 数据库：本机 MySQL 8.0.29（localhost:3305，traffic_audit）。4 个账号 admin/yangb/wangq/chenzj 密码哈希均未改动（admin 密码经今日改密测试后已恢复 admin123；chenzj 原哈希已恢复）。
			- git：工作区干净；远端 Gitblit origin main 已同步到 `791e70f`（数据导入页重构）。
			- 今日交付（验收通过）：①菜单高亮间歇性失效根因修复（el-menu 同路由导航回滚，见第 6 节）；②修改密码功能（用户自改 + admin 重置他人为 123456，见第 6 节）；③数据导入页重构（选择数据类型/模板并排/失败明细表格/进度抽屉侧栏，见第 7 节）。
			- 待办：
			1. 重新打包发布测试环境——`D:\trafficAudit` 的 app.jar/web 还是 08-27 旧包，不包含：el-tabs 修复（d42a044）、超时保护、菜单高亮修复（b051f00）、修改密码、验证码跳过、数据导入页重构（791e70f）。打包方法见 `docs/打包部署说明.md`（SpringBoot 托管 web/ + docs/，单端口 8090）。
			2. 正式发布前把 `app.captcha.required` 改回 `true`（现在 application.yml 为 false 测试跳过）。
			3. 浏览器崩溃问题若在新包上仍出现：看服务器 jar 同级 `logs/access.*.log`（%D 耗时）+ 客户端 F12 Network（chunk/batches 状态），此前 el-tabs 根因（684da41/d42a044）应已消除。
			4. 态势图构想 + AI 助手 RAG 需求仍只记录未实现（见文档归档），后续排期。
			- 测试脚本：`D:\Codex\_tools\pptr-core\` 下 `menu_audit_rounds.js`（菜单高亮回归）、`pwd_ui_test.js`（改密 UI）、`prod_server.js`（打包静态+代理 8091）。puppeteer 用 node24 跑：`C:\Users\jcxiong\.cache\codex-runtimes\codex-primary-runtime\dependencies\node\bin\node.exe`。

			## 二、快速启动
			统一用一键脚本（必须沙箱外/提权运行）：
			@@ -185,3 +228,6 @@
			sql 的规则 INSERT 改写为 INSERT IGNORE VALUES（兼容 MySQL 5.7/8.0，原派生表写法在 8.0.29 报 Unknown column t.rule_code）。
			⑥ 验证：后端 mvn compile ✅、前端 npm run build ✅。坑：链接工作区 .git 是文件，robocopy /MIR 会把它删掉导致"not a git
			repository"，需重建 gitdir 文件；PowerShell 的 -e "..." 字符串里 $ 会被当变量展开，写 SQL 密码哈希要用 SQL 文件。


			- 2026-08-31（下班前）：数据导入页重构验收通过（commit 791e70f 已推送，详见第 7 节）。改造全用 Python 替换写文件（apply_patch 本机必败）；关键坑：Vue 新方法误放 methods 外 → render TypeError、el-table 展开行不渲染，[Vue warn] 只在 console 不在 pageerror；验证用 puppeteer 拦截 /api/import/batches 返回 mock 失败数据直接验明细表，真实无失败数据验「暂无导入失败记录」空态。