finansePRO/.paul/PROJECT.md

PROJECT — finansePRO

Status: Aktywny, plan-first

Opis

Jednoosobowa aplikacja finansowa w CodeIgniter 4.7.3 i MySQL do ewidencji finansów bieżących, inwestycji oraz półautomatycznego importu paragonów.

Dostarczone funkcje

• ✓ Wydatki, przychody, kategorie i pulpity finansowe — Plan 1.
• ✓ Instrumenty, operacje, wyceny i pulpity inwestycji — Plan 2.
• ✓ Import paragonów przez OpenAI Responses API z podpowiedziami kategorii — Plan 3.
• ✓ Zapamiętywanie logowania przez 30 dni na wielu urządzeniach — Plan 4.
• ✓ Skanowanie paragonu kamerą telefonu i mobilny przegląd wyniku AI — Plan 20260713-2111.

Trwałe wymagania i ograniczenia

• Jedno konto z .env; brak systemu wielu użytkowników.
• MySQL na hostido; nowe migracje są stosowane ręcznie na zdalnej bazie.
• Lokalnie może brakować vendor/; wtedy dostępne jest php -l, a testy runtime wykonuje się w pełnym środowisku.
• Tokeny logowania są niezależne per urządzenie i przechowywane w bazie tylko jako hashe walidatorów.

Kluczowe decyzje

Data	Decyzja	Powód
2026-07-12	Osobny token „remember me” per urządzenie	Równoległe logowania bez wydłużania globalnej sesji
2026-07-12	Wylogowanie usuwa tylko bieżący token	Inne komputery mają pozostać zalogowane
2026-07-12	Bez panelu urządzeń i „wyloguj wszędzie”	YAGNI; brak takiego wymagania

---

Last updated: 2026-07-13 after Plan 20260713-2111