新增:智能分析图表与报告快照,支持环状图和柏拉图
This commit is contained in:
@@ -0,0 +1,330 @@
|
||||
import { useCallback, useEffect, useMemo, useRef, useState } from 'react';
|
||||
import { Button, Dropdown, Modal, Table, Tag } from 'antd';
|
||||
import type { ColumnsType } from 'antd/es/table';
|
||||
import { DownloadOutlined, MoreOutlined, TableOutlined } from '@ant-design/icons';
|
||||
import {
|
||||
buildAnalysisVisualOption,
|
||||
formatVisualValue,
|
||||
isVisualCellInvalid,
|
||||
loadAnalysisVisualECharts,
|
||||
parseAnalysisVisuals,
|
||||
renderVisualPng,
|
||||
visualCategoryLabel,
|
||||
visualPeriodSummary,
|
||||
visualScopeSummary,
|
||||
} from './analysisVisualsModel';
|
||||
import type { AnalysisVisual } from './analysisVisualsModel';
|
||||
import { analysisVisualCumulativeShares, analysisVisualShares, analysisVisualTypeLabel } from './analysisVisualPresentation';
|
||||
import './analysis-visuals.css';
|
||||
|
||||
export interface AnalysisVisualsProps {
|
||||
visuals: unknown;
|
||||
visualState?: unknown;
|
||||
beforeExport?: () => Promise<void>;
|
||||
}
|
||||
|
||||
interface VisualTableRow {
|
||||
key: string;
|
||||
index: number;
|
||||
label: string;
|
||||
values: Array<number | null>;
|
||||
}
|
||||
|
||||
function documentIsHidden(): boolean {
|
||||
return document.visibilityState === 'hidden';
|
||||
}
|
||||
|
||||
function visualTheme() {
|
||||
const styles = getComputedStyle(document.documentElement);
|
||||
return {
|
||||
ink: styles.getPropertyValue('--ink').trim() || '#263c5a',
|
||||
mutedInk: styles.getPropertyValue('--muted-ink').trim() || '#728198',
|
||||
line: styles.getPropertyValue('--line').trim() || '#dfe5ef',
|
||||
surface: styles.getPropertyValue('--surface').trim() || '#ffffff',
|
||||
};
|
||||
}
|
||||
|
||||
function visualStateName(value: unknown): string {
|
||||
if (typeof value === 'string') return value;
|
||||
if (typeof value === 'object' && value !== null) {
|
||||
const record = value as Record<string, unknown>;
|
||||
if (typeof record.status === 'string') return record.status;
|
||||
if (typeof record.state === 'string') return record.state;
|
||||
}
|
||||
return '';
|
||||
}
|
||||
|
||||
function ChartDataTable({ visual, compact = false }: { visual: AnalysisVisual; compact?: boolean }) {
|
||||
const shares = analysisVisualShares(visual);
|
||||
const cumulativeShares = analysisVisualCumulativeShares(visual);
|
||||
const rows: VisualTableRow[] = visual.categories.map((category, index) => ({
|
||||
key: category.key,
|
||||
index: index + 1,
|
||||
label: visualCategoryLabel(visual, index),
|
||||
values: visual.series.map(series => series.values[index] ?? null),
|
||||
}));
|
||||
const columns: ColumnsType<VisualTableRow> = [
|
||||
{ title: '序号', dataIndex: 'index', width: 68, align: 'center', fixed: 'left' },
|
||||
{
|
||||
title: '对象名称', dataIndex: 'label', width: 240, ellipsis: false, fixed: 'left',
|
||||
render: (label: string, row) => <span className="analysis-visual-full-label" title={`${label}(${row.key})`}>{label}</span>,
|
||||
},
|
||||
...visual.series.map((series, seriesIndex) => ({
|
||||
title: series.label,
|
||||
key: series.key,
|
||||
align: 'center' as const,
|
||||
width: 150,
|
||||
render: (_value: unknown, row: VisualTableRow) => {
|
||||
const value = row.values[seriesIndex];
|
||||
return isVisualCellInvalid(visual, seriesIndex, row.index - 1)
|
||||
? <Tag color="error">无效值</Tag>
|
||||
: <span className="analysis-visual-table-value">{formatVisualValue(value, visual.unit)}</span>;
|
||||
},
|
||||
})),
|
||||
...(shares ? [{ title: '占已列类别合计', key: 'compositionShare', align: 'center' as const, width: 160,
|
||||
render: (_value: unknown, row: VisualTableRow) => `${(shares[row.index - 1] * 100).toFixed(2)}%` }] : []),
|
||||
...(cumulativeShares ? [{ title: '累计占已列类别合计', key: 'cumulativeShare', align: 'center' as const, width: 170,
|
||||
render: (_value: unknown, row: VisualTableRow) => `${(cumulativeShares[row.index - 1] * 100).toFixed(2)}%` }] : []),
|
||||
];
|
||||
return <div className={compact ? 'analysis-visual-table is-compact' : 'analysis-visual-table'}>
|
||||
<Table<VisualTableRow>
|
||||
size="small"
|
||||
bordered
|
||||
columns={columns}
|
||||
dataSource={rows}
|
||||
pagination={false}
|
||||
rowKey="key"
|
||||
scroll={{ x: 'max-content', y: compact ? 290 : 440 }}
|
||||
/>
|
||||
</div>;
|
||||
}
|
||||
|
||||
function safeFilename(title: string): string {
|
||||
const base = title.replace(/[\\/:*?"<>|\u0000-\u001f]/g, '-').replace(/\s+/g, '-').slice(0, 64) || 'analysis-chart';
|
||||
return `${base}.png`;
|
||||
}
|
||||
|
||||
function chartSummary(visual: AnalysisVisual): string {
|
||||
return `${visual.title}。${visual.subtitle}。期间:${visualPeriodSummary(visual)}。${visual.categories.length} 个对象,${visual.series.map(item => item.label).join('、')}。${visualScopeSummary(visual.scope)}`;
|
||||
}
|
||||
|
||||
function AnalysisVisualCard({ visual, beforeExport }: { visual: AnalysisVisual; beforeExport?: () => Promise<void> }) {
|
||||
const cardRef = useRef<HTMLElement>(null);
|
||||
const chartNodeRef = useRef<HTMLDivElement>(null);
|
||||
const chartRef = useRef<Awaited<ReturnType<typeof loadAnalysisVisualECharts>> extends never ? never : import('echarts/core').ECharts | null>(null);
|
||||
const exportControllerRef = useRef<AbortController | null>(null);
|
||||
const [nearViewport, setNearViewport] = useState(false);
|
||||
const [chartReady, setChartReady] = useState(false);
|
||||
const [chartLoading, setChartLoading] = useState(false);
|
||||
const [chartError, setChartError] = useState('');
|
||||
const [dataOpen, setDataOpen] = useState(false);
|
||||
const [exporting, setExporting] = useState(false);
|
||||
const [exportError, setExportError] = useState('');
|
||||
const [themeRevision, setThemeRevision] = useState(0);
|
||||
|
||||
useEffect(() => {
|
||||
const node = cardRef.current;
|
||||
if (!node) return;
|
||||
if (typeof IntersectionObserver === 'undefined') { setNearViewport(true); return; }
|
||||
const observer = new IntersectionObserver(entries => {
|
||||
const entry = entries[0];
|
||||
if (entry) setNearViewport(entry.isIntersecting);
|
||||
}, { rootMargin: '180px 0px', threshold: 0.01 });
|
||||
observer.observe(node);
|
||||
return () => observer.disconnect();
|
||||
}, []);
|
||||
|
||||
useEffect(() => {
|
||||
if (!nearViewport || !visual.chartable) return;
|
||||
let cancelled = false;
|
||||
let resizeObserver: ResizeObserver | null = null;
|
||||
let instance: Awaited<ReturnType<typeof loadAnalysisVisualECharts>>['init'] extends (...args: never[]) => infer T ? T : never;
|
||||
const mount = async () => {
|
||||
const node = chartNodeRef.current;
|
||||
if (!node || documentIsHidden() || cancelled) return;
|
||||
setChartLoading(true);
|
||||
try {
|
||||
const echarts = await loadAnalysisVisualECharts();
|
||||
if (cancelled || !chartNodeRef.current || documentIsHidden()) return;
|
||||
instance = echarts.init(chartNodeRef.current, undefined, { renderer: 'svg' });
|
||||
chartRef.current = instance;
|
||||
// Initializing a cached/offscreen card must draw even when React batches
|
||||
// loading=true/false into one commit and no option-effect dependency changes.
|
||||
instance.setOption(buildAnalysisVisualOption(visual, visualTheme()), { notMerge: true, lazyUpdate: false });
|
||||
const resize = () => {
|
||||
const chartNode = chartNodeRef.current;
|
||||
if (cancelled || documentIsHidden() || !chartNode) return;
|
||||
const bounds = chartNode.getBoundingClientRect();
|
||||
if (bounds.width > 0 && bounds.height > 0) instance.resize();
|
||||
};
|
||||
resizeObserver = new ResizeObserver(resize);
|
||||
resizeObserver.observe(chartNodeRef.current);
|
||||
setChartError('');
|
||||
setChartReady(true);
|
||||
} catch {
|
||||
if (!cancelled) setChartError('图表渲染暂不可用,可以继续查看完整数据表。');
|
||||
} finally {
|
||||
if (!cancelled) setChartLoading(false);
|
||||
}
|
||||
};
|
||||
const onVisibility = () => {
|
||||
if (!documentIsHidden()) {
|
||||
if (!instance) void mount();
|
||||
else requestAnimationFrame(() => instance?.resize());
|
||||
}
|
||||
};
|
||||
document.addEventListener('visibilitychange', onVisibility);
|
||||
void mount();
|
||||
return () => {
|
||||
cancelled = true;
|
||||
document.removeEventListener('visibilitychange', onVisibility);
|
||||
resizeObserver?.disconnect();
|
||||
instance?.dispose();
|
||||
if (chartRef.current === instance) chartRef.current = null;
|
||||
};
|
||||
}, [nearViewport, visual.chartable, visual.id]);
|
||||
|
||||
useEffect(() => {
|
||||
if (!nearViewport || !visual.chartable) return;
|
||||
const observer = new MutationObserver(() => setThemeRevision(value => value + 1));
|
||||
observer.observe(document.documentElement, { attributes: true, attributeFilter: ['data-workspace-theme'] });
|
||||
return () => observer.disconnect();
|
||||
}, [nearViewport, visual.chartable]);
|
||||
|
||||
useEffect(() => {
|
||||
const chart = chartRef.current;
|
||||
const node = chartNodeRef.current;
|
||||
if (!chart || !node || !visual.chartable) return;
|
||||
try {
|
||||
chart.setOption(buildAnalysisVisualOption(visual, visualTheme()), { notMerge: true, lazyUpdate: false });
|
||||
setChartReady(true);
|
||||
} catch {
|
||||
setChartError('图表渲染失败,可以继续查看完整数据表。');
|
||||
setChartReady(false);
|
||||
}
|
||||
}, [visual, themeRevision, chartLoading]);
|
||||
|
||||
useEffect(() => () => { exportControllerRef.current?.abort(); }, []);
|
||||
|
||||
const openData = useCallback(async () => {
|
||||
try { await beforeExport?.(); setDataOpen(true); setExportError(''); }
|
||||
catch (error) { setExportError(error instanceof Error ? error.message : '无法读取当前图表数据。'); }
|
||||
}, [beforeExport]);
|
||||
const download = useCallback(async () => {
|
||||
if (!visual.chartable || exporting) return;
|
||||
const controller = new AbortController();
|
||||
exportControllerRef.current?.abort();
|
||||
exportControllerRef.current = controller;
|
||||
setExporting(true);
|
||||
setExportError('');
|
||||
try {
|
||||
await beforeExport?.();
|
||||
const image = await renderVisualPng(visual, controller.signal);
|
||||
if (controller.signal.aborted) return;
|
||||
const link = document.createElement('a');
|
||||
link.href = image;
|
||||
link.download = safeFilename(visual.title);
|
||||
link.click();
|
||||
} catch (error) {
|
||||
if (!controller.signal.aborted) setExportError(error instanceof Error ? error.message : '图表导出失败');
|
||||
} finally {
|
||||
if (exportControllerRef.current === controller) exportControllerRef.current = null;
|
||||
if (!controller.signal.aborted) setExporting(false);
|
||||
}
|
||||
}, [beforeExport, exporting, visual]);
|
||||
|
||||
const period = visualPeriodSummary(visual);
|
||||
const scope = visualScopeSummary(visual.scope);
|
||||
const coverage = visual.coverage.truncated
|
||||
? `本图展示 ${visual.coverage.returnedRows} / 共 ${visual.coverage.totalRows} 项`
|
||||
: `共 ${visual.coverage.totalRows} 项`;
|
||||
|
||||
return <article className={`analysis-visual-card analysis-visual-type-${visual.type}`} ref={cardRef} aria-label={visual.title}>
|
||||
<header className="analysis-visual-heading">
|
||||
<div className="analysis-visual-heading-copy">
|
||||
<h3>{visual.title}</h3>
|
||||
<p>{visual.subtitle}</p>
|
||||
<div className="analysis-visual-context">
|
||||
<span className="analysis-visual-type-label">{analysisVisualTypeLabel(visual.type)}</span>
|
||||
<span>{period}</span>
|
||||
{scope && <span>{scope}</span>}
|
||||
<span>{coverage}</span>
|
||||
{visual.stage && <Tag color={visual.stage === 'black' ? 'blue' : 'cyan'}>{visual.stage === 'black' ? '黑片' : '亮片'}</Tag>}
|
||||
</div>
|
||||
</div>
|
||||
<div className="analysis-visual-actions">
|
||||
<Button size="small" icon={<TableOutlined />} onClick={openData}>查看数据</Button>
|
||||
<Dropdown
|
||||
trigger={['click']}
|
||||
menu={{ items: [{ key: 'png', icon: <DownloadOutlined />, label: exporting ? '正在导出…' : '下载 PNG', disabled: !visual.chartable || exporting, onClick: () => { void download(); } }] }}
|
||||
>
|
||||
<Button size="small" aria-label="更多图表操作" icon={exporting ? <span className="analysis-visual-spinner" aria-hidden="true" /> : <MoreOutlined />} />
|
||||
</Dropdown>
|
||||
</div>
|
||||
</header>
|
||||
{visual.note && <p className="analysis-visual-note">{visual.note}</p>}
|
||||
{visual.chartable ? <>
|
||||
<div
|
||||
className="analysis-visual-chart-wrap"
|
||||
role="button"
|
||||
tabIndex={0}
|
||||
aria-label={`${chartSummary(visual)}。按 Enter 或空格查看数据。`}
|
||||
aria-busy={chartLoading}
|
||||
onClick={openData}
|
||||
onKeyDown={event => {
|
||||
if (event.key === 'Enter' || event.key === ' ') { event.preventDefault(); openData(); }
|
||||
}}
|
||||
>
|
||||
<div className="analysis-visual-chart" ref={chartNodeRef} aria-hidden="true"
|
||||
style={visual.type === 'heatmap' ? { minWidth: Math.max(380, visual.categories.length * 62 + 160) }
|
||||
: visual.type === 'pareto' ? { minWidth: Math.max(600, visual.categories.length * 90 + 180) } : undefined} />
|
||||
{!nearViewport && <div className="analysis-visual-placeholder">图表将在进入视口时加载</div>}
|
||||
{nearViewport && chartLoading && <div className="analysis-visual-placeholder" role="status">正在加载图表…</div>}
|
||||
{chartError && <div className="analysis-visual-chart-error" role="status">{chartError}</div>}
|
||||
{!chartLoading && !chartError && !chartReady && nearViewport && <div className="analysis-visual-placeholder">图表准备中…</div>}
|
||||
</div>
|
||||
{visual.type === 'heatmap' && <p className="analysis-visual-scroll-hint">可横向滑动查看各期,或查看完整数据。</p>}
|
||||
{visual.type === 'pareto' && <p className="analysis-visual-scroll-hint">窄屏可横向滑动查看,或查看完整数据。</p>}
|
||||
<p className="analysis-visual-summary">{chartSummary(visual)}</p>
|
||||
{chartError && <ChartDataTable visual={visual} compact />}
|
||||
</> : <>
|
||||
<p className="analysis-visual-chart-error" role="status">{visual.chartIssue || '此图表暂以数据表显示'}</p>
|
||||
<ChartDataTable visual={visual} compact />
|
||||
</>}
|
||||
{exportError && <p className="analysis-visual-export-error" role="alert">{exportError}</p>}
|
||||
<Modal
|
||||
className="analysis-visual-modal"
|
||||
open={dataOpen}
|
||||
title={visual.title}
|
||||
onCancel={() => setDataOpen(false)}
|
||||
footer={<Button onClick={() => setDataOpen(false)}>关闭</Button>}
|
||||
width={920}
|
||||
destroyOnHidden
|
||||
>
|
||||
<div className="analysis-visual-modal-context">
|
||||
<span>{visual.subtitle}</span><span>期间:{period}</span>{scope && <span>范围:{scope}</span>}
|
||||
<span>单位:{visual.unit === 'ratio' ? '合格率' : visual.unit === 'kg' ? 'kg' : visual.unit === 'pp' ? '百分点' : '数量'}</span>
|
||||
</div>
|
||||
<ChartDataTable visual={visual} />
|
||||
{visual.note && <p className="analysis-visual-modal-note">{visual.note}</p>}
|
||||
{visual.evidenceRefs.length > 0 && <div className="analysis-visual-evidence"><strong>证据引用</strong><ul>{visual.evidenceRefs.map(ref => <li key={ref}>{ref}</li>)}</ul></div>}
|
||||
</Modal>
|
||||
</article>;
|
||||
}
|
||||
|
||||
/** A bad or old visual payload is confined to this module; it never interrupts the answer text. */
|
||||
export function AnalysisVisuals({ visuals, visualState, beforeExport }: AnalysisVisualsProps) {
|
||||
const parsed = useMemo(() => parseAnalysisVisuals(visuals), [visuals]);
|
||||
if (!parsed.visuals.length) {
|
||||
const state = visualStateName(visualState);
|
||||
if (state === 'building') return <div className="analysis-visual-state" role="status">图表整理中</div>;
|
||||
if (state === 'failed' || state === 'unavailable') return <div className="analysis-visual-state" role="status">图表暂不可用,已保留分析结果。</div>;
|
||||
return null;
|
||||
}
|
||||
return <section className="analysis-visuals" aria-label="分析图表">
|
||||
{parsed.visuals.slice(0, 3).map(visual => <AnalysisVisualCard key={visual.id} visual={visual} beforeExport={beforeExport} />)}
|
||||
</section>;
|
||||
}
|
||||
|
||||
export { parseAnalysisVisuals };
|
||||
export type { AnalysisVisual };
|
||||
Reference in New Issue
Block a user