Budget Web Assistant to zaawansowana aplikacja webowa do zarządzania finansami osobistymi, która łączy klasyczne podejście do księgowości domowej z nowoczesnymi technologiami AI. Aplikacja została zbudowana od podstaw w języku PHP 8.2 z wykorzystaniem autorskiego frameworka opartego na wzorcu MVC (Model-View-Controller), co gwarantuje czystość kodu, skalowalność i wysoką wydajność. Aplikacja działa pod adresem:
https://finanse.damian-molter.profesjonalnyprogramista.pl/
💡 Kluczowe Innowacje
🤖 Integracja z Gemini AI (Sztuczna Inteligencja)
To nie jest zwykły kalkulator wydatków. Dzięki integracji z Google Gemini API, aplikacja pełni rolę osobistego doradcy finansowego.
- Analiza wydatków: System przesyła zanonimizowane dane o Twoich przepływach pieniężnych do modelu AI.
- Spersonalizowane porady: Otrzymujesz 3 konkretne wskazówki dotyczące optymalizacji budżetu.
- Wykrywanie trendów: Asystent wskazuje, w których kategoriach wydajesz zbyt dużo i jak możesz zaoszczędzić.
🎯 Inteligentne Limity Wydatków
Aplikacja pozwala na definiowanie miesięcznych limitów dla poszczególnych kategorii (np. „Jedzenie”, „Rozrywka”).
- Monitoring w czasie rzeczywistym: Podczas dodawania wydatku system sprawdza, ile środków pozostało do wykorzystania.
- Alerty: Automatyczne ostrzeżenia chronią Cię przed przekroczeniem założonego planu finansowego.
🛠️ Architektura i Technologie
Projekt stanowi pokaz umiejętności programistycznych w zakresie programowania obiektowego (OOP) i bezpieczeństwa aplikacji webowych.
- Backend: PHP 8.2 (Strict Types) z autorskim systemem routingu i kontenerem Dependency Injection.
- Baza Danych: MySQL/MariaDB z pełną normalizacją danych i więzami integralności (Cascade Delete).
- Frontend: Bootstrap 5.3.3 (Responsive Design) oraz Chart.js do generowania czytelnych wykresów kołowych.
- Bezpieczeństwo: * Ochrona przed SQL Injection (PDO Prepared Statements).
- System CSRF Protection dla każdego formularza.
- Haszowanie haseł algorytmem Bcrypt (cost=12).
- Pełna izolacja danych użytkowników.
📊 Funkcjonalności w pigułce
| Funkcja | Opis |
| Ewidencja | Rejestrowanie przychodów i rozchodów z możliwością dodawania komentarzy. |
| Bilans | Przegląd finansów w ujęciu miesięcznym, rocznym lub w dowolnie wybranym zakresie dat. |
| Personalizacja | Możliwość zarządzania własnymi kategoriami oraz metodami płatności (Karta, Gotówka itp.). |
| Wizualizacja | Interaktywne wykresy prezentujące strukturę wydatków. |
| API | Dostępne endpointy REST dla limitów wydatków i porad AI. |
📂 Struktura Projektu (Clean Code)
Aplikacja promuje separację logiczną (Separation of Concerns):
src/Framework: Rdzeń aplikacji – router, baza danych, walidator.src/App/Controllers: Obsługa żądań i logika sterowania.src/App/Services: Czysta logika biznesowa (np. obliczenia finansowe).src/App/views: Szablony widoków oddzielone od logiki PHP.
📈 Dlaczego warto wybrać tę aplikację?
Budget Web Assistant – OOP to idealne rozwiązanie dla osób, które szukają narzędzia bezpiecznego, prywatnego i inteligentnego. Dzięki architekturze opartej na autorskim frameworku, aplikacja jest niezwykle lekka i szybka, a wsparcie AI sprawia, że zarządzanie pieniędzmi staje się prostsze niż kiedykolwiek wcześniej.
Repozytorium GitHub: https://github.com/DamianMolter/BudgetWebAssistant-OOP
Status Projektu: Produkcja