feat(platform): surface overview consistency

vehicle-data-platform/apps/api/internal/platform/handler_test.go

@@ -276,6 +276,9 @@ func TestHandlerVehicleServiceOverviewEndpoint(t *testing.T) {
 	if body.Data.ServiceStatus == nil || body.Data.ServiceStatus.Status != "degraded" || body.Data.ServiceStatus.Title != "部分来源离线" {
 		t.Fatalf("overview endpoint should expose canonical service status, got %+v", body.Data.ServiceStatus)
 	}
+	if body.Data.SourceConsistency == nil || body.Data.SourceConsistency.SourceCount != 2 || body.Data.SourceConsistency.OnlineSourceCount != 1 {
+		t.Fatalf("overview endpoint should expose source consistency, got %+v", body.Data.SourceConsistency)
+	}
 	if strings.Contains(rec.Body.String(), `"raw"`) || strings.Contains(rec.Body.String(), `"history"`) {
 		t.Fatalf("overview endpoint should not return heavy detail pages: %s", rec.Body.String())
 	}
@@ -330,6 +333,9 @@ func TestHandlerVehicleServiceOverviewsEndpoint(t *testing.T) {
 	if body.Data.Items[0].ServiceStatus == nil || body.Data.Items[1].ServiceStatus == nil {
 		t.Fatalf("batch overview should include canonical status for every vehicle, got %+v", body.Data.Items)
 	}
+	if body.Data.Items[0].SourceConsistency == nil || body.Data.Items[0].SourceConsistency.SourceCount != 2 {
+		t.Fatalf("batch overview should include source consistency, got %+v", body.Data.Items[0].SourceConsistency)
+	}
 	if strings.Contains(rec.Body.String(), `"raw"`) || strings.Contains(rec.Body.String(), `"history"`) {
 		t.Fatalf("batch overview should not return heavy detail pages: %s", rec.Body.String())
 	}

vehicle-data-platform/apps/api/internal/platform/model.go

@@ -64,8 +64,8 @@ type VehicleCoverageRow struct {
 }
 
 type VehicleCoverageSummary struct {
-	TotalVehicles       int `json:"totalVehicles"`
-	OnlineVehicles      int `json:"onlineVehicles"`
+	TotalVehicles        int `json:"totalVehicles"`
+	OnlineVehicles       int `json:"onlineVehicles"`
 	SingleSourceVehicles int `json:"singleSourceVehicles"`
 	MultiSourceVehicles  int `json:"multiSourceVehicles"`
 	UnboundVehicles      int `json:"unboundVehicles"`
@@ -113,22 +113,23 @@ type VehicleSourceConsistency struct {
 }
 
 type VehicleServiceOverview struct {
-	VIN               string                `json:"vin"`
-	Plate             string                `json:"plate"`
-	Phone             string                `json:"phone"`
-	OEM               string                `json:"oem"`
-	Protocols         []string              `json:"protocols"`
-	PrimaryProtocol   string                `json:"primaryProtocol"`
-	CoverageStatus    string                `json:"coverageStatus"`
-	SourceCount       int                   `json:"sourceCount"`
-	OnlineSourceCount int                   `json:"onlineSourceCount"`
-	LastSeen          string                `json:"lastSeen"`
-	RealtimeCount     int                   `json:"realtimeCount"`
-	HistoryCount      int                   `json:"historyCount"`
-	RawCount          int                   `json:"rawCount"`
-	MileageCount      int                   `json:"mileageCount"`
-	QualityIssueCount int                   `json:"qualityIssueCount"`
-	ServiceStatus     *VehicleServiceStatus `json:"serviceStatus,omitempty"`
+	VIN               string                    `json:"vin"`
+	Plate             string                    `json:"plate"`
+	Phone             string                    `json:"phone"`
+	OEM               string                    `json:"oem"`
+	Protocols         []string                  `json:"protocols"`
+	PrimaryProtocol   string                    `json:"primaryProtocol"`
+	CoverageStatus    string                    `json:"coverageStatus"`
+	SourceCount       int                       `json:"sourceCount"`
+	OnlineSourceCount int                       `json:"onlineSourceCount"`
+	LastSeen          string                    `json:"lastSeen"`
+	RealtimeCount     int                       `json:"realtimeCount"`
+	HistoryCount      int                       `json:"historyCount"`
+	RawCount          int                       `json:"rawCount"`
+	MileageCount      int                       `json:"mileageCount"`
+	QualityIssueCount int                       `json:"qualityIssueCount"`
+	ServiceStatus     *VehicleServiceStatus     `json:"serviceStatus,omitempty"`
+	SourceConsistency *VehicleSourceConsistency `json:"sourceConsistency,omitempty"`
 }
 
 type VehicleServiceSummary struct {

vehicle-data-platform/apps/api/internal/platform/production_store.go

@@ -332,8 +332,7 @@ func (s *ProductionStore) VehicleServiceOverviews(ctx context.Context, query Veh
 			overview.PrimaryProtocol = overview.Protocols[0]
 		}
 		overview.RealtimeCount = overview.SourceCount
-		overview.CoverageStatus = coverageStatus(overview.SourceCount, overview.OnlineSourceCount)
-		overview.ServiceStatus = buildVehicleServiceStatus(strings.TrimSpace(overview.VIN) != "", statusesForOverview(&overview))
+		applyVehicleServiceOverviewDerivedFields(&overview, strings.TrimSpace(overview.VIN) != "")
 		overviews = append(overviews, overview)
 		current := &overviews[len(overviews)-1]
 		for _, key := range []string{overview.VIN, overview.Plate, overview.Phone} {

vehicle-data-platform/apps/api/internal/platform/production_store_test.go

@@ -40,3 +40,24 @@ func TestVehicleServiceOverviewMatchesPartialKeyword(t *testing.T) {
 		t.Fatalf("overview %+v should not match unrelated keyword", overview)
 	}
 }
+
+func TestVehicleServiceOverviewDerivedFieldsIncludeSourceConsistency(t *testing.T) {
+	overview := &VehicleServiceOverview{
+		VIN:               "LB9A32A24R0LS1426",
+		Protocols:         []string{"GB32960", "JT808"},
+		SourceCount:       2,
+		OnlineSourceCount: 1,
+	}
+
+	applyVehicleServiceOverviewDerivedFields(overview, true)
+
+	if overview.SourceConsistency == nil {
+		t.Fatalf("overview should include source consistency")
+	}
+	if overview.SourceConsistency.SourceCount != 2 || overview.SourceConsistency.OnlineSourceCount != 1 {
+		t.Fatalf("source consistency should mirror overview source coverage, got %+v", overview.SourceConsistency)
+	}
+	if overview.ServiceStatus == nil || overview.ServiceStatus.Status != "degraded" {
+		t.Fatalf("overview should keep canonical service status, got %+v", overview.ServiceStatus)
+	}
+}

vehicle-data-platform/apps/api/internal/platform/service.go

@@ -462,10 +462,23 @@ func buildVehicleServiceOverview(vin string, lookupKey string, resolution *Vehic
 	if !resolved && resolution != nil {
 		resolved = resolution.Resolved
 	}
-	overview.ServiceStatus = buildVehicleServiceStatus(resolved, statusesForOverview(overview))
+	applyVehicleServiceOverviewDerivedFields(overview, resolved)
 	return overview
 }
 
+func applyVehicleServiceOverviewDerivedFields(overview *VehicleServiceOverview, resolved bool) {
+	if overview == nil {
+		return
+	}
+	overview.CoverageStatus = coverageStatus(overview.SourceCount, overview.OnlineSourceCount)
+	overview.ServiceStatus = buildVehicleServiceStatus(resolved, statusesForOverview(overview))
+	overview.SourceConsistency = &VehicleSourceConsistency{
+		SourceCount:       overview.SourceCount,
+		OnlineSourceCount: overview.OnlineSourceCount,
+		Scope:             "all_sources",
+	}
+}
+
 func statusesForOverview(overview *VehicleServiceOverview) []VehicleSourceStatus {
 	statuses := make([]VehicleSourceStatus, 0, overview.SourceCount)
 	for index, protocol := range overview.Protocols {