Selaa lähdekoodia

docs(进件): 三-A 新文档缺陷按 Step 4 补进 §6.2

补做 Task 7 Step 4 的第二条:「若发现新的文档缺陷:追加进 **§6.2**,不要默默绕过」。
`dcb4f96` 只把这两条写进了新开的 §6.6.2,§6.2(文档缺陷登记表)里没有 —— 扫 §6.2
找文档问题的人会漏掉它们。这一笔把两条按页补进 §6.2 (e) 表,evidence 仍留 §6.6.2:

- 获取省市区 196236568:**每级各有一个未记录的返回字段**(level1 `province_code` /
  level2 `city_code` / level3 `county_code`,GB 行政码,String)。是**缺漏**不是矛盾。
  三-A 用不到,三-B 要 ⇒ 届时给 DTO 加这三个字段。
- 获取省市区 196236568:**`parent_code` 传错不报错**,回 `SUCCESS` + 空 `area_list`。
  这是**静默失败**,会被读成「上游没数据 / 上游挂了」,所以既要进 §6.6 也要进 §6.2。

Step 4 的另一条(R-2 翻转则改常量 + 反转断言)**不适用**:R-2 已由真机定案为
「上游认参数表那版」,未翻转,故无代码改动。本提交仍是**纯文档**,0 行删除、2 行新增。
alphaH 3 viikkoa sitten
vanhempi
sitoutus
5d178ae06a
1 muutettua tiedostoa jossa 2 lisäystä ja 0 poistoa
  1. 2 0
      docs/superpowers/specs/2026-09-22-receive-workbench-design.md

+ 2 - 0
docs/superpowers/specs/2026-09-22-receive-workbench-design.md

@@ -465,6 +465,8 @@ GET /payment/cashier/{codeNo}/auth
 | 创建门店 196236559 | **参数表写 `manager_name` / `manager_phone`,同页请求示例写 `maneger_name` / `maneger_phone`**("maneger" 是错拼) | ~~签名相关:发错键名上游可能直接判「参数不合法」~~ → **2026-09-22 真机定案:按参数表拼写真发成功**(返回 `shop_no`),上游认参数表那版 ⇒ **不构成缺陷,无需改动**。见 §6.6 |
 | 获取省市区 196236568 | `level` 参数表写 `String`,请求示例写**数字** `3` | 轻微。~~发字符串即可~~ → **实测(2026-09-22):`level` 发字符串 `"1"/"2"/"3"` 全部可用**,返回省 / 市 / 区县三级均非空。见 §6.6 |
 | 获取省市区 196236568 | 返回**示例**里 `area_code` 出现 `100A`…`100H`(其中 `100G`/`100H` 不是合法十六进制) | ★ **原判「真实形态不是纯数字 / 会炸」不成立 —— 那是文档示例的形状,被当成了服务行为。2026-09-22 真机普查:`area_code` 是 `Integer`,483/483,非数字 0 条**(见 §6.6)。**仍按 `String` 承载**,理由是实测撑得住的:① `area_code` 要被**原样回传**给上游的 `parent_code`(那是 String 参数);② `asText` 的 `String.valueOf` 对 Integer **无损**。**不是**因为「它可能是 `100A`」 |
+| 获取省市区 196236568 | ★ **每级各有一个未记录的返回字段**:level1 `province_code`、level2 `city_code`、level3 `county_code`(GB 行政码,**String**);文档三级都只记了 `area_name` / `area_code` | 是**缺漏**不是矛盾。三-A 用不到;**三-B 要**(进件要 `address_province` / `address_city` / `address_county`)⇒ 届时给 DTO 加这三个字段。读数见 §6.6.2,缺口见 §6.6.3 |
+| 获取省市区 196236568 | ★ **`parent_code` 传错不报错**:回 `SUCCESS` + **空 `area_list`**(实测填 GB 码 `110000` 而非上级的 `area_code` 就是这个结果);文档未提 | **排障陷阱**:某级忽然空了会被读成「上游没数据 / 上游挂了」。**静默失败**,故记在此而非只留在 §6.6。见 §6.6.2 与 §6.6 表 #2b |
 | 获取门店列表 196236560 | 返回参数表 `result_code` 一行的「参数示例」列写着 `PAY_SUCCESS`,与同一行的说明「SUCCESS操作成功,FAIL操作失败」**自相矛盾**(支付类页面复制残留) | 无(说明与返回示例一致,取 `SUCCESS`/`FAIL`) |
 | 获取门店列表 196236560 | 返回示例里 `"trace_no": "123456"` 后面**缺一个逗号**,整段是**非法 JSON** | **会误导**:谁照抄这坨当夹具,Hutool 会解析失败,而失败原因看起来像「上游报文坏了」。同时 `shop_list` 第二项**没有 `shop_tel` 键** |
 | 获取商户信息 196236558 | `wx_channel_rate` / `ali_channel_rate` 在返回参数表里**各出现两次**;返回示例里 `merchant_type` / `account_type` / `license_type` / `wx_channel_id` 是**数字**而表里写 `String` | 轻微,读时按 `String.valueOf` 归一 |