Skip to content

RAGFlow is an agent-native database: a Retrieval-Augmented Generation (RAG) engine that grew into context infrastructure.

23.2 KB
Raw Blame
//
//  Copyright 2026 The InfiniFlow Authors. All Rights Reserved.
//
//  Licensed under the Apache License, Version 2.0 (the "License");
//  you may not use this file except in compliance with the License.
//  You may obtain a copy of the License at
//
//      http://www.apache.org/licenses/LICENSE-2.0
//
//  Unless required by applicable law or agreed to in writing, software
//  distributed under the License is distributed on an "AS IS" BASIS,
//  WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
//  See the License for the specific language governing permissions and
//  limitations under the License.
//

package dao

import (
	"encoding/json"
	"testing"

	"github.com/glebarez/sqlite"
	"gorm.io/gorm"

	"ragflow/internal/common"
	"ragflow/internal/entity"
)

func setupDocumentTestDB(t *testing.T) *gorm.DB {
	t.Helper()
	db, err := gorm.Open(sqlite.Open(":memory:"), &gorm.Config{
		TranslateError: true,
	})
	if err != nil {
		t.Fatalf("failed to open sqlite: %v", err)
	}
	if err := db.AutoMigrate(
		&entity.Document{},
		&entity.Knowledgebase{},
		&entity.Tenant{},
		&entity.UserTenant{},
	); err != nil {
		t.Fatalf("failed to migrate: %v", err)
	}
	return db
}

func pushDocDB(t *testing.T, testDB *gorm.DB) {
	t.Helper()
	orig := DB
	DB = testDB
	t.Cleanup(func() { DB = orig })
}

func TestDocumentGetByIDs_Success(t *testing.T) {
	db := setupDocumentTestDB(t)

	db.Create(&entity.Document{ID: "doc1", KbID: "kb1", Name: sp("Doc 1"), CreatedBy: "user1", ParserConfig: entity.JSONMap{}})
	db.Create(&entity.Document{ID: "doc2", KbID: "kb1", Name: sp("Doc 2"), CreatedBy: "user1", ParserConfig: entity.JSONMap{}})
	db.Create(&entity.Document{ID: "doc3", KbID: "kb2", Name: sp("Doc 3"), CreatedBy: "user2", ParserConfig: entity.JSONMap{}})

	ctx := t.Context()
	dao := NewDocumentDAO()
	docs, err := dao.GetByIDs(ctx, db, []string{"doc1", "doc3"})
	if err != nil {
		t.Fatalf("GetByIDs failed: %v", err)
	}
	if len(docs) != 2 {
		t.Fatalf("expected 2 docs, got %d", len(docs))
	}

	ids := make(map[string]bool)
	for _, d := range docs {
		ids[d.ID] = true
	}
	if !ids["doc1"] || !ids["doc3"] {
		t.Errorf("expected doc1 and doc3, got %v", ids)
	}
}

func TestDocumentGetByIDs_EmptyIDs(t *testing.T) {
	db := setupDocumentTestDB(t)
	ctx := t.Context()
	dao := NewDocumentDAO()
	docs, err := dao.GetByIDs(ctx, db, []string{})
	if err != nil {
		t.Fatalf("GetByIDs failed: %v", err)
	}
	if docs != nil {
		t.Errorf("expected nil for empty IDs, got %v", docs)
	}
}

func TestDocumentGetByIDs_NilIDs(t *testing.T) {
	db := setupDocumentTestDB(t)
	ctx := t.Context()
	dao := NewDocumentDAO()
	docs, err := dao.GetByIDs(ctx, db, nil)
	if err != nil {
		t.Fatalf("GetByIDs failed: %v", err)
	}
	if docs != nil {
		t.Errorf("expected nil for nil IDs, got %v", docs)
	}
}

func TestDocumentGetByIDs_NoMatch(t *testing.T) {
	db := setupDocumentTestDB(t)

	db.Create(&entity.Document{ID: "doc1", KbID: "kb1", Name: sp("Doc 1"), CreatedBy: "user1", ParserConfig: entity.JSONMap{}})
	ctx := t.Context()
	dao := NewDocumentDAO()
	docs, err := dao.GetByIDs(ctx, db, []string{"nonexistent"})
	if err != nil {
		t.Fatalf("GetByIDs failed: %v", err)
	}
	if len(docs) != 0 {
		t.Errorf("expected 0 docs, got %d", len(docs))
	}
}

