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

feat(platform): summarize service status on dashboard

Browse Source
This commit is contained in:
lingniu
2026-07-04 01:59:05 +08:00
parent 14408d135d
commit 5d401a8f0b
8 changed files with 132 additions and 10 deletions
Download Patch File Download Diff File Expand all files Collapse all files

3
vehicle-data-platform/apps/api/internal/platform/handler_test.go
View File

@@ -19,6 +19,9 @@ func TestHandlerDashboardSummary(t *testing.T) {
if !strings.Contains(rec.Body.String(), "onlineVehicles") {
t.Fatalf("response missing onlineVehicles: %s", rec.Body.String())
}
if !strings.Contains(rec.Body.String(), "serviceStatuses") || !strings.Contains(rec.Body.String(), "degraded") {
t.Fatalf("response missing vehicle service status distribution: %s", rec.Body.String())
}
}
func TestHandlerVehicles(t *testing.T) {

6
vehicle-data-platform/apps/api/internal/platform/mock_store.go
View File

@@ -44,6 +44,12 @@ func (m *MockStore) DashboardSummary(context.Context) (DashboardSummary, error)
{Protocol: "JT808", Online: 73, Total: 318},
{Protocol: "YUTONG_MQTT", Online: 1, Total: 8},
},
ServiceStatuses: []ServiceStatusStat{
{Status: "healthy", Title: "服务正常", Count: 2},
{Status: "degraded", Title: "部分来源离线", Count: 1},
{Status: "offline", Title: "车辆离线", Count: 1},
{Status: "identity_required", Title: "身份未绑定", Count: 0},
},
LinkHealth: []LinkHealth{
{Name: "Redis realtime", Status: "ok", Detail: "在线状态 1 分钟 TTL 正常"},
{Name: "TDengine raw_frames", Status: "ok", Detail: "最近 5 分钟有写入"},

21
vehicle-data-platform/apps/api/internal/platform/model.go
View File

@@ -8,13 +8,14 @@ type Page[T any] struct {
}
type DashboardSummary struct {
OnlineVehicles int `json:"onlineVehicles"`
ActiveToday int `json:"activeToday"`
FrameToday int `json:"frameToday"`
IssueVehicles int `json:"issueVehicles"`
KafkaLag *int `json:"kafkaLag"`
Protocols []ProtocolStat `json:"protocols"`
LinkHealth []LinkHealth `json:"linkHealth"`
OnlineVehicles int `json:"onlineVehicles"`
ActiveToday int `json:"activeToday"`
FrameToday int `json:"frameToday"`
IssueVehicles int `json:"issueVehicles"`
KafkaLag *int `json:"kafkaLag"`
Protocols []ProtocolStat `json:"protocols"`
ServiceStatuses []ServiceStatusStat `json:"serviceStatuses"`
LinkHealth []LinkHealth `json:"linkHealth"`
}
type ProtocolStat struct {
@@ -23,6 +24,12 @@ type ProtocolStat struct {
Total int `json:"total"`
}
type ServiceStatusStat struct {
Status string `json:"status"`
Title string `json:"title"`
Count int `json:"count"`
}
type LinkHealth struct {
Name string `json:"name"`
Status string `json:"status"`

26
vehicle-data-platform/apps/api/internal/platform/production_store.go
View File

@@ -60,6 +60,11 @@ func (s *ProductionStore) DashboardSummary(ctx context.Context) (DashboardSummar
return DashboardSummary{}, err
}
summary.Protocols = protocols
serviceStatuses, err := s.serviceStatusStats(ctx)
if err != nil {
return DashboardSummary{}, err
}
summary.ServiceStatuses = serviceStatuses
health, err := s.OpsHealth(ctx)
if err != nil {
return DashboardSummary{}, err
@@ -69,6 +74,27 @@ func (s *ProductionStore) DashboardSummary(ctx context.Context) (DashboardSummar
return summary, nil
}
func (s *ProductionStore) serviceStatusStats(ctx context.Context) ([]ServiceStatusStat, error) {
definitions := []ServiceStatusStat{
{Status: "healthy", Title: "服务正常"},
{Status: "degraded", Title: "部分来源离线"},
{Status: "offline", Title: "车辆离线"},
{Status: "identity_required", Title: "身份未绑定"},
}
out := make([]ServiceStatusStat, 0, len(definitions))
for _, definition := range definitions {
query := url.Values{"serviceStatus": {definition.Status}, "limit": {"1"}}
built := buildVehicleCoverageSQL(query)
count := 0
if err := s.db.QueryRowContext(ctx, built.CountText, built.CountArgs...).Scan(&count); err != nil {
return nil, err
}
definition.Count = count
out = append(out, definition)
}
return out, nil
}
func (s *ProductionStore) frameToday(ctx context.Context, now time.Time) (int, error) {
if s.tdengine == nil {
return 0, nil

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

@@ -23,9 +23,16 @@ export interface DashboardSummary {
issueVehicles: number;
kafkaLag: number | null;
protocols: ProtocolStat[];
serviceStatuses: ServiceStatusStat[];
linkHealth: LinkHealth[];
}
export interface ServiceStatusStat {
status: string;
title: string;
count: number;
}
export interface VehicleRow {
vin: string;
plate: string;

28
vehicle-data-platform/apps/web/src/pages/Dashboard.tsx
View File

@@ -1,7 +1,7 @@
import { Button, Card, Col, Form, Row, Select, Space, Spin, Table, Tag, Toast, Typography } from '@douyinfe/semi-ui';
import { useEffect, useState } from 'react';
import { api } from '../api/client';
import type { DashboardSummary, LinkHealth, ProtocolStat, QualityIssueRow, VehicleCoverageRow, VehicleRealtimeRow } from '../api/types';
import type { DashboardSummary, LinkHealth, ProtocolStat, QualityIssueRow, ServiceStatusStat, VehicleCoverageRow, VehicleRealtimeRow } from '../api/types';
import { PageHeader } from '../components/PageHeader';
import { StatusTag } from '../components/StatusTag';
import { qualityIssueVehicleLookup } from '../domain/vehicleLookup';
@@ -12,6 +12,13 @@ const statusColor: Record<string, 'green' | 'orange' | 'red' | 'grey'> = {
error: 'red'
};
const serviceStatusColor: Record<string, 'green' | 'orange' | 'red' | 'grey'> = {
healthy: 'green',
degraded: 'orange',
offline: 'red',
identity_required: 'orange'
};
function formatLag(value?: number | null) {
return value == null ? '未接入' : value.toLocaleString();
}
@@ -74,7 +81,22 @@ export function Dashboard({ onOpenVehicle, onOpenQuality }: { onOpenVehicle: (vi
))}
</div>
<Row gutter={16}>
<Col span={14}>
<Col span={8}>
<Card title="车辆服务状态" bordered>
<Table
pagination={false}
dataSource={summary?.serviceStatuses ?? []}
columns={[
{
title: '状态',
render: (_: unknown, row: ServiceStatusStat) => <Tag color={serviceStatusColor[row.status] ?? 'grey'}>{row.title}</Tag>
},
{ title: '车辆数', dataIndex: 'count' }
]}
/>
</Card>
</Col>
<Col span={8}>
<Card title="数据来源在线分布" bordered>
<Table
pagination={false}
@@ -91,7 +113,7 @@ export function Dashboard({ onOpenVehicle, onOpenQuality }: { onOpenVehicle: (vi
/>
</Card>
</Col>
<Col span={10}>
<Col span={8}>
<Card title="链路健康" bordered>
<Table
pagination={false}

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

@@ -14,6 +14,49 @@ test('renders vehicle platform shell', () => {
expect(screen.getAllByText('总览工作台').length).toBeGreaterThanOrEqual(1);
});
test('shows vehicle service status distribution on dashboard', async () => {
window.history.replaceState(null, '', '/#/dashboard');
vi.spyOn(globalThis, 'fetch').mockImplementation(async (input) => {
const path = String(input);
if (path.includes('/api/dashboard/summary')) {
return {
ok: true,
json: async () => ({
data: {
onlineVehicles: 3,
activeToday: 4,
frameToday: 1286320,
issueVehicles: 7,
kafkaLag: 0,
protocols: [],
serviceStatuses: [
{ status: 'healthy', title: '服务正常', count: 12 },
{ status: 'degraded', title: '部分来源离线', count: 39 }
],
linkHealth: []
},
traceId: 'trace-test',
timestamp: 1783094400000
})
} as Response;
}
return {
ok: true,
json: async () => ({
data: { items: [], total: 0, limit: 10, offset: 0 },
traceId: 'trace-test',
timestamp: 1783094400000
})
} as Response;
});
render(<App />);
expect(await screen.findByText('车辆服务状态')).toBeInTheDocument();
expect(screen.getByText('部分来源离线')).toBeInTheDocument();
expect(screen.getByText('39')).toBeInTheDocument();
});
test('opens vehicle detail from shareable hash', async () => {
window.history.replaceState(null, '', '/#/detail?keyword=%E7%B2%A4AG18312');
vi.spyOn(globalThis, 'fetch').mockResolvedValue({

8
vehicle-data-platform/docs/api-contract.md
View File

@@ -39,6 +39,14 @@ If a keyword cannot be resolved to a VIN, data APIs must not fabricate a VIN. Th
## Core Query APIs
### Dashboard Summary
```http
GET /api/dashboard/summary
```
Returns vehicle service KPIs, source distribution, vehicle service status distribution, link health, and realtime backlog.
### Vehicle Service
```http