mirror of
https://github.com/ThearchyHelios/AgentLab.git
synced 2026-11-18 00:11:59 +00:00
数据目录闭环(前端):数据目录页左栏加「审阅队列」视图——照服务端的优先级列出推断项,每项写位置、所在表、值、说明、为什么排在这里、来源和状态、所在表的使用次数,按项(影响数字的项 / 名称和含义)和表筛选(记在地址里),多选成批确认、驳回、撤销审阅(逐表带读到的版本,逐条的结果原地标出、冲突的写明),顶上是审阅进度(常用 20 张表、全部表、影响数字的项),点开一项右栏是所在表的详情(滚到那一项、列出用过这张表的运行),详情里改过之后队列跟着换状态;页头加「导出目录」(下载服务端给的文件)和「导入目录」(选文件 → 预览对上的表、新增 / 更新 / 保留 / 冲突 / 跳过,冲突逐条列出 → 确认导入 → 逐表写入后的版本,起草任务进行中、文件格式不对时照原样写服务端那句话);新检查 check-catalog-loop(表助手、审阅队列、导出导入、防错事实的说明和纯函数,用 page.route 假接口),登记进 check-all
This commit is contained in:
@@ -1,14 +1,19 @@
|
||||
import { useCallback, useEffect, useMemo, useRef, useState } from 'react'
|
||||
import type { ReactNode } from 'react'
|
||||
import type { KeyboardEvent as ReactKeyboardEvent, ReactNode } from 'react'
|
||||
import { useNavigate, useParams, useSearchParams } from 'react-router-dom'
|
||||
import { ArrowLeft, BookMarked, Database, ListFilter as ListFilterIcon, ScanSearch, Sparkles, TriangleAlert } from 'lucide-react'
|
||||
import {
|
||||
ArrowLeft, BookMarked, Database, Download, ListFilter as ListFilterIcon, ScanSearch, Sparkles, TriangleAlert, Upload,
|
||||
} from 'lucide-react'
|
||||
import clsx from 'clsx'
|
||||
import { ApiError, api } from '../../api/client'
|
||||
import type { CatalogDetail, CatalogList, CatalogTableRow } from '../../types'
|
||||
import { EmptyState, ErrorState, PageHeader, Skeleton, Spinner, toast, useTicker } from '../../components/ui'
|
||||
import type { CatalogDetail, CatalogList, CatalogReviewItem, CatalogReviewKind, CatalogTableRow } from '../../types'
|
||||
import { EmptyState, ErrorState, PageHeader, Skeleton, Spinner, rovingTarget, toast, useTicker } from '../../components/ui'
|
||||
import { useCatalog, useDatasources, useOnReconnect } from '../../store/catalog'
|
||||
import { errorMessage } from '../../lib/errors'
|
||||
import { formatNumber } from '../../lib/format'
|
||||
import {
|
||||
CATALOG_DRAFT_TEXT as DT, CATALOG_TEXT as CT, PROFILE_STOP_LABEL, PROFILE_TEXT as PT, SCHEMA_PARTIAL_TEXT as SPT,
|
||||
CATALOG_DRAFT_TEXT as DT, CATALOG_REVIEW_TEXT as RT, CATALOG_TEXT as CT, CATALOG_TRANSFER_TEXT as XT, PROFILE_STOP_LABEL,
|
||||
PROFILE_TEXT as PT, SCHEMA_PARTIAL_TEXT as SPT,
|
||||
} from '../../lib/terms'
|
||||
import { StatusLegend, SystemNotesNotice } from './parts'
|
||||
import { DraftDialog } from './DraftDialog'
|
||||
@@ -20,6 +25,10 @@ import { ProfileSettingsDialog } from './ProfileSettings'
|
||||
import { fillKey, profileBlockOf, profileSettingsOf, secondsText } from './profile'
|
||||
import { TableDetail } from './TableDetail'
|
||||
import { TableIndex } from './TableIndex'
|
||||
import { ReviewOverview, ReviewQueue } from './ReviewQueue'
|
||||
import { ImportDialog } from './TransferDialog'
|
||||
import { itemKey, reviewParamsOf, writeReviewParams } from './review'
|
||||
import type { CatalogView } from './review'
|
||||
import { filterCounts, listParamsOf, progressOf, rowFromDetail, usageSummary, visibleRows, writeListParams } from './model'
|
||||
import type { ListFilter, ListParams, ListSort } from './model'
|
||||
|
||||
@@ -34,6 +43,10 @@ import type { ListFilter, ListParams, ListSort } from './model'
|
||||
//
|
||||
// 清单的搜索词、筛选、排序和「只看运行中查询过的表」记在地址的查询参数里(q / filter / sort / used),刷新、前进后退
|
||||
// 都不丢;在清单和表详情之间跳转时带着它们走。
|
||||
//
|
||||
// 左栏有两个视图:表清单(逐表看)和审阅队列(view=review:跨表按优先级列出推断项,成批确认、驳回,筛选记在 kind /
|
||||
// rtable 里)。从队列点开一项,右栏是所在表的详情,地址带着那一项(item),详情滚到那一项、列出用过这张表的运行。
|
||||
// 页头的「导出目录」「导入目录」把整理好的目录带到另一个实例(导入先预览,确认后才写)。
|
||||
// ===========================================================================
|
||||
|
||||
export function CatalogPage() {
|
||||
@@ -98,10 +111,20 @@ export function CatalogPage() {
|
||||
const setFilter = useCallback((f: ListFilter) => setList((c) => ({ ...c, filter: f })), [])
|
||||
const setSort = useCallback((v: ListSort) => setList((c) => ({ ...c, sort: v })), [])
|
||||
const setUsedOnly = useCallback((v: boolean) => setList((c) => ({ ...c, used: v })), [])
|
||||
/** 跳到别的表、回到清单时带上清单的查询参数(按页面上的算:搜索词可能还没写进地址) */
|
||||
/**
|
||||
* 跳到别的表、回到清单时带上清单的查询参数(按页面上的算:搜索词可能还没写进地址)。审阅视图的参数(view、kind、rtable)
|
||||
* 照旧带着,从审阅队列打开的那一项(item)不带:换了表就不是那一项了
|
||||
*/
|
||||
const searchRef = useRef('')
|
||||
const search = writeListParams(params, list).toString()
|
||||
const carried = writeListParams(params, list)
|
||||
carried.delete('item')
|
||||
const search = carried.toString()
|
||||
searchRef.current = search ? `?${search}` : ''
|
||||
const carriedRef = useRef(carried)
|
||||
carriedRef.current = carried
|
||||
/** 审阅视图:view=review 时左栏是审阅队列;kind、rtable 是队列的筛选;item 是右栏从队列打开的那一项 */
|
||||
const review = useMemo(() => reviewParamsOf(params), [params])
|
||||
const inReview = review.view === 'review'
|
||||
const [selected, setSelected] = useState<Set<string>>(() => new Set())
|
||||
/**
|
||||
* 起草对话框开着没有、打开时显示什么:setup 选范围开始;job 显示页面跟着的任务(进行中的进度、刚结束的结果)。
|
||||
@@ -142,12 +165,15 @@ export function CatalogPage() {
|
||||
const backToList = useCallback(() => navigate(`${base}${searchRef.current}`), [navigate, base])
|
||||
const back = source?.origin === 'upload' ? '/data/tables' : '/data/databases'
|
||||
|
||||
/** 右栏的表详情载入、改过之后的目录:审阅队列里这张表的项跟着换状态 */
|
||||
const [detailSync, setDetailSync] = useState<{ seq: number; detail: CatalogDetail } | null>(null)
|
||||
/** 写入、审阅之后按返回的单表目录更新清单里那一行 */
|
||||
const onDetail = useCallback((d: CatalogDetail) => {
|
||||
setData((cur) => cur && ({
|
||||
...cur,
|
||||
tables: cur.tables.map((r) => (r.table_name === d.table_name ? rowFromDetail(d, r) : r)),
|
||||
}))
|
||||
setDetailSync((cur) => ({ seq: (cur?.seq ?? 0) + 1, detail: d }))
|
||||
}, [])
|
||||
|
||||
/**
|
||||
@@ -306,6 +332,52 @@ export function CatalogPage() {
|
||||
return [list[i - 1]?.table_name ?? null, list[i + 1]?.table_name ?? null]
|
||||
}, [table, visible, rows, sort])
|
||||
|
||||
/**
|
||||
* 改地址的查询参数,按地址栏现在的样子改:setSearchParams 的函数式写法拿的是上一次渲染时的参数,连着改两样(先点
|
||||
* 「全部」、紧接着换表)时后一次会把前一次盖掉
|
||||
*/
|
||||
const patchSearch = useCallback((fn: (p: URLSearchParams) => URLSearchParams, opts?: { replace?: boolean }) => {
|
||||
const next = fn(new URLSearchParams(window.location.search)).toString()
|
||||
navigate({ search: next ? `?${next}` : '' }, opts)
|
||||
}, [navigate])
|
||||
/** 换视图(表清单 / 审阅队列):记进地址(后退回到上一个视图),右栏正在看的表不动 */
|
||||
const setView = useCallback((v: CatalogView) => {
|
||||
patchSearch((prev) => writeReviewParams(prev, { view: v, item: '' }))
|
||||
}, [patchSearch])
|
||||
/** 审阅队列的筛选:替换当前这条历史(筛选不该占满后退键) */
|
||||
const setReviewParams = useCallback((p: { kind?: CatalogReviewKind; table?: string }) => {
|
||||
patchSearch((prev) => writeReviewParams(prev, p), { replace: true })
|
||||
}, [patchSearch])
|
||||
/** 从审阅队列打开一项:右栏是所在表的详情,地址带着这一项 */
|
||||
const openReviewItem = useCallback((i: CatalogReviewItem) => {
|
||||
const q = writeReviewParams(carriedRef.current, { view: 'review', item: i.path }).toString()
|
||||
navigate(`${base}/${encodeURIComponent(i.table_name)}${q ? `?${q}` : ''}`)
|
||||
}, [navigate, base])
|
||||
/** 成批审阅、导入写进了这些表:重取清单,正在看的表重新载入(编辑中的不动,保存时服务端会用版本号拦下) */
|
||||
const onTablesWritten = useCallback((tables: string[]) => {
|
||||
setDrafted((cur) => ({ seq: cur.seq + 1, tables: new Set(tables) }))
|
||||
void load()
|
||||
}, [load])
|
||||
const activeReviewKey = inReview && table && review.item ? itemKey({ table_name: table, path: review.item }) : null
|
||||
const proposedTotal = useMemo(() => rows.reduce((n, r) => n + (r.in_schema ? r.counts.proposed : 0), 0), [rows])
|
||||
|
||||
/** 导出目录:下载服务端给的文件,文件名按服务端的,没给就按数据源名补 */
|
||||
const [exporting, setExporting] = useState(false)
|
||||
const [importing, setImporting] = useState(false)
|
||||
const exportCatalog = useCallback(async () => {
|
||||
setExporting(true)
|
||||
try {
|
||||
const { blob, name } = await api.dataCatalog.exportFile(sourceId)
|
||||
const file = name ?? XT.fileName(source?.name ?? sourceId)
|
||||
saveFile(file, blob)
|
||||
toast.ok(XT.exported(file))
|
||||
} catch (e) {
|
||||
toast.error(XT.exportFailed(errorMessage(e)))
|
||||
} finally {
|
||||
setExporting(false)
|
||||
}
|
||||
}, [sourceId, source?.name])
|
||||
|
||||
const usage = useMemo(() => usageSummary(rows), [rows])
|
||||
const wideHeader = useMedia('(min-width: 640px)')
|
||||
/**
|
||||
@@ -375,42 +447,58 @@ export function CatalogPage() {
|
||||
body = (
|
||||
<div className="flex min-h-0 flex-1">
|
||||
<aside className={clsx('min-h-0 w-full flex-col border-r lg:flex lg:w-[380px] lg:shrink-0 xl:w-[420px]', table ? 'hidden' : 'flex')}>
|
||||
{empty && (
|
||||
// 窄屏没有右栏的概览,空目录的下一步写在清单上面
|
||||
<div className="border-b px-3 py-2.5 text-xs lg:hidden" data-catalog-empty-banner="">
|
||||
<p className="font-medium">{CT.emptyTitle}</p>
|
||||
<p className="mt-0.5 text-2xs leading-relaxed text-faint">{CT.emptyBody}</p>
|
||||
<div className="mt-2">{draftButton(true)}</div>
|
||||
</div>
|
||||
)}
|
||||
<TableIndex
|
||||
rows={visible}
|
||||
total={rows.length}
|
||||
counts={counts}
|
||||
query={query}
|
||||
onQuery={setQuery}
|
||||
filter={filter}
|
||||
onFilter={setFilter}
|
||||
usedOnly={usedOnly}
|
||||
onUsedOnly={setUsedOnly}
|
||||
sort={sort}
|
||||
onSort={setSort}
|
||||
selected={selected}
|
||||
onSelected={setSelected}
|
||||
active={table}
|
||||
onOpen={openTable}
|
||||
onDraft={openDraft}
|
||||
onProfile={openProfile}
|
||||
/>
|
||||
<ViewTabs view={review.view} proposed={proposedTotal} onChange={setView} />
|
||||
<div role="tabpanel" id="catalog-view-panel" aria-labelledby={`catalog-view-tab-${review.view}`} className="flex min-h-0 flex-1 flex-col">
|
||||
{inReview
|
||||
? (
|
||||
<ReviewQueue sourceId={sourceId} rows={rows} kind={review.kind} table={review.table} activeKey={activeReviewKey}
|
||||
detailSync={detailSync} onParams={setReviewParams} onOpenItem={openReviewItem} onChanged={onTablesWritten} />
|
||||
)
|
||||
: (
|
||||
<>
|
||||
{empty && (
|
||||
// 窄屏没有右栏的概览,空目录的下一步写在清单上面
|
||||
<div className="border-b px-3 py-2.5 text-xs lg:hidden" data-catalog-empty-banner="">
|
||||
<p className="font-medium">{CT.emptyTitle}</p>
|
||||
<p className="mt-0.5 text-2xs leading-relaxed text-faint">{CT.emptyBody}</p>
|
||||
<div className="mt-2">{draftButton(true)}</div>
|
||||
</div>
|
||||
)}
|
||||
<TableIndex
|
||||
rows={visible}
|
||||
total={rows.length}
|
||||
counts={counts}
|
||||
query={query}
|
||||
onQuery={setQuery}
|
||||
filter={filter}
|
||||
onFilter={setFilter}
|
||||
usedOnly={usedOnly}
|
||||
onUsedOnly={setUsedOnly}
|
||||
sort={sort}
|
||||
onSort={setSort}
|
||||
selected={selected}
|
||||
onSelected={setSelected}
|
||||
active={table}
|
||||
onOpen={openTable}
|
||||
onDraft={openDraft}
|
||||
onProfile={openProfile}
|
||||
/>
|
||||
</>
|
||||
)}
|
||||
</div>
|
||||
</aside>
|
||||
<section className={clsx('min-h-0 min-w-0 flex-1 flex-col lg:flex', table ? 'flex' : 'hidden')} aria-label={table ?? CT.overviewTitle}>
|
||||
{table
|
||||
? (
|
||||
<TableDetail sourceId={sourceId} table={table} rows={rows} drafted={drafted} fillCodes={fillCodes} prev={prev} next={next}
|
||||
onFillDone={onFillDone} onOpen={openTable} onBack={backToList} onDetail={onDetail}
|
||||
draftBusy={!!stripJob} onRedraft={redraftTable} onDraftGuidance={draftWithGuidance} />
|
||||
draftBusy={!!stripJob} onRedraft={redraftTable} onDraftGuidance={draftWithGuidance}
|
||||
profileEnabled={profileSettings.enabled} focusPath={inReview ? review.item || null : null} usageOpen={inReview} />
|
||||
)
|
||||
: <Overview rows={rows} empty={empty} systemNotes={data.system_notes} draft={draftButton(true)} onOpen={openTable} />}
|
||||
: inReview
|
||||
? <ReviewOverview />
|
||||
: <Overview rows={rows} empty={empty} systemNotes={data.system_notes} draft={draftButton(true)} onOpen={openTable}
|
||||
onReview={() => setView('review')} />}
|
||||
</section>
|
||||
</div>
|
||||
)
|
||||
@@ -427,6 +515,18 @@ export function CatalogPage() {
|
||||
<div className="flex shrink-0 items-center gap-1.5">
|
||||
{hasTables && headerProfile}
|
||||
{hasTables && headerDraft}
|
||||
{hasTables && (
|
||||
<button type="button" className="btn btn-sm" onClick={() => void exportCatalog()} disabled={exporting} aria-label={XT.export}
|
||||
title={XT.exportHint} data-catalog-export="">
|
||||
{exporting ? <Spinner size={11} /> : <Download size={11} aria-hidden />} <span className="hidden md:inline">{XT.export}</span>
|
||||
</button>
|
||||
)}
|
||||
{hasTables && (
|
||||
<button type="button" className="btn btn-sm" onClick={() => setImporting(true)} aria-label={XT.import} title={XT.importHint}
|
||||
data-catalog-import="">
|
||||
<Upload size={11} aria-hidden /> <span className="hidden md:inline">{XT.import}</span>
|
||||
</button>
|
||||
)}
|
||||
<button type="button" className="btn btn-sm btn-ghost" onClick={() => navigate(back)} aria-label={CT.back} data-catalog-back="">
|
||||
<ArrowLeft size={12} aria-hidden /> <span className="hidden sm:inline">{CT.back}</span>
|
||||
</button>
|
||||
@@ -481,6 +581,9 @@ export function CatalogPage() {
|
||||
onReset={() => setJob(null)}
|
||||
/>
|
||||
)}
|
||||
{importing && (
|
||||
<ImportDialog sourceId={sourceId} onClose={() => setImporting(false)} onImported={onTablesWritten} />
|
||||
)}
|
||||
{profileSettingsOpen && source && (
|
||||
<ProfileSettingsDialog row={{ id: source.id, name: source.name, options }} onClose={() => setProfileSettingsOpen(false)}
|
||||
onSaved={onProfileSettingsSaved} />
|
||||
@@ -524,6 +627,51 @@ function DraftStrip({ job, notice, onOpen }: {
|
||||
)
|
||||
}
|
||||
|
||||
/** 存成文件(同运行记录里的下载):浏览器下载,文件名照给的 */
|
||||
function saveFile(name: string, blob: Blob) {
|
||||
const url = URL.createObjectURL(blob)
|
||||
const a = document.createElement('a')
|
||||
a.href = url
|
||||
a.download = name
|
||||
a.click()
|
||||
setTimeout(() => URL.revokeObjectURL(url), 1000)
|
||||
}
|
||||
|
||||
const VIEWS: CatalogView[] = ['list', 'review']
|
||||
|
||||
/**
|
||||
* 左栏上方的两个视图:表清单(逐表看)、审阅队列(跨表按优先级看推断项,带着还有几项待确认)。标签页语义,
|
||||
* ←→ Home End 切换
|
||||
*/
|
||||
function ViewTabs({ view, proposed, onChange }: { view: CatalogView; proposed: number; onChange: (v: CatalogView) => void }) {
|
||||
const refs = useRef<Record<string, HTMLButtonElement | null>>({})
|
||||
const move = (e: ReactKeyboardEvent, i: number) => {
|
||||
const j = rovingTarget(e, i, VIEWS.length, 'horizontal')
|
||||
if (j < 0) return
|
||||
e.preventDefault()
|
||||
onChange(VIEWS[j])
|
||||
refs.current[VIEWS[j]]?.focus()
|
||||
}
|
||||
return (
|
||||
<div className="flex shrink-0 gap-1 border-b px-2" role="tablist" aria-label={RT.viewLabel} data-catalog-view={view}>
|
||||
{VIEWS.map((v, i) => {
|
||||
const selected = view === v
|
||||
return (
|
||||
<button key={v} ref={(el) => { refs.current[v] = el }} type="button" role="tab" id={`catalog-view-tab-${v}`} aria-selected={selected}
|
||||
aria-controls="catalog-view-panel" tabIndex={selected ? 0 : -1} title={RT.viewHint[v]}
|
||||
onClick={() => onChange(v)} onKeyDown={(e) => move(e, i)} data-catalog-view-tab={v}
|
||||
className={clsx('relative px-3 py-2 text-xs outline-none transition-colors focus-visible:ring-2 focus-visible:ring-inset focus-visible:ring-[var(--accent)]',
|
||||
selected ? 'text-fg' : 'text-faint hover:text-dim')}>
|
||||
{RT.view[v]}
|
||||
{v === 'review' && proposed > 0 && <span className="tnum ml-1.5 text-2xs text-faint">{formatNumber(proposed)}</span>}
|
||||
{selected && <span className="absolute inset-x-2 -bottom-px h-0.5 rounded bg-[var(--accent)]" aria-hidden />}
|
||||
</button>
|
||||
)
|
||||
})}
|
||||
</div>
|
||||
)
|
||||
}
|
||||
|
||||
/** 媒体查询的当前结果,跟着窗口大小变 */
|
||||
function useMedia(query: string): boolean {
|
||||
const [on, setOn] = useState(() => typeof matchMedia !== 'function' || matchMedia(query).matches)
|
||||
@@ -601,13 +749,14 @@ function UsageSummary({ used, pending, none, active, onFocus }: {
|
||||
)
|
||||
}
|
||||
|
||||
/** 没有选中表时的右栏:空目录时引导起草;否则写审阅进度,给出下一张该审的表 */
|
||||
function Overview({ rows, empty, systemNotes, draft, onOpen }: {
|
||||
/** 没有选中表时的右栏:空目录时引导起草;否则写审阅进度,给出下一张该审的表,也可以去审阅队列跨表成批审阅 */
|
||||
function Overview({ rows, empty, systemNotes, draft, onOpen, onReview }: {
|
||||
rows: CatalogTableRow[]
|
||||
empty: boolean
|
||||
systemNotes: boolean
|
||||
draft: ReactNode
|
||||
onOpen: (table: string) => void
|
||||
onReview: () => void
|
||||
}) {
|
||||
const pendingNext = rows.find((r) => r.in_schema && r.counts.proposed > 0)
|
||||
const stats = { pending: 0, done: 0, none: 0 }
|
||||
@@ -634,6 +783,12 @@ function Overview({ rows, empty, systemNotes, draft, onOpen }: {
|
||||
<span className="text-2xs text-faint">{CT.reviewNextHint}</span>
|
||||
</div>
|
||||
)}
|
||||
{pendingNext && (
|
||||
<div className="flex flex-wrap items-center gap-2">
|
||||
<button type="button" className="btn btn-sm" onClick={onReview} data-catalog-open-review="">{RT.openQueue}</button>
|
||||
<span className="text-2xs text-faint">{RT.openQueueHint}</span>
|
||||
</div>
|
||||
)}
|
||||
</div>
|
||||
)}
|
||||
{systemNotes && <SystemNotesNotice />}
|
||||
|
||||
@@ -0,0 +1,409 @@
|
||||
import { memo, useCallback, useEffect, useMemo, useRef, useState } from 'react'
|
||||
import { AlertTriangle, CheckCheck, RotateCcw, RotateCw, X } from 'lucide-react'
|
||||
import clsx from 'clsx'
|
||||
import { api } from '../../api/client'
|
||||
import type {
|
||||
CatalogDetail, CatalogReviewAction, CatalogReviewItem, CatalogReviewKind, CatalogReviewProgress, CatalogTableRow,
|
||||
} from '../../types'
|
||||
import { EmptyState, ErrorState, Notice, Skeleton, Spinner, confirmDialog, toast, useRadioGroup } from '../../components/ui'
|
||||
import { errorMessage } from '../../lib/errors'
|
||||
import { CATALOG_REVIEW_TEXT as RT } from '../../lib/terms'
|
||||
import { StatusChip } from './parts'
|
||||
import {
|
||||
REVIEW_BATCH_MAX, REVIEW_KINDS, REVIEW_PAGE, applyResults, batchTargets, itemKey, percentOf, statusOf, syncFromDetail,
|
||||
} from './review'
|
||||
import type { ItemOutcome } from './review'
|
||||
|
||||
// ===========================================================================
|
||||
// 审阅队列(数据目录页的「审阅队列」视图,左栏):跨表列出推断项,顺序由服务端排好(所在表的使用次数 × 这一项对数字的
|
||||
// 影响 × 来源),每一项写为什么排在这里。可以按项(影响数字的项 / 名称和含义)和表筛选;多选后成批确认、驳回,审阅过的
|
||||
// 原地标出结果(冲突的标出来),选中可以撤销审阅;刷新队列后审阅过的才移除。顶上是审阅进度:常用 20 张表、全部表、
|
||||
// 影响数字的项各确认了多少。点开一项,右栏是所在表的详情(滚到那一项、标出来)和用过这张表的运行。
|
||||
// ===========================================================================
|
||||
|
||||
export function ReviewQueue({ sourceId, rows, kind, table, activeKey, detailSync, onParams, onOpenItem, onChanged }: {
|
||||
sourceId: string
|
||||
/** 目录清单的各行:按表筛选的候选(有推断项的表)、表的中文名 */
|
||||
rows: CatalogTableRow[]
|
||||
kind: CatalogReviewKind
|
||||
/** 只看这一张表;空串是全部表 */
|
||||
table: string
|
||||
/** 右栏正打开的那一项(itemKey) */
|
||||
activeKey: string | null
|
||||
/** 右栏的表详情载入、改过之后的目录:队列里这张表的项跟着换状态 */
|
||||
detailSync: { seq: number; detail: CatalogDetail } | null
|
||||
onParams: (p: { kind?: CatalogReviewKind; table?: string }) => void
|
||||
onOpenItem: (item: CatalogReviewItem) => void
|
||||
/** 成批审阅写进了这些表:页面重取清单、正在看的表重新载入 */
|
||||
onChanged: (tables: string[]) => void
|
||||
}) {
|
||||
const [items, setItems] = useState<CatalogReviewItem[] | null>(null)
|
||||
const [total, setTotal] = useState(0)
|
||||
const [loadError, setLoadError] = useState<unknown>(null)
|
||||
const [loadingMore, setLoadingMore] = useState(false)
|
||||
const [outcomes, setOutcomes] = useState<Map<string, ItemOutcome>>(() => new Map())
|
||||
const [versions, setVersions] = useState<Map<string, number>>(() => new Map())
|
||||
const [selected, setSelected] = useState<Set<string>>(() => new Set())
|
||||
const [acting, setActing] = useState<CatalogReviewAction | null>(null)
|
||||
const [summary, setSummary] = useState<{ action: CatalogReviewAction; ok: number; conflicts: number; failed: number } | null>(null)
|
||||
const [batchError, setBatchError] = useState<string | null>(null)
|
||||
const [progress, setProgress] = useState<CatalogReviewProgress | null>(null)
|
||||
const [progressError, setProgressError] = useState(false)
|
||||
const [reloadSeq, setReloadSeq] = useState(0)
|
||||
const loadSeq = useRef(0)
|
||||
const itemsRef = useRef(items)
|
||||
itemsRef.current = items
|
||||
const outcomesRef = useRef(outcomes)
|
||||
outcomesRef.current = outcomes
|
||||
const versionsRef = useRef(versions)
|
||||
versionsRef.current = versions
|
||||
const allRef = useRef<HTMLInputElement>(null)
|
||||
const radio = useRadioGroup(REVIEW_KINDS, kind, (k) => onParams({ kind: k }))
|
||||
|
||||
const loadProgress = useCallback(() => {
|
||||
api.dataCatalog.reviewProgress(sourceId).then((p) => { setProgress(p); setProgressError(false) }, () => setProgressError(true))
|
||||
}, [sourceId])
|
||||
useEffect(() => { loadProgress() }, [loadProgress])
|
||||
|
||||
// 第一页:筛选变了、点了刷新就从头取,审阅过的标记、选择、汇总都清掉
|
||||
useEffect(() => {
|
||||
const mine = ++loadSeq.current
|
||||
setItems(null)
|
||||
setLoadError(null)
|
||||
api.dataCatalog.reviewQueue(sourceId, { limit: REVIEW_PAGE, offset: 0, kind, table: table || null }).then((q) => {
|
||||
if (mine !== loadSeq.current) return
|
||||
setItems(q.items)
|
||||
setTotal(q.total)
|
||||
setOutcomes(new Map())
|
||||
setVersions(new Map())
|
||||
setSelected(new Set())
|
||||
setSummary(null)
|
||||
setBatchError(null)
|
||||
}, (e) => { if (mine === loadSeq.current) setLoadError(e) })
|
||||
}, [sourceId, kind, table, reloadSeq])
|
||||
|
||||
const refresh = () => {
|
||||
setReloadSeq((n) => n + 1)
|
||||
loadProgress()
|
||||
}
|
||||
|
||||
/**
|
||||
* 再载入一页。服务端的队列里已经没有审阅成功、不再是推断的项:偏移按「这一页上还在服务端队列里的项」数,
|
||||
* 不会跳过没载入的项
|
||||
*/
|
||||
const loadMore = async () => {
|
||||
const list = itemsRef.current
|
||||
if (!list || loadingMore) return
|
||||
const gone = list.filter((i) => statusOf(i, outcomes.get(itemKey(i))) !== 'proposed').length
|
||||
setLoadingMore(true)
|
||||
try {
|
||||
const q = await api.dataCatalog.reviewQueue(sourceId, { limit: REVIEW_PAGE, offset: list.length - gone, kind, table: table || null })
|
||||
setItems((cur) => {
|
||||
const have = new Set((cur ?? []).map(itemKey))
|
||||
return [...(cur ?? []), ...q.items.filter((i) => !have.has(itemKey(i)))]
|
||||
})
|
||||
setTotal(q.total + gone)
|
||||
} catch (e) {
|
||||
toast.error(e)
|
||||
} finally {
|
||||
setLoadingMore(false)
|
||||
}
|
||||
}
|
||||
|
||||
// 右栏的表详情载入、改过:这张表的项按最新的目录换状态
|
||||
const syncSeen = useRef(detailSync?.seq ?? 0)
|
||||
useEffect(() => {
|
||||
if (!detailSync || detailSync.seq === syncSeen.current) return
|
||||
syncSeen.current = detailSync.seq
|
||||
const list = itemsRef.current
|
||||
if (!list) return
|
||||
const d = detailSync.detail
|
||||
if (!list.some((i) => i.table_name === d.table_name)) return
|
||||
const next = syncFromDetail(list, d.table_name, d.notes, d.version, outcomesRef.current, versionsRef.current)
|
||||
setOutcomes(next.outcomes)
|
||||
setVersions(next.versions)
|
||||
loadProgress()
|
||||
}, [detailSync, loadProgress])
|
||||
|
||||
const act = async (action: CatalogReviewAction) => {
|
||||
const list = itemsRef.current ?? []
|
||||
const targets = batchTargets(list, selected, action, outcomes)
|
||||
if (!targets.length || acting) return
|
||||
if (targets.length > REVIEW_BATCH_MAX) {
|
||||
setBatchError(RT.tooMany(REVIEW_BATCH_MAX))
|
||||
return
|
||||
}
|
||||
if (action !== 'reset') {
|
||||
const ok = await confirmDialog(action === 'confirm'
|
||||
? { title: RT.confirmTitle(targets.length), consequences: RT.confirmConsequences, confirmLabel: RT.confirmAction(targets.length) }
|
||||
: { title: RT.rejectTitle(targets.length), consequences: RT.rejectConsequences, confirmLabel: RT.rejectAction(targets.length), danger: true })
|
||||
if (!ok) return
|
||||
}
|
||||
setActing(action)
|
||||
setBatchError(null)
|
||||
try {
|
||||
const { results } = await api.dataCatalog.reviewBatch(sourceId, targets.map((i) => ({
|
||||
table_name: i.table_name, path: i.path, action, if_version: versions.get(i.table_name) ?? i.version,
|
||||
})))
|
||||
const next = applyResults(results, action, outcomes, versions)
|
||||
setOutcomes(next.outcomes)
|
||||
setVersions(next.versions)
|
||||
setSelected(new Set())
|
||||
const ok = results.filter((r) => r.ok)
|
||||
const conflicts = results.filter((r) => !r.ok && next.outcomes.get(itemKey(r))?.kind === 'conflict').length
|
||||
setSummary({ action, ok: ok.length, conflicts, failed: results.length - ok.length - conflicts })
|
||||
if (ok.length) onChanged([...new Set(ok.map((r) => r.table_name))])
|
||||
loadProgress()
|
||||
} catch (e) {
|
||||
setBatchError(RT.failedAll(errorMessage(e)))
|
||||
} finally {
|
||||
setActing(null)
|
||||
}
|
||||
}
|
||||
|
||||
// 按表筛选的候选:有推断项的表(使用次数多的在前),正在筛的那张不在里面也列上
|
||||
const tableOptions = useMemo(() => {
|
||||
const list = rows.filter((r) => r.counts.proposed > 0)
|
||||
if (table && !list.some((r) => r.table_name === table)) {
|
||||
const row = rows.find((r) => r.table_name === table)
|
||||
return [...list, row ?? ({ table_name: table, label: null, counts: { proposed: 0 } } as unknown as CatalogTableRow)]
|
||||
}
|
||||
return list
|
||||
}, [rows, table])
|
||||
const labelOf = useMemo(() => new Map(rows.map((r) => [r.table_name, r.label])), [rows])
|
||||
|
||||
const loaded = items ?? []
|
||||
const picked = loaded.filter((i) => selected.has(itemKey(i))).length
|
||||
const all = loaded.length > 0 && picked === loaded.length
|
||||
useEffect(() => {
|
||||
if (allRef.current) allRef.current.indeterminate = picked > 0 && !all
|
||||
}, [picked, all])
|
||||
const toggleAll = () => setSelected(all ? new Set() : new Set(loaded.map(itemKey)))
|
||||
const toggle = useCallback((key: string) => setSelected((cur) => {
|
||||
const next = new Set(cur)
|
||||
if (next.has(key)) next.delete(key)
|
||||
else next.add(key)
|
||||
return next
|
||||
}), [])
|
||||
const counts = {
|
||||
confirm: batchTargets(loaded, selected, 'confirm', outcomes).length,
|
||||
reject: batchTargets(loaded, selected, 'reject', outcomes).length,
|
||||
reset: batchTargets(loaded, selected, 'reset', outcomes).length,
|
||||
}
|
||||
const filtered = kind !== 'all' || !!table
|
||||
const remaining = Math.max(0, total - loaded.length)
|
||||
|
||||
return (
|
||||
<div className="flex min-h-0 flex-1 flex-col" data-review-queue="" aria-label={RT.queueLabel}>
|
||||
<ProgressBlock progress={progress} failed={progressError} />
|
||||
<div className="space-y-2 border-b px-3 py-2.5">
|
||||
<div role="radiogroup" aria-label={RT.kindLabel} className="flex flex-wrap gap-1" data-review-kinds={kind}>
|
||||
{REVIEW_KINDS.map((k) => (
|
||||
<button key={k} type="button" {...radio(k)} title={RT.kindHint[k]} onClick={() => onParams({ kind: k })} data-review-kind={k}
|
||||
className={clsx(
|
||||
'inline-flex items-center rounded-md border px-2 py-0.5 text-2xs outline-none focus-visible:ring-2 focus-visible:ring-[var(--accent)]',
|
||||
kind === k ? 'border-[var(--accent)] bg-accent-soft text-fg' : 'text-dim hover:bg-hover hover:text-fg',
|
||||
)}>
|
||||
{RT.kind[k]}
|
||||
</button>
|
||||
))}
|
||||
</div>
|
||||
<div className="flex items-center gap-2">
|
||||
<label className="sr-only" htmlFor="catalog-review-table">{RT.tableLabel}</label>
|
||||
<select id="catalog-review-table" className="field min-w-0 flex-1 !py-0.5 !text-2xs" value={table}
|
||||
onChange={(e) => onParams({ table: e.target.value })} data-review-table="">
|
||||
<option value="">{RT.tableAll}</option>
|
||||
{tableOptions.map((r) => (
|
||||
<option key={r.table_name} value={r.table_name}>{RT.tableOption(r.label, r.table_name, r.counts.proposed)}</option>
|
||||
))}
|
||||
</select>
|
||||
<button type="button" className="btn btn-sm btn-ghost shrink-0 !px-1.5" onClick={refresh} aria-label={RT.refresh} title={RT.refreshHint}
|
||||
data-review-refresh="">
|
||||
<RotateCw size={12} aria-hidden />
|
||||
</button>
|
||||
</div>
|
||||
<div className="flex items-center gap-2 text-2xs text-faint">
|
||||
<input ref={allRef} type="checkbox" checked={all} onChange={toggleAll} disabled={!loaded.length}
|
||||
aria-label={RT.selectAll} title={RT.selectAll} data-review-select-all="" />
|
||||
<span className="tnum min-w-0 flex-1 truncate" data-review-total="">
|
||||
{selected.size ? RT.selected(selected.size) : items ? RT.total(total) : RT.loading}
|
||||
</span>
|
||||
{selected.size > 0 && (
|
||||
<button type="button" className="inline-flex items-center gap-0.5 rounded px-1 hover:bg-hover hover:text-fg"
|
||||
onClick={() => setSelected(new Set())} data-review-clear="">
|
||||
<X size={10} aria-hidden /> {RT.clearSelection}
|
||||
</button>
|
||||
)}
|
||||
</div>
|
||||
</div>
|
||||
|
||||
{summary && (
|
||||
<p className={clsx('flex items-start gap-1.5 border-b px-3 py-2 text-2xs leading-relaxed', summary.conflicts || summary.failed ? 'text-[var(--warn)]' : 'text-dim')}
|
||||
role="status" data-review-summary="">
|
||||
{summary.conflicts || summary.failed
|
||||
? <AlertTriangle size={11} className="mt-0.5 shrink-0" aria-hidden />
|
||||
: <CheckCheck size={11} className="mt-0.5 shrink-0" style={{ color: 'var(--st-done)' }} aria-hidden />}
|
||||
<span className="min-w-0">{RT.summary(summary.action, summary.ok, summary.conflicts, summary.failed)}</span>
|
||||
</p>
|
||||
)}
|
||||
{batchError && <div className="border-b px-3 py-2"><Notice tone="err" attr={{ 'data-review-batch-error': '' }}>{batchError}</Notice></div>}
|
||||
|
||||
<div className="relative min-h-0 flex-1 overflow-y-auto">
|
||||
{loadError
|
||||
? <div className="p-3"><ErrorState error={loadError} onRetry={refresh} compact /></div>
|
||||
: !items
|
||||
? <div className="p-3"><Skeleton rows={6} height={44} gap={8} /></div>
|
||||
: !items.length
|
||||
? (
|
||||
<EmptyState icon={<CheckCheck size={20} />} title={filtered ? RT.emptyFiltered : RT.empty}
|
||||
body={filtered ? RT.emptyFilteredBody : RT.emptyBody} offline={false} className="!py-10" />
|
||||
)
|
||||
: (
|
||||
<ul aria-label={RT.queueLabel}>
|
||||
{items.map((i) => {
|
||||
const key = itemKey(i)
|
||||
return (
|
||||
<QueueRow key={key} item={i} itemKeyText={key} tableLabel={labelOf.get(i.table_name) ?? null}
|
||||
outcome={outcomes.get(key)} checked={selected.has(key)} active={activeKey === key}
|
||||
onToggle={toggle} onOpen={onOpenItem} />
|
||||
)
|
||||
})}
|
||||
</ul>
|
||||
)}
|
||||
{items && remaining > 0 && (
|
||||
<div className="border-t px-3 py-2">
|
||||
<button type="button" className="btn btn-sm w-full" onClick={() => void loadMore()} disabled={loadingMore} data-review-more="">
|
||||
{loadingMore ? <><Spinner size={11} /> {RT.loading}</> : RT.more(Math.min(REVIEW_PAGE, remaining))}
|
||||
</button>
|
||||
</div>
|
||||
)}
|
||||
</div>
|
||||
|
||||
{selected.size > 0 && (
|
||||
<div className="flex flex-wrap items-center gap-1.5 border-t px-3 py-2" data-review-batch="">
|
||||
<span className="tnum text-2xs text-faint">{RT.selected(selected.size)}</span>
|
||||
<span className="flex-1" />
|
||||
<button type="button" className="btn btn-sm btn-primary" disabled={!counts.confirm || !!acting} onClick={() => void act('confirm')}
|
||||
data-review-action="confirm">
|
||||
{acting === 'confirm' ? <Spinner size={11} /> : null}{RT.confirm(counts.confirm)}
|
||||
</button>
|
||||
<button type="button" className="btn btn-sm" disabled={!counts.reject || !!acting} onClick={() => void act('reject')}
|
||||
data-review-action="reject">
|
||||
{acting === 'reject' ? <Spinner size={11} /> : null}{RT.reject(counts.reject)}
|
||||
</button>
|
||||
<button type="button" className="btn btn-sm btn-ghost" disabled={!counts.reset || !!acting} onClick={() => void act('reset')}
|
||||
title={RT.resetHint} data-review-action="reset">
|
||||
{acting === 'reset' ? <Spinner size={11} /> : <RotateCcw size={11} aria-hidden />} {RT.reset(counts.reset)}
|
||||
</button>
|
||||
</div>
|
||||
)}
|
||||
</div>
|
||||
)
|
||||
}
|
||||
|
||||
/** 队列里的一行:复选框、位置和所在表、值、说明、为什么排在这里、来源和状态(审阅过的写结果)、所在表的使用次数 */
|
||||
const QueueRow = memo(function QueueRow({ item: i, itemKeyText, tableLabel, outcome, checked, active, onToggle, onOpen }: {
|
||||
item: CatalogReviewItem
|
||||
itemKeyText: string
|
||||
tableLabel: string | null
|
||||
outcome: ItemOutcome | undefined
|
||||
checked: boolean
|
||||
active: boolean
|
||||
onToggle: (key: string) => void
|
||||
onOpen: (item: CatalogReviewItem) => void
|
||||
}) {
|
||||
const status = statusOf(i, outcome)
|
||||
const where = i.field_label || i.path
|
||||
const tableText = tableLabel ? `${tableLabel}(${i.table_name})` : i.table_name
|
||||
const mono = i.field === 'valid_filter' || i.field === 'keys'
|
||||
return (
|
||||
<li className={clsx('relative flex items-stretch border-b border-hairline', active ? 'bg-accent-soft' : 'hover:bg-hover')}
|
||||
data-review-item={`${i.table_name}::${i.path}`} data-review-result={outcome?.kind}>
|
||||
{active && <span className="absolute inset-y-0 left-0 w-0.5 bg-[var(--accent)]" aria-hidden />}
|
||||
<span className="flex shrink-0 items-start pl-3 pr-1 pt-2.5">
|
||||
<input type="checkbox" checked={checked} onChange={() => onToggle(itemKeyText)} aria-label={RT.select(where, i.table_name)}
|
||||
data-review-select="" />
|
||||
</span>
|
||||
<button type="button" className="min-w-0 flex-1 px-2 py-2 text-left outline-none focus-visible:ring-2 focus-visible:ring-inset focus-visible:ring-[var(--accent)]"
|
||||
onClick={() => onOpen(i)} aria-current={active ? 'true' : undefined} title={RT.open(where, i.table_name)} data-review-open="">
|
||||
<span className="flex items-baseline gap-2">
|
||||
<span className="min-w-0 flex-1 truncate text-xs font-medium text-fg">{where}</span>
|
||||
<span className="tnum shrink-0 text-2xs text-faint" title={RT.usageHint}>{RT.usage(i.table_usage)}</span>
|
||||
</span>
|
||||
<span className="mt-0.5 block truncate text-2xs text-faint" title={tableText}>{tableText}</span>
|
||||
<span className={clsx('mt-1 block break-words text-2xs text-dim', mono && 'mono', status === 'rejected' && 'line-through')}
|
||||
data-review-value="">{i.display || '—'}</span>
|
||||
{i.note && <span className="mt-0.5 block break-words text-2xs leading-relaxed text-faint" data-review-note="">{i.note}</span>}
|
||||
{i.reasons.length > 0 && (
|
||||
<span className="mt-1 block text-2xs leading-relaxed text-faint" data-review-reasons="">
|
||||
<span className="sr-only">{RT.reasonsLabel}:</span>{i.reasons.join(' · ')}
|
||||
</span>
|
||||
)}
|
||||
<span className="mt-1 flex flex-wrap items-center gap-1.5" data-review-outcome="">
|
||||
<StatusChip status={status} source={i.source} />
|
||||
{outcome?.kind === 'ok' && <span className="text-2xs" style={{ color: 'var(--st-done)' }}>{RT.done[outcome.action]}</span>}
|
||||
{outcome?.kind === 'conflict' && (
|
||||
<span className="text-2xs text-[var(--warn)]" title={outcome.message ?? undefined}>{RT.conflict}</span>
|
||||
)}
|
||||
{outcome?.kind === 'error' && (
|
||||
<span className="text-2xs text-[var(--err)]">{outcome.message ? `${RT.failed}:${outcome.message}` : RT.failed}</span>
|
||||
)}
|
||||
</span>
|
||||
</button>
|
||||
</li>
|
||||
)
|
||||
})
|
||||
|
||||
/** 审阅进度:常用 20 张表、全部表、影响数字的项。数字写在字里,色条只给眼睛看 */
|
||||
function ProgressBlock({ progress, failed }: { progress: CatalogReviewProgress | null; failed: boolean }) {
|
||||
if (!progress) {
|
||||
return (
|
||||
<div className="border-b px-3 py-2 text-2xs text-faint" data-review-progress={failed ? 'error' : 'loading'}>
|
||||
{failed ? RT.progressFailed : <Skeleton rows={2} height={10} gap={6} />}
|
||||
</div>
|
||||
)
|
||||
}
|
||||
const { top, all, facts } = progress
|
||||
const topPct = percentOf(top.items_confirmed, top.items_total)
|
||||
const allPct = percentOf(all.items_confirmed, all.items_total)
|
||||
const factsPct = percentOf(facts.confirmed, facts.proposed + facts.confirmed)
|
||||
return (
|
||||
<section className="space-y-1.5 border-b px-3 py-2.5" aria-label={RT.progressTitle} data-review-progress="">
|
||||
<ProgressLine label={RT.progressTop(progress.top_n)} hint={RT.progressTopHint(progress.top_n)} pct={topPct}
|
||||
text={`${RT.confirmedPct(topPct)} · ${RT.itemsOf(top.items_confirmed, top.items_total)}`} attr="top" />
|
||||
<ProgressLine label={RT.progressAll} pct={allPct}
|
||||
text={`${RT.confirmedPct(allPct)} · ${RT.allDetail(all.items_proposed, all.items_rejected)}`} attr="all" />
|
||||
<ProgressLine label={RT.progressFacts} hint={RT.progressFactsHint} pct={factsPct}
|
||||
text={RT.factsDetail(facts.proposed, facts.confirmed)} attr="facts" warn={facts.proposed > 0} />
|
||||
</section>
|
||||
)
|
||||
}
|
||||
|
||||
function ProgressLine({ label, hint, pct, text, attr, warn = false }: {
|
||||
label: string; hint?: string; pct: number | null; text: string; attr: string; warn?: boolean
|
||||
}) {
|
||||
return (
|
||||
<div className="text-2xs" data-review-progress-line={attr} {...{ [`data-review-progress-${attr}`]: '' }}>
|
||||
<div className="flex items-baseline gap-2">
|
||||
<span className="shrink-0 font-medium text-dim" title={hint}>{label}</span>
|
||||
<span className={clsx('tnum min-w-0 flex-1 truncate text-right', warn ? 'text-[var(--st-waiting)]' : 'text-faint')} title={text}>{text}</span>
|
||||
</div>
|
||||
<div className="mt-0.5 h-1 overflow-hidden rounded-full bg-hover" aria-hidden>
|
||||
<div className="h-full rounded-full bg-[var(--st-done)]" style={{ width: `${pct ?? 0}%` }} />
|
||||
</div>
|
||||
</div>
|
||||
)
|
||||
}
|
||||
|
||||
/** 审阅视图里没打开项时的右栏:怎么排的序、点开能看到什么 */
|
||||
export function ReviewOverview() {
|
||||
return (
|
||||
<div className="relative min-h-0 flex-1 overflow-y-auto">
|
||||
<div className="mx-auto max-w-xl space-y-3 p-6" data-review-overview="">
|
||||
<h2 className="text-sm font-semibold">{RT.overviewTitle}</h2>
|
||||
<p className="text-xs leading-relaxed text-dim">{RT.overviewBody}</p>
|
||||
<p className="tnum text-2xs text-faint">{RT.kindHint.facts}</p>
|
||||
</div>
|
||||
</div>
|
||||
)
|
||||
}
|
||||
@@ -0,0 +1,278 @@
|
||||
import { useState } from 'react'
|
||||
import type { ChangeEvent } from 'react'
|
||||
import { AlertTriangle, ArrowRight, FileJson, Upload } from 'lucide-react'
|
||||
import clsx from 'clsx'
|
||||
import { api } from '../../api/client'
|
||||
import type { CatalogImportReport, CatalogImportTable } from '../../types'
|
||||
import { Modal, Notice, Spinner } from '../../components/ui'
|
||||
import { errorMessage } from '../../lib/errors'
|
||||
import { formatDateTime, formatNumber } from '../../lib/format'
|
||||
import { CATALOG_TRANSFER_TEXT as T } from '../../lib/terms'
|
||||
import { patchValueText } from '../../run/catalogPatch'
|
||||
|
||||
// ===========================================================================
|
||||
// 导入数据目录(数据目录页的「导入目录」):选文件 → 预览(只读:对上了哪些表,各有几项新增、更新、保留、冲突、跳过,
|
||||
// 冲突逐条列出)→ 确认导入 → 结果(逐表写入后的版本)。规矩由服务端定(data/catalog_transfer.py),这里照预览写出来,
|
||||
// 写入前让人看清楚哪些会动、哪些以这里为准。
|
||||
//
|
||||
// 导出不在这里:页头的「导出目录」直接下载文件(CatalogPage)。
|
||||
// ===========================================================================
|
||||
|
||||
type Step = 'choose' | 'preview' | 'done'
|
||||
|
||||
interface Chosen {
|
||||
name: string
|
||||
content: unknown
|
||||
/** 文件里写的来源数据源和导出时间(认得出才有) */
|
||||
source: string | null
|
||||
exportedAt: string | null
|
||||
}
|
||||
|
||||
const COUNT_KEYS = ['add', 'update', 'keep', 'conflicts', 'skipped'] as const
|
||||
|
||||
export function ImportDialog({ sourceId, onClose, onImported }: {
|
||||
sourceId: string
|
||||
onClose: () => void
|
||||
/** 导入写进了这些表(这个数据源里的表名):页面重取清单、正在看的表重新载入 */
|
||||
onImported: (tables: string[]) => void
|
||||
}) {
|
||||
const [step, setStep] = useState<Step>('choose')
|
||||
const [file, setFile] = useState<Chosen | null>(null)
|
||||
const [includeGuidance, setIncludeGuidance] = useState(true)
|
||||
const [report, setReport] = useState<CatalogImportReport | null>(null)
|
||||
const [result, setResult] = useState<CatalogImportReport | null>(null)
|
||||
const [busy, setBusy] = useState<'preview' | 'import' | null>(null)
|
||||
const [error, setError] = useState<string | null>(null)
|
||||
|
||||
const choose = async (e: ChangeEvent<HTMLInputElement>) => {
|
||||
const f = e.target.files?.[0]
|
||||
e.target.value = ''
|
||||
if (!f) return
|
||||
setError(null)
|
||||
setFile(null)
|
||||
let text: string
|
||||
try {
|
||||
text = await f.text()
|
||||
} catch {
|
||||
setError(T.readFailed)
|
||||
return
|
||||
}
|
||||
let content: unknown
|
||||
try {
|
||||
content = JSON.parse(text)
|
||||
} catch {
|
||||
setError(T.notJson)
|
||||
return
|
||||
}
|
||||
const meta = content && typeof content === 'object' ? content as { source?: { name?: unknown }; exported_at?: unknown } : {}
|
||||
setFile({
|
||||
name: f.name, content,
|
||||
source: typeof meta.source?.name === 'string' ? meta.source.name : null,
|
||||
exportedAt: typeof meta.exported_at === 'string' ? meta.exported_at : null,
|
||||
})
|
||||
}
|
||||
|
||||
const preview = async () => {
|
||||
if (!file || busy) return
|
||||
setBusy('preview')
|
||||
setError(null)
|
||||
try {
|
||||
const r = await api.dataCatalog.importPreview(sourceId, { content: file.content, include_guidance: includeGuidance })
|
||||
setReport(r)
|
||||
setStep('preview')
|
||||
} catch (e) {
|
||||
// 文件格式不对(422)、没有表结构……服务端那句话照原样写,留在这一步
|
||||
setError(errorMessage(e))
|
||||
} finally {
|
||||
setBusy(null)
|
||||
}
|
||||
}
|
||||
|
||||
const doImport = async () => {
|
||||
if (!file || busy) return
|
||||
setBusy('import')
|
||||
setError(null)
|
||||
try {
|
||||
const r = await api.dataCatalog.importCatalog(sourceId, { content: file.content, include_guidance: includeGuidance })
|
||||
setResult(r)
|
||||
setStep('done')
|
||||
onImported(r.tables.filter((t) => !t.error).map((t) => t.matched_as ?? t.table_name))
|
||||
} catch (e) {
|
||||
// 有起草任务在进行(409)、别的原因:写服务端那句话,留在预览
|
||||
setError(errorMessage(e))
|
||||
} finally {
|
||||
setBusy(null)
|
||||
}
|
||||
}
|
||||
|
||||
const back = () => {
|
||||
setStep('choose')
|
||||
setReport(null)
|
||||
setError(null)
|
||||
}
|
||||
|
||||
const importable = report ? report.tables.length : 0
|
||||
const footer = step === 'choose'
|
||||
? (
|
||||
<>
|
||||
<button type="button" className="btn" onClick={onClose}>{T.cancel}</button>
|
||||
<button type="button" className="btn btn-primary" onClick={() => void preview()} disabled={!file || !!busy} data-import-preview="">
|
||||
{busy === 'preview' ? <><Spinner size={11} /> {T.previewing}</> : T.preview}
|
||||
</button>
|
||||
</>
|
||||
)
|
||||
: step === 'preview'
|
||||
? (
|
||||
<>
|
||||
<button type="button" className="btn" onClick={back} disabled={!!busy} data-import-back="">{T.back}</button>
|
||||
<button type="button" className="btn btn-primary" onClick={() => void doImport()} disabled={!importable || !!busy} data-import-confirm="">
|
||||
{busy === 'import' ? <><Spinner size={11} /> {T.importing}</> : T.confirm(importable)}
|
||||
</button>
|
||||
</>
|
||||
)
|
||||
: <button type="button" className="btn btn-primary" onClick={onClose} data-autofocus data-import-close="">{T.close}</button>
|
||||
|
||||
return (
|
||||
<Modal open onClose={onClose} title={T.title} width={640} footer={footer}>
|
||||
<div className="min-w-0 space-y-3 text-xs" data-import-dialog="" data-step={step}>
|
||||
{step === 'choose' && (
|
||||
<>
|
||||
<div className="space-y-1.5">
|
||||
<p className="label">{T.chooseLabel}</p>
|
||||
<div className="flex flex-wrap items-center gap-2">
|
||||
<label className="btn btn-sm cursor-pointer focus-within:ring-2 focus-within:ring-[var(--accent)]">
|
||||
<Upload size={11} aria-hidden /> {T.choose}
|
||||
<input type="file" accept=".json,application/json" className="sr-only" onChange={(e) => void choose(e)}
|
||||
aria-label={T.chooseLabel} data-import-file="" />
|
||||
</label>
|
||||
<span className="text-2xs text-faint">{T.chooseHint}</span>
|
||||
</div>
|
||||
{file && (
|
||||
<p className="flex min-w-0 flex-wrap items-center gap-x-2 gap-y-0.5 text-2xs text-dim" data-import-file-meta="">
|
||||
<FileJson size={11} className="shrink-0" aria-hidden />
|
||||
<span className="min-w-0 break-all">{T.chosen(file.name)}</span>
|
||||
{file.source && <span className="text-faint">{T.fileMeta(file.source, file.exportedAt ? formatDateTime(file.exportedAt) : '—')}</span>}
|
||||
</p>
|
||||
)}
|
||||
</div>
|
||||
<label className="flex cursor-pointer items-start gap-2 rounded-md border px-3 py-2" data-import-guidance="">
|
||||
<input type="checkbox" className="mt-0.5" checked={includeGuidance} onChange={(e) => setIncludeGuidance(e.target.checked)} />
|
||||
<span className="min-w-0">
|
||||
<span className="font-medium">{T.includeGuidance}</span>
|
||||
<span className="mt-0.5 block text-2xs text-faint">{T.includeGuidanceHint}</span>
|
||||
</span>
|
||||
</label>
|
||||
<div className="rounded-md border bg-bg px-3 py-2">
|
||||
<p className="text-2xs font-medium text-dim">{T.rulesTitle}</p>
|
||||
<ul className="mt-1 list-disc space-y-0.5 pl-4 text-2xs leading-relaxed text-faint" data-import-rules="">
|
||||
{T.rules.map((r) => <li key={r}>{r}</li>)}
|
||||
</ul>
|
||||
</div>
|
||||
</>
|
||||
)}
|
||||
|
||||
{step === 'preview' && report && <ReportView report={report} />}
|
||||
|
||||
{step === 'done' && result && (
|
||||
<>
|
||||
<Notice tone="info" attr={{ 'data-import-done': '' }}>
|
||||
<p className="font-medium">{T.done}</p>
|
||||
<p className="mt-0.5 text-dim">{T.doneTotals(result.totals)}</p>
|
||||
</Notice>
|
||||
<ReportView report={result} done />
|
||||
</>
|
||||
)}
|
||||
|
||||
{error && <Notice tone="err" attr={{ 'data-import-error': '' }}>{error}</Notice>}
|
||||
</div>
|
||||
</Modal>
|
||||
)
|
||||
}
|
||||
|
||||
/** 预览、导入结果:合计、逐表的计数(导入后写第几版)、对不上的表、冲突逐条、跳过的原因、起草要求怎么处理 */
|
||||
function ReportView({ report, done = false }: { report: CatalogImportReport; done?: boolean }) {
|
||||
const conflicts = report.tables.flatMap((t) => t.conflicts.map((c) => ({ t, c })))
|
||||
const skipped = report.tables.flatMap((t) => t.skipped.map((s) => ({ t, s })))
|
||||
return (
|
||||
<div className="min-w-0 space-y-3">
|
||||
{!done && <p className="tnum text-sm" data-import-totals="">{T.totals(report.totals)}</p>}
|
||||
{report.tables.length > 0
|
||||
? (
|
||||
<div className="overflow-x-auto rounded-md border">
|
||||
<table className="w-full border-collapse text-2xs">
|
||||
<thead>
|
||||
<tr className="border-b bg-elev text-left text-faint">
|
||||
<th scope="col" className="px-2.5 py-1.5 font-medium">{T.head.table}</th>
|
||||
{COUNT_KEYS.map((k) => <th key={k} scope="col" className="px-2 py-1.5 text-right font-medium">{T.head[k]}</th>)}
|
||||
</tr>
|
||||
</thead>
|
||||
<tbody>
|
||||
{report.tables.map((t) => <TableRow key={t.table_name} t={t} done={done} />)}
|
||||
</tbody>
|
||||
</table>
|
||||
</div>
|
||||
)
|
||||
: <p className="text-faint" data-import-nothing="">{T.nothing}</p>}
|
||||
{report.unmatched_tables.length > 0 && (
|
||||
<p className="break-words text-2xs leading-relaxed text-dim" data-import-unmatched="">
|
||||
{T.unmatched(report.unmatched_tables.length)}
|
||||
<span className="mono">{report.unmatched_tables.join('、')}</span>
|
||||
</p>
|
||||
)}
|
||||
{conflicts.length > 0 && (
|
||||
<section aria-label={T.conflictsTitle(conflicts.length)}>
|
||||
<p className="mb-1 flex items-center gap-1 text-2xs font-medium text-[var(--warn)]">
|
||||
<AlertTriangle size={11} aria-hidden /> {T.conflictsTitle(conflicts.length)}
|
||||
</p>
|
||||
<ul className="divide-y divide-[var(--hairline)] rounded-md border">
|
||||
{conflicts.map(({ t, c }) => (
|
||||
<li key={`${t.table_name}:${c.path}`} className="px-2.5 py-1.5 text-2xs leading-relaxed" data-import-conflict={`${t.table_name}:${c.path}`}>
|
||||
<p className="font-medium text-fg"><span className="mono">{t.table_name}</span> · {c.label || c.path}</p>
|
||||
<p className="flex flex-wrap items-center gap-x-1.5 text-dim">
|
||||
<span><span className="text-faint">{T.conflictFile}:</span>{patchValueText(c.path, c.file_value)}</span>
|
||||
<ArrowRight size={10} className="text-faint" aria-hidden />
|
||||
<span><span className="text-faint">{T.conflictTarget}:</span>{patchValueText(c.path, c.target_value)}</span>
|
||||
</p>
|
||||
{c.why && <p className="text-faint">{c.why}</p>}
|
||||
</li>
|
||||
))}
|
||||
</ul>
|
||||
</section>
|
||||
)}
|
||||
{skipped.length > 0 && (
|
||||
<section aria-label={T.skippedTitle(skipped.length)}>
|
||||
<p className="mb-1 text-2xs font-medium text-dim">{T.skippedTitle(skipped.length)}</p>
|
||||
<ul className="divide-y divide-[var(--hairline)] rounded-md border">
|
||||
{skipped.map(({ t, s }) => (
|
||||
<li key={`${t.table_name}:${s.path}`} className="px-2.5 py-1.5 text-2xs leading-relaxed text-dim" data-import-skipped={`${t.table_name}:${s.path}`}>
|
||||
<span className="mono text-faint">{t.table_name} · {s.path}</span>:{s.why}
|
||||
</li>
|
||||
))}
|
||||
</ul>
|
||||
</section>
|
||||
)}
|
||||
<p className="text-2xs text-dim" data-import-guidance-action={report.guidance.action}>{T.guidance[report.guidance.action] ?? T.guidance.none}</p>
|
||||
</div>
|
||||
)
|
||||
}
|
||||
|
||||
function TableRow({ t, done }: { t: CatalogImportTable; done: boolean }) {
|
||||
const renamed = t.matched_as && t.matched_as !== t.table_name ? t.matched_as : null
|
||||
const n = (k: typeof COUNT_KEYS[number]) => (k === 'conflicts' || k === 'skipped' ? t[k].length : t[k])
|
||||
return (
|
||||
<tr className="border-b border-hairline last:border-b-0" data-import-table={t.table_name}>
|
||||
<th scope="row" className="px-2.5 py-1.5 text-left align-top font-normal">
|
||||
<span className="mono break-all text-fg">{t.table_name}</span>
|
||||
{renamed && <span className="ml-1.5 text-faint">{T.matchedAs(renamed)}</span>}
|
||||
{done && t.error && <span className="block text-[var(--err)]">{T.tableFailed(t.error)}</span>}
|
||||
{done && !t.error && typeof t.version === 'number' && <span className="block text-faint">{T.version(t.version)}</span>}
|
||||
</th>
|
||||
{COUNT_KEYS.map((k) => (
|
||||
<td key={k} className={clsx('tnum px-2 py-1.5 text-right align-top', k === 'conflicts' && n(k) > 0 ? 'text-[var(--warn)]' : 'text-dim')}
|
||||
data-import-count={k}>
|
||||
{formatNumber(n(k))}
|
||||
</td>
|
||||
))}
|
||||
</tr>
|
||||
)
|
||||
}
|
||||
@@ -81,6 +81,7 @@ const ORDER = [
|
||||
'manage', // 数据、工具、知识、设置
|
||||
'versions', // 上传表格的版本:回滚、清单、移除一期、清除原件
|
||||
'catalog', // 数据目录:表清单、起草、单项审阅、批量确认、编辑即确认、409
|
||||
'catalog-loop', // 数据目录闭环:表助手、审阅队列、导出导入、防错事实的说明
|
||||
// 复核套件与导出
|
||||
'schedules', // 定时任务
|
||||
'compare', // 运行对比
|
||||
@@ -97,7 +98,7 @@ const ORDER = [
|
||||
const ESTIMATE = {
|
||||
challenge: 30,
|
||||
stream: 173, chat: 160, studio: 149, manage: 145, runs: 112, publish: 92, shell: 87,
|
||||
evidence: 91, versions: 60, catalog: 140, 'ui-kit': 70, ui: 61, guards: 8, 'canvas-layout': 2, copy: 2, tokens: 1, trace: 1, decode: 1,
|
||||
evidence: 91, versions: 60, catalog: 150, 'catalog-loop': 60, 'ui-kit': 70, ui: 61, guards: 8, 'canvas-layout': 2, copy: 2, tokens: 1, trace: 1, decode: 1,
|
||||
// 占位,换成真检查时按实测改
|
||||
schedules: 60, compare: 45, verify: 71, inquiry: 60, bundle: 16, whatif: 33, 'report-export': 30,
|
||||
}
|
||||
|
||||
File diff suppressed because it is too large
Load Diff
Reference in New Issue
Block a user