func TestDocumentGetByKBIDOrdersByCreateTime(t *testing.T) {
	db := setupDocumentTestDB(t)

	createTime10 := int64(10)
	createTime20 := int64(20)
	createTime30 := int64(30)
	db.Create(&entity.Document{ID: "doc-later", KbID: "kb1", Name: sp("Doc Later"), CreatedBy: "user1", ParserConfig: entity.JSONMap{}, BaseModel: entity.BaseModel{CreateTime: &createTime30}})
	db.Create(&entity.Document{ID: "doc-other", KbID: "kb2", Name: sp("Doc Other"), CreatedBy: "user1", ParserConfig: entity.JSONMap{}, BaseModel: entity.BaseModel{CreateTime: &createTime10}})
	db.Create(&entity.Document{ID: "doc-earlier", KbID: "kb1", Name: sp("Doc Earlier"), CreatedBy: "user1", ParserConfig: entity.JSONMap{}, BaseModel: entity.BaseModel{CreateTime: &createTime20}})
	ctx := t.Context()
	dao := NewDocumentDAO()
	docs, total, err := dao.GetByKBID(ctx, db, "kb1")
	if err != nil {
		t.Fatalf("fail to get document by dataset id: %v", err)
	}
	if total != 2 {
		t.Fatalf("expected total=2, got %d", total)
	}
	if len(docs) != 2 {
		t.Fatalf("expected 2 docs, got %d", len(docs))
	}
	if docs[0].ID != "doc-earlier" || docs[1].ID != "doc-later" {
		t.Fatalf("unexpected order: %s, %s", docs[0].ID, docs[1].ID)
	}
}

func TestDocumentListIncludesScheduledIngestionStatus(t *testing.T) {
	db := setupDocumentTestDB(t)
	if err := db.AutoMigrate(
		&entity.User{},
		&entity.UserCanvas{},
		&entity.File{},
		&entity.File2Document{},
		&entity.IngestionTask{},
	); err != nil {
		t.Fatalf("migrate document-list dependencies: %v", err)
	}
	if err := db.Create(&entity.Document{
		ID:           "doc-scheduled",
		KbID:         "kb-1",
		ParserID:     "naive",
		ParserConfig: entity.JSONMap{},
		SourceType:   "local",
		Type:         "document",
		CreatedBy:    "user-1",
		Name:         sp("scheduled.pdf"),
		Suffix:       "pdf",
	}).Error; err != nil {
		t.Fatalf("create document: %v", err)
	}
	if err := db.Create(&entity.File{
		ID:        "file-scheduled",
		ParentID:  "parent-1",
		TenantID:  "tenant-1",
		CreatedBy: "user-1",
		Name:      "scheduled.pdf",
		Type:      "document",
	}).Error; err != nil {
		t.Fatalf("create file: %v", err)
	}
	if err := db.Create(&entity.File2Document{
		ID:         "link-scheduled",
		FileID:     sp("file-scheduled"),
		DocumentID: sp("doc-scheduled"),
	}).Error; err != nil {
		t.Fatalf("link file to document: %v", err)
	}
	if err := db.Create(&entity.IngestionTask{
		ID:         "task-scheduled",
		UserID:     "user-1",
		DocumentID: "doc-scheduled",
		DatasetID:  "kb-1",
		Status:     "SCHEDULED",
	}).Error; err != nil {
		t.Fatalf("create scheduled ingestion task: %v", err)
	}

	dao := NewDocumentDAO()
	documents, total, err := dao.ListByKBIDWithOptions(t.Context(), db, DocumentListOptions{
		KbID:    "kb-1",
		OrderBy: "create_time",
		Desc:    true,
		Offset:  0,
		Limit:   10,
	})
	if err != nil {
		t.Fatalf("list documents: %v", err)
	}
	if total != 1 || len(documents) != 1 {
		t.Fatalf("listed %d documents (total %d), want 1", len(documents), total)
	}

	raw, err := json.Marshal(documents[0])
	if err != nil {
		t.Fatalf("marshal document list item: %v", err)
	}
	var listed map[string]interface{}
	if err := json.Unmarshal(raw, &listed); err != nil {
		t.Fatalf("unmarshal document list item: %v", err)
	}
	if got := listed["ingestion_status"]; got != "SCHEDULED" {
		t.Fatalf("ingestion_status = %v, want %q", got, "SCHEDULED")
	}

	opts := DocumentListOptions{KbID: "kb-1", RunStatuses: []string{common.SCHEDULED}, OrderBy: "ingestion_status", Limit: 10}
	documents, total, err = dao.ListByKBIDWithOptions(t.Context(), db, opts)
	if err != nil || total != 1 || len(documents) != 1 {
		t.Fatalf("filter scheduled documents: got %d (total %d), err %v", len(documents), total, err)
	}
	ids, err := dao.ListIDsByKBIDWithOptions(t.Context(), db, opts)
	if err != nil || len(ids) != 1 || ids[0] != "doc-scheduled" {
		t.Fatalf("filter scheduled document IDs: got %v, err %v", ids, err)
	}
	filters, total, err := dao.GetFilterByKBID(t.Context(), db, DocumentListOptions{KbID: "kb-1"})
	if err != nil || total != 1 {
		t.Fatalf("get scheduled filter count: total %d, err %v", total, err)
	}
	if got := filters["ingestion_status"].(map[string]int64)[common.SCHEDULED]; got != 1 {
		t.Fatalf("scheduled filter count = %d, want 1", got)
	}
	if db.Migrator().HasColumn(&entity.Document{}, "run") {
		t.Fatal("document list query added the legacy run column")
	}
}

