From e281e3710c5a0c3c7d7596f00cd1cc6945da7f0b Mon Sep 17 00:00:00 2001
From: puzhibing <393733352@qq.com>
Date: 星期二, 29 九月 2026 19:48:21 +0800
Subject: [PATCH] 修改VIN码模块

---
 doc/耗时统计.md |    1 +
 1 files changed, 1 insertions(+), 0 deletions(-)

diff --git "a/doc/\350\200\227\346\227\266\347\273\237\350\256\241.md" "b/doc/\350\200\227\346\227\266\347\273\237\350\256\241.md"
index edb403f..a8ff495 100644
--- "a/doc/\350\200\227\346\227\266\347\273\237\350\256\241.md"
+++ "b/doc/\350\200\227\346\227\266\347\273\237\350\256\241.md"
@@ -21,3 +21,4 @@
 | 2026-09-28 17:33:00（估算，含授权前方案分析与两轮确认问答） | 2026-09-28 17:39:39 | 约 399（估算，授权后执行 188 秒 + 方案分析约 211 秒） | 推送代码，编写完整的修改描述 | 是：先只读核查两仓库分支/远端/改动清单与编译产物，发现工作区含两个功能块改动（充电用户信息 + 优惠设置/集团联系人），经两轮确认问答确定「全部推送、每仓库一个 commit」后获「开始执行」授权 | 提交并推送公司详情充电用户信息聚合表格、公司优惠设置/账户模式改造、集团联系人字段三批改动；服务端提交 `29e9ce47`，管理后台提交 `a84f8954` | 服务端 38 个文件（VIN/刷卡/白名单三套 list-by-company 内部接口与 Feign/FallbackFactory、TGroupCompany 聚合与 CompanyChargingUserVO、TCompanyPreferential 全套与 CompanyPreferentialSupport、TGroup 联系人字段、sql/20260928_company_preferential.sql、sql/20260928_group_contact.sql、三个测试类、doc/耗时统计.md、sql/20260926_统一执行清单.md）；管理后台 9 个文件（company/index.jsx、service.js、RechargeModal.jsx、AccountModeModal.jsx、PreferentialModal.jsx、companyPayload/preferential 及各自单测） | 后端 `mvn -pl ruoyi-api/ruoyi-api-account,ruoyi-api/ruoyi-api-other,ruoyi-service/ruoyi-account,ruoyi-service/ruoyi-other -am compile` BUILD SUCCESS（17/17 模块）；前端删 dist 后 `npm run build` 成功（Webpack Compiled successfully，dist 生成）；推送后远端引用核验 aa8119b5..29e9ce47（2.3）、686b5246..a84f8954（dev_2.3）；IDE lint 0 错误 | company_preferential 与 group_contact 两个 DDL 尚未执行（测试库待执行，见 sql/20260926_统一执行清单.md 第十节）；本统计行在推送后追加，未随本次提交推送 |
 | 2026-09-28 18:07:00（估算，授权后执行阶段；含授权前方案分析与两轮确认约 19:xx 起） | 2026-09-28 18:40:44 | 约 2024（估算，授权后执行约 34 分钟；含授权前方案分析与两轮确认问答总计约 55 分钟） | 分析代码，将VIN码、卡片、白名单全部都舍弃init_quota字段，统一使用balance字段表示余额，额度分配和初始额度也是修改balance字段 | 是：先只读盘点 init_quota 全部 40 处引用（模型/DTO/Mapper/Service/前端页面/历史 SQL），输出三表统一方案（VIN/白名单 CHANGE 列名保留数据、卡片 DROP 列丢弃、前端仅改字段不改文案），经两轮确认问答（卡片历史数据直接丢弃、文案保留原表述、VIN 与白名单一同修改）后获「开始执行」授权 | 三模块舍弃 init_quota 统一 balance：VIN/白名单模型 DTO 改名 balance，卡片模型/DTO 删除 initQuota 复用既有 balance；额度分配与初始额度写库改为 balance 列；卡片编辑仅传正数余额才更新 balance（未传保持原余额）；新建统一 DDL 脚本并追加执行清单第十一节 | 服务端 20 个文件（3 模型+3 DTO、TVinManagementMapper.java、三个 Mapper XML、三个 ServiceImpl、TGroupCompanyServiceImpl、三个测试类、sql/20260928_unify_quota_to_balance.sql 新建、sql/20260926_统一执行清单.md、doc/耗时统计.md）；管理后台 6 个文件（vin/index.jsx、vin/AllocateModal.jsx、card/index.jsx、person/whitelist/index.jsx、whitelist/AddAndEdit.jsx、fleet/index.jsx） | 后端 `mvn -pl ruoyi-api-account,ruoyi-account,ruoyi-other -am compile` BUILD SUCCESS；surefire 2.22.2 跑 TChargingCardServiceImplTest 50/50、TVinManagementServiceImplTest 48/48、TAppUserWhitelistServiceImplTest 1/1、TFleetServiceImplTest 6/6、TGroupCompanyServiceImplTest 11/11 全部通过；前端删 dist 后 build 成功、`npx tsc --noEmit` 退出码 0；IDE lint 0 错误 | 首轮单测失败 1 条：updateCardRequiresExistingCardAndDoesNotChangeBalance 因编辑时 dto.balance=999.99 触发「请选择所属公司后再填写初始分配额度」，按新语义修正测试（编辑未传 balance 余额保持）并加固主代码（balance 仅正数才写列，避免共享模式清空余额）；统一 DDL（sql/20260928_unify_quota_to_balance.sql）尚未在任何库执行，发版前必须先执行；前端工作区另有 company/index.jsx、global.less 公司树选中样式改动（非本任务，未纳入） |
 | 2026-09-29（开始时间未记录，估算） | 2026-09-29 10:52:50 | 未记录（估算约 5400 秒，跨会话续作） | 充电时间超过授权时间主动停止充电的判断最好提前1分钟校验，避免数据传输延迟导致的导出实现（续作：VIN 码充电 5 项需求落码） | 是：先只读分析并输出修改方案（含提前量常量、边界保护口径），用户确认「开始执行」后落码 | 完成 VIN 码充电 5 项需求：①余额按企业账户模式（共享锁企业/分配锁 VIN）实扣冻结；②授权站点与时段（含指定电价阶段）校验 + 授权到期提前 60 秒主动停充；③按企业优惠设置（服务费比例/计费模板单价）优惠计费并落优惠金额；④结算解锁扣费退回 + 分配记录消费流水（按订单幂等）；⑤补偿/关单路径统一释放锁定；前端分配记录新增「类型」列；同步删除 IoT 下发硬编码余额 100 | 服务端 22 个：ruoyi-api-order/TVinChargingOrder（5 新列）、TVinChargingOrderAccountingStrategy（3 新列）、ruoyi-api-account/TCompanyAllocateRecord（change_type/charging_order_code/USER_TYPE_COMPANY）、TGroupCompany、TVinManagement、4 个新 Feign 客户端与 fallback、3 个 inner 接口控制器，ruoyi-service/ruoyi-order/TVinChargingOrderServiceImpl（授权校验/锁定/停充/优惠结算/流水）、ruoyi-service/ruoyi-integration/IotMessageListener、sql/20260929_vin_charge_lock_{other,account,order}.sql；测试类 TVinChargingOrderCompanyFleetTest；管理后台 2 个：allocateRecord.js、AllocateRecordModal.jsx 与其单测 | 后端 order 192/192、account 159/159、integration 2/2 通过（surefire 2.22.2）；other 128 条中 4 条、chargingPile 40 条中 1 条为历史失败（Emind/EnergyReport/导出列顺序，工作区未改相关实现，非本次引入）；前端 Jest 13/13；三方测试库执行 3 个 DDL 脚本并回查 12 项列全部存在、中文注释无乱码、分片表下推查询通过 | 开始时间因跨会话续作未记录，耗时按估算标注；测试库（内网 111:8066 / 外网 221.182.45.100:8066 同库）已执行 DDL，其他环境发版前须先执行三个 SQL 脚本 |
