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>
28 lines
839 B
Python
28 lines
839 B
Python
"""Abstrakcyjny interfejs dostawcy danych (wzorzec Repository/Strategy).
|
|
|
|
To jest klucz do "łatwej migracji do SQL". Warstwa bazodanowa udostępnia na
|
|
zewnątrz tylko ten kontrakt. Dziś realizuje go ExcelDataProvider, jutro
|
|
SqlDataProvider — bez żadnej zmiany w warstwie logicznej i prezentacji.
|
|
"""
|
|
from __future__ import annotations
|
|
|
|
from abc import ABC, abstractmethod
|
|
|
|
from app.models import HealthInfo, SearchQuery, SearchResult
|
|
|
|
|
|
class DataProvider(ABC):
|
|
name: str = "base"
|
|
|
|
@abstractmethod
|
|
def search(self, query: SearchQuery) -> SearchResult:
|
|
"""Wyszuka dane i zwróci je w górę. JEDYNE zadanie tej warstwy."""
|
|
|
|
@abstractmethod
|
|
def health(self) -> HealthInfo:
|
|
...
|
|
|
|
def warmup(self) -> None:
|
|
"""Opcjonalne wstępne zbudowanie cache/indeksu przy starcie."""
|
|
return None
|