func TestDocumentListFallsBackToReadOnlyLegacyRun(t *testing.T) {
	db := setupDocumentTestDB(t)
	if err := db.AutoMigrate(
		&entity.User{},
		&entity.UserCanvas{},
		&entity.File{},
		&entity.File2Document{},
		&entity.IngestionTask{},
	); err != nil {
		t.Fatalf("migrate document-list dependencies: %v", err)
	}
	if err := db.Exec("ALTER TABLE document ADD COLUMN run TEXT").Error; err != nil {
		t.Fatalf("add legacy run fixture column: %v", err)
	}

	tests := []struct {
		id, run, task, want string
		hasTask             bool
	}{
		{id: "unstart", run: "0", want: "UNSTART"},
		{id: "empty", want: "UNSTART"},
		{id: "running", run: "1", want: common.RUNNING},
		{id: "stopped", run: "2", want: common.STOPPED},
		{id: "completed", run: "3", want: common.COMPLETED},
		{id: "failed", run: "4", want: common.FAILED},
		{id: "scheduled", run: "5", want: common.SCHEDULED},
		{id: "unknown", run: "9", want: "UNSTART"},
		{id: "task-wins", run: "3", task: common.RUNNING, hasTask: true, want: common.RUNNING},
		{id: "empty-task-wins", run: "3", hasTask: true, want: "UNSTART"},
	}

	create := func(value interface{}) {
		t.Helper()
		if err := db.Create(value).Error; err != nil {
			t.Fatalf("create %T: %v", value, err)
		}
	}
	fileID := "file-legacy"
	create(&entity.File{ID: fileID, ParentID: "parent-1", TenantID: "tenant-1", CreatedBy: "user-1", Name: "legacy.pdf", Type: "document"})
	for _, test := range tests {
		documentID := "doc-" + test.id
		create(&entity.Document{ID: documentID, KbID: "kb-legacy", ParserConfig: entity.JSONMap{}})
		if err := db.Table("document").Where("id = ?", documentID).UpdateColumn("run", test.run).Error; err != nil {
			t.Fatalf("set legacy run for %s: %v", documentID, err)
		}
		create(&entity.File2Document{ID: "link-" + test.id, FileID: sp(fileID), DocumentID: sp(documentID)})
		if test.hasTask {
			create(&entity.IngestionTask{ID: "task-" + test.id, DocumentID: documentID, Status: test.task})
		}
	}

	dao := NewDocumentDAO()
	documents, total, err := dao.ListByKBIDWithOptions(t.Context(), db, DocumentListOptions{
		KbID: "kb-legacy", Limit: len(tests),
	})
	if err != nil {
		t.Fatalf("list legacy documents: %v", err)
	}
	if total != int64(len(tests)) || len(documents) != len(tests) {
		t.Fatalf("listed %d documents (total %d), want %d", len(documents), total, len(tests))
	}

	statusByID := make(map[string]string, len(documents))
	for _, document := range documents {
		if document.IngestionStatus != nil {
			statusByID[document.ID] = *document.IngestionStatus
		}
	}
	for _, test := range tests {
		documentID := "doc-" + test.id
		if got := statusByID[documentID]; got != test.want {
			t.Errorf("status for %s = %q, want %q", documentID, got, test.want)
		}
	}

	completedOpts := DocumentListOptions{KbID: "kb-legacy", RunStatuses: []string{common.COMPLETED}, Limit: len(tests)}
	documents, total, err = dao.ListByKBIDWithOptions(t.Context(), db, completedOpts)
	if err != nil || total != 1 || len(documents) != 1 || documents[0].ID != "doc-completed" {
		t.Fatalf("filter completed documents: got %v (total %d), err %v", documents, total, err)
	}
	ids, err := dao.ListIDsByKBIDWithOptions(t.Context(), db, completedOpts)
	if err != nil || len(ids) != 1 || ids[0] != "doc-completed" {
		t.Fatalf("filter completed document IDs: got %v, err %v", ids, err)
	}
	filters, filterTotal, err := dao.GetFilterByKBID(t.Context(), db, completedOpts)
	if err != nil || filterTotal != 1 || filters["ingestion_status"].(map[string]int64)[common.COMPLETED] != 1 {
		t.Fatalf("filter completed count: got %v (total %d), err %v", filters, filterTotal, err)
	}

	mixedOpts := DocumentListOptions{KbID: "kb-legacy", RunStatuses: []string{"UNSTART", common.COMPLETED}, Limit: len(tests)}
	documents, total, err = dao.ListByKBIDWithOptions(t.Context(), db, mixedOpts)
	if err != nil || total != 5 || len(documents) != 5 {
		t.Fatalf("filter mixed statuses: got %d (total %d), err %v", len(documents), total, err)
	}
	wantMixed := map[string]bool{
		"doc-unstart": true, "doc-empty": true, "doc-completed": true, "doc-unknown": true, "doc-empty-task-wins": true,
	}
	for _, document := range documents {
		delete(wantMixed, document.ID)
	}
	if len(wantMixed) != 0 {
		t.Fatalf("mixed status filter missed documents: %v", wantMixed)
	}
	ids, err = dao.ListIDsByKBIDWithOptions(t.Context(), db, mixedOpts)
	if err != nil || len(ids) != 5 {
		t.Fatalf("filter mixed document IDs: got %v, err %v", ids, err)
	}

	filters, filterTotal, err = dao.GetFilterByKBID(t.Context(), db, DocumentListOptions{KbID: "kb-legacy"})
	if err != nil || filterTotal != int64(len(tests)) {
		t.Fatalf("get legacy filter counts: total %d, err %v", filterTotal, err)
	}
	counts := filters["ingestion_status"].(map[string]int64)
	wantCounts := map[string]int64{"UNSTART": 4, common.RUNNING: 2, common.STOPPED: 1, common.COMPLETED: 1, common.FAILED: 1, common.SCHEDULED: 1}
	for status, want := range wantCounts {
		if got := counts[status]; got != want {
			t.Errorf("filter count for %s = %d, want %d", status, got, want)
		}
	}

	wantAscending := []string{common.COMPLETED, common.FAILED, common.RUNNING, common.RUNNING, common.SCHEDULED, common.STOPPED, "UNSTART", "UNSTART", "UNSTART", "UNSTART"}
	for _, desc := range []bool{false, true} {
		documents, total, err = dao.ListByKBIDWithOptions(t.Context(), db, DocumentListOptions{
			KbID: "kb-legacy", OrderBy: "ingestion_status", Desc: desc, Limit: len(tests),
		})
		if err != nil || total != int64(len(tests)) || len(documents) != len(tests) {
			t.Fatalf("sort legacy statuses (desc=%t): got %d (total %d), err %v", desc, len(documents), total, err)
		}
		for i, document := range documents {
			want := wantAscending[i]
			if desc {
				want = wantAscending[len(wantAscending)-1-i]
			}
			if document.IngestionStatus == nil || *document.IngestionStatus != want {
				t.Errorf("sorted status %d (desc=%t) = %v, want %s", i, desc, document.IngestionStatus, want)
			}
		}
	}

	for _, test := range tests {
		var stored string
		if err := db.Table("document").Select("run").Where("id = ?", "doc-"+test.id).Scan(&stored).Error; err != nil {
			t.Fatalf("read legacy run for %s: %v", test.id, err)
		}
		if stored != test.run {
			t.Fatalf("legacy run for %s changed from %q to %q", test.id, test.run, stored)
		}
	}
}

