import { memo, useCallback, useEffect, useMemo, useRef, useState } from 'react' import type { FormEvent } from 'react' import { useOptionalAuth } from './auth' import { fetchQARecord, fetchAllQARecords, fetchQAStatus, qaCellValue, qaColumns } from './qaOps' import type { QAQuery, QARecord, QARecordPage, QAStatus } from './qaOps' import './qaOps.css' import { ledgerWindow, ledgerCellPreview } from './qaLedgerRendering' import { QARegionalStatistics } from './QADepartmentStatistics' import { QADashboard } from './QADashboard' import { QAWeekly } from './QAWeekly' import { QAInlineFields } from './QAInlineFields' import { QAHeaderFieldFilter, useQAFieldFilterOptions } from './QAFieldFilters' import { editableFieldKeys } from './qaInlineFields' import type { EditableField } from './qaInlineFields' import { buildQAWeeklyCSV, downloadQAWeekly } from './qaWeekly' import { qaFieldColors, qaTagColumns } from './qaFieldColors' import { qualityLabels } from './qaQuality' import { QAWeekPicker } from './QAWeekPicker' import { QAAnswerMarkdown } from './QAAnswerMarkdown' import { QAMirrorSync } from './QAMirrorSync' import { QAAIWorkbench, QAAIRecordEvidence, QAAITaskBadges } from './QAAI' import type { AIStatus, AIWorkState } from './qaAITypes' import { currentQAWeek, qaDateTimeToISO, qaWeekQueryRange } from './qaWeeks' export type QAOpsView = 'records' | 'dashboard' | 'regions' | 'weekly' export function QAOperationsTabs({ view, onChange }: { view: QAOpsView; onChange: (view: QAOpsView) => void }) { return ( ) } interface ViewProps { filters?: QAQuery['filters'] onFiltersChange?: (value: NonNullable) => void taskUpdates?: AIWorkState[] onQualitySaved?: (record: QARecord) => void onReloadDetail?: () => void page: QARecordPage | null status: QAStatus | null loading: boolean error: string | null detail: QARecord | null detailID?: string | null detailLoading: boolean detailError: string | null onSelect: (id: string) => void onCloseDetail: () => void progress?: { loaded: number; total: number } onRetry: () => void } const warningLabels: Record = { database_temp_enabled: '数据库仍允许临时对象:未视为完全只读验收通过', database_transport_unencrypted: '数据库连接未启用 TLS:上线前须完成传输安全审核', } const stamp = (value: string) => new Date(value).toLocaleString('zh-CN', { hour12: false }) const sourceCoverageLabels: Record = { covered: '已覆盖', uncovered: '未覆盖' } function tasksFor(item: QARecord, updates: AIWorkState[] | undefined) { const byKind = new Map((item.background_tasks ?? []).map((task) => [task.kind, task])) for (const task of updates ?? []) { const previous = byKind.get(task.kind) if (!previous || previous.id === task.id || Date.parse(task.updated_at) > Date.parse(previous.updated_at)) byKind.set(task.kind, task) } return [...byKind.values()].sort((a, b) => a.kind.localeCompare(b.kind)) } const QARow = memo( function QARow({ item, rowIndex, tasks, onSelect, }: { item: QARecord rowIndex: number tasks: AIWorkState[] signature: string onSelect: (id: string) => void }) { return ( { if (!(event.target as HTMLElement).closest('button,a,input,select,textarea,summary')) onSelect(item.id) }} > {rowIndex - 1} {qaColumns.map(({ key }) => ( {['answer', 'question', 'question_chinese', 'department'].includes(key) ? ledgerCellPreview(qaCellValue(item, key) ?? '—') : (qaCellValue(item, key) ?? '—')} ))}
{item.quality ? {qualityLabels[item.quality.state]} : null}
) }, (before, after) => before.item === after.item && before.rowIndex === after.rowIndex && before.signature === after.signature && before.onSelect === after.onSelect ) const ledgerColumnWidth = (key: string) => ['answer', 'question', 'question_chinese'].includes(key) ? 320 : key === 'asked_at' ? 185 : key === 'department' ? 240 : key === 'root_cause' ? 155 : 125 export function QAOperationsView(props: ViewProps) { const page = props.page const items = page?.items ?? [] const filterOptions = useQAFieldFilterOptions(Boolean(props.onFiltersChange)) const scrollRef = useRef(null) const [viewport, setViewport] = useState({ top: 0, height: 600 }) const visible = ledgerWindow(page?.items.length ?? 0, viewport.top, viewport.height) useEffect(() => { const element = scrollRef.current if (!element) return const observer = new ResizeObserver(() => setViewport({ top: Math.max(0, element.scrollTop - (element.querySelector('thead')?.getBoundingClientRect().height ?? 40)), height: element.clientHeight, }) ) observer.observe(element) return () => observer.disconnect() }, [Boolean(page?.items.length)]) const columns = qaColumns const updates = useMemo(() => { const map = new Map() for (const task of props.taskUpdates ?? []) { const list = map.get(task.record_id) ?? [] if (!list.some((previous) => previous.kind === task.kind)) list.push(task) map.set(task.record_id, list) } return map }, [props.taskUpdates]) const detail = props.detail const detailIndex = page?.items.findIndex((item) => item.id === (props.detailID ?? detail?.id)) ?? -1 const previous = detailIndex > 0 ? page?.items[detailIndex - 1] : undefined const next = detailIndex >= 0 ? page?.items[detailIndex + 1] : undefined const showDrawer = Boolean(detail || props.detailLoading || props.detailError) return (
{page ? `共 ${page.total} 条 · 已载入 ${page.items.length} 条${props.loading ? ' · 后台加载中' : props.error || page.has_more ? ' · 未完整读取' : ''}` : props.loading ? '正在读取首批问答…' : '尚未读取问答'} 双击行查看详情 {props.onFiltersChange && Object.keys(props.filters ?? {}).length ? ( ) : null}
{props.status?.warnings .filter((warning) => !['database_temp_enabled', 'database_transport_unencrypted'].includes(warning)) .map((warning) => (

{warningLabels[warning] ?? '数据源有待审核的安全告警'}

))} {filterOptions.error ? (

{filterOptions.error}{' '}

) : null} {props.error ? (
{props.error}{' '}
) : null} {items.length > 0 || props.onFiltersChange ? (
{ const element = event.currentTarget setViewport({ top: Math.max( 0, element.scrollTop - (element.querySelector('thead')?.getBoundingClientRect().height ?? 40) ), height: element.clientHeight, }) }} > sum + ledgerColumnWidth(c.key), 224) }} > {qaColumns.map((c) => ( ))} {columns.map(({ key, label }) => ( ))} {!items.length && page && !props.loading && !props.error ? ( ) : null} {visible.padTop > 0 ? ( ) : null} {items.slice(visible.start, visible.end).map((item, index) => { const tasks = tasksFor(item, updates.get(item.id)) return ( ) })} {visible.padBottom > 0 ? ( ) : null}
序号 {props.onFiltersChange && editableFieldKeys.includes(key as EditableField) ? ( ) : ( label )} 操作
没有符合条件的问答,请调整表头筛选、时间范围或关键词。
) : page && !props.loading && !props.error ? (

没有符合条件的问答,请调整时间范围或关键词。

) : null} {showDrawer ? ( <> ) : null}
) } function initialDraft() { const current = currentQAWeek() const { year, week, start, end } = qaWeekQueryRange(current.year, current.week) return { year, week: week as number | null, start, end, keyword: '' } } export function QAOperations() { const [view, setView] = useState('records') const weeklyBeforeLeave = useRef<(() => Promise) | null>(null) const registerWeeklyLeave = useCallback((guard: (() => Promise) | null) => { weeklyBeforeLeave.current = guard }, []) const auth = useOptionalAuth() const canRead = auth?.identity?.role === 'admin' const [draft, setDraft] = useState(initialDraft) const [filters, setFilters] = useState>({}) const [exporting, setExporting] = useState(false), [exportError, setExportError] = useState('') const exportRequest = useRef(null) const [query, setQuery] = useState(null) const [page, setPage] = useState(null) const [status, setStatus] = useState(null) const [error, setError] = useState(null) const [loading, setLoading] = useState(false) const [revision, setRevision] = useState(0) const [qualityRevision, setQualityRevision] = useState(0) const [aiStatus, setAIStatus] = useState(null) const generation = useRef(0) const freshAI = useRef(new Map()) const viewRef = useRef(view) viewRef.current = view const [mirrorChanged, setMirrorChanged] = useState(false) const [detail, setDetail] = useState(null) const [detailID, setDetailID] = useState(null) const [detailLoading, setDetailLoading] = useState(false) const [detailError, setDetailError] = useState(null) const [progress, setProgress] = useState<{ loaded: number; total: number } | undefined>() const detailRequest = useRef(null) const returnFocus = useRef(null) useEffect(() => { if (!canRead || query) return setQuery({ start: qaDateTimeToISO(draft.start), end: qaDateTimeToISO(draft.end), keyword: draft.keyword, cursor: '', }) }, [canRead, draft, query]) useEffect(() => { if (!query || !canRead) return if (view !== 'records') { setLoading(false) setError(null) detailRequest.current?.abort() setDetail(null) setDetailID(null) return } const controller = new AbortController() generation.current += 1 freshAI.current.clear() detailRequest.current?.abort() setLoading(true) setError(null) setPage(null) setProgress(undefined) setDetail(null) setDetailID(null) setDetailError(null) setDetailLoading(false) void fetchQAStatus(controller.signal) .then(setStatus) .catch(() => { if (!controller.signal.aborted) setStatus(null) }) const publish = (result: QARecordPage) => { if (!controller.signal.aborted) setPage({ ...result, items: result.items.map((item) => freshAI.current.get(item.id) ?? item) }) } void fetchAllQARecords( { ...query, dataset: 'master', projection: 'summary' }, controller.signal, (loaded, total) => { if (!controller.signal.aborted) setProgress({ loaded, total }) }, publish ) .then((result) => { if (!controller.signal.aborted) setPage({ ...result, items: result.items.map((item) => freshAI.current.get(item.id) ?? item) }) }) .catch((reason: unknown) => { if (!controller.signal.aborted) setError(reason instanceof Error ? reason.message : '问答读取失败') }) .finally(() => { if (!controller.signal.aborted) setLoading(false) }) return () => { controller.abort() generation.current += 1 } }, [query, canRead, revision, view]) useEffect(() => { exportRequest.current?.abort() setExporting(false) setExportError('') return () => exportRequest.current?.abort() }, [query, view]) const exportCSV = async () => { if (!query || exporting) return const abort = new AbortController() exportRequest.current = abort setExporting(true) setExportError('') try { const result = await fetchAllQARecords({ ...query, dataset: 'master', projection: 'full' }, abort.signal) if (!abort.signal.aborted) downloadQAWeekly(buildQAWeeklyCSV(result), 'DobotAI-Questions.csv', 'text/csv;charset=utf-8') } catch (e) { if (!abort.signal.aborted) setExportError(e instanceof Error ? e.message : '完整明细导出失败') } finally { if (!abort.signal.aborted) setExporting(false) } } useEffect( () => () => { detailRequest.current?.abort() }, [] ) const submit = (event: FormEvent) => { event.preventDefault() try { const start = qaDateTimeToISO(draft.start), end = qaDateTimeToISO(draft.end) if (!(Date.parse(start) < Date.parse(end))) throw new Error('开始时间必须早于结束时间') if (Date.parse(start) >= Date.now()) throw new Error('所选周或时间尚未开始,请选择已开始的时间范围') setQuery({ start, end, keyword: draft.keyword, cursor: '', filters: { ...filters } }) } catch (reason) { setError(reason instanceof Error ? reason.message : '时间格式无效') } } const changeFilters = useCallback((next: NonNullable) => { setFilters(next) setQuery((current) => (current ? { ...current, cursor: '', filters: { ...next } } : current)) }, []) const select = useCallback(async (id: string) => { detailRequest.current?.abort() if (!document.activeElement?.closest('.qa-ops-drawer')) returnFocus.current = document.activeElement as HTMLElement | null const controller = new AbortController() detailRequest.current = controller setDetailID(id) setDetail(null) setDetailError(null) setDetailLoading(true) try { const result = await fetchQARecord(id, controller.signal, 'master') if (!controller.signal.aborted) setDetail(result) } catch (reason) { if (!controller.signal.aborted) setDetailError(reason instanceof Error ? reason.message : '详情读取失败') } finally { if (!controller.signal.aborted) setDetailLoading(false) } }, []) const refreshAIRecord = useCallback((id: string) => { if (viewRef.current === 'dashboard') { setQualityRevision((value) => value + 1) return } const version = generation.current void fetchQARecord(id, undefined, 'master') .then((fresh) => { if (version !== generation.current) return freshAI.current.set(id, fresh) setPage((old) => (old ? { ...old, items: old.items.map((item) => (item.id === id ? fresh : item)) } : old)) setDetail((old) => (old?.id === id ? fresh : old)) }) .catch(() => {}) }, []) const close = () => { if (mirrorChanged) { setMirrorChanged(false) setRevision((v) => v + 1) setQualityRevision((v) => v + 1) } detailRequest.current?.abort() setDetail(null) setDetailID(null) setDetailError(null) setDetailLoading(false) returnFocus.current?.focus() } const queryView = view === 'records' || view === 'dashboard' return (

问答运营

{!canRead ? (

尚未配置员工问答可见范围,当前仅管理员可访问。

) : ( <> { if (view === 'weekly' && next !== 'weekly' && weeklyBeforeLeave.current) void weeklyBeforeLeave.current().then((ok) => { if (ok) setView(next) }) else setView(next) }} /> {queryView ? ( <> {mirrorChanged ?

数据已更新,关闭详情后刷新。

: null}
{ const current = initialDraft() setDraft({ ...current, keyword: draft.keyword }) setQuery({ start: qaDateTimeToISO(current.start), end: qaDateTimeToISO(current.end), keyword: draft.keyword, cursor: '', filters: { ...filters }, }) }} onChange={(year, week) => setDraft((old) => week === null ? { ...old, year, week } : { ...old, ...qaWeekQueryRange(year, week) } ) } /> { if (detail || detailLoading) { setMirrorChanged(true) return } setQuery((q) => (q ? { ...q } : q)) setRevision((v) => v + 1) setQualityRevision((v) => v + 1) }} /> ) : null} {view === 'regions' ? ( { setRevision((v) => v + 1) setQualityRevision((v) => v + 1) }} /> ) : view === 'weekly' ? ( ) : view === 'dashboard' ? ( { setRevision((v) => v + 1) setQualityRevision((v) => v + 1) }} /> ) : ( { if (detail) void select(detail.id) }} onQualitySaved={(fresh) => { if (fresh.id !== detail?.id) return freshAI.current.set(fresh.id, fresh) setDetail(fresh) setPage((old) => old ? { ...old, items: old.items.map((item) => (item.id === fresh.id ? fresh : item)) } : old ) setQualityRevision((v) => v + 1) }} onSelect={select} onCloseDetail={close} progress={progress} onRetry={() => setRevision((v) => v + 1)} /> )} )}
) }