From 3655b39acf6dee6a8f47275fde3f068fd7105cc4 Mon Sep 17 00:00:00 2001 From: migatu Date: Sat, 27 Jun 2026 12:31:37 +0200 Subject: [PATCH] =?UTF-8?q?Rozszerz=20analiz=C4=99=20warstwy=20logicznej:?= =?UTF-8?q?=20gotowce,=20licencje,=20z=C5=82o=C5=BCono=C5=9B=C4=87=20+=20L?= =?UTF-8?q?OG-25?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit - 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 --- docs/astrololo_wymagania.xlsx | Bin 21118 -> 22769 bytes docs/przeglad-bibliotek-i-licencji.md | 110 ++++++++++++++++ docs/warstwa-logiczna-analiza.md | 174 ++++++++++++++++++++++++++ 3 files changed, 284 insertions(+) create mode 100644 docs/przeglad-bibliotek-i-licencji.md create mode 100644 docs/warstwa-logiczna-analiza.md diff --git a/docs/astrololo_wymagania.xlsx b/docs/astrololo_wymagania.xlsx index 1254b54427f298765b685a19e45846b44c7b00c4..9e6073fedc91c3538d38847fda81fc913de23d0a 100644 GIT binary patch delta 9129 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 MeS ⚠️ **Najważniejszy wniosek (TL;DR).** Branżowy standard obliczeń — **Swiss Ephemeris** — oraz **wszystkie** popularne biblioteki astrologiczne, które na nim bazują (pyswisseph, kerykeion, immanuel, flatlib, swisseph-wasm), są objęte licencją **AGPL‑3.0 albo płatną licencją komercyjną**. AGPL wymusza udostępnienie **całego kodu źródłowego aplikacji** — i to także wtedy, gdy aplikacja jest tylko udostępniana przez sieć (SaaS / API / hosting online, o którym mowa w notatkach). Dla produktu zamkniętego z unikalnymi bazami kolaboratora oznacza to albo (a) zakup licencji komercyjnej Swiss Ephemeris, albo (b) zbudowanie warstwy obliczeń na permisywnym fundamencie (Skyfield MIT + dane NASA JPL = public domain) i samodzielną implementację części astrologicznej. Szczegóły i rekomendacja: sekcja 6. + +Legenda ryzyka: 🟢 permisywne (MIT/BSD/PD) · 🟡 wymaga uwagi/atrybucji · 🔴 copyleft/AGPL — ryzykowne dla produktu zamkniętego. + +--- + +## 1. Silniki efemeryd / obliczenia astronomiczne (fundament warstwy logicznej) + +| Rozwiązanie | Co robi | Licencja | Komentarz / ryzyko | +|---|---|---|---| +| **Swiss Ephemeris** (C, Astrodienst — `aloistr/swisseph`) | De‑facto standard: pozycje obiektów, domy, aspekty, gwiazdy stałe, lots — pełna astrologia, najwyższa dokładność | **Dual: AGPL‑3.0 LUB komercyjna** (CHF 750 za pierwszą licencję + CHF 400 za każdą kolejną; ważna 99 lat) | 🔴 AGPL: użycie w usłudze sieciowej = obowiązek otwarcia całego kodu. Licencja komercyjna zdejmuje copyleft z **silnika**, ale wrappery językowe (poniżej) mają **własne** licencje — trzeba je sprawdzić osobno. Decyzję trzeba podjąć **przed** dystrybucją/uruchomieniem usługi. | +| **pyswisseph** (`astrorigin/pyswisseph`) | Wrapper Pythona do Swiss Ephemeris | **AGPL‑3.0** | 🔴 To prawdopodobnie „kalkulator z GitHuba", o którym wiesz. Sam wrapper jest AGPL niezależnie od licencji silnika. | +| **swisseph‑wasm** (`prolaxu/swisseph-wasm`) | Swiss Ephemeris skompilowany do WebAssembly (JS) | dziedziczy po Swiss Ephemeris (**AGPL/komercyjna**) | 🔴 Ta sama pułapka AGPL, tyle że w przeglądarce. | +| **Skyfield** (`skyfielders/python-skyfield`) | Czysto astronomiczne pozycje planet (research‑grade), oparte o dane NASA JPL | **MIT** | 🟢 Permisywne, idealne dla produktu zamkniętego. **ALE**: tylko astronomia — **nie liczy domów, aspektów, lots ani technik**. Warstwę astrologiczną trzeba dopisać samemu. | +| **Dane NASA JPL DE440 / DE441** | Współrzędne efemeryd (Chebyshev), źródło dla Skyfielda | Dane rządu USA — **faktycznie public domain**, swobodnie dystrybuowane | 🟢 Permisywny fundament danych. DE440: lata 1550–2650; DE441: −13200 do +17191. | +| **Moshier ephemeris** (Steve Moshier, `moshier.net`) | Semi‑analityczna teoria, ~0,1″ dokładności, bez plików danych | **Public domain** | 🟢 Wolny od jakichkolwiek zobowiązań. Mniej dokładny niż JPL, ale dla astrologii w zupełności wystarcza. Istnieje też reimplementacja JS (`0xStarcat/Moshier-Ephemeris-JS`, MIT). | +| **Astropy** | Astronomia ogólna (układy współrzędnych, czas) | **BSD‑3** | 🟢 Permisywne; pomocnicze (czas, transformacje), nie astrologia. | + +--- + +## 2. Biblioteki astrologiczne wyższego poziomu (domy, aspekty, lots, techniki) + +| Rozwiązanie | Co robi | Licencja | Komentarz / ryzyko | +|---|---|---|---| +| **kerykeion** (`g-battaglia/kerykeion`) | Nowoczesna, utrzymywana: pozycje, domy, aspekty, wykresy SVG, synastria/tranzyty/composite | **AGPL‑3.0** | 🔴 Wymaga otwarcia projektu. Autor oferuje hostowane **Astrologer API** (REST) — korzystanie z niego **nie** narzuca copyleft na Twój kod (ale to usługa zewnętrzna, płatna, wysyłasz dane na zewnątrz). | +| **immanuel** (`theriftlab/immanuel-python`) | Dane czytelne dla człowieka + JSON, wzorowane na astro.com / Astro Gold; na pyswisseph | **GPL‑3.0+** | 🔴 GPL (sieciowo łagodniejsze niż AGPL, ale wciąż copyleft); ciągnie AGPL‑owy pyswisseph. | +| **flatlib** (`flatangle/flatlib`) | Astrologia tradycyjna (domy, aspekty, godności) | **kod własny: MIT** 🟢, ale **zależy od Swiss Ephemeris** 🔴 | 🟡→🔴 Sam kod flatlib jest permisywny (MIT), lecz obliczenia robi Swiss Ephemeris — więc realnie obowiązuje Cię AGPL/komercyjna SE. Słabo utrzymywane. Dobra **referencja** projektowa. | +| **libephemeris** (`g-battaglia/libephemeris`) | API zgodne z pyswisseph, ale liczy Skyfieldem (NASA); 25 systemów domów, weryfikowane względem pyswisseph | **AGPL‑3.0** | 🔴 Ciekawe technicznie (permisywny fundament: Skyfield+JPL), ale autor wybrał AGPL → i tak copyleft. Można potraktować jako **wzorzec**, jak dołożyć domy do Skyfielda. | + +--- + +## 3. JavaScript / front‑end (jeśli warstwa prezentacji będzie webowa) + +| Rozwiązanie | Co robi | Licencja | Komentarz / ryzyko | +|---|---|---|---| +| **CircularNatalHoroscopeJS** (`0xStarcat/...`) | Liczy natalny wykres (Asc/MC, domy, tropikalny/syderyczny) — **na Moshierze, bez Swiss Ephemeris** | **MIT** | 🟢 Rzadki przypadek: obliczenia astrologiczne bez „skażenia" AGPL. Dobry wzorzec/komponent dla JS. | +| **AstroChart** (`Kibo/AstroChart`) | Renderowanie kosmogramu (SVG) — tylko rysowanie, bez efemeryd | open‑source (zweryfikować plik LICENSE) | 🟡 Brak obliczeń = brak ryzyka efemeryd. Sprawdzić dokładnie licencję przed użyciem. | +| **swisseph‑wasm** | (jak w sekcji 1) | AGPL/komercyjna | 🔴 | + +--- + +## 4. Geolokalizacja i strefy czasowe (dla pola „miejscowość → timezone → Asc/MC") + +Notatki opisują obliczenie strefy czasowej z większej miejscowości, potem przeliczenie dla dokładnej lokalizacji. Przydatne: + +| Rozwiązanie | Co robi | Licencja | Komentarz / ryzyko | +|---|---|---|---| +| **timezonefinder** (`jannikmi/timezonefinder`) | Strefa czasowa z lat/long, offline | **kod: MIT** 🟢 / **dane: ODbL** 🟡 | 🟡 Dane (timezone‑boundary‑builder, ODbL) — przy dystrybucji bazy wymagana atrybucja i klauzula share‑alike **dla samej bazy** (nie dla Twojego kodu). | +| **GeoNames** (baza miejscowości) | Miejscowości + współrzędne + strefy (do dropdowna lokalizacji) | **CC‑BY 4.0** | 🟡 Wolne, ale **wymaga atrybucji** „GeoNames". Idealne do tabeli miejscowości z notatek. | +| **IANA tz database (tzdata)** | Reguły stref i czasu letniego (DST) | **Public domain** | 🟢 W Pythonie przez `zoneinfo` (stdlib) — bez zależności. | + +--- + +## 5. Pełne programy referencyjne (do nauki algorytmów, nie do kopiowania kodu) + +| Program | Licencja | Komentarz / ryzyko | +|---|---|---| +| **Astrolog** (Walter Pullen, `astrolog.org`) | **GPL‑2.0+** (od wersji 6.00) | 🔴 do kopiowania kodu (GPL), ale **bezcenny jako referencja** algorytmów (domy, dyrekcje, techniki). Opcjonalnie używa Swiss Ephemeris. Można czytać i uczyć się metod, nie wklejać kodu do produktu zamkniętego. | +| **Maitreya / Morinus** (open‑source) | GPL (zweryfikować) | 🟡 Jw. — referencja, nie źródło kodu do zamkniętego produktu. | + +--- + +## 6. Strategia licencyjna — trzy ścieżki (z rekomendacją) + +Wybór zależy od jednej decyzji z arkusza wymagań (**Q‑01**: produkt zamknięty/hostowany czy nie) i **Q‑07** (SQL/architektura). Przy założeniu **produktu zamkniętego z prywatnymi bazami** (co wynika z notatek — hosting online, własność kolaboratora): + +**Ścieżka A — permisywna, „zbuduj sam" 🟢 (rekomendowana long‑term)** +Skyfield (MIT) + dane JPL DE440 (public domain) lub Moshier (PD) do pozycji; domy/aspekty/lots/dyrekcje implementujemy sami (wzorując się na Astrologu i libephemeris — czytając, nie kopiując). +- ➕ Pełna swoboda licencyjna, produkt może być zamknięty i hostowany. +- ➖ Najwięcej pracy w warstwie logicznej (ale dokładnie tę warstwę i tak projektujemy modułowo). + +**Ścieżka B — Swiss Ephemeris na licencji komercyjnej 🟡 (najszybsza „pełna dokładność")** +Kupujemy licencję komercyjną SE (CHF 750) i wołamy silnik C bezpośrednio (z cienkim własnym wrapperem, by ominąć AGPL‑owy pyswisseph). +- ➕ Od razu komplet funkcji i najwyższa dokładność; produkt zamknięty OK. +- ➖ Koszt + formalności licencyjne; trzeba uważać, żeby nie wciągnąć AGPL‑owych wrapperów. + +**Ścieżka C — AGPL „na całość" 🔴 (tylko jeśli produkt może być otwarty)** +kerykeion/immanuel/flatlib+pyswisseph — najszybszy development. +- ➕ Gotowiec, mało kodu. +- ➖ Wymusza **otwarcie całej aplikacji** (w tym kodu obsługującego prywatne bazy). Przy hostingu online (AGPL!) praktycznie wykluczone dla tego projektu. + +**Ścieżka D — hostowane API (np. Astrologer API)** jako uzupełnienie: korzystanie z REST nie narzuca copyleft, ale to zależność zewnętrzna, koszt, prywatność danych urodzeniowych i może nie pokrywać egzotycznych technik (firdaria, zodiacal releasing, warianty primary directions). + +> **Rekomendacja:** zarezerwować w architekturze warstwy logicznej **interfejs silnika efemeryd** (jak `DataProvider` w warstwie danych), tak by dało się podmienić backend: `MoshierEngine` / `SkyfieldEngine` (ścieżka A) ↔ `SwissEphCommercialEngine` (ścieżka B). Wtedy decyzję A vs B można podjąć później bez przepisywania logiki. + +--- + +## 7. Osobna kwestia: prawa autorskie do TREŚCI baz (to NIE są licencje software!) + +To dotyczy zawartości baz interpretacji, nie kodu — i jest tu realne ryzyko do rozważenia: + +- **Bazy kolaboratora.** Jeśli to **oryginalna twórczość** współpracownika, to on jest dysponentem praw — potrzebne jasne ustalenie (umowa/licencja) na wykorzystanie ich w produkcie. To załatwia sprawę po stronie tych danych. +- **Źródła z opublikowanych książek.** Przykładowy plik „The Encyclopaedia of Medical Astrology" to **wydana książka** (H. L. Cornell, 1933). Cyfrowy przedruk obszernych opisów interpretacyjnych z chronionego dzieła = **ryzyko naruszenia praw autorskich**, niezależnie od licencji oprogramowania. Status zależy od jurysdykcji i daty (część dawnych dzieł może być już w domenie publicznej — wymaga sprawdzenia per tytuł). +- **Fakt vs. twórczość.** Krótkie formuły sygnifikatorów (np. „Ma Ari = …") to raczej **fakty/metoda** — trudniej objąć je prawem autorskim. Natomiast rozbudowana **proza interpretacyjna** (kolumna Effect) jest chroniona jako utwór. +- **Zalecenie:** dla każdej bazy odnotować **proweniencję** (autor/źródło/status praw) — najlepiej jako kolumnę/metadane w warstwie danych (pasuje do `book-#per-txt`, `author`, `lang` z notatek). Oddzielić materiał: własny kolaboratora / public domain / cytowany za zgodą / wymagający usunięcia. + +--- + +## Źródła +- [Swiss Ephemeris — licencja (astro.com)](https://www.astro.com/swisseph/swephinfo_e.htm) · [LICENSE](https://www.astro.com/ftp/swisseph/LICENSE) · [repo `aloistr/swisseph`](https://github.com/aloistr/swisseph) +- [pyswisseph (`astrorigin/pyswisseph`)](https://github.com/astrorigin/pyswisseph) +- [kerykeion (PyPI)](https://pypi.org/project/kerykeion/) · [immanuel (PyPI)](https://pypi.org/project/immanuel/) · [flatlib LICENSE (MIT)](https://raw.githubusercontent.com/flatangle/flatlib/master/LICENSE) +- [Skyfield (PyPI, MIT)](https://pypi.org/project/skyfield/) · [libephemeris (`g-battaglia/libephemeris`)](https://github.com/g-battaglia/libephemeris) +- [NASA JPL DE440/DE441](https://ssd.jpl.nasa.gov/doc/de440_de441.html) · [Moshier ephemeris](http://www.moshier.net/) · [Moshier‑Ephemeris‑JS](https://github.com/0xStarcat/Moshier-Ephemeris-JS) +- [CircularNatalHoroscopeJS](https://github.com/0xStarcat/CircularNatalHoroscopeJS) · [AstroChart (`Kibo/AstroChart`)](https://github.com/Kibo/AstroChart) · [swisseph‑wasm](https://github.com/prolaxu/swisseph-wasm) +- [timezonefinder (PyPI, MIT)](https://pypi.org/project/timezonefinder/) · [Astrolog (Wikipedia)](https://en.wikipedia.org/wiki/Astrolog) diff --git a/docs/warstwa-logiczna-analiza.md b/docs/warstwa-logiczna-analiza.md new file mode 100644 index 0000000..39c5974 --- /dev/null +++ b/docs/warstwa-logiczna-analiza.md @@ -0,0 +1,174 @@ +# Warstwa logiczna — analiza, rozwinięcie wymagań i przypisanie rozwiązań + +Dokument roboczy. Rozwinięcie 24 wymagań warstwy logicznej (LOG‑01…LOG‑24 z `astrololo_wymagania.xlsx`) wraz z: przypisaniem gotowych **permisywnych** rozwiązań, oceną złożoności implementacji **od zera** (bo idziemy **ścieżką A**) oraz wskazaniem, gdzie narzędzia AGPL/komercyjne (B/C) służą jako **referencja i walidacja**. Stan: czerwiec 2026. + +--- + +## 0. Założenia ścieżki A + +**Fundament permisywny (co dostajemy „za darmo"):** +- **Skyfield** (MIT) + dane **NASA JPL DE440/DE441** (public domain) → geocentryczne pozycje planet i Księżyca, RA/Dec, długość/szerokość ekliptyczna, prędkości, wschody/zachody, wyszukiwanie zdarzeń (stacje, powroty, syzygia). +- **pyerfa / ERFA** (BSD; pochodna IAU SOFA) → precesja, nutacja, czas gwiazdowy (LST), nachylenie ekliptyki (obliquity) — prymitywy potrzebne do osi (Asc/MC) i ayanams. +- **Katalog Hipparcos** (ESA, swobodnie dostępny; ładuje go Skyfield) → gwiazdy stałe. +- **Lark / pyparsing** (MIT) → infrastruktura parsera składni sygnifikatorów. +- **numpy / pandas** (BSD) → cała matematyka i tabele. + +Wniosek: **~70–80% astronomicznego fundamentu jest pokryte permisywnie**. Sami budujemy **warstwę astrologiczną** (domy, dyrekcje, techniki, parser, dopasowanie) — a jej algorytmy/wzory są **wiedzą publiczną** (opisane w literaturze astronomicznej i astrologicznej), więc **nie podlegają prawu autorskiemu** — chronione są tylko konkretne implementacje kodu. Czytamy więc Astrolog/Morinus/dokumentację Swiss Ephemeris, by **zrozumieć metodę**, a piszemy **własny** kod permisywny. + +**Rola ścieżek B/C (Swiss Ephemeris, Morinus, astro.com):** +1. **Wyrocznia walidacyjna** — nasz silnik porównujemy liczbowo (do łuku sekundy) z SE/astro.com. Użycie pyswisseph **w samych testach/CI** (nie dystrybuowane, nie wystawiane użytkownikom przez sieć) **nie uruchamia obowiązków AGPL** — to legalne i bardzo przydatne. +2. **Dane referencyjne** — tabele kontrolne (np. dla profekcji, primary directions) do testów regresyjnych. +3. **Porównanie funkcjonalne** — które warianty technik liczy „konkurencja". + +Skala złożoności (implementacja od zera): **Trywialna · Niska · Średnia · Wysoka · Bardzo wysoka (XL)**. + +--- + +## 1. Macierz zbiorcza + +| ID | Wymaganie | Gotowe permisywne (ścieżka A) | Złożoność od zera | Rola B/C | +|----|-----------|-------------------------------|-------------------|----------| +| LOG‑01 | Pozycje obiektów | **Skyfield** (komplet) | Niska | walidacja pozycji | +| LOG‑02 | Taksonomia obiektów | Skyfield (planety, Księżyc), Hipparcos (gwiazdy) | **Wysoka** (true Node/Lilith, gwiazdy) | walidacja węzłów/Lilith | +| LOG‑03 | Kierunek i stacje | Skyfield (find_discrete) | Średnia | walidacja dat stacji | +| LOG‑04 | Systemy zodiaku / ayanamsy | Skyfield (tropikalny, RA), pyerfa (precesja) | Średnia | walidacja ayanams | +| LOG‑05 | Systemy domów (wiele) | pyerfa (LST, obliquity); reszta własna | **Wysoka** | walidacja cusps (kluczowa) | +| LOG‑06 | Aspekty + orby | własne (czysta matematyka) | Niska | walidacja list aspektów | +| LOG‑07 | Aspekty pozazodiakalne | Skyfield (deklinacja) | Niska | walidacja | +| LOG‑08 | Lots | własne (arytmetyka + DSL formuł) | Niska–Średnia | porównanie wartości | +| LOG‑09 | **Primary Directions** | brak permisywnego | **Bardzo wysoka (XL)** | **krytyczna** (Morinus) | +| LOG‑10 | Profekcje | własne (arytmetyka + tabele władców) | Niska–Średnia | tabela kontrolna | +| LOG‑11 | Zod. Releasing / Firdaria / Decennials | brak permisywnego | Średnia (table‑driven) | walidacja sekwencji | +| LOG‑12 | Returns (Solar/Lunar) | Skyfield (root‑finding) | Niska–Średnia | walidacja czasu powrotu | +| LOG‑13 | Ascensional Times | pyerfa/własne (oblique ascension) | Średnia | tabela kontrolna | +| LOG‑14 | Zbiorcza tabela dat | własne (orkiestracja) | Średnia | — | +| LOG‑15 | **Parser sygnifikatorów** | Lark/pyparsing (infrastruktura) | **Wysoka** (unikalne IP) | brak referencji | +| LOG‑16 | Precompute „atomów" | własne | Średnia | — | +| LOG‑17 | Interpretacja „asp"/„asp±" | własne (config + LOG‑06) | Niska–Średnia | — | +| LOG‑18 | Warstwy 1A/1B | własne (orkiestracja ↔ warstwa danych) | Średnia | — | +| LOG‑19 | Wypis interpretacji 2B | własne (↔ DataProvider) | Średnia | — | +| LOG‑20 | Kolumny sygnif. + „no of hits" | własne | Niska–Średnia | — | +| LOG‑21 | Scoring siły efektu | własne (rule/data‑driven) | Średnia | — | +| LOG‑22 | Konwersja tekst ↔ symbol | własne (tablice z notes3) | Niska | — | +| LOG‑23 | Pozostałe wyliczenia | Skyfield (zdarzenia) | Niska | walidacja | +| LOG‑24 | Abstrakcja silnika efemeryd | architektura | Niska | — | + +**Tylko 3 pozycje są naprawdę trudne:** LOG‑09 (primary directions, XL), LOG‑05 (pełny zestaw domów, Wysoka), LOG‑15 (parser — Wysoka, ale to nasze unikalne IP, więc gotowca i tak nie ma). Reszta jest Niska/Średnia, w dużej części pokryta przez Skyfield. + +--- + +## 2. Rozwinięcia pogrupowane + +### Grupa A — Fundament astronomiczny (LOG‑01, 02, 03, 24) + +**LOG‑01 · Pozycje obiektów.** +*Rozwinięcie:* długość i szerokość ekliptyczna (of‑date), prędkość (różniczkowanie pozycji), kierunek; formaty: DMS w znaku (Tau 28°12'57''), absolutne 0–360°, dziesiętne. *Ścieżka A:* Skyfield daje to wprost (`ecliptic_latlon`, prędkość z dwóch chwil). Formatowanie/podział na znaki = trywialne. *Złożoność: Niska.* *B/C:* porównać długości z astro.com do ~0,1″. + +**LOG‑02 · Taksonomia obiektów.** +*Rozwinięcie:* światła+planety (Skyfield 🟢), planety nowożytne (🟢), gwiazdy stałe (precesja+ruch własny — Hipparcos w Skyfield, 🟢 średnia), obiekty wirtualne: +- **Węzły księżycowe** — *mean* (wzór analityczny, Niska) i *true/osculating* (z wektora stanu Księżyca → elementy oskulacyjne → węzeł wstępujący; **Średnia–Wysoka**). +- **Lilith (Black Moon = apogeum Księżyca)** — *mean* (Niska–Średnia) i *true* (oskulacyjne apogeum; **Wysoka** — tu implementacje notorycznie się różnią, walidacja względem SE obowiązkowa). +- **Osie (Asc/MC → Dsc/IC)** — patrz LOG‑05. +*Złożoność całości: Wysoka* (przez gwiazdy + true Node/Lilith; reszta Niska). *B/C:* SE jako wzorzec dla true Node/Lilith (różne definicje!). + +**LOG‑03 · Kierunek i stacje.** +*Rozwinięcie:* znak prędkości → D/Rx; stacja = przejście prędkości przez 0 (SD vs SR z przyspieszenia); „dni od stacji ścisłej" + flaga <7 dni; „stacja umowna" jako konfigurowalny próg % ruchu typowego. *Ścieżka A:* Skyfield `find_discrete`/`find_maxima` znajduje momenty stacji; średnie prędkości precompute. *Złożoność: Średnia.* *B/C:* daty stacji z SE. + +**LOG‑24 · Abstrakcja silnika.** +*Rozwinięcie:* interfejs `EphemerisEngine` z implementacjami `SkyfieldEngine` (główna, MIT+JPL), `MoshierEngine` (fallback w pełni public‑domain, bez plików danych) oraz — opcjonalnie po decyzji — `SwissEphCommercialEngine`. *Złożoność: Niska* (architektura, analogicznie do `DataProvider`). To wymaganie **spina ścieżki A/B** bez przepisywania logiki. + +### Grupa B — Układy odniesienia (LOG‑04, 05) + +**LOG‑04 · Systemy zodiaku / ayanamsy.** +*Rozwinięcie:* tropikalny (domyślny, 🟢), syderyczny = tropikalny − ayanamsa(t) (Lahiri, Fagan‑Bradley… ~40 w SE; my zaczynamy od kilku + tabela rozszerzalna), draconic = tropikalny − długość NN (🟢 po LOG‑02), RA (Skyfield daje wprost). *Ścieżka A:* precesja z pyerfa; ayanamsy to znane stałe odniesienia + tempo precesji. *Złożoność: Średnia* (głównie tabela ayanams). *B/C:* wartości ayanams z SE. + +**LOG‑05 · Systemy domów (wiele, równolegle).** ⚠️ najcięższa matematyka astronomiczna. +*Rozwinięcie:* +- Whole Sign / Equal (Asc/MC) / Porphyry → **Niska** (trywialne podziały). +- Placidus, Koch, Regiomontanus, Campanus, Topocentric, Alcabitus, Meridian, Morinus, Vehlow → znane wzory trygonometrii sferycznej, każdy **Średnia**, w komplecie **Wysoka** (przypadki brzegowe na wysokich szerokościach — Placidus/Koch nieokreślone za kołem podbiegunowym). +*Ścieżka A:* Asc/MC z LST (pyerfa) + obliquity + szerokość geo (standardowe wzory). `libephemeris` (AGPL) dowodzi, że pełny zestaw 25 systemów **da się** policzyć na Skyfieldzie — czytamy go jako dowód wykonalności, ale piszemy własny kod. *Złożoność: Wysoka.* *B/C:* **walidacja cusps krytyczna** — tu kryją się błędy, szczególnie na dużych szerokościach. + +### Grupa C — Aspekty (LOG‑06, 07) + +**LOG‑06 · Aspekty + orby.** +*Rozwinięcie:* separacja kątowa vs kąt aspektu ± orb; aplikacja/separacja z różnicy prędkości; schematy orbów (domyślne, bonus dla luminarzy, fixed, ±%, per‑planeta/szkoła); aspekt „przez znak" vs „przez stopień"; major/minor/harmonic. *Ścieżka A:* czysta matematyka na policzonych długościach — **żadna biblioteka nie jest potrzebna**. *Złożoność: Niska–Średnia* (szerokość konfiguracji, nie trudność algorytmu). *B/C:* listy aspektów z astro.com do testów. + +**LOG‑07 · Aspekty pozazodiakalne.** +*Rozwinięcie:* parallel/contraparallel (po deklinacji — Skyfield 🟢), antiscia/contra‑antiscia (lustro względem osi przesileń — arytmetyka). *Złożoność: Niska.* + +### Grupa D — Lots (LOG‑08) + +**LOG‑08 · Lots.** +*Rozwinięcie:* silnik formuł `Lot = C + A − B` z odwracaniem dzień/noc (sekta); By Degree (domyślnie) i By Sign; 7 Hermetic Lots; cały znak działa jak Lot. *Ścieżka A:* mały DSL/parser formuł + ewaluacja na policzonych pozycjach. *Złożoność: Niska–Średnia* (logika sekty prosta; trudność tkwi w **tożsamości/wariantach** Lots — to kuracja danych, nie obliczenia; patrz Q‑03). *B/C:* porównanie wartości stopni. + +### Grupa E — Techniki predykcyjne (LOG‑09…14) + +**LOG‑09 · Primary Directions.** ⚠️ **najtrudniejsze (XL).** +*Rozwinięcie:* łuk dyrekcji (semi‑arc/Placidean, Regiomontanus, …) między sygnifikatorem a promisorem w ruchu dobowym; klucz łuk→czas (Ptolemeusz/Naibod/Cardan/Solar arc); direct/converse; mundo/zodiacal; z szerokością/bez. ~160 wariantów — robimy 5–8 (Q‑02), framework rozszerzalny. *Ścieżka A:* brak gotowca permisywnego — **w całości własna trygonometria sferyczna** + obsługa wariantów. *Złożoność: Bardzo wysoka.* *B/C:* **Morinus (GPL) słynie z dokładnych primary directions** — kluczowa wyrocznia; uwaga: nawet komercyjne programy różnią się w wariantach (do udokumentowania, który wariant odwzorowujemy). + +**LOG‑10 · Profekcje.** +*Rozwinięcie:* annual (Asc +1 znak/rok, mod 12), monthly/daily, continuous (klucz, domyślnie 30°/rok), Lord of Year, Lord of Orb (kolejność chaldejska, mod 84/12). *Ścieżka A:* arytmetyka dat + tabele władców domicilnych — **bez bibliotek**. *Złożoność: Niska* (annual) *– Średnia* (continuous + Lord of Orb). *B/C:* tabela kontrolna (jak ta w notes3). + +**LOG‑11 · Zodiacal Releasing / Firdaria / Decennials.** +*Rozwinięcie:* deterministyczne sekwencje okresów z tabel hellenistycznych/perskich (ZR: długości okresów Valensa + „loosing of the bond"; Firdaria: stałe sekwencje diurnal/nocturnal z podokresami; Decennials: kolejność planetarna). *Ścieżka A:* logika sekwencjonowania na tabelach — algorytmy publiczne, niepodlegające prawu autorskiemu. *Złożoność: Średnia.* *B/C:* walidacja sekwencji z SE/Astrolog. + +**LOG‑12 · Returns (Solar/Lunar).** +*Rozwinięcie:* root‑finding momentu powrotu Słońca/Księżyca do długości natalnej; 2 warianty (osobny horoskop vs tranzyt do natalu); monthly revolutions (Słońce + n×30°). *Ścieżka A:* Skyfield znajduje moment (🟢), reszta = ponowne użycie LOG‑01…06. *Złożoność: Niska–Średnia.* *B/C:* czas powrotu z astro.com. + +**LOG‑13 · Ascensional Times.** +*Rozwinięcie:* oblique ascension znaków wg szerokości (różnica ascensjonalna z RA) → lata życia; sumy i ułamki dla dodatkowych dat. Częściowo data‑driven (tabela DAN‑07). *Ścieżka A:* wzory powiązane z LOG‑05 (trygonometria sferyczna) + pyerfa. *Złożoność: Średnia.* + +**LOG‑14 · Zbiorcza tabela dat z technik.** +*Rozwinięcie:* uruchom wszystkie techniki w zakresie czasu → jedna datowana tabela (`technique | significator | start | exact | end`), sortowanie, deduplikacja, daty dokładne (wspólny root‑finding z LOG‑12). *Ścieżka A:* orkiestracja/glue. *Złożoność: Średnia.* + +### Grupa F — Parser sygnifikatorów i dopasowanie (LOG‑15…20) — **rdzeń unikalnego IP** + +**LOG‑15 · Parser składni „Significator".** ⚠️ **Wysoka — i tak nie ma gotowca.** +*Rozwinięcie:* gramatyka skrótów (obiekty, znaki, żywioły, jakości, domy, aspekty+cel, retro/combust/waxing/heliacal, opcje A/B, warunki, „r‑Asc", whole sign+orb); 7 poziomów złożoności — od poziomu „obiekt" po sygnifikatory opisowe/niejasne (poziomy 5–7 mogą wymagać fallbacku człowiek/AI). *Ścieżka A:* tokenizer + gramatyka PEG (Lark, MIT) + słownik SIGNIFICATORS KEY (warstwa danych) jako mapa znaczeń tokenów. *Złożoność: Wysoka* — tu idzie najwięcej oryginalnej inżynierii; to **wartość intelektualna projektu**. *B/C:* brak — nie istnieje zewnętrzny parser tej składni. + +**LOG‑16 · Precompute „atomów" obecnych w horoskopie.** +*Rozwinięcie:* wygeneruj zbiór wszystkich cząstek prawdziwych dla danego horoskopu (Ma Ari, Ma fire, Ma h2, Ma opp Sa, r‑Asc Ari…); dopasowanie rekordu bazy = przynależność do zbioru. Zależy od LOG‑01…08 (policzony horoskop) + LOG‑15 (słownik). *Złożoność: Średnia* (generacja kombinatoryczna + indeks; wrażliwe wydajnościowo — łączy się z DAN‑22). + +**LOG‑17 · Interpretacja „asp"/„asp+"/„asp‑"/„asp malefic".** +*Rozwinięcie:* rozwinięcie wg konfigurowalnej tabeli pomocniczej (jakie aspekty, orby, active) + LOG‑06. *Złożoność: Niska–Średnia.* + +**LOG‑18/19/20 · Dopasowanie i wypis.** +*Rozwinięcie:* silnik dopasowania: atomy → zapytanie do **warstwy danych (nasz DataProvider!)** → złożenie outputu: 1A (natal, unikalny), 1B (predykcyjne z datami), 2B (wypis interpretacji tylko dla obecnych rekordów), 2 kolumny sygnifikatora (z bazy / as‑is‑in‑chart), „no of hits" (1/2/3/…/?/2+?). To **styk warstwy logicznej z danych** — pasuje do istniejącej architektury. *Złożoność: Średnia.* + +### Grupa G — Scoring, symbole, pozostałe (LOG‑21, 22, 23) + +**LOG‑21 · Scoring siły efektu.** +*Rozwinięcie:* punktacja wg tabel relacyjnych (np. „no air" poziomy */**/***), punkty za domniemaną prawdziwość w syntezie; logika indywidualna (nie zawsze rzadkość = siła). *Ścieżka A:* silnik reguł na danych (tabele relacyjne — warstwa danych). *Złożoność: Średnia*, otwarte (autor przygotuje punktację indywidualnie). + +**LOG‑22 · Konwersja tekst ↔ symbol.** +*Rozwinięcie:* dwukierunkowe mapowanie z tablic Unicode (kompletne w notes3); przechowywanie tekstem, wyświetlanie symbolami; tylko „text" Unicode, nigdy emoji; ℞ dla retro. *Złożoność: Niska* (tablice lookup). Ligatury vs 2 kolumny — patrz Q‑05 (prezentacja). + +**LOG‑23 · Pozostałe wyliczenia.** +*Rozwinięcie:* tally żywiołów/jakości (trywialne), planetary day & hours (wschód/zachód ze Skyfielda + podział na 12 godzin dnia/nocy + władcy chaldejscy), stopnie krytyczne/wrażliwe (lookup), faza Księżyca (elongacja Su‑Mo), syzygia prenatalna (root‑find ostatniej pełni/nowiu przed urodzeniem), divisional (12th/9th parts — arytmetyka). *Ścieżka A:* Skyfield obsługuje zdarzenia astronomiczne. *Złożoność: Niska* (lokalnie Niska–Średnia). + +--- + +## 3. Proponowana kolejność budowy (fazy) + +1. **Fundament (MVP silnika):** LOG‑24 (interfejs) → LOG‑01 → LOG‑02 (bez gwiazd/true‑Lilith) → LOG‑04 (tropikalny+RA) → LOG‑06/07 → LOG‑05 (Whole/Equal/Porphyry+Placidus) → LOG‑23 (podstawy). *Tu Skyfield daje ogromny skok.* +2. **Astrologia rdzenia:** LOG‑08 (Lots) → LOG‑15 (parser) → LOG‑16 → LOG‑18/19/20 (dopasowanie ↔ warstwa danych). *Tu powstaje unikalna wartość i pełny przepływ „horoskop → interpretacje".* +3. **Predykcja prosta:** LOG‑10 (profekcje) → LOG‑12 (returns) → LOG‑14 (agregacja) → LOG‑11 (time‑lordy) → LOG‑13. +4. **Predykcja trudna i dopieszczenie:** LOG‑09 (primary directions, XL) → LOG‑02 dokończenie (gwiazdy, true Node/Lilith) → LOG‑04 (ayanamsy) → LOG‑21 (scoring) → LOG‑05 (pełny zestaw domów). + +Logika: najpierw to, co Skyfield daje tanio i co odblokowuje przepływ end‑to‑end; najtrudniejsze (primary directions, pełne domy) na koniec, gdy mamy już solidną wyrocznię walidacyjną. + +--- + +## 4. Stos technologiczny (permisywny) i walidacja + +**Produkcyjne (ścieżka A):** Skyfield (MIT), pyerfa (BSD), dane JPL DE440 (PD) lub Moshier (PD), Lark (MIT), numpy/pandas (BSD). Zero copyleft → produkt może być zamknięty i hostowany. + +**Tylko dev/test (B/C jako wyrocznia — NIE w produkcie, NIE wystawiane przez sieć):** pyswisseph (AGPL) i Morinus (GPL) do porównań liczbowych w testach regresyjnych. To legalne, bo nie dystrybuujemy ich i nie udostępniamy użytkownikom — AGPL/GPL nie zostają uruchomione. + +**Wymaganie pochodne (do dopisania w arkuszu):** **LOG‑25 — harness walidacyjny**: zestaw testów porównujących nasz silnik z SE/astro.com/Morinus na bazie znanych horoskopów (np. przykład z notes3: 30.04.1984, Warszawa), z progami tolerancji per wielkość. To nasza polisa ubezpieczeniowa przy budowie od zera. + +--- + +## 5. Wniosek + +Ścieżka A jest **w pełni wykonalna**. Skyfield + pyerfa + JPL/Moshier zdejmują z nas całą trudną astronomię (pozycje, zdarzenia, czas gwiazdowy, precesja). Realny ciężar własnej implementacji to **trzy obszary**: primary directions (XL), pełny zestaw domów (Wysoka) i parser sygnifikatorów (Wysoka — ale unikalny, gotowca i tak nie ma). Wszystkie pozostałe wymagania są Niskie/Średnie. Narzędzia AGPL/komercyjne zostają jako **wyrocznia walidacyjna i dane referencyjne** — używane legalnie poza produktem.