docs(go): document realtime total semantics

2026-07-03 07:53:30 +08:00
parent b3ea2bd91f
commit 0aa71402d1
2 changed files with 9 additions and 3 deletions
--- a/go/vehicle-gateway/internal/realtime/openapi_test.go
+++ b/go/vehicle-gateway/internal/realtime/openapi_test.go
@@ -22,4 +22,9 @@ func TestOpenAPIHandlerDocumentsRealtimeSnapshotAndLocation(t *testing.T) {
 			t.Fatalf("openapi missing %s: %s", want, body)
 		}
 	}
+	for _, want := range []string{`"includeTotal"`, `默认不执行 COUNT(*)`, `total 默认表示本页返回条数`} {
+		if !strings.Contains(body, want) {
+			t.Fatalf("openapi should document lightweight total semantics, missing %s: %s", want, body)
+		}
+	}
 }