feat(library): 整库版本/作业持久化与状态读取契约,生产同步默认拒绝
build / build (push) Failing after 17s

- 新增 library_versions:测试封存、生产生效、生产预备份三类分开登记,
  生产生效版本唯一(旧版本必须先 supersede),测试快照不能顶替生产版本
- 新增 library_jobs + library_job_stages:业务作业身份、阶段、错误与恢复说明,
  分项计数用 NULL 表示"总量未知";互斥与幂等由数据库唯一索引保证
- 新增 GET /api/v1/library/overview、/jobs、/jobs/{id};POST /syncs 闸口未齐
  返回 503 缺项且不建作业
- 封存作业落库:先建业务作业再入队,worker 推进 export 阶段并登记 test_sealed
- 发布管理读真实状态:生产未知不再顶替、差异 unknown、启动同步按缺项禁用、
  同步明细/四类分项来自持久阶段;阶段勾选只认当前作业证据
- 准备信息标注封存时间与范围,不声称实时测试库已就绪
This commit is contained in:
姚章浩
2026-10-28 13:58:51 +08:00
parent 58d0483d44
commit dc9e827656
14 changed files with 1902 additions and 126 deletions
+98 -7
View File
@@ -1,7 +1,13 @@
import { renderToStaticMarkup } from 'react-dom/server'
import { describe, expect, it, vi } from 'vitest'
import { ReleaseTargetsView } from './ReleaseTargets'
import type { LibraryCaptureJob, LibrarySnapshot, LibrarySnapshotList } from './librarySnapshots'
import type {
LibraryCaptureJob,
LibraryJobRecord,
LibraryOverview,
LibrarySnapshot,
LibrarySnapshotList,
} from './librarySnapshots'
const internalSnapshot: LibrarySnapshot = {
snapshot_id: 'f992d64ea45bf737a0721a465b5aef2b150ef7757157eb84f3aaf8b6972d98f9',
@@ -67,11 +73,69 @@ const page: LibrarySnapshotList = {
capture_reason: '',
}
// 真实接口形状:生产段未知、闸口未开、没有持久作业。
const overview: LibraryOverview = {
scope: 'internal',
test_sealed: internalSnapshot,
production: { state: 'unknown', reason: '还没有生产验证通过的生效版本记录' },
prebackup: { state: 'unknown', reason: '本次目标快照还没有生产预备份' },
diff: {
state: 'unknown',
reason: '生产与测试的文档级差异读取未接线',
added: [],
updated: [],
removed: [],
},
jobs: [],
gate: {
sync_allowed: false,
reasons: [
'生产写入闸口关闭(PRODUCTION_RELEASE_REQUESTS_ENABLED=false)',
'没有已核验的生产恢复演练证据(PRODUCTION_BACKUP_RESTORE_VERIFIED=false)',
'生产当前权威版本未知,不能启动写入',
'本次目标快照还没有生产预备份',
],
},
capture_available: true,
now: '2026-10-28T03:40:00Z',
}
const persistedSeal: LibraryJobRecord = {
id: 'libseal-lib-internal-20261028T033457',
scope: 'internal',
kind: 'seal',
state: 'running',
stage: 'export',
request_digest: 'd'.repeat(64),
queue_job_id: 'library-capture-internal-1',
snapshot_id: '',
target_snapshot_id: '',
actor: 'yaozhanghao',
error: '',
recovery: '',
created_at: '2026-10-28T03:34:50Z',
updated_at: '2026-10-28T03:34:55Z',
finished_at: null,
stages: [
{
stage: 'export',
state: 'running',
total: null,
completed: null,
bytes_total: null,
bytes_done: null,
detail: '主机侧正在暂停写入者、导出并恢复',
updated_at: '2026-10-28T03:34:55Z',
},
],
}
type ViewProps = Parameters<typeof ReleaseTargetsView>[0]
const base: ViewProps = {
page,
jobs: [],
overview,
loading: false,
error: null,
notice: null,
@@ -102,20 +166,41 @@ describe('ReleaseTargetsView(确认稿布局)', () => {
expect(html).not.toContain('对外知识库 · 尚无')
})
it('未接入项显示“未接入”,不用 0 / 无变化冒充', () => {
it('未接入项显示“未接入/未知”,不用 0 / 无变化冒充', () => {
const html = render()
expect(html).toContain('生产当前')
// 生产没有权威版本时必须写未知,不能拿测试快照顶替
expect(html).toContain('未知(尚未建立权威版本)')
expect(html).toContain('尚无记录 · 生产与测试的文档级差异读取未接线')
expect(html).toContain('未接入')
expect(html).toContain('尚无记录 · 变更清单来自生产与测试版本对比')
})
it('“启动同步”保持禁用并说明原因,不把封存当成同步', () => {
it('“启动同步”保持禁用并逐条说明缺项,不把封存当成同步', () => {
const html = render()
expect(html).toMatch(/<button[^>]*class="rel-primary"[^>]*disabled/)
expect(html).toContain('生产同步未接线')
expect(html).toContain('生产写入闸口关闭')
expect(html).toContain('没有已核验的生产恢复演练证据')
expect(html).toContain('本次目标快照还没有生产预备份')
expect(html).toContain('封存测试版本')
})
it('没有当前作业时不把历史封存当成阶段完成', () => {
const html = render()
// 阶段条第一段必须是 idle(○),"✓" 只允许出现在准备清单,不出现在阶段条
const stageBar = html.slice(html.indexOf('aria-label="作业阶段"'), html.indexOf('rel-steps-note'))
expect(stageBar).not.toContain('✓')
expect(stageBar).toContain('本次作业尚未开始')
expect(html).toContain('已有测试封存')
expect(html).toContain('没有当前作业证据时不会把历史封存当作阶段完成')
})
it('准备信息注明快照时间与范围,不声称实时测试库已就绪', () => {
const html = render()
expect(html).toContain('依据 10/28 11:34 封存的测试库全库快照,不代表实时测试库已就绪')
expect(html).toContain('同一份封存快照,不是实时 Wiki 队列状态')
expect(html).toContain('封存时的逐项校验和,重新封存才会更新')
})
it('版本与快照抽屉按 scope 列出全部历史并区分测试封存/不可直接恢复', () => {
const html = render({ drawerOpen: true, expandedSnapshot: internalSnapshot.snapshot_id })
expect(html).toContain('版本与快照')
@@ -135,8 +220,11 @@ describe('ReleaseTargetsView(确认稿布局)', () => {
})
it('同步中布局显示四类数据卡与明细,且不编造百分比', () => {
const html = render({ jobs: [runningJob] })
expect(html).toContain('正在封存测试版本')
const html = render({
jobs: [runningJob],
overview: { ...overview, job: persistedSeal, jobs: [persistedSeal] },
})
expect(html).toContain('测试库封存作业')
expect(html).toContain('数据库 · 文档与分块')
expect(html).toContain('原文件 · 图片 · 附件')
expect(html).toContain('检索索引 · 向量')
@@ -146,6 +234,9 @@ describe('ReleaseTargetsView(确认稿布局)', () => {
expect(html.match(/[1-9]\d*%/g) ?? []).toEqual(['100%'])
expect(html).toContain('文件传输 100% ≠ 作业完成')
expect(html).toContain('不编造百分比')
// 没有真实总量时只写"未知总量",不画百分比
expect(html).toContain('未知总量')
expect(html).toContain('主机侧正在暂停写入者、导出并恢复')
})
it('无权限时不给封存入口,未接线时说明通道状态', () => {
+386 -118
View File
@@ -2,12 +2,16 @@ import { useCallback, useEffect, useState } from 'react'
import {
enqueueLibraryCapture,
fetchLibraryCaptures,
fetchLibraryOverview,
fetchLibrarySnapshots,
formatBytes,
scopeLabel,
type LibraryCaptureJob,
type LibraryJobRecord,
type LibraryOverview,
type LibrarySnapshot,
type LibrarySnapshotList,
type LibraryStageRow,
} from './librarySnapshots'
import { useOptionalAuth } from './auth'
import './releaseTargets.css'
@@ -57,6 +61,10 @@ interface ScopeView {
history: LibrarySnapshot[]
activeJob?: LibraryCaptureJob
lastJob?: LibraryCaptureJob
// 持久作业与三类版本:来自 /api/v1/library/overview,重启后仍可读。
overview?: LibraryOverview | null
job?: LibraryJobRecord
syncJob?: LibraryJobRecord
}
interface ViewProps {
@@ -74,28 +82,44 @@ interface ViewProps {
pendingCapture: boolean
canCapture: boolean
canWrite: boolean
overview: LibraryOverview | null
now: number
onRefresh: () => void
onCapture: () => void
}
function scopeView(page: LibrarySnapshotList | null, jobs: LibraryCaptureJob[], scope: Scope): ScopeView {
function scopeView(
page: LibrarySnapshotList | null,
jobs: LibraryCaptureJob[],
scope: Scope,
overview: LibraryOverview | null,
): ScopeView {
const history = (page?.snapshots ?? []).filter((item) => item.scope === scope)
const scoped = jobs.filter((job) => job.scope === scope)
const persisted = overview?.jobs ?? []
const job =
overview?.job ?? persisted.find((item) => item.state === 'pending' || item.state === 'running') ?? persisted[0]
return {
scope,
snapshot: history[0],
history,
activeJob: scoped.find((job) => ACTIVE_STATES.includes(job.state)),
lastJob: scoped[0],
overview,
job,
syncJob: persisted.find((item) => item.kind === 'sync'),
}
}
const scopeName = (scope: Scope) => (scope === 'internal' ? '对内知识库' : '对外知识库')
function statusOf(view: ScopeView) {
if (view.activeJob) return { text: '封存中', tone: 'blue' as const }
if (view.snapshot) return { text: '已有封存', tone: 'green' as const }
const job = view.job
if (job && (job.state === 'running' || job.state === 'pending')) {
return { text: job.kind === 'seal' ? '封存中' : '同步中', tone: 'blue' as const }
}
if (view.overview?.production.state === 'known') return { text: '生产已记录版本', tone: 'green' as const }
if (view.overview?.test_sealed || view.snapshot) return { text: '已有封存', tone: 'green' as const }
return { text: '尚无封存', tone: 'gray' as const }
}
@@ -103,27 +127,110 @@ const jstate = (state?: string) =>
state === 'failed' ? '封存失败,可在版本与快照里查看原因' : state ? '封存已完成,生产段未接入' : '尚无作业'
// 五个阶段对应原稿:固定测试版本 → 备份生产 → 同步数据与 Wiki → 生产验证 → 新版本生效。
// 只有第一段有真实实现;其余按"未接入"显示,不画成进行中或已完成。
// 勾选只能来自**当前这次作业**的阶段证据;历史封存记录不代表本次作业推进过,
// 所以没有作业时全部是"本次作业尚未开始",不再把旧快照打勾。
function stageOf(job: LibraryJobRecord | undefined, name: string): LibraryStageRow | undefined {
return job?.stages.find((item) => item.stage === name)
}
function worstState(rows: LibraryStageRow[]): 'succeeded' | 'running' | 'failed' | 'pending' {
if (rows.some((row) => row.state === 'failed')) return 'failed'
if (rows.some((row) => row.state === 'running')) return 'running'
if (rows.length > 0 && rows.every((row) => row.state === 'succeeded' || row.state === 'skipped')) return 'succeeded'
return 'pending'
}
type StepState = 'done' | 'live' | 'fail' | 'idle'
function toState(value: 'succeeded' | 'running' | 'failed' | 'pending'): StepState {
return value === 'succeeded' ? 'done' : value === 'running' ? 'live' : value === 'failed' ? 'fail' : 'idle'
}
function jobStateText(job: LibraryJobRecord): string {
const map: Record<string, string> = {
pending: '排队中',
running: '执行中',
succeeded: '已完成',
failed: '失败',
cancelled: '已取消',
}
return map[job.state] ?? job.state
}
function StageBar({ view }: { view: ScopeView }) {
const sealed = Boolean(view.snapshot)
const capturing = Boolean(view.activeJob)
const stages = [
const job = view.job
const sealJob = job?.kind === 'seal' ? job : undefined
const syncJob = job?.kind === 'sync' ? job : undefined
let first: { state: StepState; hint: string }
if (sealJob) {
const exportStage = stageOf(sealJob, 'export')
first = {
state: toState(
sealJob.state === 'succeeded' ? 'succeeded' : sealJob.state === 'failed' ? 'failed' : 'running',
),
hint:
sealJob.state === 'succeeded'
? `本次作业已封存 ${stamp(sealJob.finished_at ?? exportStage?.updated_at ?? sealJob.updated_at)}`
: sealJob.state === 'running'
? '本次封存执行中'
: sealJob.state === 'pending'
? '已排队,等待 worker'
: '本次封存未完成',
}
} else if (syncJob) {
first = { state: 'done', hint: '已绑定的测试版本' }
} else {
first = { state: 'idle', hint: '本次作业尚未开始' }
}
const prebackup = syncJob ? stageOf(syncJob, 'prebackup') : undefined
const dataStages = syncJob
? ['database', 'resources', 'index', 'wiki']
.map((name) => stageOf(syncJob, name))
.filter((row): row is LibraryStageRow => Boolean(row))
: []
const verifyStage = syncJob ? stageOf(syncJob, 'verify') : undefined
const stages: { label: string; state: StepState; hint: string }[] = [
{ label: '固定测试版本', ...first },
{
label: '固定测试版本',
state: capturing ? 'live' : sealed ? 'done' : 'idle',
hint: capturing ? '封存执行中' : sealed ? `最近封存 ${stamp(view.snapshot!.created_at)}` : '尚未封存',
label: '备份生产',
state: prebackup ? toState(worstState([prebackup])) : 'idle',
hint: prebackup
? prebackup.state === 'succeeded'
? '已完成生产预备份'
: prebackup.state === 'running'
? '正在备份生产'
: prebackup.state === 'failed'
? '预备份失败'
: '未开始'
: '未接入',
},
{
label: '同步数据与 Wiki',
state: dataStages.length > 0 ? toState(worstState(dataStages)) : 'idle',
hint: dataStages.length > 0 ? '按数据库 / 资源 / 索引 / Wiki 分项上报' : '未接入',
},
{
label: '生产验证',
state: verifyStage ? toState(worstState([verifyStage])) : 'idle',
hint: verifyStage ? (verifyStage.state === 'succeeded' ? '校验通过' : '未完成') : '未接入',
},
{
label: '新版本生效',
state: syncJob && syncJob.state === 'succeeded' ? 'done' : 'idle',
hint: syncJob && syncJob.state === 'succeeded' ? '生产已生效' : '未接入',
},
{ label: '备份生产', state: 'idle', hint: '未接入' },
{ label: '同步数据与 Wiki', state: 'idle', hint: '未接入' },
{ label: '生产验证', state: 'idle', hint: '未接入' },
{ label: '新版本生效', state: 'idle', hint: '未接入' },
]
return (
<>
<ol className="rel-steps" aria-label="作业阶段">
{stages.map((stage, index) => (
<li key={stage.label} className={`rel-step ${stage.state}`}>
<span className="rel-step-mark">{stage.state === 'done' ? '✓' : stage.state === 'live' ? '●' : '○'}</span>
<span className="rel-step-mark">
{stage.state === 'done' ? '✓' : stage.state === 'live' ? '●' : stage.state === 'fail' ? '!' : '○'}
</span>
<strong>{stage.label}</strong>
<small>{stage.hint}</small>
{index < stages.length - 1 ? <span className="rel-step-arrow">→</span> : null}
@@ -131,15 +238,27 @@ function StageBar({ view }: { view: ScopeView }) {
))}
</ol>
<p className="rel-steps-note">
{capturing
? '封存是停写入者后的原子导出,没有分项进度上报;导出完成后才会出现新版本。'
: '运行时展开各类数据的数量、字节进度及 Wiki 快照进度;不把提交成功当作版本生效。'}
{job
? `作业 ${job.id} · ${job.kind === 'seal' ? '测试封存' : '生产同步'} · ${jobStateText(job)}${
job.error ? ` · ${job.error}` : ''
}`
: view.snapshot
? `已有测试封存 ${stamp(view.snapshot.created_at)}(历史记录),但本次作业尚未开始;没有当前作业证据时不会把历史封存当作阶段完成。`
: '本次作业尚未开始。'}
</p>
</>
)
}
function ChangeTable() {
function ChangeTable({ diff }: { diff: LibraryOverview['diff'] }) {
const computed = diff.state === 'computed'
const rows = computed
? [
...diff.added.map((item) => ({ action: '新增', item })),
...diff.updated.map((item) => ({ action: '更新', item })),
...diff.removed.map((item) => ({ action: '删除', item })),
]
: []
return (
<div className="rel-panel rel-changes">
<header className="rel-panel-head">
@@ -147,7 +266,7 @@ function ChangeTable() {
<h2>本次变更</h2>
<p>整库版本同步,不单独勾选文件</p>
</div>
<span className="rel-pill gray">未接入</span>
<span className={`rel-pill ${computed ? 'green' : 'gray'}`}>{computed ? `${rows.length} 条` : '未接入'}</span>
</header>
<table>
<thead>
@@ -157,34 +276,71 @@ function ChangeTable() {
</tr>
</thead>
<tbody>
<tr>
<td colSpan={2} className="rel-table-empty">
尚无记录 · 变更清单来自生产与测试版本对比,这项数据还没有接入
</td>
</tr>
{rows.length === 0 ? (
<tr>
<td colSpan={2} className="rel-table-empty">
{computed
? '生产与测试版本没有文档差异'
: `尚无记录 · ${diff.reason || '变更清单来自生产与测试版本对比,这项数据还没有接入'}`}
</td>
</tr>
) : (
rows.map((row, index) => (
<tr key={`${row.action}-${index}`}>
<td>{row.action}</td>
<td>{typeof row.item === 'string' ? row.item : JSON.stringify(row.item)}</td>
</tr>
))
)}
</tbody>
</table>
</div>
)
}
function ProtectionCard({ onOpen }: { onOpen: () => void }) {
function ProtectionCard({
production,
prebackup,
gate,
onOpen,
}: {
production: LibraryOverview['production']
prebackup: LibraryOverview['prebackup']
gate: LibraryOverview['gate']
onOpen: () => void
}) {
const backupKnown = prebackup.state === 'known' && prebackup.version
return (
<aside className="rel-panel rel-protection">
<header className="rel-panel-head">
<h2>生产保护与恢复</h2>
<span className="rel-pill gray">尚未创建</span>
<span className={`rel-pill ${backupKnown ? 'green' : 'gray'}`}>{backupKnown ? '已有预备份' : '尚未创建'}</span>
</header>
<dl>
<dt>本次同步前备份</dt>
<dd>未接入</dd>
<dd>
{backupKnown
? `${stamp(prebackup.version!.created_at)} · ${prebackup.version!.version_label || prebackup.version!.snapshot_id.slice(0, 12)}`
: '未接入(还没有与目标快照绑定的预备份)'}
</dd>
<dt>生产当前版本</dt>
<dd>未接入</dd>
<dd>
{production.state === 'known' && production.version
? production.version.version_label || production.version.snapshot_id.slice(0, 12)
: '未知(生产还没有权威版本记录)'}
</dd>
<dt>备份范围</dt>
<dd>数据库 / 资源 / 索引 / Wiki</dd>
<dt>恢复条件</dt>
<dd>备份完成后核验</dd>
<dd>{gate.reasons.length === 0 ? '已满足' : `缺 ${gate.reasons.length} 项`}</dd>
</dl>
{gate.reasons.length > 0 ? (
<ul className="rel-gate" aria-label="恢复与启动条件">
{gate.reasons.map((reason) => (
<li key={reason}>{reason}</li>
))}
</ul>
) : null}
<p className="rel-hint">同步启动后,这里显示本次生产恢复点及备份进度,可直接查看对应快照。</p>
<button type="button" className="rel-secondary" onClick={onOpen}>
查看已有版本与快照 ›
@@ -196,6 +352,10 @@ function ProtectionCard({ onOpen }: { onOpen: () => void }) {
interface ReadyProps {
view: ScopeView
diff: LibraryOverview['diff']
production: LibraryOverview['production']
prebackup: LibraryOverview['prebackup']
gate: LibraryOverview['gate']
canCapture: boolean
canWrite: boolean
pendingCapture: boolean
@@ -203,13 +363,24 @@ interface ReadyProps {
onOpen: () => void
}
function ReadyBody({ view, canCapture, canWrite, pendingCapture, onCapture, onOpen }: ReadyProps) {
function ReadyBody({
view,
diff,
production,
prebackup,
gate,
canCapture,
canWrite,
pendingCapture,
onCapture,
onOpen,
}: ReadyProps) {
const snapshot = view.snapshot
return (
<>
<div className="rel-grid">
<ChangeTable />
<ProtectionCard onOpen={onOpen} />
<ChangeTable diff={diff} />
<ProtectionCard production={production} prebackup={prebackup} gate={gate} onOpen={onOpen} />
</div>
<div className="rel-panel rel-jobbar">
<header className="rel-panel-head">
@@ -245,36 +416,67 @@ function ReadyBody({ view, canCapture, canWrite, pendingCapture, onCapture, onOp
}
function ProgressBody({ view, now, onOpen }: { view: ScopeView; now: number; onOpen: () => void }) {
const job = view.activeJob ?? view.lastJob
const running = Boolean(view.activeJob)
const job = view.job
const sealJob = job?.kind === 'seal' ? job : undefined
const syncJob = job?.kind === 'sync' ? job : undefined
const running = job?.state === 'running' || job?.state === 'pending'
const stage = (name: string) => syncJob?.stages.find((item) => item.stage === name)
const cards = [
{ title: '数据库 · 文档与分块', note: '封存导出为原子操作,尚无分项上报' },
{ title: '原文件 · 图片 · 附件', note: '封存导出为原子操作,尚无分项上报' },
{ title: '检索索引 · 向量', note: '复用测试端产物;生产不重新解析(未接入)' },
{ title: 'Wiki · 完整快照', note: 'Wiki 随整库快照导出;生产写入未接入' },
]
{ title: '数据库 · 文档与分块', row: stage('database'), axis: '文档 / 分块' },
{ title: '原文件 · 图片 · 附件', row: stage('resources'), axis: '对象 / 字节' },
{ title: '检索索引 · 向量', row: stage('index'), axis: '索引文档' },
{ title: 'Wiki · 完整快照', row: stage('wiki'), axis: 'Wiki 页' },
].map((card) => ({
...card,
// 只有真实的 total 才画进度;没有 total 就是"未知总量",绝不按 0 或 100% 画。
percent:
card.row && card.row.total && card.row.total > 0
? Math.min(100, Math.round(((card.row.completed ?? 0) / card.row.total) * 100))
: null,
count:
card.row && card.row.total != null
? `${card.row.completed ?? '—'} / ${card.row.total}`
: '— / 未知总量',
}))
return (
<>
<div className="rel-panel rel-progress-head">
<div className="rel-between">
<h2>
正在封存测试版本
{sealJob ? '测试库封存作业' : syncJob ? '生产同步作业' : '本次作业'}
<span className="rel-version">
当前 <b>{view.snapshot ? view.snapshot.snapshot_id.slice(0, 12) : '未接入'}</b> → 目标{' '}
<b>本次封存产物</b>
测试封存 <b>{view.overview?.test_sealed?.snapshot_id.slice(0, 12) ?? '未接入'}</b> → 生产当前{' '}
<b>
{view.overview?.production.state === 'known' && view.overview.production.version
? view.overview.production.version.version_label ||
view.overview.production.version.snapshot_id.slice(0, 12)
: '未知'}
</b>
</span>
</h2>
<span className={`rel-pill ${running ? 'blue' : job?.state === 'failed' ? 'red' : 'green'}`}>
{job ? `${jobStateLabel[job.state] ?? job.state} · 已用时 ${elapsed(job.created_at, now)}` : '无作业'}
<span className={`rel-pill ${running ? 'blue' : job?.state === 'failed' ? 'red' : job ? 'green' : 'gray'}`}>
{job ? `${jobStateText(job)} · 已用时 ${elapsed(job.created_at, now)}` : '无作业'}
</span>
</div>
<p className="rel-jobmeta">
作业 <code>{job?.capture_job ?? '未接入'}</code> · 操作人 {job?.requested_by || '—'} · 最近进展{' '}
{job ? stamp(job.updated_at) : '—'}
作业 <code>{job?.id ?? '未接入'}</code> · 类型 {job ? (job.kind === 'seal' ? '测试封存' : '生产同步') : '—'} ·
操作人 {job?.actor || '—'} · 最近进展 {job ? stamp(job.updated_at) : '—'}
{job?.recovery ? ` · 恢复:${job.recovery}` : ''}
</p>
<StageBar view={view} />
<div className="rel-between rel-progress-foot">
<span>当前:{running ? '导出数据库、索引、对象与 Wiki 快照' : jstate(job?.state)}</span>
<span>
当前:
{job?.state === 'running'
? job.stage || '执行中'
: job?.state === 'failed'
? job.error || '失败'
: job
? jobStateText(job)
: '本次作业尚未开始'}
</span>
<button type="button" className="rel-link" onClick={onOpen}>
查看版本与快照 ↗
</button>
@@ -291,15 +493,31 @@ function ProgressBody({ view, now, onOpen }: { view: ScopeView; now: number; onO
<article key={card.title} className="rel-datacard">
<header>
<h3>{card.title}</h3>
<span className="rel-pill gray">未接入</span>
<span className={`rel-pill ${card.row?.state === 'succeeded' ? 'green' : card.row?.state === 'failed' ? 'red' : card.row?.state === 'running' ? 'blue' : 'gray'}`}>
{card.row
? card.row.state === 'succeeded'
? '已完成'
: card.row.state === 'running'
? '执行中'
: card.row.state === 'failed'
? '失败'
: '等待'
: '未接入'}
</span>
</header>
<p className="rel-datacount">
<strong>—</strong> / 未接入
<strong>{card.count}</strong> · {card.axis}
</p>
<div className="rel-progress" aria-hidden="true">
<span style={{ width: '0%' }} />
<div className="rel-progress" aria-hidden={card.percent === null ? 'true' : undefined}>
<span style={{ width: `${card.percent ?? 0}%` }} />
</div>
<p className="rel-datadetail">{card.note}</p>
<p className="rel-datadetail">
{card.row?.detail
? card.row.detail
: syncJob
? '该分项还没有上报数据'
: '生产同步执行链未接通,分项不会产生数据'}
</p>
</article>
))}
</div>
@@ -308,67 +526,63 @@ function ProgressBody({ view, now, onOpen }: { view: ScopeView; now: number; onO
<div className="rel-panel rel-details">
<header className="rel-panel-head">
<h2>同步明细</h2>
<div className="rel-filters">
<button type="button" className="chosen">
全部
</button>
<button type="button">正在执行</button>
<button type="button">失败</button>
</div>
<span className="rel-hint">行来自持久作业阶段,worker 重启后仍可读</span>
</header>
<table>
<thead>
<tr>
<th>任务 / 对象</th>
<th>数据类型</th>
<th>阶段</th>
<th>进度</th>
<th>状态</th>
<th>说明</th>
</tr>
</thead>
<tbody>
<tr>
<td>测试库封存 {job ? job.capture_job : ''}</td>
<td>数据库 / 资源 / 索引 / Wiki</td>
<td>{job ? jobStateLabel[job.state] : '—'}</td>
<td>{running ? '执行中' : job?.state === 'failed' ? '失败' : job ? '已完成' : '未接入'}</td>
<td>
{job?.last_error ? job.last_error : running ? '导出完成前无分项数据' : '封存结束后恢复测试写入者'}
</td>
</tr>
<tr>
<td>生产恢复备份</td>
<td>数据库 / 资源 / 索引 / Wiki</td>
<td>未接入</td>
<td>未接入</td>
<td>生产预备份还没有接线</td>
</tr>
<tr>
<td>本次变更文档</td>
<td>文档 / 分块 / 资源关联</td>
<td>未接入</td>
<td>未接入</td>
<td>差异清单还没有接入</td>
</tr>
<tr>
<td>生产 Wiki 快照</td>
<td>Wiki 页面 / 关联数据</td>
<td>未接入</td>
<td>未接入</td>
<td>生产不重新生成 Wiki;写入未接线</td>
</tr>
{(job?.stages ?? []).length === 0 ? (
<tr>
<td colSpan={5} className="rel-table-empty">
尚无阶段记录
</td>
</tr>
) : (
job!.stages.map((row) => (
<tr key={row.stage}>
<td>{row.stage}</td>
<td>{row.stage === 'export' ? '测试封存' : row.stage}</td>
<td>
{row.total != null ? `${row.completed ?? '—'} / ${row.total}` : '未知总量'}
{row.bytes_total != null ? ` · ${formatBytes(row.bytes_done ?? 0)} / ${formatBytes(row.bytes_total)}` : ''}
</td>
<td>
{row.state === 'succeeded'
? '已完成'
: row.state === 'running'
? '执行中'
: row.state === 'failed'
? '失败'
: row.state === 'skipped'
? '已跳过'
: '等待'}
</td>
<td>{row.detail || '—'}</td>
</tr>
))
)}
</tbody>
</table>
<footer className="rel-log">
<span>
最近事件:
{job?.last_error
? `封存作业报错(${job.last_error.slice(0, 60)})`
{job?.error
? job.error.slice(0, 120)
: running
? '封存作业执行中;无错误。'
? '作业执行中;无错误。'
: job
? '封存作业已结束;无错误。'
: '尚无作业记录。'}
? `作业${jobStateText(job)};无错误。`
: sealJob
? '封存作业已结束。'
: '尚无作业记录。'}
</span>
<span>文件传输 100% ≠ 作业完成;生产验证通过前不显示“完成”。</span>
</footer>
@@ -559,13 +773,26 @@ function Drawer({ view, page, now, open, expanded, onExpand, onClose, canCapture
export function ReleaseTargetsView(props: ViewProps) {
const {
page, jobs, loading, error, notice, scope, onScope, drawerOpen, onDrawer, expandedSnapshot, onExpandSnapshot,
pendingCapture, canCapture, canWrite, now, onRefresh, onCapture,
page, jobs, overview, loading, error, notice, scope, onScope, drawerOpen, onDrawer, expandedSnapshot,
onExpandSnapshot, pendingCapture, canCapture, canWrite, now, onRefresh, onCapture,
} = props
const internal = scopeView(page, jobs, 'internal')
const external = scopeView(page, jobs, 'external')
const internal = scopeView(page, jobs, 'internal', overview?.scope === 'internal' ? overview : null)
const external = scopeView(page, jobs, 'external', overview?.scope === 'external' ? overview : null)
const view = scope === 'internal' ? internal : external
const active = Boolean(view.activeJob)
const active =
Boolean(view.activeJob) || view.job?.state === 'running' || view.job?.state === 'pending'
// 三类版本严格分开:target 是测试封存,production 是生产权威版本,prebackup 是本次预备份。
const target = view.overview?.test_sealed
const production = view.overview?.production ?? { state: 'unknown' as const }
const prebackup = view.overview?.prebackup ?? { state: 'unknown' as const }
const diff = view.overview?.diff ?? {
state: 'unknown' as const,
reason: '生产与测试的文档级差异读取未接线',
added: [],
updated: [],
removed: [],
}
const gate = view.overview?.gate ?? { sync_allowed: false, reasons: ['整库状态接口不可用'] }
return (
<section className="release-targets" aria-label="发布管理">
@@ -630,50 +857,79 @@ export function ReleaseTargetsView(props: ViewProps) {
<button
type="button"
className="rel-primary"
disabled
title="生产同步未接线:没有生产预备份、生产授权与同步协调器,点击不会写入生产"
disabled={!gate.sync_allowed}
title={
gate.sync_allowed
? '生产同步执行链尚未接线,按钮不会启用'
: `暂不能启动同步:${gate.reasons.join(';')}`
}
>
▶ 启动同步
</button>
</div>
</div>
<p className="rel-versionline">
生产当前 <b className="rel-unknown">未接入</b> → 拟发布{' '}
<b>{view.snapshot ? `封存 ${view.snapshot.snapshot_id.slice(0, 12)}` : '未接入'}</b> · 尚未启动,不修改生产
生产当前{' '}
{production.state === 'known' && production.version ? (
<b>{production.version.version_label || `生效 ${production.version.snapshot_id.slice(0, 12)}`}</b>
) : (
<b className="rel-unknown">未知(尚未建立权威版本)</b>
)}{' '}
→ 拟发布{' '}
<b>{target ? `封存 ${target.snapshot_id.slice(0, 12)} · ${stamp(target.created_at)}` : '还没有测试封存'}</b> ·
尚未启动,不修改生产
</p>
<dl className="rel-metrics">
<div>
<dt>新增文档</dt>
<dd className="rel-unknown">未接入</dd>
<dd className={diff.state === 'computed' ? '' : 'rel-unknown'}>
{diff.state === 'computed' ? diff.added.length : '未接入'}
</dd>
</div>
<div>
<dt>更新文档</dt>
<dd className="rel-unknown">未接入</dd>
<dd className={diff.state === 'computed' ? '' : 'rel-unknown'}>
{diff.state === 'computed' ? diff.updated.length : '未接入'}
</dd>
</div>
<div>
<dt>删除文档</dt>
<dd className="rel-unknown">未接入</dd>
<dd className={diff.state === 'computed' ? '' : 'rel-unknown'}>
{diff.state === 'computed' ? diff.removed.length : '未接入'}
</dd>
</div>
<div>
<dt>Wiki 发布方式</dt>
<dd>{view.snapshot ? '完整快照' : '未接入'}</dd>
<dd>{target ? '完整快照' : '未接入'}</dd>
</div>
</dl>
<ul className="rel-checklist">
<li className={view.snapshot ? 'ok' : 'unknown'}>
{view.snapshot
? `✓ 文档解析与索引完整(${view.snapshot.totals.chunks ?? 0} 分块 / ${view.snapshot.totals.index_documents ?? 0} 索引)`
<li className={target ? 'ok' : 'unknown'}>
{target
? `✓ 文档解析与索引完整(${target.totals.chunks ?? 0} 分块 / ${target.totals.index_documents ?? 0} 索引)`
: '○ 文档解析与索引:未接入'}
{target ? <em className="rel-scope">依据 {stamp(target.created_at)} 封存的测试库全库快照,不代表实时测试库已就绪</em> : null}
</li>
<li className={view.snapshot ? 'ok' : 'unknown'}>
{view.snapshot ? `✓ Wiki 快照完整(${view.snapshot.totals.wiki_pages ?? 0} 页)` : '○ Wiki 快照:未接入'}
<li className={target ? 'ok' : 'unknown'}>
{target ? `✓ Wiki 快照完整(${target.totals.wiki_pages ?? 0} 页)` : '○ Wiki 快照:未接入'}
{target ? <em className="rel-scope">同一份封存快照,不是实时 Wiki 队列状态</em> : null}
</li>
<li className={view.snapshot ? 'ok' : 'unknown'}>
{view.snapshot ? `✓ 数据完整性:${view.snapshot.parts.length} 项摘要逐项一致` : '○ 数据完整性:尚无封存可核验'}
<li className={target ? 'ok' : 'unknown'}>
{target
? `✓ 数据完整性:${target.parts.length} 项摘要逐项一致`
: '○ 数据完整性:尚无封存可核验'}
{target ? <em className="rel-scope">封存时的逐项校验和,重新封存才会更新</em> : null}
</li>
</ul>
{gate.reasons.length > 0 ? (
<ul className="rel-gate" aria-label="启动同步的缺项">
{gate.reasons.map((reason) => (
<li key={reason}>{reason}</li>
))}
</ul>
) : null}
<p className="rel-footnote">
启动后先固定测试版本,再备份生产。备份失败或恢复条件不满足,不进入生产写入。启动同步这一步当前未接线。
启动后先固定测试版本,再备份生产。备份失败或恢复条件不满足,不进入生产写入。
</p>
</div>
@@ -682,6 +938,10 @@ export function ReleaseTargetsView(props: ViewProps) {
) : (
<ReadyBody
view={view}
diff={diff}
production={production}
prebackup={prebackup}
gate={gate}
canCapture={canCapture}
canWrite={canWrite}
pendingCapture={pendingCapture}
@@ -710,6 +970,10 @@ export function ReleaseTargets() {
const auth = useOptionalAuth()
const [page, setPage] = useState<LibrarySnapshotList | null>(null)
const [jobs, setJobs] = useState<LibraryCaptureJob[]>([])
const [overviews, setOverviews] = useState<Record<Scope, LibraryOverview | null>>({
internal: null,
external: null,
})
const [loading, setLoading] = useState(true)
const [error, setError] = useState<string | null>(null)
const [notice, setNotice] = useState<string | null>(null)
@@ -722,12 +986,15 @@ export function ReleaseTargets() {
const load = useCallback(async (signal?: AbortSignal) => {
setLoading(true)
try {
const [snapshots, captures] = await Promise.all([
const [snapshots, captures, internalOverview, externalOverview] = await Promise.all([
fetchLibrarySnapshots(signal),
fetchLibraryCaptures(signal),
fetchLibraryOverview('internal', signal),
fetchLibraryOverview('external', signal),
])
setPage(snapshots)
setJobs(captures)
setOverviews({ internal: internalOverview, external: externalOverview })
setNow(Date.now())
setError(null)
} catch (loadError) {
@@ -780,6 +1047,7 @@ export function ReleaseTargets() {
<ReleaseTargetsView
page={page}
jobs={jobs}
overview={overviews[scope]}
loading={loading}
error={error}
notice={notice}
+87 -1
View File
@@ -221,4 +221,90 @@ export function scopeLabel(scope: string): string {
if (scope === 'internal') return '对内'
if (scope === 'external') return '对外'
return scope || '未知范围'
}
}
// ---- 整库状态:测试封存 / 生产生效 / 生产预备份 三类版本 + 差异 + 持久作业 ----
export interface LibraryVersionRecord {
id: string
kind: 'test_sealed' | 'production_effective' | 'production_prebackup'
snapshot_id: string
version_label: string
source_job_id: string
evidence: Record<string, unknown>
created_by: string
created_at: string
superseded_at?: string | null
}
export interface LibraryKnown {
state: 'known' | 'unknown'
version?: LibraryVersionRecord
reason?: string
}
export interface LibraryDiff {
state: 'unknown' | 'computed'
reason?: string
added: unknown[]
updated: unknown[]
removed: unknown[]
}
export interface LibraryStageRow {
stage: string
state: string
total: number | null
completed: number | null
bytes_total: number | null
bytes_done: number | null
detail: string
updated_at: string
}
export interface LibraryJobRecord {
id: string
scope: string
kind: 'seal' | 'sync'
state: 'pending' | 'running' | 'succeeded' | 'failed' | 'cancelled'
stage: string
request_digest: string
queue_job_id: string
snapshot_id: string
target_snapshot_id: string
actor: string
error: string
recovery: string
created_at: string
updated_at: string
finished_at?: string | null
stages: LibraryStageRow[]
}
export interface LibraryGate {
sync_allowed: boolean
reasons: string[]
}
export interface LibraryOverview {
scope: string
test_sealed?: LibrarySnapshot
test_sealed_reason?: string
production: LibraryKnown
prebackup: LibraryKnown
diff: LibraryDiff
job?: LibraryJobRecord
jobs: LibraryJobRecord[]
gate: LibraryGate
capture_available: boolean
capture_reason?: string
now: string
}
export async function fetchLibraryOverview(scope: string, signal?: AbortSignal): Promise<LibraryOverview | null> {
const response = await fetch(`/api/v1/library/overview?scope=${encodeURIComponent(scope)}`, {
headers: { Accept: 'application/json' },
signal,
})
const value = (await response.json().catch(() => null)) as unknown
if (!record(value)) return null
return value as unknown as LibraryOverview
}