# Czas Cykliczny — Widok 3D

Interaktywna wizualizacja 3D kalendarza i zjawisk astronomicznych —
pozycje Słońca, Księżyca, Wenus; przesilenia i równonoce, wyznaczanie
Chodesz (nowiu) wg kryteriów widoczności Odeha (2004) i Yallopa (1997).

**Wersja:** v3.40.0
**Autor:** RH_minus

## Uruchomienie

Od wersji 3.40.0 kod JavaScript jest podzielony na moduły ES
(`js/*.js`), a nie wklejony w całości do `index.html`. To oznacza, że
**otwarcie `index.html` bezpośrednio z dysku (dwuklik, `file://`) nie
zadziała** — przeglądarki blokują ładowanie modułów ES w ten sposób
(traktują to jak żądanie cross-origin, nawet dla plików w tym samym
folderze), a wizualizacja utknie na ekranie startowym.

Trzeba odpalić projekt przez lokalny serwer, np. jedną z tych opcji:

- **VSCodium/VS Code**: rozszerzenie „Live Server” → prawy przycisk na
  `index.html` → „Open with Live Server”,
- **Python**: `python3 -m http.server 8000` w folderze projektu, potem
  otwórz `http://localhost:8000/index.html`,
- **Node**: `npx serve .` w folderze projektu.

Wersja opublikowana pod adresem w `docs/` (GitHub Pages) działa bez
tego kroku, bo tam strona i tak jest serwowana przez https.

## Opis

Projekt umożliwia poruszanie się w czasie (w zakresie wielu wieków)
i obserwację, jak zmieniają się pozycje ciał niebieskich oraz jak
wyznaczany jest kalendarz w oparciu o rzeczywiste zjawiska
astronomiczne widziane z Jerozolimy.

## Filozofia dokumentacji

Jedyną i kanoniczną dokumentacją projektu jest plik `docs/index.html`.
Merytoryczna treść sekcji „O projekcie” jest redagowana bezpośrednio
w tym pliku HTML; `docs/index.html` jest zarówno miejscem pracy nad
opisem filozofii projektu, założeń biblijnych, metodologii
rekonstrukcji kalendarza i architektury interfejsu, jak i jego
ostatecznym, publikowanym rezultatem.

## © Prawa autorskie

© 2026 RH_minus. Wszelkie prawa zastrzeżone.

Autor koncepcji, projektu i implementacji: RH_minus. Narzędzia AI
wykorzystano wyłącznie jako wsparcie redakcyjne i programistyczne.

Projekt „Czas Cykliczny – Widok 3D”, wraz z kodem, wizualizacją,
interfejsem i dokumentacją, jest udostępniany do osobistego,
niekomercyjnego użytku.

Dozwolone jest korzystanie z projektu, udostępnianie linku do projektu,
publikowanie zrzutów ekranu i nagrań przedstawiających jego działanie
oraz omawianie, recenzowanie i cytowanie fragmentów dokumentacji,
z podaniem autorstwa „RH_minus” i odnośnika do projektu.

Bez pisemnej zgody autora zabronione jest kopiowanie, modyfikowanie
lub publikowanie kodu źródłowego, tworzenie i rozpowszechnianie
jego zmodyfikowanych wersji, a także wykorzystywanie projektu
w celach komercyjnych.

Każde inne wykorzystanie projektu wymaga uprzedniej zgody autora.

Pełne warunki: [LICENSE](./LICENSE)

**Kontakt** (licencjonowanie / zgoda na wykorzystanie):
rafalski.h@gmail.com

**Data pierwszej publikacji:** 2026-06-19

## Biblioteki zewnętrzne

Projekt wykorzystuje bibliotekę **Three.js** (https://threejs.org),
dostępną na licencji MIT. Powyższe warunki licencji „Czas Cykliczny –
Widok 3D” dotyczą wyłącznie autorskiego kodu, koncepcji, interfejsu
i dokumentacji projektu — nie ograniczają praw wynikających z licencji
MIT do samej biblioteki Three.js ani innych bibliotek open source
użytych w projekcie. Pełna treść licencji MIT: patrz [LICENSE](./LICENSE).

## Prywatność

Aplikacja nie wymaga logowania, nie przechowuje kont użytkowników,
nie zawiera żadnej analityki ani śledzenia i nie wykorzystuje plików
cookies do śledzenia ani profilowania.

Do działania wykorzystywane są:

- **Three.js** — biblioteka 3D ładowana z zewnętrznego CDN (unpkg.com),
  co wiąże się z przekazaniem adresu IP przeglądarki do operatora CDN
  w momencie wczytania strony.
- (dotyczy dokumentacji) **Google Fonts** — czcionki ładowane
  z serwerów Google, co wiąże się z przekazaniem adresu IP do Google LLC.
- Aplikacja nie zapisuje żadnych danych lokalnie w przeglądarce
  (bez `localStorage`, bez `sessionStorage`, bez plików cookies).

Nie prowadzę profilowania, nie sprzedaję ani nie udostępniam
żadnych danych osobom trzecim w celach marketingowych.

W razie pytań dotyczących przetwarzania danych: rafalski.h@gmail.com