func TestDocumentListDeduplicatesHistoricalIngestionTasks(t *testing.T) {
	db := setupDocumentTestDB(t)
	if err := db.AutoMigrate(
		&entity.User{},
		&entity.UserCanvas{},
		&entity.File{},
		&entity.File2Document{},
		&entity.IngestionTask{},
	); err != nil {
		t.Fatalf("migrate document-list dependencies: %v", err)
	}
	if err := db.Exec("DROP INDEX idx_ingestion_task_document_id").Error; err != nil {
		t.Fatalf("drop ingestion task unique index: %v", err)
	}

	if err := db.Create(&entity.Document{
		ID:           "doc-duplicate-tasks",
		KbID:         "kb-1",
		ParserID:     "naive",
		ParserConfig: entity.JSONMap{},
		SourceType:   "local",
		Type:         "document",
		CreatedBy:    "user-1",
		Name:         sp("duplicate-tasks.pdf"),
		Suffix:       "pdf",
	}).Error; err != nil {
		t.Fatalf("create document: %v", err)
	}
	if err := db.Create(&entity.File{
		ID:        "file-duplicate-tasks",
		ParentID:  "parent-1",
		TenantID:  "tenant-1",
		CreatedBy: "user-1",
		Name:      "duplicate-tasks.pdf",
		Type:      "document",
	}).Error; err != nil {
		t.Fatalf("create file: %v", err)
	}
	if err := db.Create(&entity.File2Document{
		ID:         "link-duplicate-tasks",
		FileID:     sp("file-duplicate-tasks"),
		DocumentID: sp("doc-duplicate-tasks"),
	}).Error; err != nil {
		t.Fatalf("link file to document: %v", err)
	}

	oldTaskTime := int64(100)
	newTaskTime := int64(200)
	for _, task := range []*entity.IngestionTask{
		{
			ID:         "task-old",
			UserID:     "user-1",
			DocumentID: "doc-duplicate-tasks",
			DatasetID:  "kb-1",
			Status:     "FAILED",
			BaseModel:  entity.BaseModel{CreateTime: &oldTaskTime},
		},
		{
			ID:         "task-new",
			UserID:     "user-1",
			DocumentID: "doc-duplicate-tasks",
			DatasetID:  "kb-1",
			Status:     "SCHEDULED",
			BaseModel:  entity.BaseModel{CreateTime: &newTaskTime},
		},
	} {
		if err := db.Create(task).Error; err != nil {
			t.Fatalf("create ingestion task %s: %v", task.ID, err)
		}
	}

	documents, total, err := NewDocumentDAO().ListByKBIDWithOptions(t.Context(), db, DocumentListOptions{
		KbID:    "kb-1",
		OrderBy: "create_time",
		Desc:    true,
		Offset:  0,
		Limit:   10,
	})
	if err != nil {
		t.Fatalf("list documents: %v", err)
	}
	if total != 1 || len(documents) != 1 {
		t.Fatalf("listed %d documents (total %d), want 1", len(documents), total)
	}
	if documents[0].IngestionStatus == nil || *documents[0].IngestionStatus != "SCHEDULED" {
		t.Fatalf("ingestion status = %v, want %q", documents[0].IngestionStatus, "SCHEDULED")
	}
}

