Symulator emerytalny

Aplikacja webowa składająca się z backendu Flask i frontendowej aplikacji React do edukacyjnego prognozowania wysokości emerytury.

Struktura

• backend/ – serwer Flask udostępniający API symulacji i raportowania.
• frontend/ – aplikacja React budująca interfejs użytkownika.

Uruchamianie backendu

python -m venv .venv
source .venv/bin/activate
pip install -r backend/requirements.txt
python -m backend.app

Domyślnie serwer nasłuchuje na porcie 5000.

Uruchamianie frontendu

cd frontend
npm install
npm run dev

Aplikacja developerska działa domyślnie na porcie 5173 i korzysta z proxy do backendu (/api).

Aby wskazać backend działający pod inną domeną niż frontend, utwórz plik .env w katalogu frontend (na podstawie .env.example) i ustaw zmienną VITE_BACKEND_URL, np. https://api.example.com. Pozostawienie zmiennej pustej powoduje użycie bieżącej domeny frontendu.

Uruchamianie z Docker Compose

Najprostszy sposób na lokalne uruchomienie całego stosu to Docker Compose:

docker compose up --build

Frontend będzie dostępny pod adresem http://localhost:5173, a backend pod http://localhost:5000. Dane symulacji zapisywane są w wolumenie backend-data.

Funkcje

• panel startowy z określeniem oczekiwanej emerytury, porównaniem z grupami i ciekawostką,
• formularz symulacji z wymaganymi i opcjonalnymi parametrami (m.in. środki, kod pocztowy, zwolnienia lekarskie),
• szczegółowy widok wyników wraz z informacjami o stopie zastąpienia, średniej emeryturze i wpływie wydłużenia kariery,
• dashboard umożliwiający modyfikację historii i prognozy wynagrodzeń oraz okresów chorobowych,
• pobieranie raportu użytkownika (JSON) oraz raportu administratora w formacie XLS.