Trzy usterki uniemożliwiające uruchomienie stosu lokalnie:
1. Warstwa danych wykładała się na starcie przy zapisie Parquet dla realnych
plików (np. Encyclopaedia of Medical Astrology) — kolumny o mieszanych
typach (int+str+NaN). frame_cache.put() zapisuje teraz ramkę jako string
(warstwa i tak wyszukuje po tekście). Dodatkowo warmup() jest odporny:
pojedynczy uszkodzony plik nie blokuje startu usługi.
2. Brakowało kroku instalacji zależności — dev-logic/dev-presentation padały na
'No module named httpx'. Nowy cel `make install` instaluje zależności
WSZYSTKICH warstw do aktywnego venv. README zaktualizowane (instalowało
wcześniej tylko warstwę danych).
3. `make up` zakładał `docker compose`, którego użytkownik nie ma. Makefile
wykrywa `docker compose` lub `docker-compose`, a przy braku obu podaje
czytelną instrukcję trybu lokalnego. Dodano `make test` i `make clean-cache`.
Zweryfikowane end-to-end na realnym środowisku (.env, Python 3.14) i danych:
warmup przechodzi (3 pliki), cały stos wstaje, formularz → logika → silnik
Skyfield zwraca poprawne pozycje.
Co-Authored-By: Claude Opus 4.8 <noreply@anthropic.com>
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>
gitea