first commit

2026-06-03 12:36:51 +02:00
commit 3ab205b769
22 changed files with 1261 additions and 0 deletions
@@ -0,0 +1,31 @@
+# Symulator kredytu hipotecznego
+
+Nowoczesna aplikacja one-page do symulacji kredytu hipotecznego: zmienne stopy w czasie, nadpłaty, raty równe/malejące, skrócenie okresu albo obniżenie raty, wykresy, CSV/PDF, WebSocket live.
+
+## Start
+
+```bash
+docker compose up --build
+```
+
+Otwórz:
+
+```text
+http://localhost:8080
+```
+
+## Funkcje
+
+- symulacja rat równych i malejących,
+- harmonogram zmiennego oprocentowania w konkretnych miesiącach,
+- nadpłaty jednorazowe i cykliczne,
+- tryb nadpłaty: skrócenie okresu albo zmniejszenie raty,
+- live przeliczenia przez WebSocket,
+- wykresy liniowe, słupkowe i kołowe,
+- opis oszczędności: odsetki, czas, suma nadpłat,
+- eksport CSV i PDF,
+- pobieranie aktualnej stopy referencyjnej NBP z oficjalnej strony jako pomocnicza wartość bazowa.
+
+## Uwaga
+
+To symulator edukacyjny. Wynik może różnić się od harmonogramu banku, bo banki stosują własne zasady zaokrągleń, dat płatności, prowizji i aktualizacji WIBOR/WIRON.