fix(release): 禁止导入未被算进期望策略 —— 生产知识下不了架(计划与建批两处同源缺陷)
界面验收实测(2026-10-10):把已发布到生产的 PDF 改为「禁止导入」后,发布通道既给不出
delete、也建不了 delete 批次。
根因:禁止导入只写 source_items.policy_state='blocked',而"期望策略"的解析只看
source_item_scope_overrides / directory_scope_rules / source_items.visibility——
两处实现都不看 policy_state:
1) release_plan.go 的 source_truth:被禁止且生产侧存在的条目被算成 unchanged/present、
can_release=false → 永远不会出现 delete 动作;
2) release_batches.go 的 releaseDeleteReadyCTEs.source_truth:同样口径 → 计划即使给了
delete,创建封批仍被拒 422(实测原文「创建封批失败(HTTP 422)」)。
修复:两处都把 policy_state='blocked' 算进期望策略(各一行,注释写明成因)。
新增集成测试 release_plan_policy_state_integration_test.go:用 policy_state(真实路由的写法)
造"生产存在 + 已禁止"的条目,断言①计划给出 action=delete/can_release、②delete 批次可创建;
分别回退任一处修复,该测试即 FAIL(已实测两种回退都 FAIL)。
实测闭环:重新发布使生产存在(enable_status=enabled)→ 禁止导入 → 计划 delete(present/
can_release=true)→ v8 delete_count=1 → 批次 rb-8c1ad1c9…(sealed, action=delete) → 留档
20261010T033100Z + 门禁 PASS → 执行 rx-6c19232a… completed(项级 verified/delete、
production_revision=absent)→ 目标库该行 enable_status=disabled(行保留、检索停用、可恢复)。
附带:从未导入却被标为禁止的 82 条"等待测试"噪音不再占发布计划(195 → 113 项)。
证据与说明补进 docs/USER_FLOWS_ACCEPTANCE.md(C2b + F.3h)。
This commit is contained in:
@@ -149,6 +149,21 @@
|
||||
因为我用 `deploy-api-web.sh` 重建 api 时没叠 `compose.release-gates.yaml`,两道生产门禁被静默关掉;
|
||||
补上门禁文件重新 up 后重试即成功 ✓(页面当时只在点击处回一句英文错误,很容易误判成功能坏了)
|
||||
|
||||
### C2b 下架(delete 动作)★2026-10-10 首次实测
|
||||
- 入口:**发布管理 → 发布计划** 里对「删除」行勾选 **「选择删除…」** → 勾选 **「确认删除生产知识」**(二次确认框)
|
||||
→ 填批次名 → **创建草稿批次** → 锁定 → 留档 → **授权发布**(同一固定语句 `publish-to-production`)
|
||||
- 期望:执行项 `action=delete`、`production_revision=absent`、`state=verified`;目标库该知识**停用**(行保留,可恢复)
|
||||
- 证据(2026-10-10):先把 PDF 重新发布使生产侧"存在"(`rx-80ad81d5…`,目标行 `enable_status=enabled`)→
|
||||
在来源目录把它改为**禁止导入** → 计划给出 `相机线束固定孔位尺寸图.pdf → action=delete / production_state=present / can_release=true` ✓
|
||||
→ v8 `rcs-8702357179…`(**delete_count=1**、113 项)→ 批次 `rb-8c1ad1c9ba849c7cfe3a5045b53eb880`
|
||||
(`验收-下架孔位图-20261010`、**sealed**、1 项、`action=delete`、绑定 v8)→ 留档 `20261010T033100Z-0b217e8a` + 门禁 PASS
|
||||
→ 执行 `rx-6c19232a4ce1a19f937292a0a60b6c84` → **`completed`**(1/1、failed 0、项级 `verified`/`delete`、
|
||||
`production_revision=absent`);worker 日志 `in_scope=11 foreign=8 … degraded=true` ✓
|
||||
→ **独立核对目标库**:`相机线束固定孔位尺寸图.pdf.pdf` 行仍在、`parse_status=completed`、
|
||||
**`enable_status=disabled`** ✓(下架=停用检索、不删行,可恢复)
|
||||
- ⚠️ 过程中踩到并修掉 **Bug #6**(见 F.3h):禁止导入只写 `source_items.policy_state`,而**两处**"期望策略"解析
|
||||
(计划 + 建批 delete 就绪判定)都不看它 → 计划不给 delete、建批直接 422
|
||||
|
||||
### C3 查看结果 → 回滚
|
||||
- 入口:**发布管理 → 查看结果** → 需要时 **回滚** → 确认语句 `rollback-production-release`
|
||||
- 期望:回滚后目标库该知识停用(**不删知识行**),wiki 页保持
|
||||
@@ -244,6 +259,16 @@
|
||||
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 均成功),仅探测口径问题。
|
||||
3h. **「禁止导入」未进入发布计划的期望策略 → 生产知识下不了架(已修)**:禁止导入写的是
|
||||
`source_items.policy_state='blocked'`,但"期望策略/desired_policy"的解析只看
|
||||
`source_item_scope_overrides` / `directory_scope_rules` / `source_items.visibility`,**两处都不看 policy_state**:
|
||||
① 发布计划(`release_plan.go`)把被禁止且生产侧已存在的条目算成 `unchanged/present`、`can_release=false` → 永远不给 delete;
|
||||
② 建批的 delete 就绪判定(`release_batches.go` 的 `releaseDeleteReadyCTEs`)同样口径 → 即使计划给了 delete,创建封批仍被拒 **422**
|
||||
(实测原文:"创建封批失败(HTTP 422)")。修复=两处都把 `policy_state='blocked'` 算进期望策略(同一口径,各一行);
|
||||
新增集成测试用 **policy_state**(真实路由的写法)复现,并同时断言"计划出 delete"与"delete 批次可创建",
|
||||
回退任一处修复该测试即 FAIL ✓。附带效果:从未导入却被标为禁止的 82 条"等待测试"噪音不再占发布计划(195 → 113 项)。
|
||||
注意:现有 release_authorization 集成测试用 `source_item_scope_overrides` 造 blocked(计划能识别),
|
||||
所以一直没暴露这个"测试与现实写法不一致"的偏差。
|
||||
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`。
|
||||
@@ -259,6 +284,8 @@
|
||||
唯一约束 `uq_ui_setting_active` 只允许一条 active)恢复,两条 update 各影响 1 行,并复核线上值 ✓;
|
||||
根因修复=给该用例加 per-test schema 隔离(照 `internal/monitoring`),复跑后线上设置不再被改动 ✓。
|
||||
**规矩**:任何"创建并激活"的集成测试必须建独立 schema;只判 `TEST_DATABASE_URL` 存在就写共享库的用例一律视为危险。
|
||||
3i. **测试库侧的移除仍无页面入口**:生产侧下架已可通过发布通道完成(见 C2b);但"禁止导入后从**测试库**移除知识"
|
||||
仍只能靠 `test.remove` 工作流(变更集删除路径触发),需下架车道也只有按库计数、没有条目级列表与按钮。
|
||||
3e. **发布/回滚结果页不自动刷新**:Release Worker 完成后,`发布管理` 的执行行仍显示"待执行"(首次与第二遍都遇到),
|
||||
需手动 `刷新当前页面`/reload 才看到 `已完成`/`已回滚`。后端状态是对的(DB 已是终态),属展示层轮询缺口。
|
||||
3d. **`release_executions.snapshot_verification_id` 为空**:发布前快照门禁确实生效(缺少/过期会 `release_target_snapshot_missing`),但执行行没有记下"用的是哪份快照",追踪性待补。
|
||||
|
||||
Reference in New Issue
Block a user