📝 认证记录相关文件去掉外部文档引用，注释改为自解释
前一次提交的注释大量引用本仓库之外、同事看不到的东西： 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 成功。
This commit is contained in:
@@ -1,33 +1,19 @@
|
||||
-- 认证记录数据模型（司机 / 车辆共用一张不可变快照表）
|
||||
-- 认证记录数据模型：新建 blade_transport_cert_record，为司机表、车辆表补认证字段与
|
||||
-- 生效快照指针，订正司机表排序规则，并新增认证审核菜单。
|
||||
--
|
||||
-- 背景与设计依据：
|
||||
-- docs/adr/0001-certification-record-immutable-snapshot.md（不可变快照 + 生效指针）
|
||||
-- docs/adr/0002-certification-does-not-block-usage.md（提交不影响可用性）
|
||||
-- 术语定义见根工作区 GLOSSARY.md
|
||||
-- 认证对象（司机 / 车辆）每次提交产生一条不可变记录，审核只改记录的状态，
|
||||
-- 不覆盖已提交的内容。司机与车辆共用本表，由 biz_type 区分。
|
||||
--
|
||||
-- 本脚本只做 schema 变更，不含任何业务数据订正：
|
||||
-- 1. 新建 blade_transport_cert_record（认证记录，司机与车辆共用，biz_type 区分）
|
||||
-- 2. blade_transport_driver 补认证字段、生效快照指针、身份证有效期
|
||||
-- 3. blade_transport_vehicle 补生效快照指针
|
||||
-- 4. blade_transport_driver 排序规则订正为 utf8mb4_general_ci
|
||||
-- 5. 新增「认证审核-司机 / 车辆」菜单与权限码
|
||||
-- ⚠️ effective_cert_record_id（生效快照指针）是判定「该对象是否已认证」的唯一依据：
|
||||
-- NULL = 从未审核通过；一经写入永不回退，提交、驳回、作废都不得修改它。
|
||||
-- 因此「重新提交审核」不会让一辆已认证的车掉出可用池。
|
||||
--
|
||||
-- 幂等：全部语句可重复执行（建表用 IF NOT EXISTS，加列先查 information_schema）。
|
||||
-- 幂等：全部语句可重复执行（建表 IF NOT EXISTS、加列先查 information_schema）。
|
||||
-- MySQL 5.7+ 兼容。
|
||||
--
|
||||
-- ⚠️ 生效快照指针（effective_cert_record_id）的语义：
|
||||
-- "该认证对象是否已认证"的**唯一**判据。为 NULL 表示从未通过审核。
|
||||
-- 一旦被指向，**永不回退为 NULL**——提交、驳回、作废都不得修改它。
|
||||
--
|
||||
-- ⚠️ 留给后续票的两条约束（本脚本无法用 DDL 表达）：
|
||||
-- 1) 指针所指记录的 status 必须恒为「已通过」(1)，且不得再被改动。
|
||||
-- 这正是不变式 I2 的后半句；由 03 的「已终态记录不可再次审核」保证。
|
||||
-- 2) 指针所指记录的 biz_type / biz_id 必须与持有它的对象一致。
|
||||
-- 由 03 写指针时保证（通过时用的是待审记录自身的 biz_id）。
|
||||
|
||||
-- ---------------------------------------------------------------------------
|
||||
-- ----------------------------
|
||||
-- 1. 认证记录表
|
||||
-- ---------------------------------------------------------------------------
|
||||
-- ----------------------------
|
||||
CREATE TABLE IF NOT EXISTS `blade_transport_cert_record` (
|
||||
`id` bigint(20) NOT NULL COMMENT '主键',
|
||||
`tenant_id` varchar(12) NOT NULL DEFAULT '000000' COMMENT '租户ID',
|
||||
@@ -55,9 +41,9 @@ CREATE TABLE IF NOT EXISTS `blade_transport_cert_record` (
|
||||
KEY `idx_cert_record_submit_time` (`submit_time`) USING BTREE
|
||||
) ENGINE=InnoDB DEFAULT CHARSET=utf8mb4 COLLATE=utf8mb4_general_ci COMMENT='认证记录';
|
||||
|
||||
-- ---------------------------------------------------------------------------
|
||||
-- ----------------------------
|
||||
-- 2~4. 加列与排序规则订正
|
||||
-- ---------------------------------------------------------------------------
|
||||
-- ----------------------------
|
||||
DELIMITER $$
|
||||
|
||||
DROP PROCEDURE IF EXISTS `upgrade_transport_cert_record_20261002`$$
|
||||
@@ -67,8 +53,8 @@ BEGIN
|
||||
SET db_name = DATABASE();
|
||||
|
||||
-- ---- 2. 司机表：认证字段 + 生效快照指针 ----
|
||||
-- certification_status 是「最新提交状态」的展示缓存，不是可用性判据；
|
||||
-- 初始为 NULL 表示「从未提交」，与「审核中(0)」语义不同。
|
||||
-- certification_status 是「最新提交状态」的展示缓存；初始为 NULL 表示「从未提交」，
|
||||
-- 与「审核中(0)」语义不同，故不可用 0 兜底。
|
||||
IF NOT EXISTS (SELECT 1 FROM information_schema.columns WHERE table_schema = db_name AND table_name = 'blade_transport_driver' AND column_name = 'certification_status') THEN
|
||||
ALTER TABLE `blade_transport_driver` ADD COLUMN `certification_status` int(11) DEFAULT NULL COMMENT '最新提交状态展示缓存：0审核中 1已通过 2已驳回 3已作废，NULL为从未提交' AFTER `remark`;
|
||||
END IF;
|
||||
@@ -92,15 +78,16 @@ BEGIN
|
||||
|
||||
-- ---- 3. 车辆表：生效快照指针 ----
|
||||
-- 现有 certification_status / certification_reject_reason 保留，降级为「最新提交状态」展示缓存；
|
||||
-- 可用性判定一律改读本指针（改造见 ticket 04）。
|
||||
-- 车辆可用性判定改读本指针。
|
||||
IF NOT EXISTS (SELECT 1 FROM information_schema.columns WHERE table_schema = db_name AND table_name = 'blade_transport_vehicle' AND column_name = 'effective_cert_record_id') THEN
|
||||
ALTER TABLE `blade_transport_vehicle` ADD COLUMN `effective_cert_record_id` bigint(20) DEFAULT NULL COMMENT '生效快照指针：指向 blade_transport_cert_record.id，NULL 表示从未认证通过；一经设置永不回退' AFTER `certification_reject_reason`;
|
||||
END IF;
|
||||
|
||||
-- ---- 4. 司机表排序规则订正 ----
|
||||
-- blade_transport_driver 建表未显式指定 COLLATE，MySQL 8+ 默认 utf8mb4_0900_ai_ci，
|
||||
-- 与项目规范（utf8mb4_general_ci）不一致；blade_transport_vehicle 曾因此报
|
||||
-- Illegal mix of collations，故一并订正，避免司机认证 JOIN 重演同一故障。
|
||||
-- blade_transport_driver 建表未显式指定 COLLATE，MySQL 8+ 会落到服务器默认
|
||||
-- utf8mb4_0900_ai_ci，与项目规范（utf8mb4_general_ci）不一致。
|
||||
-- blade_transport_vehicle 曾因同类问题在 JOIN 时报 Illegal mix of collations，
|
||||
-- 故在此一并订正，避免司机认证的关联查询重演同一故障。
|
||||
IF EXISTS (SELECT 1 FROM information_schema.tables WHERE table_schema = db_name AND table_name = 'blade_transport_driver' AND table_collation <> 'utf8mb4_general_ci') THEN
|
||||
ALTER TABLE `blade_transport_driver` CONVERT TO CHARACTER SET utf8mb4 COLLATE utf8mb4_general_ci;
|
||||
END IF;
|
||||
@@ -108,7 +95,7 @@ BEGIN
|
||||
-- ---- 4.1 待审唯一键自修复 ----
|
||||
-- 生成列必须同时排除「已逻辑删除」的行：MyBatis-Plus 的 removeById 只把 is_deleted 置 1，
|
||||
-- 不会改 status。若生成列只看 status = 0，一条被逻辑删除的待审记录会继续占用唯一键，
|
||||
-- 导致该认证对象**永远无法再提交**（ticket 02 明确要求车辆认证按逻辑删除处理）。
|
||||
-- 导致该认证对象永远无法再次提交。
|
||||
-- 建表语句已是正确版本；这里负责把按早期版本建过表的环境就地修正过来。
|
||||
IF EXISTS (
|
||||
SELECT 1 FROM information_schema.columns
|
||||
@@ -120,8 +107,9 @@ BEGIN
|
||||
END IF;
|
||||
|
||||
-- ---- 4.2 tenant_id 收紧为 NOT NULL ----
|
||||
-- tenant_id 是待审唯一键 uk_cert_record_pending 的第一列，而 MySQL 的唯一索引**不对 NULL 去重**：
|
||||
-- 若 tenant_id 允许为 NULL，两条 tenant_id IS NULL 的待审记录可以并存，I1 会被整个绕过。
|
||||
-- tenant_id 是待审唯一键 uk_cert_record_pending 的第一列，而 MySQL 的唯一索引不对 NULL 去重：
|
||||
-- 若 tenant_id 允许为 NULL，两条 tenant_id IS NULL 的待审记录可以并存，
|
||||
-- 「同一对象至多一条待审」的约束就被绕过了。
|
||||
-- 本库三张表（driver / vehicle / waybill）实测均无 tenant_id 为 NULL 的行，
|
||||
-- 且「NOT NULL DEFAULT '000000'」是项目既有写法（doc/sql/transport 下 23 个脚本如此）。
|
||||
IF EXISTS (
|
||||
@@ -136,7 +124,7 @@ BEGIN
|
||||
|
||||
-- ---- 4.3 车辆认证状态缓存词表对齐 ----
|
||||
-- 改造前车辆侧是「0认证中 1认证通过 2认证驳回」，不含「已作废」；
|
||||
-- 而 02/03 会把「被同对象再次提交取代」写成 3，届时该列无对应语义。
|
||||
-- 而新流程会把「被同对象再次提交取代」写成 3，届时该列无对应语义。
|
||||
-- 取值 0/1/2 在两套词表下含义一致（进行中 / 通过 / 驳回），故这里只补 3 并统一措辞，
|
||||
-- 不改变任何既有数据的含义。仅改列注释（元数据），不动数据。
|
||||
IF EXISTS (
|
||||
@@ -162,12 +150,11 @@ DROP PROCEDURE `upgrade_transport_cert_record_20261002`$$
|
||||
|
||||
DELIMITER ;
|
||||
|
||||
-- ---------------------------------------------------------------------------
|
||||
-- ----------------------------
|
||||
-- 5. 菜单与权限码
|
||||
-- 挂在「运力管理」(2079000000000000001) 下，与司机管理 / 车辆管理同级。
|
||||
-- 权限码按 spec 约定：列表用 cert_certification_audit_{driver|vehicle}，
|
||||
-- 审核动作用对应 _audit 后缀。
|
||||
-- ---------------------------------------------------------------------------
|
||||
-- 列表页权限码 cert_certification_audit_{driver|vehicle}，审核动作加 _audit 后缀。
|
||||
-- ----------------------------
|
||||
INSERT INTO `blade_menu` (`id`, `parent_id`, `code`, `name`, `alias`, `path`, `source`, `sort`, `category`, `action`, `is_open`, `component`, `remark`, `is_deleted`) VALUES
|
||||
(2079000000000000300, 2079000000000000001, 'cert_certification_audit_driver', '认证审核-司机', 'cert_certification_audit_driver', '/transportCapacity/cert-audit-driver', 'iconfont iconicon_doc', 4, 1, 0, 1, '', '司机认证待审列表', 0),
|
||||
(2079000000000000301, 2079000000000000300, 'cert_certification_audit_driver_audit', '审核', 'cert_certification_audit_driver_audit', '', '', 1, 2, 0, 1, NULL, '通过/驳回司机认证', 0),
|
||||
|
||||
Reference in New Issue
Block a user