func TestDocumentGetByDocumentIDAndDatasetIDUsesKBID(t *testing.T) {
	db := setupDocumentTestDB(t)

	db.Create(&entity.Document{ID: "doc1", KbID: "kb1", Name: sp("Doc 1"), CreatedBy: "user1", ParserConfig: entity.JSONMap{}})
	db.Create(&entity.Document{ID: "doc1-other", KbID: "kb2", Name: sp("Doc 2"), CreatedBy: "user1", ParserConfig: entity.JSONMap{}})
	ctx := t.Context()
	dao := NewDocumentDAO()
	doc, err := dao.GetByDocumentIDAndDatasetID(ctx, db, "doc1", "kb1")
	if err != nil {
		t.Fatalf("GetByDocumentIDAndDatasetID failed: %v", err)
	}
	if doc.ID != "doc1" || doc.KbID != "kb1" {
		t.Fatalf("unexpected document: id=%s kb_id=%s", doc.ID, doc.KbID)
	}

	if _, err = dao.GetByDocumentIDAndDatasetID(ctx, db, "doc1", "kb2"); err == nil {
		t.Fatal("expected no match when document does not belong to dataset")
	}
}

func TestDocumentGetChunkingConfigScansParserConfig(t *testing.T) {
	db := setupDocumentTestDB(t)

	if err := db.Create(&entity.Tenant{ID: "tenant1", ParserIDs: "naive"}).Error; err != nil {
		t.Fatalf("create tenant: %v", err)
	}
	joined := entity.TenantMembershipStatusJoined
	if err := db.Create(&entity.UserTenant{
		ID: "ut-tenant1", UserID: "tenant1", TenantID: "tenant1", Role: "owner", Status: &joined,
		LLMID: "llm1", EmbdID: "embd1", ASRID: "asr1", Img2TxtID: "img2txt1", RerankID: "rerank1",
	}).Error; err != nil {
		t.Fatalf("create owner membership: %v", err)
	}
	if err := db.Create(&entity.Knowledgebase{
		ID:           "kb1",
		TenantID:     "tenant1",
		Name:         "Dataset 1",
		Language:     sp("English"),
		EmbdID:       "kb-embd1",
		Permission:   "me",
		CreatedBy:    "user1",
		ParserID:     "naive",
		ParserConfig: entity.JSONMap{},
	}).Error; err != nil {
		t.Fatalf("create knowledgebase: %v", err)
	}
	if err := db.Create(&entity.Document{
		ID:           "doc1",
		KbID:         "kb1",
		ParserID:     "naive",
		ParserConfig: entity.JSONMap{"chunk_token_num": float64(128), "delimiter": "\\n"},
		SourceType:   "local",
		Type:         "doc",
		CreatedBy:    "user1",
		Size:         42,
		Suffix:       ".txt",
	}).Error; err != nil {
		t.Fatalf("create document: %v", err)
	}
	ctx := t.Context()
	dao := NewDocumentDAO()
	config, err := dao.GetChunkingConfig(ctx, db, "doc1")
	if err != nil {
		t.Fatalf("GetChunkingConfig failed: %v", err)
	}
	parserConfig, ok := config["parser_config"].(entity.JSONMap)
	if !ok {
		t.Fatalf("parser_config type = %T, want entity.JSONMap", config["parser_config"])
	}
	if parserConfig["chunk_token_num"] != float64(128) || parserConfig["delimiter"] != "\\n" {
		t.Fatalf("unexpected parser_config: %#v", parserConfig)
	}
	if config["tenant_id"] != "tenant1" || config["embd_id"] != "kb-embd1" {
		t.Fatalf("unexpected joined config: %#v", config)
	}
}

