Weknora/knowledge-governance
4
0
Fork 0
Code Issues 2 Pull Requests 5 Actions Packages Projects Releases 1 Wiki Activity
198 Commits 11 Branches 57 Tags
8930ef29cdfd091dfb0897c195799fba002e12bd
Commit Graph

12 Commits

Author SHA1 Message Date
姚章浩 ed60b20790 docs(acceptance): 补 C9 数据源配置（列出来→勾选→变成来源）实测记录 2026-10-10 16:47:06 +08:00
姚章浩 f8faed0b21 feat(release): 发布到生产一键完成（建批+锁定+授权合成一个动作） 
用户的反馈是对的：上一轮只砍掉了"冻结/锁定"两个按钮，但一条文档从"已批准"到"发出"实际仍要
~9 次交互（找条目→勾选→填名→建批→滚到清单→找批次→授权→输语句→提交），因为"批次仪式"本身
还留在路径上。

- 新端点 POST /api/v1/release-batches/publish-now：在同一操作里先建批（SealImmediately，冻结
  即锁定）再授权生产发布，返回 {batch, execution}。
- 不放松任何约束：请求门禁(403)、备份恢复验证门禁(412)、管理员身份(401)、固定确认语句(400)、
  发布前快照硬门禁(409)、建批门禁(422) 全部沿用既有实现，无旁路；名称可省(服务端固定回退名，
  保证重放指纹一致)。
- 界面：审核行上直接「发布到生产」（管理员 + 门禁开启时显示），工具栏支持选中多条一次发布；
  复用既有确认弹窗（固定语句）。批次名不再是必经步骤。
- 实测（面板）：点行级按钮 → 输 `publish-to-production` → 提交 → 批次 rb-bee80550…(sealed)
  + 执行 rx-3d831129…(completed, 项级 verified) → 页面回滚 rx-43835fac…(rolled_back, absent)。

测试：publish_now_test.go（四道关卡 + 组合调用 + 名称回退）与 reviewRelease.test.ts（请求体/回传/错误原因）；
Go 26 包、前端 183 条全过。
 2026-10-10 15:48:30 +08:00
姚章浩 70131c6161 feat(release): 批量审核 + 建批即锁定 —— 发布管理单文档交互降到 3~4 次 
P0-3：
- 批量审核：新增 POST /api/v1/review-candidates/batch-decision，逐条复用单条审核的写入
  路径（同一套合法性校验与"最新验收轮次"绑定），逐条回报 decided/skipped/skipped_ids；
  不可审核的条目只计入 skipped，不打断整批，其他错误整批回滚（不留半成品）。
  界面新增「全选可批准」「批量批准选中」「批量驳回选中」。
- 建批即锁定：建批请求加 seal 字段，服务端在创建后立即执行既有的密封（仍逐项复核门禁，
  失败整批回滚），草稿态不再单独占一步；界面按钮改为「创建并锁定清单」，流程说明从 8 步改 7 步。
- 判据修正：「可批准」原先把已驳回的算进去（review_state !== 'approved'），改为只含 pending + 门禁通过。

语义边界（写进测试）：批量批准按人工身份记录，人工可推翻自己先前的驳回；system:auto 发起的
批量批准对人工驳回过的那条必须跳过（Decided=0/Skipped=1）——机器永远不覆盖人工。

测试：review_batch_integration_test.go（批量决定/跳报/重复 id 拒绝/机器不覆盖人工、
建批即锁定）、review_batch_test.go（幂等键、400/409/500/501 映射、服务端盖操作人）、
reviewRelease.test.ts（批量请求体与逐条回报、建批带 seal）。前端 181 条通过。
 2026-10-10 15:29:31 +08:00
姚章浩 c83a6c8086 docs(runbook): 发布准备改为「勾选 → 建批 → 锁定」（建批时冻结 + 对内自动批准），并补 C6 实测 2026-10-10 15:06:44 +08:00
姚章浩 a1b46d2b7c feat(monitor): 需下架车道可逐条移除测试库知识 —— 补齐最后一个没有页面入口的流程 
背景：来源侧被判「禁止导入」后，已建好的测试库知识不会自动消失；此前只有变更集
删除路径会入队 test.remove，页面既列不出条目也没有按钮，运维无法闭环（车道只有按
库计数）。

新增：
- GET /api/v1/test-publications?removal=required：条目级列表，判据与车道计数同源
  （superseded_at IS NULL / 有 knowledge_id / completed / retrieval_state NOT IN
  (disabling,disabled) / policy_state='blocked'），过滤是叠加而不是替换。
