HANDOFF.md
@@ -4,6 +4,19 @@
> **每天结束时**:把当天进展、踩过的坑、新需求、未完成事项更新到本文件,然后可以放心开新对话。
> **协作约定(2026-08-31)**:说「提交」= 本地 commit + 推送到远端 git(origin main,Gitblit),不再只做本地 commit。
## 最新(2026-09-23)
- **已同步**:本地 `main` 快进合并公司 `origin/main` 最新 `8b739ce`(同事 09-22 关机快照统一版),合并后 `HEAD = 8b739ce = origin/main`,工作区干净。
- **本次新增交接文档**:`docs/交接文档_2026-09-23.md`(09-23 增量:现状快照 + 腾讯文档读取调研 + 当前待办 + 文件索引)。系统全景与 P0/P1/P2 全量遗留仍以 `docs/交接文档_2026-09-21.md` 为准。
- **今日工作**:腾讯文档读取调研 + 潜江物流投资月报重导修正;无业务代码改动(见 `docs/工作日结/工作日结_2026-09-23.md`)。
- **潜江重导(已完成)**:潜江物流 2026-06/07/08 在应用实际库 `3305` 均改为“中国虾谷冷链仓储物流园” `11947.9 / 0 / 1135 / 0`;重复重导保持每月 1 条、无重名项目,2026-08 导出端到端核对通过。09-22 报告记录的验证库是 `3308`,与当前应用连接库不一致,故当前库 08 月旧值本次一并修正。报告 `docs/功能测试报告/功能测试报告_潜江投资物流月报重导_2026-09-23.md`。
- **腾讯文档读取调研(新结论)**:
  1. 只读分享链接(《2026年十一数据》,10 页签)**能读显示值** —— 浏览器「打印 → 整个工作簿 → 打印预览」渲染成 SVG 段,读 `<text>` 即得数值/日期/百分比/`#DIV/0!`;但读不到公式、隐藏行列、打印范围外内容,且不易恢复精确 A1 坐标。
  2. **trafficAudit 目前不支持**在线文档导入,只走本地文件上传(`DataImport.vue:57/502` → `DataImportController.java:33` → Apache POI)。
  3. **腾讯官方 Open API V3 可行**:`GET /openapi/spreadsheet/v3/files/{fileId}/{sheetId}/{range}`(A1 范围,返回 `cellValue`),但需 OAuth 2.0 + 应用凭证 + `scope.sheet(.readonly)`;仅凭分享链接不能匿名调用。落产品建议走官方 API,不用打印预览。详见 `docs/交接文档_2026-09-23.md` §3。
- **运行状态(09-23 08:50 续接实测)**:dev 后端 `8090`、前端 `8080` 已启动并就绪,应用数据库 `localhost:3305/traffic_audit`。启动命令:`powershell -NoProfile -ExecutionPolicy Bypass -File start-dev.ps1`(沙箱外)。
- **接手优先(更新)**:投资明细表 L/D/E/F 覆盖口径、武汉物流/黄冈客运 8 月源数据、未覆盖清单落文件;汇总大表 304 格「2025 累计列」;P0-2 亿元表按 Q7 追列、P0-3 导出前基数体检、P0-4 2026-09 母版。
## 最新(2026-09-22)
- **已同步**:本地 `main` 已合并公司 `origin/main` 最新 `db0ee92`(含投资明细取数/导入修复);合并后 `mvn -q -DskipTests compile` 通过。