docs: record channel sensitive words test deployment

2026-09-10 16:11:13 +08:00
parent 8e4bc5a20e
commit d13ca0713a
5 changed files with 136 additions and 1 deletions
@@ -1,6 +1,6 @@
 # 通道敏感词需求评估与实施方案
-日期：2026-09-10。状态：已按用户授权完成本地实现及验证，待本地提交与测试部署；线上结果见测试进度。用户要求在敏感词页面新增“通道敏感词”Tab，按通道配置，短信命中时不走该通道。本方案补充[风控设计](phase-6-risk-review-plan.md)和[发送链路设计](phase-4-send-pipeline-redesign.md)，不替代平台全局敏感词或[引流门禁](drainage-send-gating-plan-20260910.md)。
+日期：2026-09-10。状态：已实现、本地提交并部署测试环境；应用8e4bc5a，验收与未执行项见测试进度。用户要求在敏感词页面新增“通道敏感词”Tab，按通道配置，短信命中时不走该通道。本方案补充[风控设计](phase-6-risk-review-plan.md)和[发送链路设计](phase-4-send-pipeline-redesign.md)，不替代平台全局敏感词或[引流门禁](drainage-send-gating-plan-20260910.md)。
 用户已明确基于性能考虑，第一版不做入队后的通道敏感词复核。以下方案已按“仅在选路时过滤”修订，替代初稿的逐片复核、发送授权锁及配置变化触发重选设计；既有引流门禁保持原有行为。
@@ -91,3 +91,6 @@
 本地证据：API全量69套745项通过，后追加非CMPP恢复测试后对应发送链138项通过；前端28套139项通过。API类型/构建、前端production构建、lint（既有28警告，无错误）、格式、CSS、依赖安全、bundle门禁通过。新增tools/testing/verify-channel-sensitive-words.mjs在隔离本地PostgreSQL克隆中验证迁移、真实管理服务并发、普通/100条微批选路、失败SQL耐久标记、原文不变和客户数据隔离；微批通道词SQL读取1次、决策写1次，样本390～441ms包含既有引流处理，不是物理发送TPS。
 生产构建+真实Nest API+隔离PostgreSQL/Redis的Edge浏览器通过三尺寸新增/编辑/启停/软删除、Tab筛选保持、显式关闭、刷新/跨路由及历史选路原因；pageerror=0。浏览器鉴权使用真实Redis7隔离前缀，未启用短信Worker或Gateway传输；fixture的在线状态仅用于隔离路由验证，不作为真实供应商连接证据。实际短信发送、供应商零Submit、客户回执ACK、费用流水闭环及实际吞吐未执行，不以隔离结果替代。
 发布收尾：测试应用8e4bc5a已完成标准部署和真实页面只读验收，详见[发布报告](release-20260910-test-channel-sensitive-words.md)。未推送、未部署预生产，未保存线上通道词或发送短信。
@@ -361,3 +361,8 @@ npm run prisma:generate、API 生产构建，以及线上 api/dist、api/node_mo
 测试100.93.204.60已由809175b544f2526891ba6d2dece1a50eadaf57a0发布至0c3f820cc92eeae8c996ac7d6d8d6db98e049ea7，标准计划20260910T053026-0c3f820cc92e-76f98ff4。用户单独批准修复cmpp-security-agent缺少运行目录：新增/etc/systemd/system/cmpp-security-agent.service.d/runtime-directory.conf，声明RuntimeDirectory=cmpp-security-agent、RuntimeDirectoryMode=0750；目录root:cmpp-security，保留原沙箱限制。模板尚未同步，未整机重启验证；本机drop-in已持久保存并通过服务重启。
 [发布证据与完整资产清单](release-20260910-test-drainage.md)记录恢复点、工具摘要、13项服务/数据库/队列/真实页面验收、磁盘11.85GB→10.37GB可用和既有资产保留。测试无独立数据盘，不套用预生产迁盘结论。应用已部署、仅本地提交；未推送、未预生产部署、未发送或补发短信。
 ## 2026-09-10 通道敏感词测试发布
 已按用户授权使用标准入口将测试应用从0c3f820更新为8e4bc5a20e4d98e96fc8572fabbac149ba12c8e6。计划20260910T075122-8e4bc5a20e4d-0e177bfe，前端/API及一项增量迁移，7个Node服务更新，Gateway保持原进程。独立备份、13服务、迁移/资源/日志/队列及真实管理员页面通过；详细恢复路径、容量增量、未执行项见[本次验收](release-20260910-test-channel-sensitive-words.md)。系统盘可用8.81GB（92%已用），资产未清理；此记录不授权清理、推送或预生产。
