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

feat(platform): add vehicle detail aggregate api

Browse Source
This commit is contained in:
lingniu
2026-07-03 21:34:50 +08:00
parent 0438d054f6
commit d4bd70fdf4
7 changed files with 147 additions and 51 deletions
Download Patch File Download Diff File Expand all files Collapse all files

11
vehicle-data-platform/apps/api/internal/platform/handler.go
View File

@@ -27,6 +27,7 @@ func (h *Handler) ServeHTTP(w http.ResponseWriter, r *http.Request) {
func (h *Handler) routes() {
h.mux.HandleFunc("GET /api/dashboard/summary", h.handleDashboardSummary)
h.mux.HandleFunc("GET /api/vehicles", h.handleVehicles)
h.mux.HandleFunc("GET /api/vehicles/detail", h.handleVehicleDetail)
h.mux.HandleFunc("GET /api/realtime/locations", h.handleRealtimeLocations)
h.mux.HandleFunc("GET /api/history/locations", h.handleHistoryLocations)
h.mux.HandleFunc("GET /api/history/raw-frames", h.handleRawFramesGet)
@@ -46,6 +47,16 @@ func (h *Handler) handleVehicles(w http.ResponseWriter, r *http.Request) {
h.write(w, r, data, err)
}
func (h *Handler) handleVehicleDetail(w http.ResponseWriter, r *http.Request) {
vin := strings.TrimSpace(r.URL.Query().Get("vin"))
if vin == "" {
httpx.WriteError(w, http.StatusBadRequest, "VIN_REQUIRED", "VIN 不能为空", "", traceID(r))
return
}
data, err := h.service.VehicleDetail(r.Context(), vin, r.URL.Query().Get("protocol"))
h.write(w, r, data, err)
}
func (h *Handler) handleRealtimeLocations(w http.ResponseWriter, r *http.Request) {
data, err := h.service.RealtimeLocations(r.Context(), r.URL.Query())
h.write(w, r, data, err)

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

@@ -33,6 +33,21 @@ func TestHandlerVehicles(t *testing.T) {
}
}
func TestHandlerVehicleDetail(t *testing.T) {
handler := NewHandler(NewService(NewMockStore()))
rec := httptest.NewRecorder()
req := httptest.NewRequest(http.MethodGet, "/api/vehicles/detail?vin=LB9A32A24R0LS1426", nil)
handler.ServeHTTP(rec, req)
if rec.Code != http.StatusOK {
t.Fatalf("status = %d body=%s", rec.Code, rec.Body.String())
}
for _, want := range []string{"identity", "realtime", "history", "raw", "mileage", "sources"} {
if !strings.Contains(rec.Body.String(), want) {
t.Fatalf("response missing %q: %s", want, rec.Body.String())
}
}
}
func TestHandlerRealtimeLocations(t *testing.T) {
handler := NewHandler(NewService(NewMockStore()))
rec := httptest.NewRecorder()

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

@@ -41,6 +41,16 @@ type VehicleRow struct {
BindingScore int `json:"bindingScore"`
}
type VehicleDetail struct {
VIN string `json:"vin"`
Identity *VehicleRow `json:"identity,omitempty"`
Sources []string `json:"sources"`
Realtime []RealtimeLocationRow `json:"realtime"`
History Page[HistoryLocationRow] `json:"history"`
Raw Page[RawFrameRow] `json:"raw"`
Mileage Page[DailyMileageRow] `json:"mileage"`
}
type RealtimeLocationRow struct {
VIN string `json:"vin"`
Plate string `json:"plate"`

85
vehicle-data-platform/apps/api/internal/platform/service.go
View File

@@ -3,6 +3,8 @@ package platform
import (
"context"
"net/url"
"sort"
"strings"
)
type Store interface {
@@ -44,6 +46,60 @@ func (s *Service) Vehicles(ctx context.Context, query url.Values) (Page[VehicleR
return s.store.Vehicles(ctx, query)
}
func (s *Service) VehicleDetail(ctx context.Context, vin string, protocol string) (VehicleDetail, error) {
vin = strings.TrimSpace(vin)
protocol = strings.TrimSpace(protocol)
vehicleQuery := url.Values{"keyword": {vin}, "limit": {"10"}}
realtimeQuery := url.Values{"vin": {vin}, "limit": {"20"}}
historyQuery := url.Values{"vin": {vin}, "limit": {"20"}}
rawQuery := RawFrameQuery{VIN: vin, IncludeFields: true, Limit: 10}
mileageQuery := url.Values{"vin": {vin}, "limit": {"20"}}
if protocol != "" {
realtimeQuery.Set("protocol", protocol)
historyQuery.Set("protocol", protocol)
rawQuery.Protocol = protocol
}
vehicles, err := s.store.Vehicles(ctx, vehicleQuery)
if err != nil {
return VehicleDetail{}, err
}
realtime, err := s.store.RealtimeLocations(ctx, realtimeQuery)
if err != nil {
return VehicleDetail{}, err
}
history, err := s.store.HistoryLocationsFromTDengine(ctx, historyQuery)
if err != nil {
return VehicleDetail{}, err
}
raw, err := s.RawFrames(ctx, rawQuery)
if err != nil {
return VehicleDetail{}, err
}
mileage, err := s.store.DailyMileage(ctx, mileageQuery)
if err != nil {
return VehicleDetail{}, err
}
var identity *VehicleRow
for index := range vehicles.Items {
if strings.EqualFold(vehicles.Items[index].VIN, vin) {
identity = &vehicles.Items[index]
break
}
}
if identity == nil && len(vehicles.Items) > 0 {
identity = &vehicles.Items[0]
}
return VehicleDetail{
VIN: vin,
Identity: identity,
Sources: vehicleSources(vehicles.Items, realtime.Items, raw.Items, mileage.Items),
Realtime: realtime.Items,
History: history,
Raw: raw,
Mileage: mileage,
}, nil
}
func (s *Service) RealtimeLocations(ctx context.Context, query url.Values) (Page[RealtimeLocationRow], error) {
return s.store.RealtimeLocations(ctx, query)
}
@@ -70,3 +126,32 @@ func (s *Service) QualityIssues(ctx context.Context, query url.Values) (Page[Qua
func (s *Service) OpsHealth(ctx context.Context) (OpsHealth, error) {
return s.store.OpsHealth(ctx)
}
func vehicleSources(vehicles []VehicleRow, realtime []RealtimeLocationRow, raw []RawFrameRow, mileage []DailyMileageRow) []string {
seen := map[string]struct{}{}
add := func(value string) {
value = strings.TrimSpace(value)
if value == "" {
return
}
seen[value] = struct{}{}
}
for _, row := range vehicles {
add(row.Protocol)
}
for _, row := range realtime {
add(row.Protocol)
}
for _, row := range raw {
add(row.Protocol)
}
for _, row := range mileage {
add(row.Source)
}
out := make([]string, 0, len(seen))
for source := range seen {
out = append(out, source)
}
sort.Strings(out)
return out
}

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

@@ -8,6 +8,7 @@ import type {
QualityIssueRow,
RawFrameRow,
RealtimeLocationRow,
VehicleDetail,
VehicleRow
} from './types';
@@ -23,6 +24,7 @@ async function request<T>(path: string, init?: RequestInit): Promise<T> {
export const api = {
dashboardSummary: () => request<DashboardSummary>('/api/dashboard/summary'),
vehicles: (params = new URLSearchParams()) => request<Page<VehicleRow>>(`/api/vehicles?${params.toString()}`),
vehicleDetail: (params = new URLSearchParams()) => request<VehicleDetail>(`/api/vehicles/detail?${params.toString()}`),
realtimeLocations: (params = new URLSearchParams()) => request<Page<RealtimeLocationRow>>(`/api/realtime/locations?${params.toString()}`),
historyLocations: (params = new URLSearchParams()) => request<Page<HistoryLocationRow>>(`/api/history/locations?${params.toString()}`),
rawFrames: (params = new URLSearchParams()) => request<Page<RawFrameRow>>(`/api/history/raw-frames?${params.toString()}`),

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

@@ -38,6 +38,16 @@ export interface VehicleRow {
bindingScore: number;
}
export interface VehicleDetail {
vin: string;
identity?: VehicleRow;
sources: string[];
realtime: RealtimeLocationRow[];
history: Page<HistoryLocationRow>;
raw: Page<RawFrameRow>;
mileage: Page<DailyMileageRow>;
}
export interface RealtimeLocationRow {
vin: string;
plate: string;

65
vehicle-data-platform/apps/web/src/pages/VehicleDetail.tsx
View File

@@ -2,18 +2,10 @@ import { Button, Card, Descriptions, Form, Select, Space, Table, Tabs, Tag, Toas
import { IconRefresh, IconSearch } from '@douyinfe/semi-icons';
import { useEffect, useMemo, useState } from 'react';
import { api } from '../api/client';
import type { DailyMileageRow, HistoryLocationRow, RawFrameRow, RealtimeLocationRow, VehicleRow } from '../api/types';
import type { VehicleDetail as VehicleDetailData } from '../api/types';
import { PageHeader } from '../components/PageHeader';
import { StatusTag } from '../components/StatusTag';
type VehicleServiceState = {
vehicles: VehicleRow[];
realtime: RealtimeLocationRow[];
history: HistoryLocationRow[];
raw: RawFrameRow[];
mileage: DailyMileageRow[];
};
type VehicleQuery = {
vin: string;
protocol?: string;
@@ -23,17 +15,9 @@ const defaultQuery: VehicleQuery = {
vin: 'LB9A32A24R0LS1426'
};
const emptyState: VehicleServiceState = {
vehicles: [],
realtime: [],
history: [],
raw: [],
mileage: []
};
export function VehicleDetail() {
const [query, setQuery] = useState<VehicleQuery>(defaultQuery);
const [state, setState] = useState<VehicleServiceState>(emptyState);
const [detail, setDetail] = useState<VehicleDetailData | null>(null);
const [loading, setLoading] = useState(false);
const load = (nextQuery = query) => {
@@ -43,30 +27,12 @@ export function VehicleDetail() {
return;
}
setLoading(true);
const scoped = new URLSearchParams({ vin, limit: '20' });
const vehicleParams = new URLSearchParams({ keyword: vin, limit: '5' });
const rawParams = new URLSearchParams({ vin, limit: '10', includeFields: 'true' });
const mileageParams = new URLSearchParams({ vin, limit: '20' });
const params = new URLSearchParams({ vin });
if (nextQuery.protocol?.trim()) {
scoped.set('protocol', nextQuery.protocol.trim());
rawParams.set('protocol', nextQuery.protocol.trim());
params.set('protocol', nextQuery.protocol.trim());
}
Promise.all([
api.vehicles(vehicleParams),
api.realtimeLocations(scoped),
api.historyLocations(scoped),
api.rawFrames(rawParams),
api.dailyMileage(mileageParams)
])
.then(([vehicles, realtime, history, raw, mileage]) => {
setState({
vehicles: vehicles.items,
realtime: realtime.items,
history: history.items,
raw: raw.items,
mileage: mileage.items
});
})
api.vehicleDetail(params)
.then(setDetail)
.catch((error: Error) => Toast.error(error.message))
.finally(() => setLoading(false));
};
@@ -75,13 +41,10 @@ export function VehicleDetail() {
load(defaultQuery);
}, []);
const identity = state.vehicles[0];
const latest = state.realtime[0];
const protocols = useMemo(
() => Array.from(new Set([...state.vehicles.map((row) => row.protocol), ...state.realtime.map((row) => row.protocol)].filter(Boolean))),
[state.realtime, state.vehicles]
);
const latestRaw = state.raw[0];
const identity = detail?.identity;
const latest = detail?.realtime[0];
const protocols = useMemo(() => detail?.sources ?? [], [detail?.sources]);
const latestRaw = detail?.raw.items[0];
return (
<div className="vp-page">
@@ -130,7 +93,7 @@ export function VehicleDetail() {
loading={loading}
pagination={false}
rowKey="protocol"
dataSource={state.realtime}
dataSource={detail?.realtime ?? []}
columns={[
{ title: '来源', dataIndex: 'protocol', width: 130 },
{ title: '经度', dataIndex: 'longitude', width: 120 },
@@ -147,7 +110,7 @@ export function VehicleDetail() {
loading={loading}
pagination={false}
rowKey="deviceTime"
dataSource={state.history}
dataSource={detail?.history.items ?? []}
columns={[
{ title: '来源', dataIndex: 'protocol', width: 130 },
{ title: '经度', dataIndex: 'longitude', width: 120 },
@@ -164,7 +127,7 @@ export function VehicleDetail() {
loading={loading}
pagination={false}
rowKey="id"
dataSource={state.raw}
dataSource={detail?.raw.items ?? []}
columns={[
{ title: '来源', dataIndex: 'protocol', width: 130 },
{ title: '帧类型', dataIndex: 'frameType', width: 190 },
@@ -181,7 +144,7 @@ export function VehicleDetail() {
loading={loading}
pagination={false}
rowKey="date"
dataSource={state.mileage}
dataSource={detail?.mileage.items ?? []}
columns={[
{ title: '日期', dataIndex: 'date', width: 130 },
{ title: '来源', dataIndex: 'source', width: 130 },