b2894lxlx/tms-erp-api
1
0
Fork 0
Code Issues Pull Requests Actions Packages Projects Releases Wiki Activity
259 Commits 4 Branches 0 Tags
fbced4e6a09be74e0285d3d3a9ed06001521fc0d
Commit Graph

110 Commits

Author SHA1 Message Date
weicw-dshsa 2edbacf838 ✨ 小程序证件 OCR 薄适配层，含类型映射 
小程序按既有契约 POST {imageUrl, type, side?} 到 /driver/auth/ocr，
后端转调已有的百度 OCR 能力（recognizeUrl）。

映射的必要性在于两侧命名对「行驶证」和「驾驶证」的用词正好相反：
  驾驶证 —— 小程序传 driver，后端 OCR 用 driving_license
  行驶证 —— 小程序传 vehicle，后端 OCR 用 vehicle_license
把入参直接透传下游，调用方不会收到任何错误，只会拿到另一种证件的字段，
问题要到人工核对时才发现。故用显式白名单逐一对应。

采用白名单而非「透传 + 兜底为通用识别」，是因为从业资格证没有对应的百度接口：
静默降级成通用文字识别会让前端以为识别成功，实际拿到一堆通用文本。
该类型明确报错并提示手动填写。

正反面：小程序目前不传 side，按 front 处理（正页是常用场景）。

10 个映射用例覆盖五个小程序类型、后端既有命名、大小写/分隔符变体、
未知类型、空值、不支持类型与 side 归一化。
全模块 58 个测试通过：mvn -o test -pl blade-service/blade-transport -am
 2026-10-02 16:31:42 +08:00
weicw-dshsa 5747975152 ✨ 管理端认证审核接口，并弃用旧车辆审核入口 
审核作用于**一条认证记录**，不是车辆行或司机行。两条路径的差别是本次改造的关键：
- 通过：记录转已通过 + 写审核人/审核时间，并把该对象的生效快照指针**切换**到它
  （切换而非追加，故一个对象至多一条生效快照）；
- 驳回：记录转已驳回并留原因，生效快照指针**一个字都不动**。

因此「已认证的车被驳回」不会掉出可用池，只是这次提交没被采纳。

已终态（已通过/已驳回/已作废）的记录拒绝再次审核。理由：若允许，
把指针指着的那条「已通过」改成「已驳回」，生效值就凭空消失了。

审核详情同时返回待审快照与当前生效值两侧，供审核页做字段级 diff
（这正是「看出司机改了什么」的实质要求），并附 certified 标记，
便于前端提示「本次驳回不影响该对象继续使用」。

旧接口 POST /transport-vehicle/audit-certification 置为 @Deprecated 并加告警日志：
它作用于车辆行且原地覆盖，在生效值/待审值分离后语义已不成立。
保留而不删除是为了避免小程序历史版本或其它系统 404；它只写展示缓存，
不再影响可用性判定（可用性只看 effective_cert_record_id）。

修复过程中被测试抓到两个真实问题：
1. 通过路径原先对同一行连发两次 UPDATE（先切指针、再刷展示缓存），
   合并为一次，消除了「后写覆盖先写」的可能；
2. 新增 EffectivePointerUpdateSqlTest，直接断言 MyBatis-Plus 生成的 UPDATE SET 片段：
   指针列必须被「值非 null 才写」的 if 包住——驳回传 null 因此物理上碰不到它。
   把「靠约定」变成「靠语句」，若有人给该字段加 ALWAYS 策略，测试立刻变红。

13 个审核用例 + 全模块 48 个测试通过：mvn -o test -pl blade-service/blade-transport -am
 2026-10-02 16:26:20 +08:00
weicw-dshsa 63762b9dd0 ✨ 司机端认证提交与记录查询接口（车辆/个人） 
实现司机在小程序上提交认证、查看生效值与认证记录的能力。

