Mój Budżet — zarządzanie finansami na własnym mikro-frameworku PHP

01Funkcjonalności

nawigacja główna — Bootstrap navbar z sekcjami: Panel, Przychody, Wydatki, Bilans, Ustawienia

02Zarządzanie transakcjami

Aplikacja umożliwia dodawanie przychodów i wydatków z pełną walidacją — kwoty, daty, kategorii i opcjonalnego komentarza. Kwoty obsługują zarówno format z kropką jak i przecinkiem jako separatorem dziesiętnym. Daty akceptowane są w formatach ze słupkami i z kropkami.

strona bilansu — zestawienie przychodów z podziałem na kategorie, sumy i wykres kołowy

formularz dodawania nowej kategorii wydatków z opcjonalnym limitem miesięcznym

modal edycji kategorii — zmiana nazwy i limitu

// src/App/Services/TransactionService.php — createIncome()
public function createIncome(array $formData)
{
    $date = $formData['date'];
    if (strpos($date, '.') !== false) {
        list($day, $month, $year) = explode('.', $date);
        $date = sprintf('%04d-%02d-%02d', $year, $month, $day);
    }
    $amount = str_replace(',', '.', trim($formData['amount']));

    $this->db->query(
        'INSERT INTO incomes VALUES (NULL, :user_id, :income_category_assigned_to_user_id,
         :amount, :date_of_income, :income_comment)',
        [
            'user_id'   => $_SESSION['logged_id'],
            'category'  => $formData['category'],
            'amount'    => $amount,
            'date'      => $date,
            'comment'   => $formData['comment']
        ]
    );
    $_SESSION['income_added'] = true;
}

03REST API — real-time informacja o limicie

Najbardziej interaktywny element aplikacji: przy dodawaniu wydatku każda zmiana kategorii lub wpisywanej kwoty wyzwala AJAX do endpointu, który sprawdza ustawiony limit i aktualną sumę wydatków w bieżącym miesiącu. Użytkownik widzi natychmiast, ile mu zostało i jaki będzie balans po dodaniu tej kwoty.

odpowiedź endpointu GET /api/limit/{category}/{date} — limit kategorii i suma wydatków w miesiącu

// src/App/Services/ApiService.php
public function fetchLimit($categoryId): array|false
{
    return $this->db->query(
        'SELECT `limit` FROM expenses_category_assigned_to_users WHERE id = :id',
        ['id' => (int) $categoryId]
    )->fetch();
}

public function fetchMoneyspentSoFar($categoryId, $pickedDate): array
{
    return $this->db->query(
        'SELECT SUM(amount) AS total_spent FROM expenses
         WHERE expense_category_assigned_to_user_id = :id
           AND YEAR(date_of_expense) = :year
           AND MONTH(date_of_expense) = :month',
        [
            'id'    => (int) $categoryId,
            'year'  => (int) substr($pickedDate, 0, 4),
            'month' => (int) substr($pickedDate, 5, 2)
        ]
    )->fetch();
}

04Własny mikro-framework PHP

Serce projektu — katalog src/Framework/ z samodzielną implementacją każdej warstwy tradycyjnie dostarczanej przez Laravel czy Symfony. Rozumienie frameworka przez jego zbudowanie od zera.

Router — dispatch z middleware chain

// src/Framework/Router.php — middleware jako zagnieżdżone domknięcia
foreach ($allMiddleware as $middleware) {
    $middlewareInstance = $container->resolve($middleware);
    $action = fn() => $middlewareInstance->process($action);
}
$action(); // uruchamia cały łańcuch od zewnątrz do wewnątrz

Container — autowiring przez Reflection API

// src/Framework/Container.php
public function resolve(string $className)
{
    $reflectionClass = new ReflectionClass($className);
    $params = $reflectionClass->getConstructor()->getParameters();

    $dependencies = [];
    foreach ($params as $param) {
        $type = $param->getType()->getName(); // odczytaj type hint
        $dependencies[] = $this->get($type);  // rekursywnie wstrzyknij
    }

    return $reflectionClass->newInstanceArgs($dependencies);
    // → np. BalanceController(TemplateEngine, TransactionService, ApiService)
    // → automatycznie, bez jednej linii konfiguracji
}

05Łańcuch middleware — 9 klas

06Stack technologiczny

07Struktura projektu

08Czego dowodzi ten projekt