fix(obs): 对齐无兼容层与健康/UV 权威语义

Agent 本地旧观测缓冲直接删除并运行重建；设计文档去掉兼容期表述。健康当前态以 PG status/message 为准，CH 仅存 status 与连接时序； Zone 曲线标明分桶 UV，顶部为整窗独立访客。
2026-10-06 07:36:37 +08:00 · 2026-07-18 12:09:27 +08:00
parent 802d516f5b
commit 55f8c9a527
8 changed files with 285 additions and 107 deletions
@@ -1,7 +1,9 @@
 package state

 import (
+	"os"
 	"path/filepath"
+	"strings"
 	"testing"

 	"github.com/Rain-kl/Wavelet/internal/apps/agent/protocol"
@@ -95,3 +97,93 @@ func TestObservabilityWindowStartedAt(t *testing.T) {
 		t.Fatalf("unexpected host-metrics window start: %d", value)
 	}
 }
+
+func TestObservabilityBufferStoreDiscardsLegacyDiskJSON(t *testing.T) {
+	path := filepath.Join(t.TempDir(), "observability-buffer.json")
+	legacy := `[{
+		"window_started_at_unix": 1710403200,
+		"snapshot": {"captured_at_unix": 1710403205, "cpu_usage_percent": 11.5},
+		"openresty_observation": {"captured_at_unix": 1710403206, "openresty_connections": 7},
+		"traffic_report": {"request_count": 42},
+		"access_logs": [{"logged_at_unix": 1710403201, "path": "/", "status_code": 200}]
+	}]`
+	if err := os.WriteFile(path, []byte(legacy), 0o644); err != nil {
+		t.Fatalf("WriteFile: %v", err)
+	}
+
+	store := NewObservabilityBufferStore(path)
+	records, err := store.Replayable(0, 0)
+	if err != nil {
+		t.Fatalf("Replayable: %v", err)
+	}
+	if len(records) != 0 {
+		t.Fatalf("expected legacy buffer discarded, got %+v", records)
+	}
+	// Replayable may rewrite an empty v2 array; legacy keys must be gone.
+	if body, err := os.ReadFile(path); err == nil {
+		raw := string(body)
+		for _, key := range []string{`"snapshot"`, `"openresty_observation"`, `"traffic_report"`} {
+			if strings.Contains(raw, key) {
+				t.Fatalf("legacy key %s still present: %s", key, raw)
+			}
+		}
+	}
+
+	// Fresh upsert after discard should create a clean v2 file.
+	if err := store.Upsert(ObservabilityBufferRecord{
+		WindowStartedAtUnix: 1710403200,
+		HostMetrics:         &protocol.NodeMetricSnapshot{CapturedAtUnix: 1710403205},
+	}, 0); err != nil {
+		t.Fatalf("Upsert after discard: %v", err)
+	}
+	records, err = store.Replayable(0, 0)
+	if err != nil {
+		t.Fatalf("Replayable after rebuild: %v", err)
+	}
+	if len(records) != 1 || records[0].HostMetrics == nil {
+		t.Fatalf("expected rebuilt buffer, got %+v", records)
+	}
+}
+
+func TestObservabilityBufferStoreDiscardsCorruptJSON(t *testing.T) {
+	path := filepath.Join(t.TempDir(), "observability-buffer.json")
+	if err := os.WriteFile(path, []byte(`{not-json`), 0o644); err != nil {
+		t.Fatalf("WriteFile: %v", err)
+	}
+	store := NewObservabilityBufferStore(path)
+	records, err := store.Replayable(0, 0)
+	if err != nil {
+		t.Fatalf("Replayable should not fail: %v", err)
+	}
+	if len(records) != 0 {
+		t.Fatalf("expected empty after discard, got %+v", records)
+	}
+	// Corrupt payload must not remain; empty rewrite is fine.
+	if body, err := os.ReadFile(path); err == nil && strings.Contains(string(body), "not-json") {
+		t.Fatalf("corrupt content still on disk: %s", body)
+	}
+}
+
+func TestObservabilityBufferStoreKeepsModernJSON(t *testing.T) {
+	path := filepath.Join(t.TempDir(), "observability-buffer.json")
+	modern := `[{
+		"window_started_at_unix": 1710403200,
+		"host_metrics": {"captured_at_unix": 1710403205, "cpu_usage_percent": 3},
+		"edge_health": {"captured_at_unix": 1710403205, "status": "healthy", "connections": 2},
+		"access_logs": []
+	}]`
+	if err := os.WriteFile(path, []byte(modern), 0o644); err != nil {
+		t.Fatalf("WriteFile: %v", err)
+	}
+	store := NewObservabilityBufferStore(path)
+	records, err := store.Replayable(0, 0)
+	if err != nil {
+		t.Fatalf("Replayable: %v", err)
+	}
+	if len(records) != 1 || records[0].HostMetrics == nil || records[0].HostMetrics.CPUUsagePercent != 3 {
+		t.Fatalf("modern buffer should be kept: %+v", records)
+	}
+	if _, err := os.Stat(path); err != nil {
+		t.Fatalf("modern buffer file should remain: %v", err)
+	}
+}