8 / 100 Punktacja SEO

    Organizer Budżetu – instrukcja użytkownika.

    1. O aplikacji
      Organizer Budżetu służy do planowania domowych finansów w podziale na tygodnie,
      miesiące i rok. Wprowadzisz bieżący stan, planowane dochody i wydatki, a aplikacja
      policzy pozostałą kwotę, poprowadzi ciągłość między tygodniami i miesiącami i przygotuje
      raporty (tekst + wykres).
    2. Podstawowe pojęcia
      Okres – każdy wpis dotyczy konkretnego tygodnia: YYYY_MM_Tx (np. 2025_09_T3).
      Sekcje:
      Obecny stan budżetu – ile masz na koncie i w portfelu na start tygodnia.
      Planowane dochody – np. Praca stała, Dodatkowe źródło (możesz dodać kolejne).
      Planowane wydatki – wszystkie planowane koszty (możesz dodawać/usuwać
      pozycje).
      Pozostała kwota – wynik: (Obecny stan + Dochody) − Wydatki.
      Ta wartość może być automatycznie przenoszona na kolejny okres (patrz §6).
    3. Pierwsze uruchomienie i logowanie

      1. Zaloguj się lub załóż konto (ekran logowania).
        Po zalogowaniu trafisz na ekran Budżet – Organizer.
        Jeśli wylogujesz się z menu (⋮ →
        Wyloguj), aplikacja wyczyści sesję i wróci do ekranu
        logowania.
    4. Ekran „Budżet – Organizer”
      4.1. Wybór okresu
      Na górze są 3 listy:
      Rok, Miesiąc, Tydzień.
      Wybierz interesujący tydzień – dane ładują się automatycznie.
      4.2. Wprowadzanie danych
      W każdej sekcji możesz:
      zmienić nazwę pozycji,
      uzupełnić kwotę (liczby, przecinek lub kropka),
      dodać pozycję przyciskiem „+ Dodaj pozycję”,
      usunąć wiersz ikoną

      .
      Stały porządek w sekcjach
      „Obecny stan budżetu”: zawsze Na koncie, W portfelu (pierwsze dwa wiersze).
      „Planowane dochody”: Praca stała, Dodatkowe źródło (na górze).
      Dodatkowe pozycje w dochodach i wszystkie wydatki możesz dodawać dowolnie.
      4.3. Obliczanie wyniku
      Kliknij Oblicz budżet. Aplikacja pokaże:
      Pozostałą kwotę (z kolorem stanu),
      szczegóły: łączny stan, dochody, wydatki, suma, procent, klucz okresu.
      Kolor wyniku:
      czerwony – wynik ujemny,
      pomarańczowy/żółty – niski bufor,
      zielony – bezpieczny bufor.
      4.4. Zapisywanie
      Dane zapisują się automatycznie przy edycji i zmianie okresu.
      Ręczne Oblicz budżet też zapisuje.
    5. Raporty
      W menu (⋮) wybierz Raporty.
      5.1. Zakres raportu
      Raport korzysta z ustawień:
      Rodzaj raportu: tygodniowy / miesięczny / roczny,
      Typ wykresu: kołowy / słupkowy,
      Waluta.
      5.2. Zawartość raportu
      Część tekstowa: lista dochodów i wydatków z sumami oraz wyliczenia.
      Wykres: rozkład wydatków (koło lub słupki).
      W ciemnym motywie opisy wykresu mogą być mniej kontrastowe – to zostawiamy do
      dopracowania (patrz §10).
    6. Ciągłość między tygodniami i miesiącami (carry-over)
      6.1. Tydzień →
      kolejny tydzień

    7. Gdy w Tygodniu N+1 oba pola „Na koncie” i „W portfelu” są puste, aplikacja:
      obliczy Pozostałą kwotę z Tygodnia N,
      wpisze ją do pola Na koncie w Tygodniu N+1,
      W portfelu zostawi puste (możesz je wpisać ręcznie).
      Jeśli wpiszesz wartość W portfelu i opuścisz to pole, aplikacja automatycznie:
      pomniejszy Na koncie o wpisaną kwotę (kursor nie „skacze”).
      6.2. Miesiąc →
      kolejny miesiąc
      W Tygodniu 1 nowego miesiąca (T1), gdy obu pól stanu nie wypełniono:
      aplikacja szuka ostatniego zapisanego tygodnia poprzedniego miesiąca (T5→
      T1)
      i przenosi z niego Pozostałą kwotę do „Na koncie”.
      Jeśli cokolwiek wpiszesz ręcznie w stanach, automatyczne przenoszenie jest wyłączone
      dla tego tygodnia (masz pełną kontrolę).
    8. Ustawienia
      W menu (⋮) wybierz Ustawienia i skonfiguruj:
      Walutę (np. PLN),
      Rodzaj raportu (domyślnie „Miesięczny”),
      Typ wykresu (kołowy/słupkowy),
      Motyw (jasny/ciemny – w zależności od systemu).
    9. Dobre praktyki pracy
      Najpierw ustaw tydzień, miesiąc i rok.
      Uzupełnij „Obecny stan budżetu”:
      zostaw puste, jeżeli chcesz, by wartość przepisała się z poprzedniego
      tygodnia/miesiąca,
      wpisz ręcznie, jeżeli chcesz nadpisać wyliczenia.
      Wpisz dochody i wydatki, dodaj brakujące pozycje.
      Kliknij Oblicz budżet (zapis następuje sam, ale to dobry moment na wgląd).
      Przejdź do Raportów i sprawdź podsumowanie.
    10. Gdzie są dane?
      Dane trzymane są lokalnie w pamięci urządzenia (SharedPreferences).
      Każdy tydzień zapisany jest pod kluczem data_YYYY_MM_Tx.
      Aplikacja nie wysyła danych na serwer.
      Tip: jeśli chcesz zrobić kopię, skorzystaj z systemowego backupu aplikacji lub narzędzi do
      eksportu danych (na Androidzie wymagane mogą być dodatkowe uprawnienia / narzędzia
      programistyczne).
    11. Znane ograniczenia / uwagi
      W trybie ciemnym etykiety legendy wykresu mogą być mniej czytelne; zaplanowana
      jest poprawa kontrastu.
      Czcionki na przyciskach w ciemnym motywie mogą mieć zbyt niski kontrast —
      poprawka również zaplanowana.
      Wydatki w raporcie grupowane są po nazwie pozycji – jeśli dodasz kilka „Paliwo” w
      różnych tygodniach, w raporcie miesięcznym sumują się jako jedna kategoria (to
      pożądane zachowanie).
    12. Rozwiązywanie problemów (FAQ)
      Nie przeniosła się pozostała kwota do nowego tygodnia.

      Sprawdź, czy w „Na koncie” lub „W portfelu” nie było wpisu – automatyczne
      przenoszenie działa tylko gdy oba pola są puste. Zmień okres na inny i wróć lub wyczyść
      pola.
      Wpisałem kwotę do portfela i „Na koncie” się nie zmieniło.

      Przeliczanie konta następuje po wyjściu z pola „W portfelu” (po utracie fokusu). Dotknij
      poza polem lub przejdź dalej.
      Raport liczbowo nie zgadza się z moimi oczekiwaniami.

      Pamiętaj: miesięczny raport sumuje wszystkie T1..T5 miesiąca:
      Dochody = suma z sekcji „Planowane dochody”,
      Wydatki = suma z sekcji „Planowane wydatki”,
      „Obecny stan” w miesięcznym raporcie nie jest doliczany do dochodów (jest tylko
      migawką).
      Zniknęły niektóre nazwy w sekcjach / zmieniła się kolejność.

      Aplikacja wymusza stały układ pierwszych pozycji (patrz §4.2). Twoje dodatkowe
      wiersze pozostają, ale są układane niżej.
    13. Wskazówki i skróty
      Szybkie dodawanie: w sekcji użyj „+ Dodaj pozycję”, nazwy możesz wpisać dowolne
      (np. „ZUS”, „Lekarz”, „Netflix”).
      Kropka lub przecinek – oba działają w kwotach.
      Zmieniasz tydzień/miesiąc? Wejście w nowy okres automatycznie ładuje dane;
      poprzedni okres jest zapisywany.
      Masz pomysł na ulepszenie (np. stałe kategorie wydatków, eksport do PDF/CSV,
      przypomnienia)? Daj znać — dorzucę do następnej wersji