// 模型/协议纯回归:用内存对象与 recorder 验证身份、原子变更或流传输契约,不访问真实数据库。 package platform import ( "bufio" "context" "encoding/json" "fmt" "net/http/httptest" "testing" ) // streamRecords 把 recorder 内每行 JSON 转为断言对象;用例中的小记录不需要增大 Scanner 缺省预算。 func streamRecords(t *testing.T, writer *httptest.ResponseRecorder) []response { t.Helper() var records []response scanner := bufio.NewScanner(writer.Body) for scanner.Scan() { var record response if err := json.Unmarshal(scanner.Bytes(), &record); err != nil { t.Fatal(err) } records = append(records, record) } if err := scanner.Err(); err != nil { t.Fatal(err) } return records } // TestCanonicalModelStreamFramesAndSnapshot 用超过两个批次的元素验证 header/批次/complete 分帧,token、序号、墓碑和全元素 owner 清单必须一致且无重复漏项。 func TestCanonicalModelStreamFramesAndSnapshot(t *testing.T) { model := modelTestDocument() for i := 0; i < 129; i++ { id := fmt.Sprintf("extra-%03d", i) model.Elements[id] = modelTestNode(id, modelRootID) } model.Tombstones["deleted"] = 2 model.TombstoneOwners["deleted"] = modelRootID writer := httptest.NewRecorder() writeCanvasModelStream(context.Background(), writer, model) if writer.Code != 200 || writer.Header().Get("Content-Type") != modelStreamType || !writer.Flushed { t.Fatal("stream was not negotiated/flushed", writer.Code, writer.Header()) } records := streamRecords(t, writer) if len(records) != 5 || records[0]["kind"] != "header" || records[4]["kind"] != "complete" { t.Fatal("missing stream framing", len(records)) } token := modelString(records[0]["snapshotToken"]) if !uuidSlugPattern.MatchString(token) || records[0]["projectId"] != modelRootID || !modelEqual(records[0]["versions"], model.Versions) || !modelEqual(records[0]["tombstones"], model.Tombstones) { t.Fatal("stream header lost snapshot identity") } owners := records[0]["elementOwners"].(map[string]any) if len(owners) != len(model.Elements) { t.Fatal("identity manifest must cover unloaded elements too") } for id, element := range model.Elements { if owners[id] != element["ownerCanvasId"] { t.Fatal("identity manifest mixed owners", id) } } seen := map[string]bool{} for i, record := range records { if record["sequence"] != float64(i) || record["snapshotToken"] != token || record["streamVersion"] != float64(1) { t.Fatal("mixed or unordered snapshot") } if record["kind"] == "elements" { items := record["elements"].([]any) if len(items) == 0 || len(items) > 64 { t.Fatal("unbounded record batch") } for _, item := range items { element := item.(map[string]any) id := modelString(element["id"]) if seen[id] || !modelEqual(element, model.Elements[id]) { t.Fatal("duplicated or corrupted stream element") } seen[id] = true } } } if len(seen) != len(model.Elements) || records[4]["elementCount"] != float64(len(seen)) { t.Fatal("terminal coverage mismatch") } } // cancelStreamWriter 在首个 flush 后取消请求,用于验证已开始流的中途停止语义。 type cancelStreamWriter struct { *httptest.ResponseRecorder cancel context.CancelFunc } // Flush 先模拟实际输出,再取消,使下一次编码检测到上下文结束。 func (writer cancelStreamWriter) Flush() { writer.ResponseRecorder.Flush() writer.cancel() } // TestCanonicalModelStreamCancellationNeverClaimsCompletion 第一次 Flush 即取消上下文,验证仅发 header,不能追加 complete 或假成功尾记录。 func TestCanonicalModelStreamCancellationNeverClaimsCompletion(t *testing.T) { ctx, cancel := context.WithCancel(context.Background()) defer cancel() writer := httptest.NewRecorder() writeCanvasModelStream(ctx, cancelStreamWriter{writer, cancel}, modelTestDocument()) records := streamRecords(t, writer) if len(records) != 1 || records[0]["kind"] != "header" { t.Fatal("cancelled stream wrote a tail", len(records)) } } // TestCanonicalModelStreamDeclaresDirectScopeCountsIncludingEmptyCanvases 验证每个 scope 只计直接成员且显式保留零元素画布,未知 owner 必须在首次 Flush 前拒绝。 func TestCanonicalModelStreamDeclaresDirectScopeCountsIncludingEmptyCanvases(t *testing.T) { model := modelTestDocument() empty, nested := modelTestID(41), modelTestID(42) model.Canvases[empty] = modelCanvas{ID: empty, Parent: &modelParent{CanvasID: model.Root, EntryElementID: "frame-empty"}} model.Canvases[nested] = modelCanvas{ID: nested, Parent: &modelParent{CanvasID: model.Root, EntryElementID: "frame-nested"}} model.Versions[empty], model.Versions[nested] = 1, 1 model.Elements["frame-empty"] = modelTestNode("frame-empty", model.Root) model.Elements["frame-nested"] = modelTestNode("frame-nested", model.Root) model.Elements["nested-node"] = modelTestNode("nested-node", nested) writer := httptest.NewRecorder() writeCanvasModelStream(context.Background(), writer, model) records := streamRecords(t, writer) if !modelEqual(records[0]["canvasElementCounts"], map[string]int{model.Root: 3, empty: 0, nested: 1}) { t.Fatal("scope counts must count direct members, preserve empty scopes and match the captured snapshot") } bad := modelTestDocument() bad.Elements["a"]["ownerCanvasId"] = "foreign" failed := httptest.NewRecorder() writeCanvasModelStream(context.Background(), failed, bad) if failed.Code != 500 || failed.Flushed { t.Fatal("invalid owner must fail before publishing a scope certificate") } } // TestCanonicalModelStreamRejectsAmbiguousIdentityManifest 构造空或重复内部元素 ID,验证不发布有歧义的身份清单,返回 500 且未开始流。 func TestCanonicalModelStreamRejectsAmbiguousIdentityManifest(t *testing.T) { for _, id := range []string{"", "a"} { model := modelTestDocument() model.Elements["other"] = modelTestNode(id, modelRootID) writer := httptest.NewRecorder() writeCanvasModelStream(context.Background(), writer, model) if writer.Code != 500 || writer.Flushed { t.Fatal("ambiguous identity was published before rejection") } } }