Fix SSE route dependency and align architecture docs

This commit is contained in:
ash66
2026-05-18 16:32:42 +08:00
parent 86b9ac806a
commit 3f69cad404
149 changed files with 4786 additions and 5957 deletions

View File

@@ -0,0 +1,29 @@
"""Define domain models for retrieval."""
from __future__ import annotations
from dataclasses import dataclass, field
from typing import Any
# Keep module behavior explicit so the backend flow stays easy to audit.
@dataclass
class RetrievalQuery:
"""Represent the Retrieval Query type."""
query: str
top_k: int
filters: str | None = None
@dataclass
class RetrievedChunk:
"""Represent the Retrieved Chunk type."""
chunk_id: str
doc_id: str
doc_name: str
content: str
score: float
section_title: str = ""
page_number: int = 0
metadata: dict[str, Any] = field(default_factory=dict)