| | |
|---|
| | | > **用法**：新对话开始后，先读本文件 + 项目根目录 `AGENTS.md`，即可无缝接力。 |
|---|
| | | > **每天结束时**：把当天进展、踩过的坑、新需求、未完成事项更新到本文件，然后可以放心开新对话。 |
|---|
| | | |
|---|
| | | ## 一、当前状态（2026-08-23） |
|---|
| | | - 前后端**均未运行**（8080/8090 连接被拒），需要先启动（见下）。 |
|---|
| | | - 最近代码改动截至 08-07；08-14 起代码已入库 Gitee 私有仓库（见第九节），main 分支工作区干净、已推送。 |
|---|
| | | ## 〇、关机交接（2026-08-27 深夜，用户关机前） |
|---|
| | | - **当前运行状态**：前后端应用服务全部已停止（开发服务、打包版均未运行）；仅数据库在跑 |
|---|
| | | （MySQL80 服务=3305，本项目用；MySQL57=3306 勿动）；8080 上 IIS 站点仍在但本项目已不再依赖 IIS。 |
|---|
| | | - **进行中/待验证（用户负责）**：用户在**打包环境**验证数据库合并结果——用 `admin/admin123` 登录 |
|---|
| | | （行为验证码需人工点击，无法自动化验证）；若登录及各业务模块数据正常，则全流程闭环。 |
|---|
| | | - **部署知识（本轮确认）**：外置 `application.yml` 与 jar 内置是**属性级合并**（外置只需写要覆盖的项，其余自动沿用内置）， |
|---|
| | | 不是文件级替换；Spring Boot 按**启动工作目录**找配置（`file:./config/` > `classpath:/config/` > `file:./` > `classpath:/`）， |
|---|
| | | 在 jar 同级执行 `java -jar app.jar` 即可命中外部配置；推荐放 `config\` 子目录。 |
|---|
| | | - **待办（下次）**：`docs/打包部署说明.docx` 第六节"外置 application.yml 需包含完整配置"表述不准确， |
|---|
| | | 应改为"属性级合并，只需写要覆盖的项"；改后重新导出 docx 并推送。 |
|---|
| | | |
|---|
| | | ## 一、当前状态（2026-08-27 合并后，打包部署已完成） |
|---|
| | | - **开发服务已停止**（前后端均未运行），打包版测试**验收通过**。 |
|---|
| | | - **打包部署方案（已定稿）**：Spring Boot 直接托管前端静态文件，单端口 8090，**不需要 IIS/nginx**。 |
|---|
| | | 部署结构 = jar 同级 `web\`（前端 dist 内容）+ `docs\`（模板目录）；`java -jar app.jar` 启动后访问 `http://<服务器>:8090`。 |
|---|
| | | 说明文档：`docs/打包部署说明.md` / `.docx`（含 nginx 备选方案、IIS 反代示例 `docs/iis-web.config.example`）。 |
|---|
| | | - **数据库已合并（2026-08-27 晚）**：同事 Navicat 全表导出 `traffic_audit.sql`（27 表、约 6 万行，来自其 mysql80:3308）已全量导入本机库（MySQL 8.0.29，localhost:3305，root/root）。 |
|---|
| | | 导入前已备份本机库 → `D:\03_公司\02_项目\27_湖北省道路运输事业发展中心\05_开发测试\00_开发\_db_backup_20260827.sql`。 |
|---|
| | | `sys_user` 现有 4 账号（admin + zhangsan/lisi/wangwu，均带 modules）；admin 密码已恢复为 BCrypt（admin/admin123），其余账号密码为同事原 hash。 |
|---|
| | | ⚠️ **MySQL 客户端用 8.0**（`C:\Program Files\MySQL\MySQL Server 8.0\bin\mysql.exe`），不要用 5.7 客户端（`D:\mysql\mysql-5.7.41-winx64`）。 |
|---|
| | | - 本次配套改动：`SecurityConfig` 放行静态资源（`/`、`/js/**` 等）+ `application.yml` 加 |
|---|
| | | `spring.web.resources.static-locations: file:./web/`（application.yml 不入库，重打包时需保留该配置）。 |
|---|
| | | - **2026-08-27 完成双方开发结果合并**：以对方（郑玉洁，另一开发人员）的代码为基础，并入我方三样改动 |
|---|
| | | （态势图/AI助手构想记录、登录行为验证码、登出与上下布局）。验证码采用**我方实现**（Captcha3D + 后端 captcha 包， |
|---|
| | | 内存存储，无 Redis 依赖），对方独立实现的 ShapeCaptcha（Canvas+Redis）已弃用、不入库。 |
|---|
| | | - 新 git 仓库迁移**已完成**：合并结果已提交到 Gitblit 根仓库 `trafficAudit.git`（见第九节），旧 Gitee 仓库弃用；`~xyc/trafficAudit.git` 临时仓库已删。 |
|---|
| | | - 数据库已补齐对方新增表（MySQL 8，库 traffic_audit，本机 3305）：h2031_enterprise_monthly、passenger_*、 |
|---|
| | | h204_*、investment_*、city_bus_monthly、city_taxi_monthly、city_taxi_auth、passenger_individual_monthly、audit_run； |
|---|
| | | sys_user 已加 modules 列；admin 密码已重置为 BCrypt（admin/admin123）。 |
|---|
| | | - 无已知阻塞性问题。 |
|---|
| | | |
|---|
| | | ## 二、快速启动 |
|---|
| | |
|---|
| | | - 后端：Spring Boot 2.x + MyBatis Plus + EasyExcel，`traffic-audit-server`，端口 8090。 |
|---|
| | | - 数据库：MySQL（本机 3305 端口，库名 `traffic_audit`；账号密码见 `traffic-audit-server/src/main/resources/application.yml`）。 |
|---|
| | | - LLM：DeepSeek API（`deepseek-chat`，配置同样在 application.yml；注意不要把 API Key 写进任何文档）。 |
|---|
| | | - 核心模块：数据导入（5类）、审核引擎（规则驱动）、AI 分析（脱敏+查库+解释生成）、报表生成（3类）、用户权限（三员分离）。 |
|---|
| | | - 核心模块：数据导入（货运/旅客/城市客运/投资/能耗多类）、审核引擎（规则驱动）、AI 分析（脱敏+查库+解释生成）、 |
|---|
| | | 报表生成（货运/旅客/城市客运/投资/能耗 Tab 工作台）、用户权限（三员分离）、操作日志。 |
|---|
| | | - 对方（郑玉洁）08-26/08-27 的完整开发记录见 `docs/同事开发记录-20260827.md`（含报表 Tab 工作台、目录导入、 |
|---|
| | | 解释按需展开、动态报表标题、城市客运/公路旅客/投资/能耗模块等细节与踩坑）。 |
|---|
| | | |
|---|
| | | ## 四、已完成功能（截至 08-07） |
|---|
| | | - 数据导入：H203-2月报、运政车辆、轨迹里程、规上规下拆分、货运量周转量；导入失败显示行号。 |
|---|
| | |
|---|
| | | - 每日反思自动化尚未创建（提示词已备好，见 `docs/每日反思任务.md`；需要 automation 工具可用的会话）。 |
|---|
| | | - 官方 Codex 手册本机访问 403，`docs/Codex功能清单.md` 待网络恢复后补官方核实版。 |
|---|
| | | - 后续扩展：H203-1 公路旅客、W203 水路、P203 港口、H204 能源等（需求文档 v2/v3 计划），先把 H203-2 演示做好。 |
|---|
| | | - 【新需求·仅记录未实现·2026-08-23】登录后首页新增「全省交通运输态势感知图」：把货运、客运、巡游出租、网约车、投资、能耗等方面的变化态势可视化展示。 |
|---|
| | | - 【新需求·仅记录未实现·2026-08-23】扩展现有 AI 分析为「AI 助手」：以本地数据库数据为基础建立知识库，做 RAG，支持自然语言提问/聊天，灵活查看与挖掘数据。 |
|---|
| | | - **2026-08-28 复核「点数据导入浏览器崩溃」（打包测试环境，部分用户）**：重点排查 `GET /api/import/batches`——后端 limit 上限 200；全表 81 条、error_detail 最长 2.6KB、全量响应约 17KB（前端只取 50 条）；前端表格仅 8 列短字段（errorDetail 不渲染）、无轮询/定时器。**结论：接口不是崩溃根因**（若接口有问题，所有用户都会崩，而非"部分用户"）。现象符合客户端环境差异（第三方扩展注入/旧显卡驱动/低配内存，与 08-27 迅雷扩展+Intel 旧驱动结论一致）。建议对崩溃用户依次验证：无痕模式→换 Edge→禁扩展，并看 chrome://crashes。 |
|---|
| | | - 【新需求·仅记录未实现·2026-08-28】增加**经济指标试算功能**：领导非常关注经济指标，**货运是大头**；常驻现场的所有人都要会计算货运相关数据（货运量/周转量等）。领导经常要求把某个数据「压一压」，今后考虑在软件里增加试算功能——可按需要调整/测算指标数值（如模拟下调某企业/某口径的货运量后看汇总与趋势影响），辅助现场人员快速试算与应对。 |
|---|
| | | |
|---|
| | | ## 八、每日交接约定 |
|---|
| | | 1. 新对话第一步：读 `AGENTS.md` + `HANDOFF.md`；涉及 AI 分析/审核时参考 `docs/` 与数据库表结构。 |
|---|
| | | 2. 每天结束时：更新 `HANDOFF.md`（进展、坑、新需求、待办），再关对话。 |
|---|
| | | 3. 跨项目可复用经验沉淀到机器级顶层 AGENTS.md（本项目不再重复）。 |
|---|
| | | ## 九、Git 仓库（2026-08-14 建立） |
|---|
| | | - 远程：Gitee **私有**仓库 https://gitee.com/jichengxiong/trafficAudit ，分支 `main`（提交身份 xyc <jc_xiong@hotmail.com>）。 |
|---|
| | | ## 九、Git 仓库（2026-08-27 起使用新仓库 Gitblit） |
|---|
| | | - **新仓库（在用）**：Gitblit 服务器 `61.183.254.94:3000`（HTTP），仓库 **`trafficAudit.git`**（根目录命名空间，非 `~xyc/` 个人空间）。 |
|---|
| | | - 推送地址：`http://xyc@61.183.254.94:3000/r/trafficAudit.git`（账号 `xyc` 密码 `gitP@ssw0rd`，已存本机 GCM 凭据管理器，直接 `git push` 即可）。 |
|---|
| | | - 说明：管理员已在 Gitblit Web（http://61.183.254.94:3000）给 `xyc` 授权该仓库推送（RW+），2026-08-27 已验证 `xyc` 推送成功；日常推送用 `xyc`。 |
|---|
| | | - 旧的 `~xyc/trafficAudit.git` 个人仓库已删除（2026-08-27，admin 在 Web 编辑页删除）。 |
|---|
| | | - 本机 remote：仅 `origin` = `http://xyc@61.183.254.94:3000/r/trafficAudit.git`（不用 SSH，ssh-alt 已删）。 |
|---|
| | | - **旧仓库（弃用）**：Gitee https://gitee.com/jichengxiong/trafficAudit（2026-08-14 建立）——不再使用，未再推送。 |
|---|
| | | - 合并历史：main 分支 = 原历史 + 我方 08-27 提交（`715e9e1`）+ 对方开发结果分支（`f713166`，partner-work）+ 合并提交 `ec9b25a`；对方未用 git，其代码经独立分支合入。 |
|---|
| | | - 敏感配置不入库：`traffic-audit-server/src/main/resources/application.yml` 已在 `.gitignore` 中， |
|---|
| | | 仓库内只提交占位符模板 `application.yml.example`（`${DEEPSEEK_API_KEY}` 等）。新环境：复制模板为 application.yml 并填真实值。 |
|---|
| | | - 日常流程：`git add -A` → `git commit -m "..."` → `git push`（凭据已存 Windows 凭据管理器，本机 push 无需再输令牌；换机器需重新提供令牌）。 |
|---|
| | | - 注意：`backend.log`、`frontend.log`、`node_modules/`、`dist/`、`target/` 等不入库。 |
|---|
| | | - 日常流程：`git add -A` → `git commit -m "..."` → `git push`（HTTPS 推送免输密码）。 |
|---|
| | | - 注意：`backend.log`、`frontend.log`、`node_modules/`、`dist/`、`target/` 等不入库；`docs/sql_city_bus.sql`、 |
|---|
| | | `docs/sql_city_taxi.sql` 已入库（建表+审核规则，MySQL 8 可用）。 |
|---|
| | | |
|---|
| | | ## 十、会话记录 |
|---|
| | | - 2026-08-14：启动前后端验证正常（后均已停止）；建立 git 仓库（新增 `.gitignore`、脱敏模板 `application.yml.example`，真实 `application.yml` 不入库），创建 Gitee 私有仓库 `jichengxiong/trafficAudit` 并推送 `main`（2 commits：初始提交 + HANDOFF 补充 git 说明）。 |
|---|
| | | - 2026-08-23：交接前核实——git 工作区干净、远端已同步；前后端均未在运行。 |
|---|
| | | - 2026-08-23：交接后启动前后端验证正常（8090/8080 已监听）；记录两条新需求（态势感知图、AI 助手 RAG），仅记录未实现。 |
|---|
| | | - 2026-08-27：登录功能改造完成——行为验证码（按提示顺序点击立体图形）。后端 security/captcha/CaptchaService.java 直接生成等轴测几何面（响应不含图形类型名，答案只在服务端），/api/auth/captcha 获取、/captcha/verify 校验（错 3 次换题）、/login 消费（一次性，未验证 4003/已过期 4002/顺序错 4001）；前端 Captcha3D.vue SVG 渲染（背景随机色+6 种图案、8 种立体图形随机位置/大小/旋转/颜色），Login.vue 接入真实登录（axios+token+localStorage），router 加登录守卫。实测通过：正确顺序验证成功、错误顺序提示重试、未验证拦截、错密码 401、登录跳转工作台。坑：Vue2 组件名大小写敏感，组件注册 Captcha3D 时模板必须写 <captcha3-d>（<captcha3d> 会被解析成 Captcha3d 匹配不上）。 |
|---|
| | | - 2026-08-27（续）：登录页视觉与登出——验证码画布 340x190 缩为 340x148、图形 size 0.8~1.2 缩为 0.6~0.95、间距/抖动收紧、旋转 ±14°；登录卡片 420→400 宽、form 间距收紧（卡片高约 559px）。立方体/长方体改为斜二测教科书画法（前面正方形+顶/侧斜出，更立体）。新增公共 components/AppHeader.vue（标题+当前用户+退出登录，退出清 token 回登录页），替换 6 个业务页原有 el-header。坑：批量插入 components 时 ExplainReview 原有 components: { AiChatDialog } 被覆盖（重复键），需合并为 { AppHeader, AiChatDialog }。另：PowerShell 双引号字符串里的反引号会被吞掉，写 markdown 代码标记要避免。 |
|---|
| | | - 2026-08-27（续2）：六棱柱改为标准等轴测正六边形顶面+3 侧面（此前顶面过扁认不出）；球改为径向渐变（亮→暗，前端渲染器新增 radial 渐变支持，gradient id 用 shape id 去重）。修布局回归：AppHeader 是自定义组件，el-container 检测不到 el-header 子组件导致外层容器变成横向（系统名称+登出只占左侧 435px）——6 个业务页外层容器显式加 direction="vertical" 修复（上：系统栏 左标题右用户+登出；下：左菜单右工作区）。坑：radialFaces 方法误放进 computed（Vue computed 不接受参数，s 为 undefined 报错），须放 methods；vue-loader 编译缓存/浏览器启发式缓存（index.html 无缓存头）导致改代码后页面仍加载旧 chunk——vue.config.js devServer.headers 加 Cache-Control: no-store，测试时用未访问过的 host:port。 |
|---|
| | | |
|---|
| | | - 2026-08-27（续3，双方合并）：合并流程——① 我方改动先提交（验证码+登出+布局，commit 前缀 feat:）；② 从 08-23 基线 |
|---|
| | | 建 `partner-work` 分支，镜像对方目录 `D:\03_公司\02_项目\27_湖北省道路运输事业发展中心\05_开发测试\00_开发\traffic-audit-project-20260827` |
|---|
| | | （排除 .git/dist/日志/对方验证码相关文件：ShapeCaptcha.vue、security/captcha/*、CAPTCHA.md、cp.txt、t_test.js），提交为对方开发结果； |
|---|
| | | ③ `git merge partner-work` 解决冲突：LoginController=我方验证码+对方数据库校验（UserMapper+PasswordEncoder+modules/realName）； |
|---|
| | | Login.vue=我方 Captcha3D 版（补存 realName/modules）；router 守卫用我方版本；6 个业务页=对方功能版+我方 AppHeader 上下布局 |
|---|
| | | （根容器 direction="vertical"、el-header 换 app-header、删菜单内退出登录、注册 AppHeader 组件）；HANDOFF.md 重写为合并版。 |
|---|
| | | ④ pom.xml 去掉对方加的 spring-boot-starter-data-redis（验证码用我方内存版，无需 Redis）；application.yml 本地合并 |
|---|
| | | （保留我方 3305 数据库参数，加 multipart 100MB、docs 模板目录配置；example 模板同步）。⑤ 数据库补齐（见第一节）；init.sql |
|---|
| | | 补 sys_user.modules 列、修正 admin 密码为真实 BCrypt、追加 passenger_individual_monthly 与 audit_run 表；城市客运两个 |
|---|
| | | 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 文件。 |
|---|
