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

110 Commits

Author SHA1 Message Date
weicw-dshsa ac6318d174 ✨ 新增存量司机/车辆补生效快照的订正脚本 
「能否接单」的判据是生效快照指针，该列随认证门槛一起新增时对存量对象一律为 NULL，门槛默认开启后存量司机与车辆全部被判未认证、接不了单。脚本给尚无快照的对象补一条已通过记录并把指针指过去，含备份、校验与回退；幂等，且能在已订正过的库上续跑（从段内最大号之后接着发号，不撞主键）。
 2026-10-07 18:21:38 +08:00
weicw-dshsa 2e5eae4d32 ✨ 打卡照片按类型最多传 9 张，照片列加宽为 text 
- 节点打卡提交新增 photoItems（带显式类型），photos 原样保留供旧版小程序按下标回推
- 打卡照片是每个打卡节点必有的类型，不由过程配置决定，与各凭证类型各自最多 9 张
- 新版提交要求每个类型至少 1 张；旧版仍只要求至少 1 张，避免打断未升级的小程序
- 管理端订正只校验每类上限，不校验必填
- photos 由 varchar(2000) 改 text：36 张约 4000 字符，旧列宽约 17 张即溢出
- 基线建表脚本补 COLLATE=utf8mb4_0900_ai_ci（与本机库实际排序规则一致）
 2026-10-07 16:49:19 +08:00
weicw-dshsa 7c30ead839 ✨ 异常处置支持归属过程节点并新增打卡门禁 
异常上报强制选择过程节点，节点归属写入 node_code / node_name；节点存在未了结
异常时，该节点及其后节点不可打卡（异常门禁），被拦节点仍可展开查看回填内容。

另新增顺序门禁：前置打卡节点未完成时后续节点不可打卡且不可展开；在途节点不受
顺序门禁约束，但仍受异常门禁约束。

