docs: sync reviewed public manuals

Sync manuals, navigation and screenshots from open-source c8fa783 while preserving public README, LICENSE and history.
2026-10-26 16:10:40 +08:00
parent 92f239fcc4
commit 19455e1cbc
152 changed files with 812 additions and 241 deletions
@@ -0,0 +1,41 @@
+# 通道与接入管理
+
+本章仅供有接入维护权限的平台管理员使用。企业日常查卡、诊断及业务受理通常不需要修改通道。入口为左侧菜单中的“通道模板”和“通道管理”。
+
+## 通道模板
+
+![通道模板查询入口](/images/manual/channel-template-query.png)
+
+1. 按模板标识、名称、模型或状态查询已有模板，优先使用已确认可用的模板。
+2. 新增时填写模板标识、名称、模型、状态及模板配置。
+3. 模型包括 `shared_token` 和 `direct`；必须与实际上游接入方式匹配。
+4. 模板配置按对应接入实现要求填写有效 JSON，保存后重新查看配置。
+
+模板影响引用它的通道。变更前核对关联通道和兼容性，不在公开手册、截图或工单里展示真实密钥。
+
+## 新增与维护通道
+
+![通道管理中的新增入口](/images/manual/web/channel-add-entry.png)
+
+1. 在“通道管理”新增，填写通道名称、别名、编号、运营商及模板。
+2. 按模板要求配置应用标识、密钥、地址等接入信息，不将凭证填入名称或备注。
+3. 分别核对通道状态、是否正常、是否轮询、共享 Token 及对接信息；这些配置含义不同，不能互相代替。
+4. 保存后打开详情核对，并使用通道测试验证上游返回。
+5. 需要时使用“刷新卡数量”，再核对库存、已出库及已销户数量。
+
+未开启共享 Token 的通道修改编号时，系统会提示迁移关联数据并刷新通道实例。确认前核对旧编号、新编号和关联业务，不把它当作仅修改显示名称。已开启共享 Token 的通道不能在页面修改编号。
+
+## 通道测试
+
+1. 在目标通道点击“测试”，选择“单码直测”“单码补全”或“完整三码”。
+
+   ![通道管理列表中的测试入口](/images/manual/channel-test-entry.png)
+
+2. 单码模式选择 ICCID、IMSI 或 MSISDN 并输入对应值；“单码直测”直接使用所填号码调用查询接口，“单码补全”会先查询完整卡信息再测试。“完整三码”需填写同一张卡的 ICCID、IMSI 和 MSISDN。部分电信接口只能按 MSISDN 查询，测试前应选用适合该通道的模式。
+
+   ![通道测试中的单码直测、单码补全和完整三码模式](/images/manual/web/channel-test-modes.jpg)
+
+3. 选择全部测试项或单项测试。测试项包括基础信息、实时会话、卡状态、停机原因、冻结、机卡绑定、设备、区域限制、IMEI、流量及 APN 等。
+4. 执行后逐项查看成功、失败或超时结果。需要重试时先核对失败原因，只重试相关项目。
+
+某一查询成功不代表所有上游能力均已支持。测试失败时核对模板、凭证、请求地址、上游授权和卡片所属通道，避免高频重复请求。