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>
Strona główna "/" = formularz podstawowych danych momentu (data, godzina,
strefa, opcjonalnie lokalizacja) → tabela policzonych pozycji w formie
human-readable (znak, pozycja w znaku, absolutna, kierunek, prędkość).
Woła logic /chart/positions; przelicza czas lokalny + offset na UTC.
Przycisk "Tu i teraz" uzupełnia bieżącą datę/godzinę i strefę przeglądarki.
Retrogradacja wyróżniona w tabeli.
Wyszukiwarkę sygnifikatorów przeniesiono pod "/significants" -> /significators,
dodano nawigację (base.html). Czytelny komunikat, gdy logika nie ma jeszcze
endpointu silnika.
Zweryfikowano end-to-end: formularz → przeliczenie UTC → render tabeli
(przez stub kontraktu /chart/positions).
Co-Authored-By: Claude Opus 4.8 <noreply@anthropic.com>
Pierwszy increment implementacji warstwy logicznej (ścieżka A).
LOG-24: interfejs EphemerisEngine z dwoma backendami — SkyfieldEngine
(własny, permisywny: Skyfield MIT + dane JPL public domain) oraz
RemoteEngine (klient izolowanej usługi swisseph). Fabryka + leniwa
inicjalizacja; endpointy /chart/positions i /chart/compare.
LOG-01: pozycje obiektów (długość/szerokość ekliptyczna, prędkość,
kierunek, formaty: w znaku / absolutny / dziesiętny).
LOG-25/28: harness porównawczy (compare.py) z progami tolerancji oraz
wspólny kontrakt parzystości; pełen zestaw testów.
LOG-27: services/engine-swisseph — osobna, opcjonalna usługa AGPL
(pyswisseph, tryb Moshiera), licencjonowana osobno, w compose pod
profilem "comparison"; nie wchodzi do zamkniętego produktu.
Walidacja: SkyfieldEngine zgadza się ze Swiss Ephemeris co do ~1" dla
wszystkich 10 obiektów na horoskopie referencyjnym (30.04.1984, Warszawa);
12 testów przechodzi (silnik B pomijany gdy nieskonfigurowany).
Co-Authored-By: Claude Opus 4.8 <noreply@anthropic.com>
Dodaje per-requirement, kompletnie nietechniczne tłumaczenie do trzech
arkuszy warstw (dane 24, logika 28, prezentacja 13) jako ostatnią kolumnę.
Dla osób nietechnicznych — m.in. współpracownika dostarczającego bazy —
żeby każdy wiersz był zrozumiały bez żargonu. Autofiltr rozszerzony.
Co-Authored-By: Claude Opus 4.8 <noreply@anthropic.com>
Decyzja: warstwa logiczna ma dwie wymienne implementacje silnika obliczeń —
własną/permisywną (ścieżka A) i AGPL (Swiss Ephemeris) — dla wbudowanego
frameworku porównań i walidacji. Prezentacja i dane pozostają wspólne.
- docs/architektura-dwoch-silnikow.md: schemat, izolacja licencyjna silnika
AGPL jako osobnej usługi (engine-swisseph), mechanizm dual-run, mapowanie
na wymagania, profile wdrożeniowe.
- astrololo_wymagania.xlsx (Warstwa logiczna): rewizja LOG-24 (EngineProvider
z dwoma backendami) i LOG-25 (framework porównawczy); nowe LOG-26 (dual-run
+ raport różnic), LOG-27 (izolacja licencyjna silnika AGPL), LOG-28
(kontrakt parzystości silników). Licznik w Przeglądzie: 28.
Co-Authored-By: Claude Opus 4.8 <noreply@anthropic.com>
- docs/przeglad-bibliotek-i-licencji.md: przegląd istniejących bibliotek/
programów z komentarzem licencyjnym i oceną ryzyka praw autorskich;
rekomendacja ścieżki A (Skyfield/Moshier permisywne) + nota o prawach do
treści baz.
- docs/warstwa-logiczna-analiza.md: rozwinięcie 24 wymagań LOG, przypisanie
permisywnych gotowców, ocena złożoności implementacji od zera, rola B/C
jako wyroczni walidacyjnej; kolejność budowy.
- astrololo_wymagania.xlsx: w arkuszu "Warstwa logiczna" 4 nowe kolumny
(gotowe rozwiązanie / licencja / złożoność od zera / rola B/C) oraz nowy
wiersz LOG-25 (harness walidacyjny). Licznik w Przeglądzie zaktualizowany.
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
Michal Tuszowski