📝 认证记录相关文件去掉外部文档引用，注释改为自解释

前一次提交的注释大量引用本仓库之外、同事看不到的东西： 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
parent 87f4c3a830
commit 36d23cb426
6 changed files with 45 additions and 61 deletions
@@ -34,8 +34,8 @@ import java.util.List;
 /**
 * 认证记录 服务类
 * <p>
- * 只承载认证记录本身的读写与<b>数据模型不变式</b>的守护；
- * 提交（02/05）、审核（03）、可用性门槛（04）等业务链路在各自的票中实现。
+ * 只承载认证记录本身的读写与数据模型约束的守护；提交、审核、可用性门槛等业务链路
+ * 由各自的业务服务实现。
 *
 * @author Chill
 */
@@ -89,8 +89,8 @@ public class TransportCertRecordServiceImpl extends BaseServiceImpl<TransportCer
 	 * ⚠️ 本表的 {@code status} 是<b>审核状态</b>，不是「启用 / 停用」。
 	 * 而 {@code BaseServiceImpl#changeStatus} 会绕过 {@link #validateRecord} 直接写 status，
 	 * 调用 {@code changeStatus(ids, 1)} 即等于<b>批量通过审核</b>——
-	 * 审核人、审核时间、驳回原因全部缺失，既破坏 I3 的留痕，也会凭空造出生效快照。
-	 * 审核必须走 03 的审核接口（作用于单条记录、带留痕）。
+	 * 审核人、审核时间、驳回原因全部缺失，既丢失审核留痕，也会凭空造出生效快照。
+	 * 审核必须逐条走带留痕的审核方法。
 	 *
 	 * @param ids    主键集合
 	 * @param status 状态
@@ -122,8 +122,7 @@ public class TransportCertRecordServiceImpl extends BaseServiceImpl<TransportCer
 	 * 认证对象检索条件：按提交时间倒序
 	 * <p>
 	 * 排序用 {@code submit_time} 而非框架默认的 {@code create_time}，是刻意为之：
-	 * 「认证记录」的业务时间轴是<b>提交</b>，ticket 02 明确要求
-	 * 「查询某辆车的认证记录列表：按提交时间倒序」。
+	 * 认证记录的业务时间轴是<b>提交时间</b>，列表需按提交时间倒序展示每次提交。
 	 *
 	 * @param bizType 认证对象类型
 	 * @param bizId   认证对象主键