mirror of
https://github.com/migatu/astrololo.git
synced 2026-07-14 13:34:38 +00:00
gitea
16d35c16dc
Trzy niezależne usługi FastAPI komunikujące się przez HTTP/JSON, każda zna tylko adres warstwy bezpośrednio pod nią: - presentation (:8000) — strona WWW + formularz - logic (:8001) — reguły biznesowe, pośrednik - data (:8002) — wyszukiwanie danych za interfejsem DataProvider Warstwa danych: czytanie setek plików .xlsx z wykrywaniem nagłówka i mapowaniem układu kolumn na schemat kanoniczny, z 4-poziomowym cache (schemat L1, Parquet L2, wyniki zapytań L3, odwrócony indeks L4) i unieważnianiem po odcisku pliku. Gotowa ścieżka migracji do SQL (ingest/to_sql.py + SqlDataProvider, przełączane przez DATA_PROVIDER). Zawiera docker-compose, Makefile, generator danych przykładowych. Co-Authored-By: Claude Opus 4.8 <noreply@anthropic.com>
42 lines
1.4 KiB
Python
42 lines
1.4 KiB
Python
"""Kontrakt danych warstwy bazodanowej.
|
|
|
|
Te modele są JEDYNYM publicznym interfejsem tej warstwy. Warstwa logiczna zna
|
|
wyłącznie te kształty (poprzez HTTP/JSON) — nie wie nic o Excelu, cache ani SQL.
|
|
Dzięki temu można podmienić implementację (Excel -> SQL) bez zmiany pozostałych
|
|
warstw.
|
|
"""
|
|
from __future__ import annotations
|
|
|
|
from typing import Any
|
|
|
|
from pydantic import BaseModel, Field
|
|
|
|
|
|
class SearchQuery(BaseModel):
|
|
"""Znormalizowane zapytanie wyszukiwania przychodzące z warstwy logicznej."""
|
|
|
|
key: str = Field(..., description="Pole/kolumna kanoniczna, po której szukamy, np. 'name'.")
|
|
value: str = Field(..., description="Szukana wartość.")
|
|
exact: bool = Field(False, description="Dopasowanie dokładne vs. zawieranie (contains).")
|
|
limit: int = Field(50, ge=1, le=1000)
|
|
fields: list[str] | None = Field(
|
|
None, description="Lista pól kanonicznych do zwrócenia; None = wszystkie."
|
|
)
|
|
|
|
|
|
class SearchResult(BaseModel):
|
|
"""Wynik wyszukiwania zwracany w górę do warstwy logicznej."""
|
|
|
|
rows: list[dict[str, Any]]
|
|
total: int
|
|
elapsed_ms: float
|
|
cache: str = Field("miss", description="hit/miss/partial — skąd pochodzą dane.")
|
|
provider: str = Field(..., description="Nazwa aktywnej implementacji, np. 'excel' lub 'sql'.")
|
|
|
|
|
|
class HealthInfo(BaseModel):
|
|
status: str = "ok"
|
|
provider: str
|
|
indexed_files: int = 0
|
|
details: dict[str, Any] = Field(default_factory=dict)
|