func TestDocumentDAOGetParsingStatusByKBID(t *testing.T) {
	db := setupDocumentTestDB(t)
	if err := db.AutoMigrate(&entity.IngestionTask{}); err != nil {
		t.Fatalf("migrate IngestionTask: %v", err)
	}

	// doc-unstart: no task
	if err := db.Create(&entity.Document{ID: "doc-1", KbID: "kb-status", ParserConfig: entity.JSONMap{}}).Error; err != nil {
		t.Fatalf("create doc-1: %v", err)
	}
	// doc-running: task RUNNING
	if err := db.Create(&entity.Document{ID: "doc-2", KbID: "kb-status", ParserConfig: entity.JSONMap{}}).Error; err != nil {
		t.Fatalf("create doc-2: %v", err)
	}
	if err := db.Create(&entity.IngestionTask{ID: "task-2", DocumentID: "doc-2", Status: common.RUNNING}).Error; err != nil {
		t.Fatalf("create task-2: %v", err)
	}
	// doc-completed: task COMPLETED
	if err := db.Create(&entity.Document{ID: "doc-3", KbID: "kb-status", ParserConfig: entity.JSONMap{}}).Error; err != nil {
		t.Fatalf("create doc-3: %v", err)
	}
	if err := db.Create(&entity.IngestionTask{ID: "task-3", DocumentID: "doc-3", Status: common.COMPLETED}).Error; err != nil {
		t.Fatalf("create task-3: %v", err)
	}
	// doc-failed: task FAILED
	if err := db.Create(&entity.Document{ID: "doc-4", KbID: "kb-status", ParserConfig: entity.JSONMap{}}).Error; err != nil {
		t.Fatalf("create doc-4: %v", err)
	}
	if err := db.Create(&entity.IngestionTask{ID: "task-4", DocumentID: "doc-4", Status: common.FAILED}).Error; err != nil {
		t.Fatalf("create task-4: %v", err)
	}
	// doc-stopped: task STOPPED
	if err := db.Create(&entity.Document{ID: "doc-5", KbID: "kb-status", ParserConfig: entity.JSONMap{}}).Error; err != nil {
		t.Fatalf("create doc-5: %v", err)
	}
	if err := db.Create(&entity.IngestionTask{ID: "task-5", DocumentID: "doc-5", Status: common.STOPPED}).Error; err != nil {
		t.Fatalf("create task-5: %v", err)
	}

	dao := NewDocumentDAO()
	counts, err := dao.GetParsingStatusByKBID(t.Context(), db, "kb-status")
	if err != nil {
		t.Fatalf("GetParsingStatusByKBID failed: %v", err)
	}
	if counts["unstart_count"] != 1 {
		t.Errorf("unstart_count = %d, want 1", counts["unstart_count"])
	}
	if counts["running_count"] != 1 {
		t.Errorf("running_count = %d, want 1", counts["running_count"])
	}
	if counts["done_count"] != 1 {
		t.Errorf("done_count = %d, want 1", counts["done_count"])
	}
	if counts["fail_count"] != 1 {
		t.Errorf("fail_count = %d, want 1", counts["fail_count"])
	}
	if counts["cancel_count"] != 1 {
		t.Errorf("cancel_count = %d, want 1", counts["cancel_count"])
	}
}

