HANDOFF.md
@@ -4,7 +4,19 @@
> **每天结束时**:把当天进展、踩过的坑、新需求、未完成事项更新到本文件,然后可以放心开新对话。
> **协作约定(2026-08-31)**:说「提交」= 本地 commit + 推送到远端 git(origin main,Gitblit),不再只做本地 commit。
## 今日(2026-08-31,含 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/经济指标试算仅记录未实现。
## 历史(2026-08-31,含 08-28 起积累记录)
### 1. 登录验证码:测试阶段可跳过(已完成并验证)
- 后端新增 `app.captcha.required` 开关(缺省 `true`=启用);本机 application.yml 与 example 现为 `false`(测试阶段跳过,**正式发布前改回 `true`**)。