配套：
- 过程配置「上传货量为是、货量类型为空」的脏配置订正为不采集货量
- 网关补充 /blade-resource/** 路由（图片上传，小程序打卡与异常上报照片均经此）
 2026-10-05 15:10:24 +08:00
weicw-dshsa 7296a5af21 ✨ 异常处置跟进支持上传附件 
跟进记录新增 attachments_json 列，存 [{name, url}] 形式的 JSON 数组。
跟进说明与附件至少填其一即可：只传附件时，follow_content 列为 NOT NULL，
故写入固定文案「已上传跟进附件」，列表按该文案展示。

建表脚本补 COLLATE：原先只写 CHARSET，落到 MySQL 8 服务器默认排序规则，
与库中实际的 utf8mb4_0900_ai_ci 不一致。
 2026-10-05 01:09:33 +08:00
weicw-dshsa 8d35abd23e ✨ 异常处置新增编辑功能 
运管员可订正已上报的异常内容：异常类型、异常原因、上报说明、现场照片。
车牌、项目、承运商、配载单号由上报时从运单回填，不开放编辑，避免与运单脱钩。

编辑不改动处置状态。状态只能经跟进与完成流转，因为运单详情、运单列表、
首页计数与待办四处都以 disposal_status IN (pending, processing) 判定未完成，
允许编辑改状态会让已结案的异常重新长出来，而那四处判定无从知晓。

每次编辑按字段逐项比对生成变更说明，写入一条跟进记录留痕。
变更说明会内嵌修改前后的原文，长文本字段一次编辑就可能超过跟进内容的
varchar(500) 上限，故按 500 截断。

Permission 表达式用 hasMenu('exception_disposal_edit')：
@PreAuth 的值由 SpEL 求值，root object 是 AuthFun，
写成裸字符串会被当作属性访问而在请求时抛错。
 2026-10-05 00:54:08 +08:00
weicw-dshsa 5061df8c78 📝 删除认证迁移脚本里的解释性注释 
SQL 本身（列名、列 COMMENT、IF 条件）已经把意图说清楚了，注释在复述它、
或是在讲当时的排查过程，对读者没有增量信息。只留一处真正反直觉的：
唯一索引不对 NULL 去重，故 tenant_id 必须 NOT NULL。

注释 31 -> 8 行，DDL 未动，重跑两遍验证。
 2026-10-04 23:49:33 +08:00
weicw-dshsa 4a65951adc 📝 精简认证迁移脚本注释 
上一版注释把决策理由、备选方案、实测数据都写进了脚本，篇幅盖过 SQL 本身
（cert_record 注释 58 行 / 非空 170 行），后续阅读反而更难抓到重点。
按同目录既有脚本的密度收敛：只留「从 SQL 本身看不出来」的事实
（字段业务含义、不可回退的指针语义、排序规则不能改的原因），
删掉论证过程与常识性说明。

cert_record 注释 58 -> 31 行，另两个 14 -> 6 行；
DDL 一个字未动，重跑一遍验证仍无报错。
 2026-10-04 23:46:39 +08:00
weicw-dshsa 378aa11842 ♻️ 认证迁移脚本补幂等并统一注释格式 
三个认证相关迁移脚本按项目既有约定整理，DDL 效果不变：

- driving_vehicle 扩长、owner_name/vin 加列两处原为裸 ALTER，重复执行会报
  「Duplicate column」或白白重建表；改为 DELIMITER 存储过程 + information_schema
  判定，与 doc/sql/transport 下 upgrade_* 的既有写法一致，可重复执行。
  扩长那条额外判定 character_maximum_length < 100：MODIFY COLUMN 会重建整表，
  已达标就不必再跑一次。
- cert_record 的菜单段补注 parent_id 的出处（与 blade_transport_driver.sql /
  blade_transport_vehicle.sql / blade_vehicle_dispatch.sql 同一 ID），并说明
  ON DUPLICATE KEY UPDATE 会把 parent_id / name 回写，对旧环境重跑即可收敛。
- 去掉注释里的 markdown 粗体（doc/sql/transport 的既有排版不用 markdown），
  统一以 30 个破折号的横幅开头。

已在 dev 库 transport 连跑两遍验证：两遍均无报错，且列定义 116 行、索引 29 行、
三表排序规则与整理前逐项一致。
 2026-10-04 23:43:05 +08:00
weicw-dshsa ec98954351 🔀 合并认证记录功能分支到 master 
认证记录不可变快照数据模型、司机端提交与记录查询、管理端审核、
小程序证件 OCR 适配、接单可用性门槛（带开关可回退），含迁移脚本与单元测试。
 2026-10-04 23:38:39 +08:00
weicw-dshsa 17ae367100 🐛 认证审核菜单名改为「司机审核 / 车辆审核」 
原名「认证审核-司机 / 认证审核-车辆」与需求文档的表述不一致，
后台菜单显示为「司机审核」「车辆审核」——与 .scratch 里
审核页分页签那轮需求的措辞对齐。

只改 blade_menu 的 name 字段，code / alias / path / 权限码均不变，
故不影响权限校验与前端路由。

注意：该 INSERT 是 ON DUPLICATE KEY UPDATE，改脚本本身不会改库里已有的行，
要在已有环境生效需重跑本脚本（新环境按脚本建库则直接是新名）。
 2026-10-04 19:16:38 +08:00
weicw-dshsa 04a7846328 ✨ 车辆认证扩到6张证件图，字段与车辆档案对齐；补齐建车必填列 
司机端车辆认证此前只有 3 张图、5 个字段，且语义与车辆管理不一致
（「副页」字段里装的其实是主页反面）。本次把证件内容整体对齐车辆表列：

- 车辆表新增 owner_name（所有人：行驶证登记的单位名称，不是司机）与 vin；
- 提交请求与司机端车辆卡片全量对齐表列，行驶证四张图各自独立、
  不再把「主页反面」与「副页正面」挤在同一个字段；
- 业务关系新增为司机自选（自有/管理挂靠/业务合作），不再由后端替用户猜。

顺带修掉三处会直接让功能不可用的缺陷：

1. 司机建车必失败：organization_name、approved_load_kg、business_relation、
   energy_type、registration_no 五列 NOT NULL 且无默认值，而建车链路一个都不设置，
   严格模式下 INSERT 直接报「doesn't have a default value」。已补齐并加服务端校验
   （司机提交链路此前一句都不查，全靠前端）。
2. OCR 自动填充从未生效：后端按契约透传百度原始结果（中文键），
   前端读的却是扁平字段名，永远 undefined 且不报错。新增 OcrFieldSupport
   做归一化（键名别名容错、数值/日期/「长期」归一化、外廓尺寸拆三段、
   有效期区间拆起止），响应的 fields 即前端直接回填的字段。
3. 审核通过不写回车辆档案：状态已通过、内容却还是旧的，自相矛盾。
   现把生效快照的证件内容与指针合并成同一次 UPDATE 写回；快照是改造前
   旧格式时明确报错，而不是静默写一堆空值。
 2026-10-03 16:34:47 +08:00
weicw-dshsa cc997c1c0c ✨ 审核列表新增司机姓名与手机号，并修正驾驶车辆绑定校验 
审核页的司机姓名与手机号取司机档案的**当前值**，不是提交时的历史值：
手机号从未进入过认证快照（只有司机档案这一个来源），而队列的用途是
「找得到人、联系得上」。司机侧的认证对象就是记录本身；车辆侧记录不含任何
司机信息，取提交该记录的司机。存量订正记录里没有系统账号的那些司机解析不到，
两列为空属正常状态。

筛选必须发生在分页之前，故列表改为自定义 SQL；在 Java 层补字段再过滤会变成
「先分页再过滤」，每页条数与总数都不准。姓名搜索同时匹配档案当前姓名与提交时的
旧名，改名后按新名、旧名都搜得到。

顺带修掉两处既有缺陷：

1. 管理端保存绑定多辆车的司机会误报「驾驶车辆不存在」——小程序把车牌逗号并列
   写入 driving_vehicle，管理端却拿整串去车牌表精确查，两边口径不一致。
2. 「一个司机最多 5 辆车」后端从未校验，且 driving_vehicle 原为 varchar(30)，
   5 个车牌连分隔符要 39 字符，超长写入会被静默截断成半个车牌（还会被当成一辆车）。
   列扩到 varchar(100) 并在写入前校验数量与车牌格式。
 2026-10-03 14:35:59 +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 2f4513d501 📝 新增指定账号各业务模块创建量统计 SQL 
Co-authored-by: Cursor <cursoragent@cursor.com>
 2026-09-29 21:42:34 +08:00
b2894lxlx 087f361a8b ✨ 组织类型改业务字典，并完善金蝶部门代码与MK再提交 
组织类型翻译切换为 organization_type；新增金蝶部门代码字段；流程已结束或已通过时强制新建MK表单实例。

Co-authored-by: Cursor <cursoragent@cursor.com>
 2026-09-29 03:15:26 +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 6eb5362d5f 🐛 修复车辆调度列表排序规则冲突 
JOIN 车牌号/租户时统一 utf8mb4_general_ci，并补充车辆表排序规则对齐脚本。

Co-authored-by: Cursor <cursoragent@cursor.com>
 2026-09-23 14:49:19 +08:00
b2894lxlx 809790e737 🐛 修复本地无法运行的问题 2026-09-23 14:08:53 +08:00
b2894lxlx f09879d1dc 🐛 修复客商类型无法保存的问题 2026-09-23 11:29:52 +08:00
b2894lxlx 14c1d9dff0 ✨ 认证退出与操作日志、密码规则，以及运输业务多项修正 2026-09-22 12:03:59 +08:00
b2894lxlx 427e4b0c84 组织同步逻辑修改 2026-09-21 16:03:28 +08:00
b2894lxlx 0797785176 项目、合同、运单、预结算、正式结算、付款对接mk 2026-09-21 10:36:00 +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 0bfc9cbc86 调试mk 2026-09-20 16:36:31 +08:00
b2894lxlx d5e7787e89 调试mk 2026-09-20 16:05:25 +08:00
b2894lxlx a138f3b916 调试mk 2026-09-20 13:16:44 +08:00
b2894lxlx 380fd117c5 调整定位 2026-09-18 22:12:43 +08:00
b2894lxlx a2e23ea264 1、修改同步组织 
2、新增北斗定位
 2026-09-18 21:12:01 +08:00
b2894lxlx a2d9cfec02 1、修复小程序手机号登录问题 
2、调整OA
 2026-09-18 19:13:45 +08:00
b2894lxlx 01993779a7 1、新增小程序相关接口 
2、调整OA
 2026-09-18 16:31:37 +08:00
b2894lxlx cbc7e16453 调整 IAM 2026-09-16 08:08:09 +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 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 f370f56a92 1、调整凭证 
2、调整运单
 2026-09-08 17:50:20 +08:00
b2894lxlx a3eeb24f4f 调整结算模块 2026-09-08 10:58:21 +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 14a3c23c9d 调整结算 2026-09-05 00:03:21 +08:00