feat: remediate HTTP API reliability and developer documentation

2026-09-14 12:48:10 +08:00
parent d13ca0713a
commit f0e843436c
33 changed files with 3332 additions and 452 deletions
@@ -5427,3 +5427,21 @@ TC-DRAINAGE-GATE-01～16的实现范围以专项方案第10节为准，不再笼


 TC-CHANNEL-WORD测试部署验收：应用8e4bc5a；新Tab/API200真实空词库、已有管理员登录、三尺寸弹窗显式关闭、刷新/跨路由和历史短信详情通过。线上未保存规则，写操作/并发/路由组合仍以隔离PG证据为准；真实供应商Submit/客户回执ACK/费用流水用例未执行。详见release-20260910-test-channel-sensitive-words.md。
+
+## TC-HTTP-REMED-IMPL-20260914
+
+| 编号 | 场景与判定 | 已取得证据 / 边界 |
+|---|---|---|
+| R01 | 五行LF/GET{}、原UTF8字节、固定向量、nonce重放和篡改 | 定向单测及隔离真实HTTP/Redis通过；不切换协议 |
+| R02 | 自动重试任务编号、真实首次500后60秒再200、尝试/退避落库 | 独立PG15439/Redis16389及受控HTTP接收端通过；传输DI仅隔离接收端，不改生产SSRF限制 |
+| R03-A | Redis入队失败后DB事件/投递仍存在，扫描恢复；legacy版本0不自动投递 | 隔离真实PG/Redis通过；非历史业务维护 |
+| R03-B | 消息/响应快照/待办同事务；待办写入故障回滚，未知结果重放不重建 | 真实PG事务集成通过，前置分类/计费以隔离依赖替代；未作真实发送/计费验收，未入队短信 |
+| R03-C | 多实例认领失败不派发；已取消/发送中/终态/待审不再入队 | 定向恢复单测通过；不冒充生产并发容量结论 |
+| R04 | 四接口schema、七query、幂等头不重复、User-Agent可选、clientMessageId string/null、回调schema、非法字段/limit/cursor/date | 生成契约测试及隔离真实HTTP边界通过 |
+| R05/R07 | 未知依赖错误固定公共文案，首次/重放一致，X-Request-Id与有界安全日志定位 | 定向测试通过；故障日志无正文/Secret/完整签名；新查询日志复用原协议日志 |
+| R06 | 上行详情与列表公共字段一致；跨企业应用404，不含通道/供应商/内部诊断 | 真实HTTP/PG及字段投影测试通过；按用户要求直接收紧旧输出 |
+| R08-A | 共用阅读器、三尺寸、检索无结果、复制成功/失败、示例切换、MD同字节、刷新 | 本地实际文档HTTP阅读器与隔离Edge 1600×1000/1366×768/390×844通过，无整页溢出、pageerror=[] |
+| R08-B | 客户端无应用/配置失败通用正文、应用私有参数不进入公开URL | 组件测试通过；现有已登录客户端/其余Tab的真实目标环境验收未完成 |
+| R09 | 默认24小时、应用跨度与分页上限；不实现留存清理 | 查询定向与真实隔离分页通过；历史留存清理未执行 |
+
+候选完整门禁、精确版本及测试发布另见testing-progress.md。浏览器连接器本轮实际返回nodeRepl.fetch request failed；隔离浏览器使用已有Edge二进制，不操作用户浏览器配置或会话。外部证据在本机TEMP/cmpp-http-remediation-20260914和测试机独立/tmp/cmpp-http-remediation-inqN9k，不提交测试凭据、快照或客户数据。