- POST /api/v1/test-publications/{id}/removal：engineer 级写路由，要求 Idempotency-Key，
  按条目幂等（operator-remove:<id>）；置 disabling 并交既有 test.remove 工作流去删除
  远端知识并读回校验。错误映射 404/409(已移除)/409(不可移除)/501(未接线)。
- 界面：需下架车道逐条显示条目 + 「下架（从测试库移除）」，页内二次确认，成功提示，
  完成后计数归零。

修掉过程中踩到的两个真问题：
1. 二次确认的确认态原先经容器 props 传给视图，一次容器改动把三个 props 丢了 ——
   视图永远渲染原按钮、确认步骤静默消失，而所有静态单元测试仍然通过。改为把确认态
   放在视图内部；并把「取消」放在原按钮位置（真实指针连点两下只会落到取消）。
2. jobs 上有部分唯一索引 UNIQUE (business_change_set_id, business_version_id,
   business_target_kb_id, business_action) WHERE business_change_set_id IS NOT NULL。
   本路径给这三列写空串（非 NULL），('','','','remove') 对所有条目是同一个键 ——
   第一条之后每次 INSERT 都撞唯一索引、被 ON CONFLICT DO NOTHING 静默吞掉，留下
   「状态已 disabling、没有任务」的永久卡死条目，而车道恰好隐藏 disabling，运维也
   看不到。改为写 NULL（语义：无变更集身份）+ 冲突目标收敛到 idempotency_key +
   校验 RowsAffected()（0 行回查既有任务；查不到就报错，不提交无任务的 disabling）。
   卡死状态在重试时可自愈。

测试：internal/platform/postgres/test_publication_removal_integration_test.go（两条发布
各自入队、business_* 为 NULL、卡死自愈；把修复退回旧写法该测试即 FAIL，已实测）、
internal/httpapi/test_publication_removal_test.go（权限/幂等键/错误映射/未接线 501/列表
过滤）、前端 testPublications.test.ts + WeKnoraMonitor.test.tsx。

验收（纯界面，两条都走完）：解析监控 → 需下架（2）→ 逐条「下架」+ 二次确认 →
retrieval_state=disabled（PDF 03:57:03Z、md 04:08:55Z），jobs completed（attempt 2，
首次 test_remove_pending＝远端仍在处理，重试通过；工作流以 GetKnowledge 读回 404 判
成功）→ 车道需下架（0）。核验「确认前不执行」：首次点击后仍 unpublished、移除任务数仍 1。
 2026-10-10 12:10:46 +08:00
姚章浩 e9a643cc33 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）。
 2026-10-10 11:36:08 +08:00
姚章浩 fa244c447c fix(deploy): 重建 api 会静默关掉生产门禁 —— 加前置保护 + 门禁状态回显 
界面验收第三遍（PDF）踩到：授权发布被回绝 "production release requests are disabled"。
根因：scripts/deploy-api-web.sh 的 COMPOSE_FILES 默认只叠 compose.yaml，重建 api 时没叠
compose.release-gates.yaml → PRODUCTION_RELEASE_REQUESTS_ENABLED / PRODUCTION_BACKUP_RESTORE_VERIFIED
变 false，生产授权接口被静默关闭（页面只在点击那一刻提示一句，极易误判成功能坏了）。

- 前置保护：正在运行的 api 已开闸、而本次 COMPOSE_FILES 不含门禁文件时直接拒绝
  （REFUSED_WOULD_CLOSE_PRODUCTION_GATES，并打印保留门禁的正确命令；确要关闸用 ALLOW_GATE_OFF=1）
- 结尾新增 === 7b 打印重建后的两道门禁状态，避免"以为开着"
- 已用同一段判定逻辑覆盖三种情形（已开闸+不叠门禁→拒绝 / 已开闸+叠门禁→放行 / 显式 ALLOW_GATE_OFF→放行）

验收第三遍同时确认：PDF→MinerU 解析链路是通的（入库 completed、验收"内容处理：通过"），
发布首轮 completed/verified（in_scope=8 foreign=8 降级保留正常），回滚 rolled_back、
目标库 enable_status=disabled。证据补进 docs/USER_FLOWS_ACCEPTANCE.md。
 2026-10-10 11:10:51 +08:00
姚章浩 d0a45d563f fix(monitor): 需下架车道恒为 0（判据用了没人写的状态）+ 隔离会改线上设置的集成测试 
界面验收第三遍（禁止导入 → 需下架）暴露两处真问题：

