docs: record clause recommendation funnel deployment

2026-05-22 08:15:22 +08:00
parent 748aab08e0
commit 344fbc9f2f
2 changed files with 47 additions and 0 deletions
@@ -4489,3 +4489,36 @@
 - 后续部署要求：
  - 测试服务器需要执行 Alembic 到 `20260522_0039`。
  - 需要重新部署后端和前端后，再做 `/operation-kpis`、`/documents/new/[type]`、`/documents/[id]/edit` 远程烟测。
+
+### 远程部署与真实库烟测补齐
+
+- 已提交并推送：
+  - `748aab08 feat: add clause recommendation funnel`
+  - 当前 `main` 已推送到 `origin http://192.168.3.90:3000/yuqei/ai-contract-platform.git`。
+- 已部署到 `192.168.3.90`：
+  - 部署命令：`powershell -NoProfile -ExecutionPolicy Bypass -File scripts\deploy-ai-contract-restore-docker.ps1 -UseSshpass -SmokeFrontendPath "/operation-kpis"`
+  - 部署结果：`RESTORE_DOCKER_DEPLOY_PASS`
+  - 部署证据目录：`project-docs/qa-artifacts/restore-docker-deploy/2026-05-22T08-05-29`
+- 远程容器状态：
+  - `ai-contract-backend-restore restart=unless-stopped status=running`
+  - `ai-contract-frontend restart=unless-stopped status=running`
+  - `ai-contract-legal-change-worker restart=unless-stopped status=running`
+- 远程 HTTP 烟测：
+  - `http://192.168.3.90:8001/health` 返回 HTTP 200。
+  - `http://192.168.3.90:8001/api/v1/system/readiness` 返回 HTTP 200。
+  - `http://192.168.3.90:3003/operation-kpis` 返回 HTTP 200。
+  - `http://192.168.3.90:3003/documents/new/procurement_goods` 返回 HTTP 200。
+  - `http://192.168.3.90:3003/documents/contract-123/edit` 返回 HTTP 200。
+- 远程 Alembic 与 PostgreSQL 真相源：
+  - `alembic current` 返回 `20260522_0039 (head)`。
+  - `alembic heads` 返回 `20260522_0039 (head)`。
+  - `alembic_version=20260522_0039`。
+  - `clause_recommendations_exists=True`。
+- 远程真实库动作更新烟测：
+  - 临时创建 `clause_recommendations` 烟测记录。
+  - 调用 `ClauseRecommendationService.update_recommendation_action` 将状态更新为 `ignored`。
+  - 返回 `remote_action_status=ignored`。
+  - 清理前烟测记录数：`remote_smoke_record_count_before_cleanup=1`。
+  - 清理后烟测记录数：`remote_smoke_record_count_after_cleanup=0`。
+- 当前闭环结论：
+  - 条款推荐行为漏斗已完成“本地开发验证 -> Git 提交推送 -> 3.90 部署 -> Alembic 真相源 -> 远程 HTTP -> 真实库动作更新烟测”的完整闭环。
@@ -209,3 +209,17 @@ Generating static pages (40/40)

 1. 远程测试服务器部署后需要执行 Alembic 到 `20260522_0039`，并重新部署后端、前端。
 2. 通用质量评测域、全量法规向量化、真实支付、电子签章或小程序仍属于后续增强项，不是当前 Phase15 主线代码缺口。
+
+### 9.1 远程闭环补充
+
+上述第 1 项远程部署边界已在同日补齐：
+
+- 已提交并推送：`748aab08 feat: add clause recommendation funnel`。
+- 已部署到 `192.168.3.90`，部署结果：`RESTORE_DOCKER_DEPLOY_PASS`。
+- 部署证据目录：`project-docs/qa-artifacts/restore-docker-deploy/2026-05-22T08-05-29`。
+- 远程 `alembic current` 和 `alembic heads` 均为 `20260522_0039 (head)`。
+- 远程 PostgreSQL 已确认 `clause_recommendations_exists=True`。
+- `http://192.168.3.90:8001/health`、`/api/v1/system/readiness`、`http://192.168.3.90:3003/operation-kpis`、`/documents/new/procurement_goods`、`/documents/contract-123/edit` 均返回 HTTP 200。
+- 已通过远程真实库动作更新烟测：临时推荐记录从 `shown` 更新为 `ignored`，清理后剩余记录数为 `0`。
+
+因此，条款推荐行为漏斗增强项已经形成完整闭环；当前仍保留的只是后续增强项：通用质量评测域、全量法规向量化、真实支付、电子签章或小程序等。