shishengliang/lingniu-vehicle-ingest
1
0
Fork 0
Code Issues Pull Requests Actions Packages Projects Releases Wiki Activity

feat(platform): add source readiness operations view

Browse Source
This commit is contained in:
lingniu
2026-07-04 23:29:31 +08:00
parent bf106a9730
commit 44c7748958
9 changed files with 536 additions and 4 deletions
Download Patch File Download Diff File Expand all files Collapse all files

41
vehicle-data-platform/apps/web/src/api/client.test.ts
View File

@@ -287,6 +287,47 @@ test('onlineVehicleStatuses reads paged online vehicle status rows', async () =>
expect(result.items[0].offlineDurationMinutes).toBe(18);
});
test('sourceReadiness reads ops source readiness plan', async () => {
const fetchMock = vi.spyOn(globalThis, 'fetch').mockResolvedValue({
ok: true,
json: async () => ({
data: {
totalVehicles: 1033,
onlineVehicles: 208,
kafkaLag: 0,
activeConnections: 178,
redisOnlineKeys: 258,
platformRelease: 'platform-source-test',
sources: [{
protocol: 'GB32960',
role: '整车与氢能实时数据主来源',
online: 73,
total: 340,
onlineRate: 21.47,
missingVehicles: 693,
severity: 'warning',
status: '覆盖不足',
evidence: '在线 73/340',
action: '核对平台转发清单',
acceptance: '缺失来源车辆下降',
vehiclesHash: '#/vehicles?missingProtocol=GB32960',
realtimeHash: '#/realtime?protocol=GB32960',
historyHash: '#/history-query?protocol=GB32960&tab=raw',
alertHash: '#/alert-events?protocol=GB32960'
}]
},
traceId: 'trace-test',
timestamp: 1783094400000
})
} as Response);
const result = await api.sourceReadiness();
expect(fetchMock).toHaveBeenCalledWith('/api/ops/source-readiness', undefined);
expect(result.platformRelease).toBe('platform-source-test');
expect(result.sources[0].protocol).toBe('GB32960');
});
test('api errors include backend message, detail, and trace id', async () => {
vi.spyOn(globalThis, 'fetch').mockResolvedValue({
ok: false,

4
vehicle-data-platform/apps/web/src/api/client.ts
View File

@@ -14,6 +14,7 @@ import type {
QualityIssueRow,
RawFrameRow,
RealtimeLocationRow,
SourceReadinessPlan,
VehicleRealtimeRow,
VehicleCoverageRow,
VehicleCoverageSummary,
@@ -117,5 +118,6 @@ export const api = {
alertEvents: (params = new URLSearchParams()) => request<Page<QualityIssueRow>>(`/api/alert-events?${params.toString()}`),
alertEventNotificationPlan: (params = new URLSearchParams()) => request<QualityNotificationPlan>(`/api/alert-events/notification-plan?${params.toString()}`),
reverseGeocode: (params = new URLSearchParams()) => request<MapReverseGeocode>(`/api/map/reverse-geocode?${params.toString()}`),
opsHealth: () => request<OpsHealth>('/api/ops/health')
opsHealth: () => request<OpsHealth>('/api/ops/health'),
sourceReadiness: () => request<SourceReadinessPlan>('/api/ops/source-readiness')
};

28
vehicle-data-platform/apps/web/src/api/types.ts
View File

@@ -359,6 +359,34 @@ export interface OpsHealth {
runtime: RuntimeInfo;
}
export interface SourceReadinessPlan {
totalVehicles: number;
onlineVehicles: number;
kafkaLag: number | null;
activeConnections: number | null;
redisOnlineKeys: number | null;
platformRelease: string;
sources: SourceReadinessRow[];
}
export interface SourceReadinessRow {
protocol: string;
role: string;
online: number;
total: number;
onlineRate: number;
missingVehicles: number;
severity: 'ok' | 'warning' | 'error' | string;
status: string;
evidence: string;
action: string;
acceptance: string;
vehiclesHash: string;
realtimeHash: string;
historyHash: string;
alertHash: string;
}
export interface CapacityMetrics {
activeConnections: number;
kafkaLag: number;

92
vehicle-data-platform/apps/web/src/pages/OpsQuality.tsx
View File

@@ -2,7 +2,7 @@ import { Button, Card, Space, Table, Tag, Toast, Typography } from '@douyinfe/se
import { IconCopy } from '@douyinfe/semi-icons';
import { useEffect, useState } from 'react';
import { api } from '../api/client';
import type { CapacityMetrics, LinkHealth, OpsHealth } from '../api/types';
import type { CapacityMetrics, LinkHealth, OpsHealth, SourceReadinessPlan, SourceReadinessRow } from '../api/types';
import { PageHeader } from '../components/PageHeader';
const statusColor: Record<string, 'green' | 'orange' | 'red' | 'grey'> = {
@@ -15,6 +15,14 @@ function formatNumber(value?: number | null) {
return value == null ? '-' : value.toLocaleString();
}
function formatRate(value?: number | null) {
return value == null || !Number.isFinite(Number(value)) ? '0%' : `${Number(value).toLocaleString(undefined, { maximumFractionDigits: 1 })}%`;
}
function normalizeSourceReadiness(plan: SourceReadinessPlan | null): SourceReadinessPlan | null {
return plan && Array.isArray(plan.sources) ? plan : null;
}
function statusText(ok?: boolean) {
return ok ? '正常' : '异常';
}
@@ -384,6 +392,27 @@ function opsCapacityActionPlanText(health: OpsHealth | null) {
].join('\n\n');
}
function sourceReadinessReport(plan: SourceReadinessPlan | null) {
if (!plan) return '【数据源生产就绪度】\n暂无数据源就绪度数据';
return [
'【数据源生产就绪度】',
`运行版本：${plan.platformRelease || '-'}`,
`车辆规模：${formatNumber(plan.totalVehicles)} / 在线 ${formatNumber(plan.onlineVehicles)}`,
`接入状态：连接 ${formatNumber(plan.activeConnections)} / Redis在线Key ${formatNumber(plan.redisOnlineKeys)} / Kafka Lag ${formatNumber(plan.kafkaLag)}`,
'',
...plan.sources.map((source, index) => [
`${index + 1}. [${source.severity}] ${source.protocol} - ${source.status}`,
` 角色：${source.role}`,
` 证据：${source.evidence}`,
` 在线率：${formatRate(source.onlineRate)}，缺失车辆：${formatNumber(source.missingVehicles)}`,
` 动作：${source.action}`,
` 验收：${source.acceptance}`,
` 实时监控：${window.location.origin}${window.location.pathname}${source.realtimeHash}`,
` 历史证据：${window.location.origin}${window.location.pathname}${source.historyHash}`
].join('\n'))
].join('\n');
}
async function copyText(value: string, label: string) {
try {
await navigator.clipboard.writeText(value);
@@ -395,12 +424,22 @@ async function copyText(value: string, label: string) {
export function OpsQuality() {
const [health, setHealth] = useState<OpsHealth | null>(null);
const [sourceReadiness, setSourceReadiness] = useState<SourceReadinessPlan | null>(null);
const [loading, setLoading] = useState(true);
const load = () => {
setLoading(true);
api.opsHealth()
.then(setHealth)
Promise.all([
api.opsHealth(),
api.sourceReadiness().catch((error: Error) => {
Toast.error(error.message);
return null;
})
])
.then(([nextHealth, nextSourceReadiness]) => {
setHealth(nextHealth);
setSourceReadiness(normalizeSourceReadiness(nextSourceReadiness));
})
.catch((error: Error) => Toast.error(error.message))
.finally(() => setLoading(false));
};
@@ -477,6 +516,53 @@ export function OpsQuality() {
</Space>
</Card>
<Card
bordered
title={<Space><span>数据源生产就绪度</span><Button size="small" icon={<IconCopy />} disabled={!sourceReadiness} onClick={() => copyText(sourceReadinessReport(sourceReadiness), '数据源生产就绪度')}>复制就绪度报告</Button></Space>}
loading={loading}
style={{ marginTop: 16 }}
>
<Table<SourceReadinessRow>
pagination={false}
dataSource={sourceReadiness?.sources ?? []}
rowKey={(row?: SourceReadinessRow) => row?.protocol ?? ''}
columns={[
{
title: '来源',
width: 150,
render: (_: unknown, row: SourceReadinessRow) => (
<Space vertical align="start" spacing={4}>
<Tag color={row.severity === 'error' ? 'red' : row.severity === 'warning' ? 'orange' : 'green'}>{row.protocol}</Tag>
<Typography.Text type="secondary">{row.role}</Typography.Text>
</Space>
)
},
{
title: '就绪状态',
width: 150,
render: (_: unknown, row: SourceReadinessRow) => <Tag color={row.severity === 'error' ? 'red' : row.severity === 'warning' ? 'orange' : 'green'}>{row.status}</Tag>
},
{ title: '在线率', width: 100, render: (_: unknown, row: SourceReadinessRow) => formatRate(row.onlineRate) },
{ title: '在线/总数', width: 120, render: (_: unknown, row: SourceReadinessRow) => `${formatNumber(row.online)} / ${formatNumber(row.total)}` },
{ title: '缺失车辆', width: 110, render: (_: unknown, row: SourceReadinessRow) => formatNumber(row.missingVehicles) },
{ title: '证据', dataIndex: 'evidence' },
{ title: '建议动作', dataIndex: 'action' },
{
title: '入口',
width: 220,
render: (_: unknown, row: SourceReadinessRow) => (
<Space wrap>
<Button size="small" onClick={() => { window.location.hash = row.realtimeHash; }}>实时</Button>
<Button size="small" onClick={() => { window.location.hash = row.vehiclesHash; }}>车辆</Button>
<Button size="small" onClick={() => { window.location.hash = row.historyHash; }}>RAW</Button>
<Button size="small" onClick={() => { window.location.hash = row.alertHash; }}>告警</Button>
</Space>
)
}
]}
/>
</Card>
<Card bordered title="消息链路积压" loading={loading} style={{ marginTop: 16 }}>
<Table<CapacityMetricRow>
pagination={false}

173
vehicle-data-platform/apps/web/src/test/App.test.tsx
View File

@@ -121,6 +121,59 @@ test('exposes AMap operations shortcuts when map key is configured', async () =>
})
} as Response;
}
if (path.includes('/api/ops/source-readiness')) {
return {
ok: true,
json: async () => ({
data: {
totalVehicles: 1033,
onlineVehicles: 208,
kafkaLag: 42,
activeConnections: 1234,
redisOnlineKeys: 368,
platformRelease: 'platform-ops-test',
sources: [
{
protocol: 'GB32960',
role: '整车与氢能实时数据主来源',
online: 73,
total: 340,
onlineRate: 21.47,
missingVehicles: 693,
severity: 'warning',
status: '覆盖不足',
evidence: '在线 73/340，缺失车辆 693，Kafka Lag 42',
action: '核对现代和交投平台转发清单。',
acceptance: '缺失来源车辆下降，单源车辆可解释。',
vehiclesHash: '#/vehicles?protocol=GB32960&missingProtocol=GB32960',
realtimeHash: '#/realtime?protocol=GB32960&online=online',
historyHash: '#/history-query?protocol=GB32960&tab=raw&includeFields=true',
alertHash: '#/alert-events?protocol=GB32960'
},
{
protocol: 'JT808',
role: '位置、总里程和设备在线主来源',
online: 174,
total: 424,
onlineRate: 41.04,
missingVehicles: 609,
severity: 'ok',
status: '生产可用',
evidence: '在线 174/424，缺失车辆 609，Kafka Lag 42',
action: '保持实时、轨迹、RAW 和统计链路巡检。',
acceptance: '车辆服务可回查实时、轨迹和 RAW 证据。',
vehiclesHash: '#/vehicles?protocol=JT808&missingProtocol=JT808',
realtimeHash: '#/realtime?protocol=JT808&online=online',
historyHash: '#/history-query?protocol=JT808&tab=raw&includeFields=true',
alertHash: '#/alert-events?protocol=JT808'
}
]
},
traceId: 'trace-test',
timestamp: 1783094400000
})
} as Response;
}
return {
ok: true,
json: async () => ({
@@ -191,6 +244,59 @@ test('shows global alert pressure from notification plan in topbar', async () =>
})
} as Response;
}
if (path.includes('/api/ops/source-readiness')) {
return {
ok: true,
json: async () => ({
data: {
totalVehicles: 1033,
onlineVehicles: 208,
kafkaLag: 42,
activeConnections: 1234,
redisOnlineKeys: 368,
platformRelease: 'platform-ops-test',
sources: [
{
protocol: 'GB32960',
role: '整车与氢能实时数据主来源',
online: 73,
total: 340,
onlineRate: 21.47,
missingVehicles: 693,
severity: 'warning',
status: '覆盖不足',
evidence: '在线 73/340，缺失车辆 693，Kafka Lag 42',
action: '核对现代和交投平台转发清单。',
acceptance: '缺失来源车辆下降，单源车辆可解释。',
vehiclesHash: '#/vehicles?protocol=GB32960&missingProtocol=GB32960',
realtimeHash: '#/realtime?protocol=GB32960&online=online',
historyHash: '#/history-query?protocol=GB32960&tab=raw&includeFields=true',
alertHash: '#/alert-events?protocol=GB32960'
},
{
protocol: 'JT808',
role: '位置、总里程和设备在线主来源',
online: 73,
total: 340,
onlineRate: 21.47,
missingVehicles: 693,
severity: 'warning',
status: '覆盖不足',
evidence: '在线 73/340，缺失车辆 693，Kafka Lag 42',
action: '补齐手机号绑定和注册缺失车辆。',
acceptance: '未知 VIN 注册下降，位置与里程持续可查。',
vehiclesHash: '#/vehicles?protocol=JT808&missingProtocol=JT808',
realtimeHash: '#/realtime?protocol=JT808&online=online',
historyHash: '#/history-query?protocol=JT808&tab=raw&includeFields=true',
alertHash: '#/alert-events?protocol=JT808'
}
]
},
traceId: 'trace-test',
timestamp: 1783094400000
})
} as Response;
}
return {
ok: true,
json: async () => ({
@@ -3732,6 +3838,59 @@ test('renders ops quality as a standalone runtime health page', async () => {
})
} as Response;
}
if (path.includes('/api/ops/source-readiness')) {
return {
ok: true,
json: async () => ({
data: {
totalVehicles: 1033,
onlineVehicles: 208,
kafkaLag: 42,
activeConnections: 1234,
redisOnlineKeys: 368,
platformRelease: 'platform-ops-test',
sources: [
{
protocol: 'GB32960',
role: '整车与氢能实时数据主来源',
online: 73,
total: 340,
onlineRate: 21.47,
missingVehicles: 693,
severity: 'warning',
status: '覆盖不足',
evidence: '在线 73/340，缺失车辆 693，Kafka Lag 42',
action: '核对现代和交投平台转发清单。',
acceptance: '缺失来源车辆下降，单源车辆可解释。',
vehiclesHash: '#/vehicles?protocol=GB32960&missingProtocol=GB32960',
realtimeHash: '#/realtime?protocol=GB32960&online=online',
historyHash: '#/history-query?protocol=GB32960&tab=raw&includeFields=true',
alertHash: '#/alert-events?protocol=GB32960'
},
{
protocol: 'JT808',
role: '位置、总里程和设备在线主来源',
online: 73,
total: 340,
onlineRate: 21.47,
missingVehicles: 693,
severity: 'warning',
status: '覆盖不足',
evidence: '在线 73/340，缺失车辆 693，Kafka Lag 42',
action: '补齐手机号绑定和注册缺失车辆。',
acceptance: '未知 VIN 注册下降，位置与里程持续可查。',
vehiclesHash: '#/vehicles?protocol=JT808&missingProtocol=JT808',
realtimeHash: '#/realtime?protocol=JT808&online=online',
historyHash: '#/history-query?protocol=JT808&tab=raw&includeFields=true',
alertHash: '#/alert-events?protocol=JT808'
}
]
},
traceId: 'trace-test',
timestamp: 1783094400000
})
} as Response;
}
return {
ok: true,
json: async () => ({
@@ -3768,7 +3927,14 @@ test('renders ops quality as a standalone runtime health page', async () => {
expect(screen.getByText('NATS 桥接 ACK 未确认')).toBeInTheDocument();
expect(screen.getAllByText('NATS 桥接待消费').length).toBeGreaterThanOrEqual(1);
expect(screen.getByText('桥接处置顺序')).toBeInTheDocument();
expect(screen.getByText('数据源生产就绪度')).toBeInTheDocument();
expect(await screen.findByText('GB32960')).toBeInTheDocument();
expect(screen.getByText('JT808')).toBeInTheDocument();
expect(screen.getByText('整车与氢能实时数据主来源')).toBeInTheDocument();
expect(screen.getAllByText('覆盖不足').length).toBeGreaterThanOrEqual(1);
expect(screen.getAllByText('在线 73/340，缺失车辆 693，Kafka Lag 42').length).toBeGreaterThanOrEqual(1);
expect(fetchMock).toHaveBeenCalledWith(expect.stringContaining('/api/ops/health'), undefined);
expect(fetchMock).toHaveBeenCalledWith(expect.stringContaining('/api/ops/source-readiness'), undefined);
fireEvent.click(screen.getByRole('button', { name: '复制容量交接' }));
expect(writeText).toHaveBeenCalledWith(expect.stringContaining('【车辆数据中台运维容量交接】'));
@@ -3782,6 +3948,13 @@ test('renders ops quality as a standalone runtime health page', async () => {
expect(writeText).toHaveBeenCalledWith(expect.stringContaining('【车辆数据中台容量处置计划】'));
expect(writeText).toHaveBeenCalledWith(expect.stringContaining('P0 稳定 NATS 到 Kafka 桥接'));
expect(writeText).toHaveBeenCalledWith(expect.stringContaining('负责人：数据库 / 应用'));
const sourceReadinessCopyButton = screen.getByText('复制就绪度报告').closest('button');
expect(sourceReadinessCopyButton).not.toBeNull();
fireEvent.click(sourceReadinessCopyButton as HTMLButtonElement);
expect(writeText).toHaveBeenCalledWith(expect.stringContaining('【数据源生产就绪度】'));
expect(writeText).toHaveBeenCalledWith(expect.stringContaining('GB32960 - 覆盖不足'));
expect(writeText).toHaveBeenCalledWith(expect.stringContaining('实时监控：http://localhost:3000/#/realtime?protocol=GB32960&online=online'));
});
test('copies notification text from quality priority queue', async () => {