1) 需下架车道死掉：判据 `retrieval_state='enabled'`，而 retrieval_state 在这套状态机里
   描述「是否发布到生产」(unpublished/disabling/disabled/failed)，全仓没有任何代码写过
   'enabled'，线上 5/5 发布单元都是 unpublished → 车道恒 0，界面「仍在知识库里的文件会
   出现在这里」的承诺不成立。改为与设计注释一致的口径：仍在测试库存活（completed + 有
   knowledge_id + 未 disabling/disabled）+ 来源项 policy_state='blocked'。
   线上对照：旧判据 0 → 新判据 1，命中被禁止导入的 DH-AG95夹爪适配-指令协议.md；
   修后页面显示「需下架（1）· 对内知识库 · 1 份仍在检索中」。新增集成测试覆盖
   存活/未禁止/移除中/已移除/未上传五种情形（真实 Postgres + 独立 schema）。

2) 集成测试改到线上设置（直接踩到并已恢复）：ui_settings_integration_test.go 只判断
   TEST_DATABASE_URL 是否存在、无 schema 隔离，而它「创建候选并激活」——跑在共享库上会把
   真实 active 设置挤成 retired。已先备份（backups/ui-settings/…pre-restore.jsonl），再用
   单事务（先 retire 再 activate，uq_ui_setting_active 只允许一条 active）恢复
   uis-d40ea1fc…（15/30/1800/7200 + https://weknora-test.dobot.cn/），并复核线上值。
   根因修复：给该用例加 per-test schema 隔离，复跑后线上设置不再被改动。

同时把两处与事实不符的文案改实话（WeKnoraMonitor.tsx 需下架说明、SourceCatalogBrowser.tsx
禁止导入说明）：移除走 test.remove 工作流（删除测试库知识条目，可再入库），入口当前由
变更集删除路径触发，页面尚无独立按钮——条目级列表与下架按钮列为待排期。
 2026-10-10 10:55:03 +08:00
姚章浩 6a8db9ca98 docs(acceptance): 补第二遍界面验收（.md / drive 直下路由） 
- A1：第二遍取件（DH-AG95夹爪适配-指令协议.md，3513 B）与内容级 sha256 去重的核对方法
  （content_objects 命中已有行时只更新 updated_at，不更新 created_at；必须走
  source_item_versions.content_object_id 关联，不要按 created_at 过滤）
- B1：tp-466164a074cb22efb → completed（polls=8，测试库 0c84a098…）
- C1：v4 rcs-2b22276e…（新增3/阻断193）+ 批次 rb-f1819fb0…（sealed、1 项）→ 再证「批准后才生成」顺序规则
- C2：留档 20261010T023538Z-0b217e8a + guardcheck PASS + 执行 rx-bc714172… 首轮 completed/verified
- C3：回滚 rolled_back + 独立核对目标库 enable_status=disabled（行不删）
- F：新增待办 3e——发布结果页不自动刷新（worker 已完成仍显示待执行，需手动刷新）
 2026-10-10 10:41:49 +08:00
姚章浩 134da985fa docs(acceptance): 补 2026-10-10 界面端到端验收结果（含三处修复与顺序约束） 
- A1：记录白名单环境漏传 dws 变量这一缺陷与修复后的真实产物证据（d29e04e）
- A3/C1：写明生成即固化的顺序约束——处理完成 → 批准 → 生成新版本 → 确认冻结（冻结不重算）
- B1/C1/C2/C3/C4：补本期实测（tp-c3412382… / rb-d6eb1c91… / rx-63b81560… / rx-71d13453…）
- C2：记录首个真实跨环境 wiki 发布与「写入保留外来源页 vs 校验要求集合相等」的口径冲突（eabe55b）
- F：wiki 跨环境发布不再列为未跑；新增健康探测误报、测试端 404、snapshot_verification_id 空 三项待办
 2026-10-10 10:23:51 +08:00
姚章浩 32b480ce85 docs(acceptance): A1 补钉钉取件走 dws 的实现与复核结论 
- 记录开关/路由/平台侧判定保留、凭据共享与续期 runbook 依赖
- 本人复核：worker 内 dws v1.0.63 接线、鉴权（须 HOME=DWS_HOME，否则误报未登录）、
  真实调用 ok、回归测试 18 项 + 19 断言、CI #6/#7/#8 全 success
 2026-10-09 14:41:55 +08:00
姚章浩 b1b4ca5488 docs(acceptance): 用户操作流程验收清单
build / build (push) Successful in 33s
Details 
按 A 内容进入 / B 入库监控 / C 发布回滚 / D 系统设置 / E 备份恢复 分组，
每条给出入口、用户步骤、期望、验收证据与状态，并附验收建议顺序与已知限制。
证据全部来自本期实测：面板原文 + 主机侧独立复核（含存储与备份定时往返）。
 2026-10-09 14:21:54 +08:00