Jelajahi Sumber

docs(接入文档): 两条通道改叫「支付宝收单」「银联收单」,并把银联那组露出来

用户裁定:「门店与订单改为支付宝收单;新增银联收单,就是 lsy 相关」。

- 侧边栏分组标题:`门店与订单` → `支付宝收单`,`收付款接口` → `银联收单`。
  两个 `<h3>` 是**硬编码在本文件里的分组标题**,不来自 md ⇒ 改名碰不到切片器
  那条「标题对不上就整条消失」的契约(那条契约管的是 `parts` 里那些 `##` / `###` 标题)。
- `SHOW_COLLECTION_DOC` 由 `false` 翻成 `true`。2026-09-24 按通道拆文档时这一组留了个开关
  没露出,正文、切片器、分组当时都已就位 —— 这里只翻开关,md / 切片器 / 模板结构一行没动。

露出来之前先确认那一组**不是空的**:`buildSections` 的契约是「标题对不上就整条不渲染」,
而这一组正好踩过「侧边栏渲染成一个空 ul」的缺陷(CRLF 打穿按行解析,已修)。
所以另跑了一次执行级验证(`logs/_lsy-doc-verify.mjs`,esbuild 把真
`collectionDoc.ts` / `harDoc.ts` 打成一个包再 `import()`,读的是页面运行时读的同一批值):

  银联收单 10 条,每条都有正文(529 ~ 9411 字符,都含标题行),
  支付宝收单 1 条(`har_endpoints`,10279 字符),两组 key 无重名。

★ 未改的一处,留给人裁定:`支付宝收单` 组里那唯一一条条目的标题仍是 `门店与订单`
(它在 `harDoc.ts` 的 SECTIONS 里,也是正文面板上方的标题)。用户那句话的字面对象是
侧边栏上那个分组——改动前分组与条目**都**叫「门店与订单」,而 3.1 / 3.2 两句是在
并列地说「一个改名、一个新增」,指的是分组。要不要把条目也改掉,一句话即可。
md 里的 `## 10. 门店与订单接口` 是切片锚点,不能动。
alphaH 2 minggu lalu
induk
melakukan
459187a6fd
1 mengubah file dengan 13 tambahan dan 8 penghapusan
  1. 13 8
      frontend/src/views/module_payment/apikey/index.vue

+ 13 - 8
frontend/src/views/module_payment/apikey/index.vue

@@ -446,9 +446,9 @@
                 两条通道是两个产品、两份文档,不合并(2026-09-24 拆分)。
               -->
 
-              <!-- 门店与订单(harDoc.ts ← docs/har-openapi.md) -->
+              <!-- 支付宝收单(harDoc.ts ← docs/har-openapi.md)—— 2026-09-30 由「门店与订单」改名 -->
               <div class="sidebar-section">
-                <h3>门店与订单</h3>
+                <h3>支付宝收单</h3>
                 <ul>
                   <li
                     v-for="(section, key) in harSections"
@@ -461,9 +461,9 @@
                 </ul>
               </div>
 
-              <!-- 收付款接口(collectionDoc.ts ← docs/collection-openapi.md)—— 见 SHOW_COLLECTION_DOC -->
+              <!-- 银联收单(collectionDoc.ts ← docs/collection-openapi.md)—— 2026-09-30 由「收付款接口」改名并露出 -->
               <div v-if="SHOW_COLLECTION_DOC" class="sidebar-section">
-                <h3>收付款接口</h3>
+                <h3>银联收单</h3>
                 <ul>
                   <li
                     v-for="(section, key) in collectionSections"
@@ -1409,13 +1409,18 @@ const activeTab = ref("management");
 const activeSection = ref("auth");
 
 /**
- * 「收付款接口」这一组是否露出。
+ * 「银联收单」这一组是否露出。
  *
  * 2026-09-24:文档按通道拆成两份(收付款 / 门店与订单),两者是不同产品,不再混在一起。
- * 本批只上「门店与订单」,收付款那一组暂不露出 —— 正文、切片器、分组都已就位,
- * 要放出来把这里改成 true 即可,不需要动 md、切片器或模板。
+ * 当时只上「门店与订单」那一份,收付款那一组留了个开关没露出。
+ *
+ * 2026-09-30:用户裁定两组都上,并把叫法改成业务口径 ——
+ * 「门店与订单」→「支付宝收单」(汇安融通道)、「收付款接口」→「银联收单」(乐收赢通道)。
+ * 这里翻成 true。正文、切片器、分组本来都已就位,**没有动 md、切片器或模板结构**;
+ * 两个 `<h3>` 只是侧边栏的分组标题(硬编码在这份文件里,不来自 md),
+ * 所以改名不会碰到切片器的「标题对不上就整条消失」那条契约。
  */
-const SHOW_COLLECTION_DOC = false;
+const SHOW_COLLECTION_DOC = true;
 
 // 两条通道的正文合成一张查找表:正文渲染与卡片标题只认 key,不关心它属于哪一组。
 // 侧边栏仍按通道分两组渲染(见模板)。