@@ -0,0 +1,117 @@
 # 通道敏感词测试发布验收（2026-09-10）
 ## 交付与授权
 应用提交`8e4bc5a20e4d98e96fc8572fabbac149ba12c8e6`已本地提交，并于2026-09-10 16:03:45 CST部署测试机`100.93.204.60`，基线`0c3f820cc92eeae8c996ac7d6d8d6db98e049ea7`。只授权测试环境；未推送，未部署预生产。后续仅文档提交不需要再次切换应用。
 [方案](channel-sensitive-words-plan-20260910.md)第一版已实现：敏感词页独立Tab及真实CRUD、通道候选排除、普通/微批同快照检查、运营端历史原因和无路由失败完成恢复。不增加Gateway/逐片复核；已读取规则快照的微批和已选路消息不追溯配置变更。现有全局词库和引流门禁保留。未修改线上词库、原通道/客户配置或余额，没有发送/补发/重投/重新入队短信。
 ## 版本和标准发布证据
 - 标准计划`20260910T075122-8e4bc5a20e4d-0e177bfe`，planHash`ac7a5d317f948c75e2f7e4f73745e8f27ea3db51783cf88d9d485bd19bcc702e`；完整执行plan→validate→preflight→prepare→deploy→verify→status→report。
 - 应用包SHA256`0357647cf2a80154b7dbf37711b5745618436c8acfedaf12d8df178f2dec8494`，历史基线CRLF格式通过逐文件摘要核验。相对线上28个文件变化：本轮26个文件，加前一文档提交的部署说明/引流验收文档，无额外运行代码。
 - 发布工具`tools/release/`仍未提交，toolHash`e0220a990afc6b3d0fb791dd71e9ab37d2687cbd0272ae05c2e0bffd0d06b5d9`，不以应用提交冒称工具版本，也未夹带该草稿。
 - 精确提交独立归档validate：前端28套139项、API69套745项，类型、格式、lint、CSS门禁通过。工作区production前端/API构建、安全和bundle门禁通过，lint既有28警告、0错误；未改Go。
 - 本地证据`%TEMP%/cmpp-channel-sensitive-implementation-20260910/`，发布工具证据`.local-data/releases/20260910T075122-8e4bc5a20e4d-0e177bfe/`；计划、state、validation和报告均保留。
 ## 真实功能及环境验收
 本地隔离PostgreSQL克隆`cmpp_qa_channel_words_1789025601486`已应用新增迁移，真实管理服务验证参数、权限、唯一约束、并发version冲突、启停/删除恢复和审计；真实普通/100条微批排除A选B，全部命中返回专用原因，保留原文/历史快照且客户端无通道词详情。每批新增词库读1次、决策写1次，390～441ms含既有引流处理，不是实际发送TPS。真实失败SQL在注入费用释放失败后保留独立完成标记；费用与回执幂等/恢复分支有隔离单测。
 本地production构建+真实Nest API/PG及隔离Redis认证，Edge三尺寸1600×1000、1366×768、390×844完成新增/编辑/启停/软删除、独立筛选保持、显式关闭、刷新/跨路由、历史原因验收，pageerror=0。没有运行短信Worker/Gateway传输；夹具连接状态仅支持隔离路由验证。
 部署后使用已有验收管理员正常登录，`GET /api/admin/dictionaries/channel-sensitive-words?page=1&pageSize=25`返回200、items=[]、total=0；新表初始为空，未保存线上规则。三尺寸新Tab、显式关闭、刷新/跨路由及历史短信详情兼容通过；最终浏览器记录errors=[]。首次观察器因右上角和页脚两个“关闭”按钮同名发生strict selector错误，明确选择页脚按钮后通过，保留原失败记录`live-after.log`及成功`live-after2.log`，不是应用Bug或网络失败。
 2026-09-10 16:05:30 CST标准verify回读：13项服务active；Gateway/security-agent未重启，7个相关Node服务按计划更新。API健康、102项迁移含`20260910160000_channel_sensitive_words`及前端资源摘要通过；PostgreSQL/Redis/MinIO服务健康。三个Gateway Stream pending/lag均0；消息119509、提交130769，前后未变。受保护文件无变化，journal警告和应用日志新增errorMarkers均0，verify warnings=[]。工具的businessAcceptance仍显示“未执行”，原因是第一期没有业务页面验收写入入口；本节独立记录真实浏览器证据，不修改工具状态冒充自动验收。
 ## 恢复资产和时间
 独立备份`/var/backups/cmpp-platform/20260910T075122-8e4bc5a20e4d-0e177bfe-attempt-1789027371632202403`，包含PostgreSQL dump/目录、Redis RDB、原源码/产物及系统配置，清单摘要与可读性通过；未做实际恢复演练。应用回退会失去通道词过滤，回退不删新数据、不自动重投。
 | 阶段 | 实测耗时 |
 |---|---:|
 | 精确提交本地validate | 约7分38秒，含锁定依赖安装和全量测试；与远端服务停机分开 |
 | 远端prepare | 56.5秒 |
 | 独立备份 | 35.2秒 |
 | 停止受影响服务至启动恢复 | 17.0秒（含迁移及切换） |
 | 其中迁移 | 1.2秒 |
 | deploy内verify | 4.7秒 |
 本地实施及真实集成/浏览器验证另行完成，不把整段工作会话称作部署耗时。远端发布各阶段无失败/重试；浏览器选择器修正与登录/观察时间单独留证，未精确拆分的浏览器总耗时不编造。
 ## 容量与资产保留
 测试机只有`/dev/sda2`系统盘，未挂载独立/data。发布前2026-09-10 15:48:29 CST、发布后2026-09-10 16:05:54 CST分别盘点47个根目录及其子目录，见inventory-before.json / inventory-after.json。df：可用10348167168→8812388352字节，减少1535778816字节（约1.54GB），使用率90%→92%。此增量含同时发生的正常数据/日志增长；目录实占不应重复相加。
 | 分类/实际路径 | 发布前字节 | 发布后字节 | 增量字节 |
 |---|---:|---:|---:|
 | `/opt/cmpp-platform` | 1023991808 | 1025716224 | 1724416 |
 | `/opt/cmpp-releases` | 6464483328 | 7495319552 | 1030836224 |
 | `/var/backups/cmpp-platform` | 4564557824 | 5060235264 | 495677440 |
 | `/var/log` | 946245632 | 946380800 | 135168 |
 | `/home/hector/.npm` | 611745792 | 611745792 | 0 |
 | `/root/.npm` | 622092288 | 622174208 | 81920 |
 | `/var/lib/postgresql` | 2658304000 | 2658480128 | 176128 |
 | `/var/lib/redis` | 225660928 | 225656832 | -4096 |
 | `/var/lib/minio` | 563314688 | 563462144 | 147456 |
 本次新增发布目录内资产（与当前程序同一文件系统；以下子目录已包含在上表，不再求和）：
 | 路径 | 字节 | 版本/保留理由 |
 |---|---:|---|
 | `/opt/cmpp-releases/20260910T075122-8e4bc5a20e4d-0e177bfe/previous-api-dist` | 4591616 | 0c3f820上一有效版本回退组件 |
 | `/opt/cmpp-releases/20260910T075122-8e4bc5a20e4d-0e177bfe/previous-api-node_modules` | 586670080 | 0c3f820上一有效版本回退组件 |
 | `/opt/cmpp-releases/20260910T075122-8e4bc5a20e4d-0e177bfe/candidate-1789027246523059732` | 395890688 | 8e4bc5a候选余留/证据，未清理 |
 | `/opt/cmpp-releases/20260910T075122-8e4bc5a20e4d-0e177bfe/previous-source` | 2412544 | 0c3f820上一有效版本回退组件 |
 | `/opt/cmpp-releases/20260910T075122-8e4bc5a20e4d-0e177bfe/previous-dist` | 36978688 | 0c3f820上一有效版本回退组件 |
 | `/opt/cmpp-releases/20260910T075122-8e4bc5a20e4d-0e177bfe` | 1030836224 | 本次发布总目录，含源包/计划/日志/组件 |
 源包保留在`/opt/cmpp-releases/20260910T075122-8e4bc5a20e4d-0e177bfe/source.tgz`，绑定上述archiveHash；本机源包和基线包也保留。当前程序为8e4bc5a；上一有效0c3f820的previous-source、previous-dist、previous-api-dist、previous-api-node_modules和成套备份独立保留。candidate剩余依赖供故障分析，未把已切至live的组件重复算为候选。
 所有历史旧版本、候选、备份、迁盘/冷副本、缓存和日志均未删除或迁盘；“当前＋上一有效版本”的稳态目标仍未完成，第一期工具尚无治理入口。本次发布成功不等于资产治理完成；系统盘已有92%使用率，后续发布应重新预检余量，不能据本次余量自动授权清理。
 以下为47个根目录盘点中的历史程序根目录保留清单；未知精确版本的目录不从名字猜测版本，均保留待治理。缓存/数据/日志已在上表列出：
 | 历史路径 | 实占字节 | 标记核验 |
 |---|---:|---|
 | `/opt/cmpp-night-previous-20260907T230742` | 612507648 | 未取得独立部署标记；保留 |
 | `/opt/cmpp-platform.previous-reportbatch-068b804-20260903T031400Z` | 988270592 | 068b8047ddbfbacf32b233b7b8cfb4e52fd04a6f |
 | `/opt/cmpp-platform-previous-20260906-monitor-442dda7` | 623988736 | 442dda711d5c9f778f3f76fd6d8fd69f14414ce6 |
 | `/opt/cmpp-platform.previous-wps-fe3c6e5-20260904T095352Z` | 988004352 | fe3c6e5b589cf475c611f5189e9243e657b5deac |
 | `/opt/cmpp-platform-candidate-e4f93f7` | 14458880 | 0e3424c4a726f112385d0c7f3f3ebd90c127195b |
 | `/opt/cmpp-platform.previous-css-6508295-20260905T0055` | 988237824 | 65082959c05c975eb7856ee281811a37e1fc284a |
 | `/opt/cmpp-platform.previous-report-material-state-dc201bf9-20260903T050717Z` | 987893760 | dc201bf92ef039dd5beb3c16950e622c600f0026 |
 | `/opt/cmpp-platform.previous-report-briefs-ad89e8f-20260902T1040Z` | 966549504 | ad89e8fed793857daf18ea6cebb995edfe3b74d4 |
 | `/opt/cmpp-night-release-633ba59` | 985272320 | 未取得独立部署标记；保留 |
 | `/opt/cmpp-platform-v5-stage-20260820T073310Z` | 10334208 | 未取得独立部署标记；保留 |
 | `/opt/cmpp-platform.previous-p4-20260821T024737Z` | 838713344 | fcf6d3e6b439b20ad09f517f4fb11c8142758460+workspace.p4fix.b9de7aafef63 |
 | `/opt/cmpp-platform.previous-drainage-20260828T093754Z` | 987291648 | 226527f1cef122e4dbd163da782485e8c0254dc5 |
 | `/opt/cmpp-platform-frontend-247fee6` | 14061568 | 未取得独立部署标记；保留 |
 | `/opt/cmpp-platform.previous-p2fix-20260820T110500Z` | 840720384 | 99fb346c125b0f620641562c50ad517a7682a10f+workspace.p2.56456e81d3be |
 | `/opt/cmpp-platform-candidate-4c21072` | 42749952 | 未取得独立部署标记；保留 |
 | `/opt/cmpp-v4-final-20260820T061323Z` | 7843840 | 未取得独立部署标记；保留 |
 | `/opt/cmpp-platform.previous-schemeless-20260828T100204Z` | 987258880 | c68ac7a3db82d1bdb867260378df18f93cca0fd2 |
 | `/opt/cmpp-platform.previous-p4-20260821T022833Z` | 835203072 | 52028b9bbdea20f0cd02efe792e91b558ba50be9+workspace.p3.7c14cd5f197a |
 | `/opt/cmpp-night-candidate-20260907` | 982675456 | 未取得独立部署标记；保留 |
 | `/opt/cmpp-platform.previous-channel-groups-20260905T231242-15a1f9d` | 1003593728 | 15a1f9d8eddd4f7233987fbf676a91f4e0bfab08 |
 | `/opt/cmpp-platform.previous-p2-20260820T105600Z` | 1037434880 | 229a0b28fd8b84d910c359ff9ac442fc3e843cb4+workspace.p1submitpool.f50505ad9ee9 |
 | `/opt/cmpp-platform-previous-step2-20260824T023615Z` | 835596288 | 90345fba22e3ae183e1edb4fdae718fb7cb2d963+workspace.p4progress.d82933c344ec |
 | `/opt/cmpp-platform.previous-brief-default-7cb5dd3-20260903T0142Z` | 988180480 | 7cb5dd376e23ff0c8a1e3785ab376e432f2ebf6a |
 | `/opt/cmpp-platform-backups` | 23341174784 | 未取得独立部署标记；保留 |
 | `/opt/cmpp-platform.previous-high-frequency-final-cd82499-20260902T0851Z` | 987590656 | cd824999f3b604155e09fbad1f5c6258cfe1d918 |
 | `/opt/cmpp-platform.failed-p4-20260821T030907Z` | 798334976 | 未取得独立部署标记；保留 |
 | `/opt/cmpp-platform.previous-wps-async-41962e7-20260904T1500Z` | 988098560 | 41962e7a6e6cfd34b4313c8bf52d9345d37d8e10 |
 | `/opt/cmpp-platform.candidate-report-record-fe3c6e5` | 11743232 | 未取得独立部署标记；保留 |
 | `/opt/cmpp-platform.previous-p3-20260821T014803Z` | 835768320 | f4560479d3bcb9f1b1a6fc9b1b2664a997cdf851+workspace.p2fix.51553e0d5555 |
 | `/opt/cmpp-v4-stage-20260820T052612Z` | 7843840 | 未取得独立部署标记；保留 |
 | `/opt/cmpp-platform.previous-p4-20260821T030956Z` | 835121152 | 3c6f1beed1c4e6cbfc3822ae377de13317e48ded+workspace.p4cb.68ad7a6ef649 |
 | `/opt/cmpp-platform.previous-import-review-20260904T122649Z` | 988098560 | bb435fb0ac1e7812fcdb59950a4b13757899ab39 |
 | `/opt/cmpp-platform.previous-enterprise-signature-b0deef5` | 987676672 | b0deef5e6ebe6adbfe85591c53dedf11866880a0 |
 | `/opt/cmpp-platform.previous-code-quality-20260828T040442Z` | 859160576 | d85ff8599955e8d217b923dd314690f4b18a4dd2 |
 | `/opt/cmpp-platform.previous-sixfix-20260831T042224Z` | 987369472 | 5328bb09bf89170b4368407e896dbce9527a7b5c |
 | `/opt/cmpp-platform.previous-code-quality-20260828T035307Z` | 1096306688 | 0b84370270c681dff3b15363f91b73566c6954b5 |
 | `/opt/cmpp-platform.previous-p4-20260821T024137Z` | 835813376 | 487b5282a66ec11957a3edf4e9e93cc70cd76342+workspace.p4.ee5b0f3d0db8 |
 ## 未验证项
 未发送短信，未做供应商物理Submit/客户CMPP回执ACK、真实费用释放流水对账或完整链路压测。测试环境只做配置页只读与空表验收，规则写入/路由组合在隔离PG完成，线上词库由用户配置。没有修改OpenWrt/网关；此前网络根因和预生产历史故障未宣称解决。没有推送或预生产部署。