提交链路的结构性保证（这是本次改造的核心约束「提交审核不影响车辆正常使用」）：
- 提交只产生一条新的待审记录，**绝不修改 effective_cert_record_id**，
  因此已认证的车重新提交后依然可用；待审内容在审核通过前只存在于记录表里；
- 同对象至多一条待审：落新记录前先把前一条待审转已作废，
  且只动作待审——已通过/已驳回是终态，尤其不碰生效快照指着的那条；
- 新记录状态显式设为待审：框架会把空 status 静默填成 1，而 1 在本表是「已通过」，
  不显式设置会让一次提交凭空变成审核通过；
- 新记录清空驳回原因，避免出现「审核中」却带着上一次驳回文案。

越权校验：司机只能提交/查看本人及本人绑定车辆的认证（复用 VehiclePlateSupport），
不可查看者返回业务异常而不是空列表——空列表会被误读成「没有记录」。

新增：
- DriverAuthController（/driver/auth/**，兼容 /blade-transport/driver/auth/**）
- IDriverCertService / DriverCertServiceImpl
- PersonCertSubmitRequest / VehicleCertSubmitRequest
- TransportCertRecordVO.statusText（状态文案统一在 Wrapper 翻译，四端一套说法）
- IDriverAppService.currentDriverEntity()（认证写入需要司机实体）

17 个用例覆盖票 02 的三条验收点与不变式（含「重新提交后生效值仍是旧的」）。
全模块 33 个测试通过：mvn -o test -pl blade-service/blade-transport -am
 2026-10-02 16:17:06 +08:00
weicw-dshsa e891100a23 ✨ 认证记录状态机规则集中为 CertificationRuleSupport 并补测试 
把「什么状态能做什么」从持久化里拎出来单独验证。这几条规则是认证改造的地基，
改坏的后果都是线上事故，故先锁住行为再写业务：

- prepareForSubmit：新提交一律待审，并清空驳回原因（否则会继承上一次的驳回文案，
  出现「审核中」却带着驳回原因的自相矛盾状态）；
- supersedeIfPending：再次提交只作废前一条待审，已通过/已驳回/已作废都是终态不碰
  ——尤其是不得改动已通过的记录，它可能正被生效快照指针指着；
- isCertified：唯一判据是生效快照指针，故「曾通过即永久保持」；
- isAuditable：只有待审可审，终态再审会把生效快照改坏；
- statusText：四种状态各一个中文说法，与列注释、前端文案保持一致。

TransportCertRecord.REJECT_REASON_MAX_LENGTH 与 reject_reason 列宽（200）对齐。
9 个用例覆盖上述规则与边界（null、未知状态、超长原因）。

可离线执行：mvn -o test -pl blade-service/blade-transport -am
 2026-10-02 16:10:34 +08:00
weicw-dshsa 36d23cb426 📝 认证记录相关文件去掉外部文档引用，注释改为自解释 
前一次提交的注释大量引用本仓库之外、同事看不到的东西：
docs/adr/0001、docs/adr/0002、GLOSSARY.md、.scratch/ 下的 spec 与 ticket 编号、
以及 ADR-0002 / D10 / 不变式 I1~I3 这类代号。这些都在另一个 git 仓库
（weicw/tms-erp）里，单独 checkout 本仓库的人根本找不到，只会困惑。

改为把结论直接写在注释里：
- 生效快照指针为何「一经设置永不回退」（原来只写「见 ADR-0002」）；
- 为何 redis 状态字段不能用 0 兜底；
- 为何生成列要排除 is_deleted、为何 tenant_id 必须 NOT NULL；
- changeStatus 为何被禁用（原来写「破坏 I3 的留痕」）。

顺带对齐本仓库的既有排版习惯：
- 横幅破折号由 77 个改为 30 个（与 blade_annual_inspection_record.sql 等一致）；
- 去掉 SQL 注释里的 markdown 粗体（本目录无其他脚本这么写）。

仅注释变更：SQL 的 diff 已逐行核对，非注释行改动为 0，DDL 一字未动；
迁移重跑仍 exit 0，audit-migrations 通过，mvn clean compile 成功。
 2026-10-02 15:47:39 +08:00
weicw-dshsa 87f4c3a830 ✨ 新增认证记录不可变快照数据模型与迁移脚本 
按 ADR-0001/0002 建立司机与车辆共用的认证记录表 blade_transport_cert_record
（biz_type 区分、载荷存 JSON、检索字段提升为真实列），并为司机/车辆表补生效快照指针。

不变式结构性保证：
- I1 同对象至多一条待审：生成列 pending_biz_id + 唯一索引，数据库层拦截；
  生成列同时排除 is_deleted，避免逻辑删除的待审记录永久占用唯一键。
- I3 快照不可变：snapshot_json 等 5 列标 FieldStrategy.NEVER，永不进入 UPDATE。
- status 承载审核状态（0审核中/1已通过/2已驳回/3已作废），新增时必须显式设置：
  框架 resolveEntity 会把 null 的 status 静默填成 1（即「已通过」），
  且继承来的 changeStatus 可直接写 status，两条通道均已封堵。

其他：司机表补身份证有效期三列并订正排序规则为 utf8mb4_general_ci
（原先为 0900_ai_ci，与车辆表 JOIN 已发生过 Illegal mix of collations）；
生效快照指针加 @JsonProperty(READ_ONLY)，防止以 /submit 请求体自行「认证」自己；
同步基线建表脚本与认证审核菜单/权限码。本票不含任何业务接口。
 2026-10-02 14:40:56 +08:00
b2894lxlx 087f361a8b ✨ 组织类型改业务字典，并完善金蝶部门代码与MK再提交 
组织类型翻译切换为 organization_type；新增金蝶部门代码字段；流程已结束或已通过时强制新建MK表单实例。

Co-authored-by: Cursor <cursoragent@cursor.com>
 2026-09-29 03:15:26 +08:00
b2894lxlx 32cff235e0 🐛 修复审核通过后再提交未新建MK流程实例的问题 
Co-authored-by: Cursor <cursoragent@cursor.com>
 2026-09-29 02:44:48 +08:00
b2894lxlx beb0850644 ✨ 解耦MK表单实例与业务ID，公开页按formInstanceId反查业务数据 
Co-authored-by: Cursor <cursoragent@cursor.com>
 2026-09-29 02:23:19 +08:00
b2894lxlx eef9d7ad9d ✨ 完善运单导入配载标识、导入状态与凭证文件夹统计 
记录配载标识号并在同批次多运单时生成配载单，导入状态与运单状态对齐，凭证按车牌文件夹统计并支持压缩包重传匹配。

Co-authored-by: Cursor <cursoragent@cursor.com>
 2026-09-27 22:54:30 +08:00
b2894lxlx 1185c9792c 🐛 修复车务非必填-1占位落库，并完善总单分段调度与运单导入 
上一段运单完成到达后才可调度且不超过到达量；车务多模块保存/列表/导出将-1归一为null；同步网关大报文限制与导入校验能力。

Co-authored-by: Cursor <cursoragent@cursor.com>
 2026-09-27 21:26:54 +08:00
b2894lxlx f09879d1dc 🐛 修复客商类型无法保存的问题 2026-09-23 11:29:52 +08:00
b2894lxlx 3e23507b3a ✨ 客商评分提交校验、复评状态与空评分持久化 
提交审批前必须完成且仅保留一条自评，审核通过前必须完成复评。
列表返回最新复评状态；删除最后一条评分会落库；评分为 0 时不再被当成空值覆盖。

Co-authored-by: Cursor <cursoragent@cursor.com>
 2026-09-22 20:21:43 +08:00
b2894lxlx 14c1d9dff0 ✨ 认证退出与操作日志、密码规则，以及运输业务多项修正 2026-09-22 12:03:59 +08:00
b2894lxlx 427e4b0c84 组织同步逻辑修改 2026-09-21 16:03:28 +08:00
b2894lxlx 2404281bff 项目、合同、运单、预结算、正式结算、付款对接mk 2026-09-21 13:52:34 +08:00
b2894lxlx cfe36dfc8b 项目、合同、运单、预结算、正式结算、付款对接mk 2026-09-21 11:38:44 +08:00
b2894lxlx 0797785176 项目、合同、运单、预结算、正式结算、付款对接mk 2026-09-21 10:36:00 +08:00
b2894lxlx 780cd56ffe 调试mk 2026-09-20 18:34:40 +08:00
b2894lxlx 2f56ca07cb 调试mk 2026-09-20 17:35:59 +08:00
b2894lxlx 6987a0e790 调试mk 2026-09-20 17:11:08 +08:00
b2894lxlx a138f3b916 调试mk 2026-09-20 13:16:44 +08:00
b2894lxlx a2e23ea264 1、修改同步组织 
2、新增北斗定位
 2026-09-18 21:12:01 +08:00
b2894lxlx 3b26591f9d 新增同步公司、组织 2026-09-18 20:25:33 +08:00
b2894lxlx 01993779a7 1、新增小程序相关接口 
2、调整OA
 2026-09-18 16:31:37 +08:00
b2894lxlx af3b6982fd 调整 业务 2026-09-15 17:52:34 +08:00
b2894lxlx 0d1f14f703 调整 合同、运力、客商、项目 2026-09-15 11:59:42 +08:00
b2894lxlx 087d89b31a 调整 合同、运力、基础配置、客商 2026-09-14 23:43:00 +08:00
b2894lxlx 70e44da789 调整 合同 2026-09-14 15:00:40 +08:00
b2894lxlx 940f0b9b9f 调整 基础数据、运力、车船务 2026-09-14 01:49:02 +08:00
b2894lxlx 2262c39f60 调整项目 2026-09-13 01:01:09 +08:00
b2894lxlx 2da4d824fd 小程序对接 2026-09-11 15:30:22 +08:00
b2894lxlx aa8b7ade99 小程序对接 2026-09-11 14:39:10 +08:00
b2894lxlx 93c7e6f8f5 1、调整导入运单 
2、调整对账
 2026-09-10 22:50:00 +08:00
b2894lxlx e7d7e61846 1、调整导入运单 
2、调整对账
 2026-09-10 02:01:51 +08:00
b2894lxlx 049a46227d 1、调整导入运单 
2、调整对账
 2026-09-09 15:39:21 +08:00
b2894lxlx 63af35a333 1、调整导入运单 
2、调整对账
 2026-09-09 14:43:26 +08:00
b2894lxlx 0ce701ab90 1、调整凭证 
2、调整对账
3、解决正式结算冲突bug
 2026-09-09 10:20:52 +08:00
b2894lxlx f370f56a92 1、调整凭证 
2、调整运单
 2026-09-08 17:50:20 +08:00
b2894lxlx a3eeb24f4f 调整结算模块 2026-09-08 10:58:21 +08:00
b2894lxlx 4e9bb19b23 调整结算模块 2026-09-08 07:56:07 +08:00
b2894lxlx 4d34525b7b 调整结算模块 2026-09-07 19:37:08 +08:00
b2894lxlx 2e7ab6f508 fix bug 2026-09-07 16:08:05 +08:00
b2894lxlx 397e9f3b62 调整结算 2026-09-05 23:26:00 +08:00
b2894lxlx c725aaf203 调整业务模块 2026-09-04 05:22:59 +08:00
b2894lxlx 809b4eb63a 调整基础数据、车船务、项目、合同 2026-09-03 22:40:19 +08:00
b2894lxlx a8d866231b 1、修复基础配置 
2、修复业务模块
 2026-09-03 15:59:20 +08:00
b2894lxlx 88b04b7dac 1、修复基础配置 
2、修复业务模块
 2026-09-03 03:30:57 +08:00
b2894lxlx e5b8ff5d4c 调整业务问题 2026-09-02 03:22:22 +08:00
b2894lxlx 27ed35f9dd 调整收付款问题 2026-08-31 12:40:27 +08:00