Ver código fonte

docs(进件): 交付前引用复核 —— 两处行号漂移加注、补交付提交上的 652 绿读数

交付前把交付说明自己写的断言当断言复量了一遍(不读它的转述)。三处纯插入,未删改既有行
(`git diff --numstat` = 20 增 / 0 删):

1) §二 2.2 五跳表第 ③④ 跳:`index.vue` 写时是 800 行 / 31470 B、`:242`,
   现在 964 行 / 40192 B、`:270–271`(`4a67ffd` 把该文件写大了)。原读数保留、加注现读数,
   并补一条消歧:§七 也有一个 `index.vue:242`,那是模板渲染点、在 HEAD 上仍然正确 ——
   两个 242 指两件不同的事,别把其中任一个当成漂移。

2) §六-3 的 `:181/:183/:184`:那是 `5290d84^` 那一版的读数,当时正确;
   R-7b/R-7c 把该文件从 613 行写到 754 行,`createMerchant(body)` 现在在 `:191`。

3) §十:原那条 652 没写明跑在哪个提交。补一条**交付提交 `fe127af` 上的 652 绿**读数:
   `Tests run: 652, Failures: 0, Errors: 0, Skipped: 0` / `BUILD SUCCESS` / rc=0 / 27.3 s;
   第二支独立量法 = surefire XML 逐文件聚合(49 文件 / 652 / 0 / 0 / 0),
   配 `tests=` 属性正控(缺该属性的文件数 = 0);先 `clean` 所以无跨运行累积。
   能这样说是因为 `git diff --name-only 1af6ef2..HEAD -- 'java/**'` = 0 个文件,
   而同一支命令在 `663156f..HEAD` 上量到 36 个文件(量具是活的)。

两处漂移都不是「当时写错」而是「后来文件长大了」,所以不动原句、只加时点与现读数,
两条都真。本轮未动任何生产码。
alphaH 3 semanas atrás
pai
commit
20a222bf18

+ 20 - 0
.claude/plan/2026-09-23-lsy-onboarding-B-交付说明.md

@@ -95,6 +95,14 @@
 | ④ 组件名 | 该文件 `:242` `defineOptions({ name: "CollectionOnboarding" })` = DB 的 `route_name` **逐字相等** |
 | ⑤ 叶子判定 | `permission.store.ts:203` **只有叶子才挂组件**;页面下挂着 2 个 type=3 按钮 ⇒ 若按钮进路由树就不是叶子。**实测判否**:`UserService.java:623` 与 **`:636`** 两处都 `.in(MenuEntity::getType, List.of(1, 2, 4))` ⇒ **按钮被排除在建树之外** |
 
+★ **2026-09-23 复核:上表第 ③④ 跳的两个读数已漂,结论不变**(漂因是后来那次前端入口提交 `4a67ffd`
+把该文件从 **800 行 / 31470 B** 改成 **964 行 / 40192 B**):
+第 ③ 跳的 **31470 B** ⇒ 现在 **40192 B**;第 ④ 跳的 **`:242`** ⇒ 现在 **`:270–271`**
+(`defineOptions` 在 `:270`、`name: "CollectionOnboarding"` 在 `:271`,**逐字相等仍成立**)。
+⇒ 表里那两个是**写下时**的真读数,留着;**要照它去点开文件的话,用括号里的现值**。
+★ 别与 §七 的 `index.vue:242` 混:那是**模板渲染点**(`v-for="f in visibleFields(s)"`,HEAD 实测仍在 `:242`),
+与本表的「组件名」是两处不同的东西 —— 巧合同号。
+
 ★ **仍未证明的**:页面在浏览器里**渲染成功**(需登录态 + 后端在跑)—— 那是 §五 的 Step 3b。
 
 ---
@@ -266,6 +274,10 @@
    `LeshouyingOnboardingController` 也**没有**自己的 `@ExceptionHandler`。
    ⇒ `/create` 里 `onboardingService.createMerchant(body)`(`:183`)抛出的上游异常**不被** `:184` 那个 try 覆盖
    (它只包本地落库那一步)⇒ 逃逸成 catch-all 500。`:181` 之后、`:183` 之前无任何兜底。
+   ★ **2026-09-23 复核:这三个行号是「修复前那一版」(`5290d84^`)的读数,写下时逐行核对无误**
+   (当时 `:181` = `rejectBodySuppliedRateCode(body);`、`:183` = `String mchNo = onboardingService.createMerchant(body);`、
+   `:184` = `try {`)。**R-7b 与 R-7c 两次提交把该文件从 613 行长到 754 行** ⇒ 现在要照它去点开文件的话,
+   用现值:`createMerchant(body)` 在 **`:191`**。(**本行是那段保留原文的历史读数,不是「今天仍如此」**。)
    ★ **现成先例别漏**:`LeshouyingOpenController:301-309` 已有一条 `@ExceptionHandler(LeshouyingApiException.class)`
    (回 `Result.of(500, "处理未成功,请稍后重试")`)—— 但它是**控制器局部**的(类上是 `@RestController`,
    **不是** advice,见 `:266` 的注释解释了为何故意不用全局 advice)⇒ **只覆盖那 7 个 open API 端点**。
@@ -451,6 +463,14 @@
   相对上面 647 的增量 **+5** 已**定位到提交**:`git show 1af6ef2 -- '*/src/test/*' | grep -c '^+.*@Test'`
   = **5**(R-7c 的 `POST /update` 那组用例);同法量 `5290d84`(R-7b)= **2**,与 645→647 的 +2 对得上。
   ★ 上面 645 / 647 两行**保留不动** —— 它们是各自时点的真读数,本行只是把链子接到今天。
+- ★ **2026-09-23 在交付提交 `fe127af` 上又复跑一次:仍是 652 绿**
+  (`Tests run: 652, Failures: 0, Errors: 0, Skipped: 0`、`BUILD SUCCESS`、rc=0、27.3 s)。
+  **两支独立量法同值**:① Maven 控制台汇总行;② `target/surefire-reports/*.xml` 逐文件聚合 =
+  **49 个文件 / tests 652 / failures 0 / errors 0 / skipped 0**,且**每个 XML 都带 `tests=` 属性**
+  (正控:无该属性的文件数 = **0**)⇒ 不是「0 个文件求和得 0」那一型。先 `clean` ⇒ 报告目录 mtime 全是本次。
+  ★ **能这样说的依据是实测不是推断**:`git diff --name-only 1af6ef2..HEAD -- 'java/**'` = **0 个文件**
+  (即 R-7c 之后 java/ 一个字没动;同一支命令在 `663156f..HEAD` 上量到 **36** 个文件 ⇒ 量具是活的)。
+  ⇒ 本条的用处:给出**交付提交上的读数**(上面那条 652 没写明跑在哪个提交)。
 - **两个注释修复提交 `70bb22a`、`2663020` 也都是 645 绿**(BUILD SUCCESS)。
   两者**「逐字节无行为变化」的完整证据**(`2663020` 这一版**两侧的 class 读数都是我自己采的**):
   ① 行数不变(CR=1485 / LF=1485,无孤立 CR/LF,行尾仍 CRLF)⇒ `LineNumberTable` 不变;