@@ -5424,3 +5424,6 @@ TC-DRAINAGE-GATE-01～16的实现范围以专项方案第10节为准，不再笼
 10：源码确认未改Gateway，不增加最终通道词复核；规则快照更新边界通过真实数据库检查。物理发送中途配置变更未执行。
 11：普通全排除的CMPP/非CMPP分支、既有回执意图恢复失败后保留标记、非CMPP恢复不推送通过隔离单测；真实批量失败SQL在注入释放失败后仍持久保存完成标记。未执行真实余额变更或客户回执投递。
 12性能样本：100条完整同文消息，候选词一次读取、决策一次写入，390～441ms含原引流处理；不代表完整短信链路TPS。真实页面三尺寸1600×1000、1366×768、390×844通过，实际测试环境发布后验收另记。
 TC-CHANNEL-WORD测试部署验收：应用8e4bc5a；新Tab/API200真实空词库、已有管理员登录、三尺寸弹窗显式关闭、刷新/跨路由和历史短信详情通过。线上未保存规则，写操作/并发/路由组合仍以隔离PG证据为准；真实供应商Submit/客户回执ACK/费用流水用例未执行。详见release-20260910-test-channel-sensitive-words.md。
@@ -4902,3 +4902,10 @@ git diff --check
 真实浏览器：production构建、Nest API、隔离PG、Redis7认证前缀，三尺寸CRUD/软删除/独立筛选/关闭/刷新/跨路由/详情通过，pageerror=0；匿名API401。未启动短信发送Worker/Gateway transport。证据%TEMP%/cmpp-channel-sensitive-implementation-20260910，包括real-api-failure.log、browser-1789026246272、各质量门禁日志。实际短信发送/客户回执ACK/费用流水与完整吞吐未执行。
 本地实现和验收完成；本地提交、测试部署正在执行，推送/预生产未授权。测试部署成功后另补精确版本、恢复资产、磁盘增量及真实页面验收。
 ## 2026-09-10 通道敏感词测试交付完成
 应用`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/费用流水与完整吞吐未执行。