Bläddra i källkod

docs(进件): Task 4 自校 - reportQuery 里「码 2 是审核驳回」那句改成两种读法都成立(零行为改动)

self-review 发现的一处自相矛盾:同一段 javadoc 上面刚写「本页两套 0–6 映射互相冲突,
任何映射都是在挑一套猜」,下面 15 行却把码 2 单读成「审核驳回」(只按返回参数表那套读的)。
测试文件里同一句话(unknownCode 用例的 javadoc)同病。

改法:两处都写成**两种读法下结论都成立**的形式 —— 码 2 在本页两套映射里各有含义
(一套「审核驳回」、另一套「重新修改信息进件」),而 LsyReviewStatus 的码只有
0/1/9/10/98/99、没有 2 这一项 ⇒ 两种读法下复用都错。R41 的裁定(不要复用该枚举)不变,
变的只是这句举例的射程。

措辞溯源:原句是照 R41 裁定里「码 2 在 196236564 是「审核驳回」」那句写的。该句作为
**举例**成立(返回参数表确实这么写),但它比同一段 javadoc 的论断层窄了一档 —— 记在
报告的偏离项里,由主控裁定是否也订正裁定原文。

验证:git diff 只落在 javadoc 行(非注释改动行 = 0);
全量 547 → 547,0 fail / 0 error / 0 skipped,BUILD SUCCESS。
alphaH 3 veckor sedan
förälder
incheckning
f616fea1e3

+ 3 - 2
java/src/main/java/com/payment/platform/module/payment/leshouying/service/LsyOnboardingService.java

@@ -628,8 +628,9 @@ public class LsyOnboardingService {
      * {@code LsyReviewStatus} 的类注释**逐字**写着「★ <b>本枚举不通用 —— 不得拿它去解别的接口的
      * {@code reviewed_status}。</b>」,它自己的类注释也明写「入网状态那一套({@code reportQuery})
      * 属三-B,用到时另建,不要扩本枚举」。
-     * 复用会**静默**给出错误文案(不抛、不红):码 {@code 2} 在本页是「审核驳回」,
-     * 而在那套值域里**没有对应项**。
+     * 复用会**静默**给出错误文案(不抛、不红):码 {@code 2} 在本页**两套映射里都不是那套值域
+     * 能表达的东西**(一套读「审核驳回」、另一套读「重新修改信息进件」,而该枚举的码只有
+     * {@code 0 / 1 / 9 / 10 / 98 / 99},**没有** {@code 2} 这一项)—— 两种读法下复用都错。
      *
      * <p><b>【{@code channel_id} 取自配置,不是形参】</b>本页参数表里它的说明**逐字**是
      * 「由客户经理提供,**同创建商户接口**」—— 与创建腿**同一个值**,而创建腿取的就是

+ 3 - 2
java/src/test/java/com/payment/platform/module/payment/leshouying/service/LsyOnboardingServiceTest.java

@@ -2365,8 +2365,9 @@ class LsyOnboardingServiceTest {
      *
      * <p>换句话说本用例就是那条陷阱的探测器:谁把 {@code LsyReviewStatus} 接进来做映射
      * (「长得非常像的现成枚举」,顺手复用是最可能发生的错),{@code 9} 这一格立刻红
-     * —— 码 {@code 2} 在**本页**是「审核驳回」,而在那套值域里根本没有对应项,复用会**静默**
-     * 给出错误文案(不抛、不红)。所以本方法返回的是**原始字符串**,不是任何文案。
+     * —— 码 {@code 2} 在**本页两套映射里**各有各的含义(一套「审核驳回」、另一套「重新修改信息
+     * 进件」),而那套值域**没有** {@code 2} 这一项,复用会**静默**给出错误文案(不抛、不红)。
+     * 所以本方法返回的是**原始字符串**,不是任何文案。
      */
     @Test
     void reportQuery_returnsRawStatus_forUnknownCode() {