feat: remediate HTTP API reliability and developer documentation

docs/testing-progress.md

@@ -4909,3 +4909,16 @@ git diff --check
 应用`8e4bc5a20e4d98e96fc8572fabbac149ba12c8e6`已本地提交，并通过标准工具部署测试；精确归档validate为API69套745项、前端28套139项及门禁通过。13项服务active，三个Stream pending/lag=0，消息119509/提交130769前后未变，新增迁移/HTTP产物摘要/日志验证通过。已有管理员正常登录、新Tab真实空词库API200、三尺寸显式关闭/刷新/跨路由/历史详情通过；没有保存线上词库或发送短信。观察器同名关闭按钮修正后通过，原失败保留。
 
 [发布验收与容量清单](release-20260910-test-channel-sensitive-words.md)记录精确版本、工具未提交摘要、独立备份、47目录盘点和时间。prepare56.5秒、备份35.2秒、停止至恢复17.0秒；系统盘可用10.35GB→8.81GB、使用率92%，增量约1.54GB，旧版本/候选/备份均未清理，容量治理未完成。未推送、未部署预生产，实际发送/客户回执ACK/费用流水与完整吞吐未执行。
+
+## 2026-09-14 HTTP整改代码与隔离验收（提交前）
+
+- 授权：按http-api-assessment-20260910.md整改，提交、推送、部署测试；不操作预生产，不发送/补发/重投/入队短信，不改现有余额、通道、客户配置或恢复账号。
+- 开工本地main/实际远端d13ca0713abd6afbea5a62af39bcbb876b8bb186、0/0、staged为空；保护metrics、tools/release及全部旧文档/工具草稿。测试SSH已实查，应用8e4bc5a20e4d98e96fc8572fabbac149ba12c8e6、系统盘可用24,643,088,384字节、76%；没有/data目录，sudo -n需要密码。仅测试环境，预生产版本未在本轮重新核验。
+- 实现：共享签名/固定GET兼容、DTO/schema/query、未知错误公共化和交互ID；上行仅公共字段，按用户决定移除通道/供应商/内部匹配信息。确定性HTTP消息与受理快照/发送待办同事务；不确定结果requires_review，不自动重建。回调事件/投递同事务，新版本待办恢复、租约、尝试/退避同事务和无冒号任务编号，历史记录不回填。新迁移只追加，应用回退不会删除待办，但旧应用不识别新待办，回退前必须核对排空或保留后续恢复安排。
+- 文档阅读器：公开/api/client-docs及原JSON地址保留；客户端同源iframe复用单一MD和阅读组件，文档HTML内嵌所需样式/脚本，无需扩大Nginx资源白名单。版本从MD元数据读取。补应用切换过期响应保护及无配置阅读状态；原业务Tab不主动改变操作语义。CSS所有权已登记。
+- 本地验证：首次API生成缺少隔离NODE_ENV/DATABASE_URL失败，补明确隔离环境后Prisma generate/API构建通过。HTTP定向最终4套47项通过；工作区API全量此前71套779项、前端29套141项通过（含保护中的旧metrics修改，不作为精确发布候选证据）。前端生产构建、类型检查、入口gzip107.17KiB/250KiB门禁、部署/安全检查通过。CSS首次漏登记所有者失败，登记后CSS治理15项和stylelint通过。旧文件未用import造成lint失败，限定本轮触及文件清理无用import后通过；未改保护文件以消除失败。
+- 隔离真实验证：测试机新建PG15439与Redis16389，仅127.0.0.1及/tmp/cmpp-http-remediation-inqN9k。实际Nest控制器+鉴权+Prisma完成GET签名、分页、跨租户404、nonce/篡改、参数拒绝和上行字段核对；合成回调在受控Redis发布失败后恢复，首次HTTP500、60秒后HTTP200，PG尝试[500,200]，历史version0未重投。该轮0短信/0供应商Submit。另真实PG事务测试用隔离前置依赖核对待办故障回滚及202原子快照，保留1条合成消息fixture，未冻结/扣费、未入队短信，不能当发送业务验收。
+- 迁移：隔离数据库从HEAD schema执行追加迁移通过，历史写法兼容进一步核验单列证据。恢复资产不删除；不做生产数据回填。
+- 页面：cua.getState本轮仍返回nodeRepl.fetch request failed，不能推断未登录。使用已有Playwright+Edge独立无头上下文验收本地实际文档页，三尺寸、复制/失败降级、检索/空结果、示例切换、MD下载同字节与刷新通过，pageerror=[]。未用隔离文档页冒称测试环境已登录客户端及其他Tab全部通过。
+- 证据：本机TEMP/cmpp-http-remediation-20260914（保护摘要、targeted/api-full/frontend-full/http-final、browser-result、截图、integration-result、事务及迁移脚本）；独立测试进程已按确切cwd/PID停止，PG/Redis临时实例与目录保留待本轮收尾。只读测试环境SSH有一次超时，成功与失败分别记录，不归因于Git或密码。
+- 当前状态：本地代码/设计/手册/用例完成本阶段；尚未本轮提交/推送/测试部署，未部署预生产。下一步仅暂存本轮代码、两份HTTP专属文档及三个台账新增段落，从精确提交跑标准release validate，再推送与测试preflight/prepare/deploy/verify。测试sudo需标准掩码入口，真实短信正向/计费与已登录客户端最终验收仍未执行。