InvestAnalyzer v0.2.0 — pierwsze publiczne wydanie

InvestAnalyzer v0.2.0 — pierwsze publiczne wydanie

Lokalny kalkulator PIT-38 i portfel inwestora dla Windows. Program liczy przychody, koszty, dochód i podatek od zagranicznych instrumentów finansowych na podstawie plików brokera: deterministyczny silnik FIFO, kursy NBP T-1, dywidendy zagraniczne z podatkiem u źródła, straty z lat ubiegłych, pakiet PIT-38/PIT-ZG. Każda kwota ma ślad dowodowy (plik → kurs NBP → partia FIFO → wyliczenie → podstawa prawna). Do tego portfel z notowaniami na żywo, wykresami, alertami cenowymi i historią transakcji.

Wszystko działa lokalnie, bez chmury: pliki brokera i wynik rozliczenia nie opuszczają komputera. Repozytorium nie zawiera żadnych danych użytkownika; zrzuty ekranu i testy używają danych syntetycznych.

Co jest w wydaniu

Plik	Opis
InvestAnalyzer-Komputerowa-v0.2.0-20261001-0701.zip	Wersja przenośna dla Windows 10/11 (64-bit), ok. 39 MB. Zawiera InvestAnalyzer.exe i wbudowany silnik podatkowy (binaries/). Nie wymaga Node.js ani Pythona.
Source code (zip / tar.gz)	Pełne źródła: aplikacja React + Vite, serwer, silnik Python, powłoka Tauri, testy i narzędzia.

SHA-256 paczki przenośnej: 4d45542b6ff360666c0094b82617e93605396632476d8e104b9e24eba9f437b1

Instalacja — Windows (wersja przenośna)

1. Pobierz InvestAnalyzer-Komputerowa-v0.2.0-20261001-0701.zip z sekcji Assets poniżej.
2. Rozpakuj do dowolnego folderu (np. C:\InvestAnalyzer). Nie wyjmuj plików z folderu — InvestAnalyzer.exe potrzebuje katalogu binaries/ obok siebie.
3. Uruchom InvestAnalyzer.exe. Paczka nie jest podpisana cyfrowo, więc SmartScreen może pokazać ostrzeżenie: Więcej informacji → Uruchom mimo to. Przed uruchomieniem możesz porównać sumę SHA-256 (Get-FileHash plik.zip w PowerShell).
4. W aplikacji wgraj pliki brokera (Dokumenty i silnik → Import) i uruchom rozliczenie. Dane zapisują się w %APPDATA%\InvestAnalyzer i %LOCALAPPDATA%\InvestAnalyzer; import kopiuje pliki, nie przenosi ich.
5. Wymagany jest WebView2 (w Windows 11 jest wbudowany; w Windows 10 pobierze go instalator Microsoft, jeśli brakuje).

Nie uruchamiaj ręcznie plików z binaries/ — to wewnętrzne pliki silnika. Automatyczne aktualizacje są wyłączone; nową wersję pobierasz z tej strony.

Telefon i przeglądarka (PWA)

Aplikacja działa też online: https://investanalyzer-app.dismonder.workers.dev — dodaj ją do ekranu głównego („Zainstaluj aplikację” w Chrome, „Dodaj do ekranu początkowego” w Safari). W tej wersji działają portfel, notowania na żywo, wykresy i alerty; dane zostają w pamięci przeglądarki. Rozliczenie PIT-38 i import plików brokera wymagają wersji Windows, bo przeglądarka nie ma silnika Pythona.

Strona projektu ze zrzutami ekranu: https://investanalyzer-strona.dismonder.workers.dev

Uruchomienie ze źródeł (dla programisty)

Wymagania: Node.js 20+, Python 3.12; do budowy desktopu dodatkowo Rust (msvc), Visual Studio Build Tools i WebView2.

git clone https://github.com/Dismonder/InvestAnalyzer-PIT38.git
cd InvestAnalyzer-PIT38
npm install
py -3.12 -m venv silnik/python/.venv
silnik/python/.venv/Scripts/python.exe -m pip install -e "silnik/python[desktop,test]"
npm run dev          # http://localhost:3000
npm run desktop:dev  # alternatywnie: desktop Tauri

Pliki brokera do pracy w repozytorium umieść w dane/pliki/ (katalog poza kontrolą wersji). Bramki jakości: npm run verify (lint, testy TS i Python, build, limity rozmiaru, bramka danych prywatnych). Szczegóły w README.

Obsługiwane źródła

• Import CSV/XLSX i raportów brokera (m.in. eksport Freedom24/Tradernet), archiwum kursów NBP z automatycznym uzupełnieniem z api.nbp.pl.
• Po konfiguracji własnych kluczy: odczyt rachunku Freedom24 i Binance (tylko odczyt w desktopie).
• Trzy plany kosztowe: conservative, defensible, aggressive_user — każdy koszt z dowodem i oceną ryzyka.
• Silnik działa w trybie fail-closed: brak kursu NBP, ujemny stan FIFO, konflikt wyciągów albo niekompletne wejście blokują oznaczenie wyniku jako gotowego do złożenia.

Licencja

Oprogramowanie własnościowe z jawnym kodem, nie open source. Wolno pobrać, zainstalować i używać niezmienionej wersji do użytku osobistego i niekomercyjnego oraz przeglądać kod. Bez pisemnej zgody autora nie wolno kopiować, rozpowszechniać, modyfikować, używać fragmentów kodu w innych projektach ani używać komercyjnie. Pełna treść: LICENSE.

Zastrzeżenie

Program nie stanowi porady podatkowej. Wynik wymaga weryfikacji z dokumentami i obowiązującymi przepisami. Oprogramowanie jest udostępniane bez gwarancji poprawności rozliczenia; odpowiedzialność za zeznanie ponosi podatnik.