+| 2026-09-29 19:22:00（估算） | 2026-09-29 19:47:00（估算） | 约 1500（估算） | VIN码管理页面字段与筛选改造（前一会话续作：补充「导入模板也更新，添加和编辑去掉备注字段」） | 是：先只读复核 DTO/Mapper/Service/前端与三个测试类，输出含字段矩阵、影响面、回归方案的完整方案，用户确认「开始执行」后落码 | ①列表新增账户模式/可用余额/超额/账户状态，移除初始分配额度与备注列，手机号改「联系人手机号」且取消筛选，启用状态改「启停状态」；②新增创建时间区间筛选（beginTime/endTime，闭区间）；③行内新增解绑、工具栏顺序调整为添加车辆/批量解绑/额度分配/导入/导出/删除；④导出改 10 列并回填车队名与账户信息；⑤导入模板改 5 列（去掉备注）；⑥添加/编辑弹窗去掉备注，后端不再接收/写入 remark（编辑不再清空历史备注），DB 列保留无 DDL | 服务端 7 个：ruoyi-api-account/VinManagementQueryDTO、VinManagementExcelDTO、VinManagementSaveDTO、TVinManagement；ruoyi-account/TVinManagementMapper.xml、TVinManagementServiceImpl；测试 3 个：TVinManagementServiceImplTest、VinManagementMapperStructureTest、TVinManagementControllerTest；管理后台 4 个：pages/vin/index.jsx、queryParams.js（新增）、queryParams.test.js（新增）、components/ImportModal.jsx | 后端 surefire 2.22.2：VIN 三个测试类 70/70（controller 15、mapper 2、service 53）、account 模块全量 172/172 通过；依赖模块 ruoyi-other、ruoyi-order test-compile BUILD SUCCESS；前端 Jest 7/7、`npm run tsc` 退出码 0、@babel/parser 语法校验 5 个改动文件全部通过；IDE 诊断 0 错误 | 开始时间未精确记录，按估算标注；未执行真实数据库与页面联调，功能验证为代码走查+编译；旧模板（含手机号/备注/启用状态列头）只能识别 VIN码/车牌号/所属公司，需用新模板；导入仍按历史逻辑只写公司名称文本、不关联公司ID，账户类列为空；接口 phone 查询条件保留兼容

--
Gitblit v1.7.1