Files
knowledge-governance/web/src/ProductionBindingsSection.test.tsx
T
姚章浩 5e1482e349
build / build (push) Successful in 1m40s
feat(library): 恢复验证成为可页面发起的真实作业
根因:生产可恢复性只有 PRODUCTION_BACKUP_RESTORE_VERIFIED 这个手填 env 开关,
页面没有任何入口去真跑一次恢复;CLI(librarydrill)又不是 worker 能复用的实现,
所以"已验证"既证明不了跑过、也证明不了跑的是当前目标。

改动:
- 共享实现 internal/libraryverify(维护隔离→捕获→基线校验→canary→恢复→复核→关窗口),
  cmd/librarydrill 改为薄封装,CLI 与 worker 只允许一份执行体。
- verify 成为独立业务作业:kind + VerifyStages(capture/verify/canary/restore/finalize),
  与 sync/restore/baseline 共用同一把写互斥;迁移 79 加 kind 约束、重建部分唯一索引、
  新建 library_restore_verifications(按 target_id 绑定,换库/索引/桶旧证据自动失效,
  同 target+scope+job 幂等)。
- worker:admitLibraryJob + runOwnedLibraryAttempt 之后调用共享实现,阶段实时写
  library_job_stages,结束后写真实终态;通过写 passed 证据,失败写 failed+原因(不伪成功);
  中断接管按同一作业 id 收掉维护窗口。
- API:POST/GET /api/v1/library/verifications(管理员;闸口关闭/维护中拒绝;返回完整
  整库目标、最近证据、失败原因),OpenAPI 同步。
- 闸口:同步/恢复/续作的证据判断改为读当前目标证据;历史 env 仅在证据缺失时兜底,
  证据存在时以证据为准。
- 页面:生产保护与恢复面板加「恢复验证」块(完整 KB/索引/桶、状态、最近证据、失败原因、
  管理员按钮、5s 轮询),作业类型补 verify 文案。

测试:make verify 16/16 全绿(go 1387 例 + web 454 例 + 契约/迁移/密钥/依赖锁定);
新增用例覆盖证据四条件、闸口证据优先、页面无证据/失败/通过三种呈现与管理员可见性。
2026-11-03 10:14:08 +08:00

102 lines
4.0 KiB
TypeScript

import { renderToStaticMarkup } from 'react-dom/server'
import { describe, expect, it, vi } from 'vitest'
import { ProductionBindingsView } from './ProductionBindingsSection'
import type { ProductionBindings } from './productionBindings'
const bindings = (overrides: Partial<ProductionBindings> = {}): ProductionBindings => ({
internal_kb_id: '0b217e8a-2a65-40a3-ab8f-34ac5c7a6f05',
external_kb_id: '9a1e5c11-0000-4000-8000-000000000002',
internal_kb_name: '对内知识库-wiki',
external_kb_name: '对外知识库-wiki',
updated_by: 'yaozhanghao',
production_base_url: 'https://weknora-test.dobot.cn',
production_connected: true,
production_message: '',
legacy_scope: '文档级发布(单篇文档写生产)· 旧路径',
whole_target: {
configured: true,
source: '部署环境 LIBRARY_PRODUCTION_*',
tenant_id: 10000,
internal_kb_id: 'a8e9c8ad-411c-4c53-8421-599d29e9b179',
external_kb_id: '2e980686-2233-4c4e-b5a6-8b0069477b8e',
database: 'pgm-wz9ohr9gk919pr1q.pg.rds.aliyuncs.com:5432/weknora_test',
elastic_index: 'weknora_test_chunks',
object_bucket: 'dobot-weknora-test',
missing_reason: '',
},
...overrides,
})
const view = (value: ProductionBindings | null, admin = true) =>
renderToStaticMarkup(
<ProductionBindingsView
bindings={value}
options={[]}
internalDraft={value?.internal_kb_id ?? ''}
externalDraft={value?.external_kb_id ?? ''}
isAdmin={admin}
loading={false}
saving={false}
error={null}
message=""
dirty={false}
sameSelection={false}
onInternalChange={vi.fn()}
onExternalChange={vi.fn()}
onSave={vi.fn()}
onReload={vi.fn()}
/>
)
describe('ProductionBindingsView', () => {
it('把实际整库目标(完整 ID + 端点)显示出来,而不是只显示可编辑的文档级绑定', () => {
const html = view(bindings())
expect(html).toContain('整库发布目标(实际写入,只读)')
// 完整 ID 必须可读:截断会让操作者核对不了 a8e9c8ad 与 0b217e8a 的区别。
expect(html).toContain('a8e9c8ad-411c-4c53-8421-599d29e9b179')
expect(html).toContain('2e980686-2233-4c4e-b5a6-8b0069477b8e')
expect(html).toContain('pgm-wz9ohr9gk919pr1q.pg.rds.aliyuncs.com:5432/weknora_test')
expect(html).toContain('weknora_test_chunks')
expect(html).toContain('dobot-weknora-test')
expect(html).toContain('部署环境 LIBRARY_PRODUCTION_*')
})
it('旧文档级绑定标成旧路径,不再声称"发布写入此库"', () => {
const html = view(bindings())
expect(html).toContain('文档级发布(单篇文档写生产)· 旧路径')
expect(html).toContain('仅文档级发布读取这组绑定;整库发布(封存/同步/恢复)不读它。')
expect(html).toContain('对内文档级目标')
expect(html).not.toContain('发布写入此库')
})
it('整库目标缺配置:点名缺哪个环境变量,且不拿文档级绑定顶上去', () => {
const html = view(
bindings({
whole_target: {
configured: false,
source: '部署环境 LIBRARY_PRODUCTION_*',
tenant_id: 0,
internal_kb_id: '',
external_kb_id: '',
database: '(未配置)',
elastic_index: '',
object_bucket: '',
missing_reason: '未配置:LIBRARY_PRODUCTION_DATABASE_URL、LIBRARY_PRODUCTION_KB_INTERNAL',
},
})
)
expect(html).toContain('LIBRARY_PRODUCTION_DATABASE_URL')
expect(html).toContain('整库目标配置不全')
// 文档级绑定仍然显示,但必须仍是"文档级"身份,不能冒充整库目标。
expect(html).toContain('对内文档级目标')
})
it('非管理员看得到目标,但没有保存入口', () => {
const html = view(bindings(), false)
expect(html).toContain('a8e9c8ad-411c-4c53-8421-599d29e9b179')
expect(html).not.toContain('保存文档级目标')
expect(html).toContain('仅管理员可修改文档级发布目标')
})
})