feat(platform): expose coverage service status

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

@@ -50,6 +50,18 @@ func TestHandlerVehicleCoverage(t *testing.T) {
 			t.Fatalf("response missing %q: %s", want, rec.Body.String())
 		}
 	}
+	var body struct {
+		Data Page[VehicleCoverageRow] `json:"data"`
+	}
+	if err := json.Unmarshal(rec.Body.Bytes(), &body); err != nil {
+		t.Fatalf("response JSON should decode: %v body=%s", err, rec.Body.String())
+	}
+	if len(body.Data.Items) == 0 || body.Data.Items[0].ServiceStatus == nil {
+		t.Fatalf("coverage row should include canonical vehicle service status: %s", rec.Body.String())
+	}
+	if body.Data.Items[0].ServiceStatus.Status != "degraded" {
+		t.Fatalf("coverage row should expose degraded status, got %+v", body.Data.Items[0].ServiceStatus)
+	}
 }
 
 func TestHandlerVehicleCoverageFiltersServiceStatus(t *testing.T) {

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

@@ -94,6 +94,7 @@ func (m *MockStore) VehicleCoverage(_ context.Context, query url.Values) (Page[V
 	}
 	items := make([]VehicleCoverageRow, 0, len(byVIN))
 	for _, row := range byVIN {
+		row.ServiceStatus = buildVehicleCoverageServiceStatus(*row)
 		if keepCoverageRow(*row, query) {
 			items = append(items, *row)
 		}

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

@@ -49,16 +49,17 @@ type VehicleRow struct {
 }
 
 type VehicleCoverageRow struct {
-	VIN               string   `json:"vin"`
-	Plate             string   `json:"plate"`
-	Phone             string   `json:"phone"`
-	OEM               string   `json:"oem"`
-	Protocols         []string `json:"protocols"`
-	SourceCount       int      `json:"sourceCount"`
-	OnlineSourceCount int      `json:"onlineSourceCount"`
-	Online            bool     `json:"online"`
-	LastSeen          string   `json:"lastSeen"`
-	BindingStatus     string   `json:"bindingStatus"`
+	VIN               string                `json:"vin"`
+	Plate             string                `json:"plate"`
+	Phone             string                `json:"phone"`
+	OEM               string                `json:"oem"`
+	Protocols         []string              `json:"protocols"`
+	SourceCount       int                   `json:"sourceCount"`
+	OnlineSourceCount int                   `json:"onlineSourceCount"`
+	Online            bool                  `json:"online"`
+	LastSeen          string                `json:"lastSeen"`
+	BindingStatus     string                `json:"bindingStatus"`
+	ServiceStatus     *VehicleServiceStatus `json:"serviceStatus,omitempty"`
 }
 
 type VehicleIdentityResolution struct {

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

@@ -163,6 +163,7 @@ func (s *ProductionStore) VehicleCoverage(ctx context.Context, query url.Values)
 		}
 		row.Protocols = splitCSV(protocols)
 		row.Online = online == 1
+		row.ServiceStatus = buildVehicleCoverageServiceStatus(row)
 		items = append(items, row)
 	}
 	if err := rows.Err(); err != nil {

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

@@ -478,6 +478,57 @@ func buildVehicleServiceStatus(resolved bool, statuses []VehicleSourceStatus) *V
 	}
 }
 
+func buildVehicleCoverageServiceStatus(row VehicleCoverageRow) *VehicleServiceStatus {
+	if row.BindingStatus != "bound" {
+		return &VehicleServiceStatus{
+			Status:            "identity_required",
+			Severity:          "warning",
+			Title:             "身份未绑定",
+			Detail:            "车辆身份绑定不完整，需先维护 VIN、车牌或手机号映射。",
+			SourceCount:       row.SourceCount,
+			OnlineSourceCount: row.OnlineSourceCount,
+		}
+	}
+	if row.SourceCount == 0 {
+		return &VehicleServiceStatus{
+			Status:            "no_data",
+			Severity:          "warning",
+			Title:             "暂无数据来源",
+			Detail:            "车辆已绑定，但暂未查询到 32960、808 或 MQTT 数据来源。",
+			SourceCount:       row.SourceCount,
+			OnlineSourceCount: row.OnlineSourceCount,
+		}
+	}
+	if row.OnlineSourceCount == 0 {
+		return &VehicleServiceStatus{
+			Status:            "offline",
+			Severity:          "error",
+			Title:             "车辆离线",
+			Detail:            "所有已知数据来源均未在线，需要检查平台转发、终端上报或链路状态。",
+			SourceCount:       row.SourceCount,
+			OnlineSourceCount: row.OnlineSourceCount,
+		}
+	}
+	if row.OnlineSourceCount < row.SourceCount {
+		return &VehicleServiceStatus{
+			Status:            "degraded",
+			Severity:          "warning",
+			Title:             "部分来源离线",
+			Detail:            sourceCoverageDetail(row.SourceCount, row.OnlineSourceCount, "车辆服务可用但需要关注离线来源。"),
+			SourceCount:       row.SourceCount,
+			OnlineSourceCount: row.OnlineSourceCount,
+		}
+	}
+	return &VehicleServiceStatus{
+		Status:            "healthy",
+		Severity:          "ok",
+		Title:             "服务正常",
+		Detail:            sourceCoverageDetail(row.SourceCount, row.OnlineSourceCount, "全部已知来源在线。"),
+		SourceCount:       row.SourceCount,
+		OnlineSourceCount: row.OnlineSourceCount,
+	}
+}
+
 func sourceCoverageDetail(sourceCount int, onlineSourceCount int, suffix string) string {
 	return strconv.Itoa(onlineSourceCount) + "/" + strconv.Itoa(sourceCount) + " 个来源在线，" + suffix
 }