diff --git a/docs/USER_FLOWS_ACCEPTANCE.md b/docs/USER_FLOWS_ACCEPTANCE.md index f57b75e..50856a9 100644 --- a/docs/USER_FLOWS_ACCEPTANCE.md +++ b/docs/USER_FLOWS_ACCEPTANCE.md @@ -79,13 +79,9 @@ 知识 `98be235b-68cf-43e1-94ca-419f5b97fddb`;任务链 `test.upload` → `test.poll`×4 → `test.validate` 全 completed ✓ - 证据(2026-10-10 第二遍):`tp-466164a074cb22efb` → `processing_state=completed`(polls=8、remote=completed、 测试库 `0c84a098…`);任务链 `test.upload → test.poll×8 → test.validate` 全 completed ✓ -- 证据(2026-10-10 第二遍):批准 `.md` → `生成新版本`(v4 `rcs-2b22276e…`,**新增3/阻断193**)→ `确认冻结` → - 批次 `rb-f1819fb0c4196ae6e22e600874954a0c`(`验收-DH-AG95指令协议-20261010`,**sealed**、1 项、仅 `tp-466164a074cb22efb`、绑定 v4)→ `锁定清单` ✓ - 又一次确认顺序规则:**批准前生成的 v3 里该条仍 `not_ready`,批准后重生成 v4 才 `ready/can_release=t`** ✓ -- 证据(2026-10-10 第二遍):`回滚` + `rollback-production-release` → 执行 `rolled_back`(1/1、failed 0、项级 `rolled_back`); - **独立核对目标库**:`knowledges` 行仍在(title `DH-AG95夹爪适配-指令协议.md.md`)、`parse_status=completed`、 - `enable_status=disabled` ✓(回滚=停用,不删行,两次实测一致) -- 状态:✅ 2026-10-08 / 2026-10-10 实测(两份文档各一次发布+回滚)(两份小文档:docx 转换路 + md 直下路) +- 证据(2026-10-10 第三遍,PDF/MinerU):`tp-4aad3a6663efe94ccc76b96…` → `processing_state=completed`(polls=6、remote=completed); + 审核页给出「知识读取:通过;内容处理:通过;搜索验证:需人工确认」✓ → **PDF/MinerU 解析链路通** +- 状态:✅ 2026-10-08 / 2026-10-10 实测(三份小文档:docx 转换路 + md 直下路 + pdf/MinerU 解析路) ### B2 解析监控与补救 - 入口:**解析监控** → 处理中 / 需要你出手 / 需下架 / 死信 / 已完成 / 知识库差异 / 知识库解析进度 @@ -114,7 +110,13 @@ (`state=confirmed`、`confirmed_by=admin`)→ 勾选本条 + 批次名 `验收-App账号注册-20261010` → `创建草稿批次` → `锁定清单` → 批次 `rb-d6eb1c91ee49ab3aedaa16d3c3c91f85`(**sealed**、1 项、 绑定 v3、`review_id=rv-e4b38040…`、`action=upsert`、`decided_visibility=internal`)✓ -- 状态:✅ 2026-10-08 / 2026-10-10 实测 +- 证据(2026-10-10 第二遍,`.md`):批准 `.md` → `生成新版本`(v4 `rcs-2b22276e…`,**新增3/阻断193**)→ `确认冻结` + → 批次 `rb-f1819fb0c4196ae6e22e600874954a0c`(`验收-DH-AG95指令协议-20261010`,**sealed**、1 项、 + 仅 `tp-466164a074cb22efb`、绑定 v4)→ `锁定清单` ✓;顺序规则再次验证:批准前生成的 v3 里该条仍 `not_ready`, + 批准后重生成 v4 才 `ready/can_release=t` ✓ +- 证据(2026-10-10 第三遍,PDF):v5 `rcs-8869e6f0…`(**新增4/阻断192**,含 `相机线束固定孔位尺寸图.pdf` `ready`) + → 批次 `rb-9dfcff203f5fc5e0b4063d3d8b09410b`(`验收-相机线束孔位图-20261010`,**sealed**、1 项)→ `锁定清单` ✓ +- 状态:✅ 2026-10-08 / 2026-10-10 实测(三份文档各一次) ### C2 授权发布(双闸 + 页面确认语句) - 入口:**发布管理 → 授权发布** → 逐字输入确认语句 `publish-to-production` → 确认执行 @@ -139,6 +141,13 @@ 执行 `rx-bc714172a3b0c77885ef18a30dd3ac6b` → **`completed` 首轮通过**(1/1、failed 0、项级 `verified`), worker 日志同样 `in_scope=1 foreign=8 … degraded=true` 且无失败行 → 页面 `发布 已完成 · 1/1`、每项结果 `DH-AG95夹爪适配-指令协议.md → 发布并验证通过 · 生产可用` ✓ + - **第三遍(2026-10-10,PDF)**:留档 `20261010T030026Z-0b217e8a`(PG knowledges 3831→**3832**、wiki_pages 1983→**1990**) + → `guardcheck` 两库 PASS → 执行 `rx-7044688b5b9432c1cb04f8cf251c3679` → **首轮 `completed`** + (1/1、failed 0、项级 `verified`、`production_revision=rv-aac1a725345c7dbf56c03bde1f5d5442`); + worker 日志 `in_scope=8 foreign=8 … degraded=true` 无失败行(这次包内 wiki 8 页,归属门禁在更大页集上同样正确)✓ + - **⚠️ 第三遍踩到真问题(已修,见 F.3g)**:授权发布被回绝 `production release requests are disabled` —— + 因为我用 `deploy-api-web.sh` 重建 api 时没叠 `compose.release-gates.yaml`,两道生产门禁被静默关掉; + 补上门禁文件重新 up 后重试即成功 ✓(页面当时只在点击处回一句英文错误,很容易误判成功能坏了) ### C3 查看结果 → 回滚 - 入口:**发布管理 → 查看结果** → 需要时 **回滚** → 确认语句 `rollback-production-release` @@ -148,7 +157,11 @@ → `rolled_back`(1/1、failed 0、项级 `rolled_back`);页面 `回滚 已回滚`、每项结果 `App账号注册.adoc → 已恢复上一版本 · 目标库 0b217e8a… · 已恢复`; **独立核对目标库**:`knowledges` 行仍在、`parse_status=completed`、`enable_status=disabled` ✓(首发布回滚=停用,不删行) -- 状态:✅ 2026-10-08 / 2026-10-10 实测 +- 证据(2026-10-10 第二遍,`.md`):`回滚` + `rollback-production-release` → 执行 `rolled_back`(1/1、failed 0、项级 `rolled_back`); + **独立核对目标库**:行仍在(title `DH-AG95夹爪适配-指令协议.md.md`)、`parse_status=completed`、`enable_status=disabled` ✓ +- 证据(2026-10-10 第三遍,PDF):执行 `rx-21be23f095075701aba8a62d58f3dd7b` → `rolled_back`(1/1、failed 0); + **独立核对目标库**:`相机线束固定孔位尺寸图.pdf.pdf` 行仍在、`parse_status=completed`、`enable_status=disabled` ✓ +- 状态:✅ 2026-10-08 / 2026-10-10 实测(三份文档各一次发布+回滚,目标库均为"停用不删行") ### C4 重排失败执行 - 入口:**发布管理 → 失败执行 → 重排** → 确认语句 `retry-production-release` @@ -231,6 +244,12 @@ 3. **wiki 通道的真实跨环境发布已跑通**(2026-10-10,见 C2):发现并修复"写入保留外来源页、校验却要求集合相等"的口径冲突(`eabe55b`);降级保留(`degraded=true`)现在是发布常态路径。 3b. **指标条的健康探测有误报**:`解析监控` 顶部把 Embedding 模型 / LLM 模型 / OSS / Redis-MQ / WeKnora API 显示为"阻断",但本期入库与发布全链路(上传/解析/索引/发布/回滚)都实际成功 → 探测口径待校正(不作阻塞项)。 3c. **`系统设置 → 服务配置` 的"测试端"探测报 404**:`test_weknora_base_url` 为空时 api 用 `TEST_WEKNORA_BASE_URL=http://app:8080` 探测,而 `app` 在治理栈网络内不可解析 → 显示"可达·不可接单";worker 走的是可用路径(本清单 B1/C2 均成功),仅探测口径问题。 +3g. **`deploy-api-web.sh` 会静默关掉生产门禁(已修)**:脚本的 `COMPOSE_FILES` 默认只叠 `compose.yaml`, + 重建 api 时若不叠 `compose.release-gates.yaml`,`PRODUCTION_RELEASE_REQUESTS_ENABLED`/`PRODUCTION_BACKUP_RESTORE_VERIFIED` + 变 false,生产授权接口静默关闭,页面只在点「授权发布」时回一句 `production release requests are disabled`。 + 修复:脚本加**前置保护** —— 正在运行的 api 已开闸而本次未叠门禁文件时直接拒绝 + (`REFUSED_WOULD_CLOSE_PRODUCTION_GATES`,并打印保留门禁的正确命令;确要关闸显式 `ALLOW_GATE_OFF=1`), + 结尾新增 `=== 7b` 回显重建后的两道门禁状态。三种情形已按同一段判定逻辑验证 ✓ 3f. **集成测试曾改到线上设置(已修 + 已恢复数据)**:`internal/httpapi/ui_settings_integration_test.go` 只判断 `TEST_DATABASE_URL` 是否存在、**没有 schema 隔离**,而它就做「创建候选并激活」——直接跑在共享/线上库上时, 会把真实的 active 设置挤成 retired。2026-10-10 排查车道问题时踩到:线上 active 变成测试负载 diff --git a/scripts/deploy-api-web.sh b/scripts/deploy-api-web.sh index a607bf9..93cb52e 100644 --- a/scripts/deploy-api-web.sh +++ b/scripts/deploy-api-web.sh @@ -18,7 +18,22 @@ docker build --network host "${PROXY_ARGS[@]}" -f Dockerfile.web -t knowledge-go echo "=== 4. 上线 api + web(不动依赖)" # COMPOSE_FILES 让调用方叠加发布接线 / 门禁 override,默认只有基础 compose.yaml。 # 例:COMPOSE_FILES="-f compose.yaml -f compose.release-sim.yaml" bash scripts/deploy-api-web.sh -docker compose ${COMPOSE_FILES:--f compose.yaml} up -d --no-build --no-deps api web || { echo "UP_FAILED"; exit 1; } +# +# 注意(2026-10-10 实测踩到):重建 api 时若不叠加 compose.release-gates.yaml,两道生产门禁会被 +# **静默关掉**(PRODUCTION_RELEASE_REQUESTS_ENABLED/BACKUP_RESTORE_VERIFIED=false),页面只在点击 +# 「授权发布」时回一句 "production release requests are disabled" —— 很容易误判成功能坏了。 +# 因此下面做前置保护:正在运行的 api 若已开闸、而本次没叠加门禁文件,直接拒绝(确要关闸用 ALLOW_GATE_OFF=1)。 +COMPOSE_FILES_EFFECTIVE="${COMPOSE_FILES:--f compose.yaml}" +GATES_PREV=$(docker exec knowledge-governance-p1-api-1 sh -lc 'printf %s "${PRODUCTION_RELEASE_REQUESTS_ENABLED:-}"' 2>/dev/null || true) +if [ "${GATES_PREV}" = "true" ] && [[ "${COMPOSE_FILES_EFFECTIVE}" != *compose.release-gates.yaml* ]] && [ "${ALLOW_GATE_OFF:-0}" != "1" ]; then + echo "REFUSED_WOULD_CLOSE_PRODUCTION_GATES" + echo " 当前 api 已开闸(PRODUCTION_RELEASE_REQUESTS_ENABLED=true),而本次 COMPOSE_FILES 不含 compose.release-gates.yaml," + echo " 继续会用基础 compose 重建 api → 生产授权接口被静默关闭。" + echo " 保留门禁:COMPOSE_FILES=\"-f compose.yaml -f compose.release-sim.yaml -f compose.release-gates.yaml\" bash scripts/deploy-api-web.sh" + echo " 确实要关闸:ALLOW_GATE_OFF=1 bash scripts/deploy-api-web.sh" + exit 1 +fi +docker compose ${COMPOSE_FILES_EFFECTIVE} up -d --no-build --no-deps api web || { echo "UP_FAILED"; exit 1; } echo "=== 5. 状态" docker ps --filter name=knowledge-governance-p1 --format '{{.Names}} {{.Status}} {{.Image}}' @@ -28,6 +43,8 @@ echo "=== 6. 健康" echo "health=$(curl -s -o /dev/null -w '%{http_code}' http://127.0.0.1:8088/health)" echo "=== 7. 生产端点环境变量(只报名字与非空)" docker exec knowledge-governance-p1-api-1 sh -lc 'for v in PRODUCTION_WEKNORA_BASE_URL PRODUCTION_WEKNORA_API_KEY_FILE PRODUCTION_WEKNORA_ALLOW_DOCKER_HTTP; do eval "val=\$$v"; if [ -n "$val" ]; then echo "$v="; else echo "$v="; fi; done' +echo "=== 7b. 生产门禁状态(重建后必须与预期一致)" +docker exec knowledge-governance-p1-api-1 sh -lc 'for v in PRODUCTION_RELEASE_REQUESTS_ENABLED PRODUCTION_BACKUP_RESTORE_VERIFIED; do eval "val=\$$v"; echo "$v=${val:-}"; done' echo "=== 8. 新包" docker exec knowledge-governance-p1-web-1 sh -lc 'grep -o "index-[A-Za-z0-9_-]*\.js" /usr/share/nginx/html/index.html | head -1' echo "DONE" \ No newline at end of file