func sp(s string) *string { return &s }

func TestDocumentListParserConfigsByKBIDs(t *testing.T) {
	db := setupDocumentTestDB(t)
	dao := NewDocumentDAO()
	ctx := t.Context()

	// Empty kbIDs returns nil, nil
	res, err := dao.ListParserConfigsByKBIDs(ctx, db, nil)
	if err != nil || res != nil {
		t.Fatalf("expected nil, nil for empty kbIDs, got res=%v, err=%v", res, err)
	}

	// Doc 1: no tag_file_id (should be filtered out by SQL query)
	db.Create(&entity.Document{
		ID:           "doc-no-tag",
		KbID:         "kb-1",
		ParserConfig: entity.JSONMap{"pages": []any{1, 5}},
	})
	// Doc 2: empty parser_config
	db.Create(&entity.Document{
		ID:           "doc-empty-config",
		KbID:         "kb-1",
		ParserConfig: entity.JSONMap{},
	})
	// Doc 3: has tag_file_id
	db.Create(&entity.Document{
		ID:   "doc-with-tag-1",
		KbID: "kb-1",
		ParserConfig: entity.JSONMap{
			"tags": map[string]any{"tag_file_id": "file-1"},
		},
	})
	// Doc 4: identical parser_config in kb-1 (should collapse via DISTINCT)
	db.Create(&entity.Document{
		ID:   "doc-with-tag-1-dup",
		KbID: "kb-1",
		ParserConfig: entity.JSONMap{
			"tags": map[string]any{"tag_file_id": "file-1"},
		},
	})
	// Doc 5: distinct tag in kb-1
	db.Create(&entity.Document{
		ID:   "doc-with-tag-2",
		KbID: "kb-1",
		ParserConfig: entity.JSONMap{
			"tags": map[string]any{"tag_file_id": "file-2"},
		},
	})
	// Doc 6: tag in kb-2
	db.Create(&entity.Document{
		ID:   "doc-with-tag-kb2",
		KbID: "kb-2",
		ParserConfig: entity.JSONMap{
			"Extractor:Auto": map[string]any{
				"tags": map[string]any{"tag_file_id": "file-3"},
			},
		},
	})

	res, err = dao.ListParserConfigsByKBIDs(ctx, db, []string{"kb-1", "kb-2"})
	if err != nil {
		t.Fatalf("ListParserConfigsByKBIDs failed: %v", err)
	}

	if len(res["kb-1"]) != 2 {
		t.Fatalf("expected 2 distinct configs for kb-1, got %d: %v", len(res["kb-1"]), res["kb-1"])
	}
	if len(res["kb-2"]) != 1 {
		t.Fatalf("expected 1 config for kb-2, got %d: %v", len(res["kb-2"]), res["kb-2"])
	}
}