Historia zmian

Wymaganie Node.js 22.22.2

• Minimalna wersja Node.js: 22.22.2 (engines, CI, .nvmrc, README)

Naprawa tworzenia budżetu (RPC)

• Migracja 056: create_budget RPC - atomowe tworzenie budżetu z pominięciem problemu insert+select RLS
• Fallback: bez RPC insert z client UUID (bez .select() blokowanego przez RLS)

Naprawa dodawania budżetu

• Budżet: członkowie rodziny wysyłani jako jedno pole JSON (jak w notatkach i prezentach)
• Walidacja członków przed utworzeniem budżetu; rollback przy błędzie sync
• Odświeżanie listy budżetów po zapisie omija deduplikację in-flight fetch

Higiena po audycie

• Migracja 055: usunięte complete_founder_onboarding i przestarzała polityka RLS families INSERT
• Nawigacja modułów w headerze na APP_MODULE_DISCOVER_IDS (jak dashboard i mobile)
• Jeden cel tour FAMILY_MEMBERS; usunięty martwy familyInsertPayload i copy familyTab

Domknięcie audytu bezpieczeństwa i UX

• Migracja 054: revoke INSERT na families, atomowe onboard_create_family, usunięte martwe RPC
• Budżet: emptyFiltered i CTA wyczyść filtry; chores kalendarz z tym samym wzorcem
• Desktop i mobile: ta sama lista modułów (APP_MODULE_DISCOVER_IDS)
• Nimbus: krok tour Dzisiaj, context hints /family, stałe FAMILY_CALENDAR_VIEW
• Cookie zaproszeń z flagą Secure w produkcji; testy RPC onboardingu i push HTTPS

Bezpieczeństwo onboardingu i spójność modułów

• Atomowe RPC onboardingu (kod zaproszenia i token e-mail) oraz migracja 053
• Kod zaproszenia rodziny tylko dla właściciela; push wymaga HTTPS w produkcji
• ModulePageHeader we wszystkich modułach, wspólne karty modułów i empty states
• Nimbus: tour mobile modułów, ścieżka /family, stałe cele tour

Moduły na mobile bez duplikatu

• Siatka modułów na dashboardzie tylko na desktopie; na mobile wyłącznie dolny sheet
• Deep link ?view=modules na mobile otwiera sheet zamiast drugiej listy

Bezpieczeństwo onboarding + spójny UX modułów

• Onboarding: bezpieczne RPC (solo, founder, join, finalize) zamiast complete_onboarding_profile
• create_family_and_join, get_family_invite_code, rate limit join, wydatki budżetu tylko dla autora
• Notatki: sanityzacja markdown przy zapisie; dashboard: błędy zapytań zamiast pustych danych
• ModulePageShell we wszystkich modułach; akcenty modułów w siatce i nagłówkach
• Karta kalendarza rodziny na dashboardzie; dolny sheet modułów na mobile
• ModuleEmptyState w restauracjach i powiadomieniach; usunięty martwy QuickAddFab
• Kalendarz: rounded-none na wpisach; jeden empty state w kalendarzu rodziny

Utwardzenie bezpieczeństwa

• Profile: blokada bezpośredniej zmiany roli, rodziny i onboardingu z klienta
• Powiadomienia rodzinne tylko przez serwer (service role)
• OAuth: walidacja parametru next (ochrona przed open redirect)
• Zaproszenia: auth.uid() w accept, rate limit lookup kodu, join przez RPC
• Middleware: cron bez redirectu logowania, onboarding zawsze z bazy
• Notatki: sanityzacja linków markdown, storage dla załączników rodziny
• Push: walidacja subskrypcji, cron z timing-safe compare

Szybkie dodawanie w kalendarzu rodziny

• Przycisk + w nagłówku znów działa na /calendar (wcześniej ukryty jako podgląd)

Jedna legenda kalendarza na mobile

• Urodziny, obowiązki i kategorie grafiku w jednym rzędzie pod kalendarzem

Legenda kategorii grafiku w kalendarzu

• Desktop: kategorie grafiku w tej samej formie co urodziny i obowiązki (kolor + etykieta)
• Mobile: legenda w jednym rzędzie, kategorie obok siebie

Kategorie grafiku w kalendarzu rodziny

• Pod kalendarzem rodziny legenda typów grafiku z ikonami (praca, wolne, zakupy i inne)
• Kreski w siatce i lista dnia pokazują kolor i typ wpisu grafiku

Kalendarz mobilny, szybkie dodawanie w nagłówku i uproszczone obowiązki

• Kalendarz rodziny na mobile: pełny miesiąc, kolorowe kreski, legenda i lista wybranego dnia
• Szybkie dodawanie (+) obok wyszukiwarki na mobile; formularz obowiązku ma wszystkie pola jak przy normalnym dodawaniu
• Usunięto status „W trakcie” z obowiązków (istniejące wpisy traktowane jak oczekujące)

Demo: kalendarz rodziny z siatką miesiąca

• Sekcja kalendarza rodzinnego w demo pokazuje legendę, nawigację miesiąca i kolorowe wpisy
• Moduł grafiku w demo ma osobny opis od kalendarza rodzinnego

Naprawa zawieszonego loadera nawigacji

• Loader znika po przerwanej nawigacji (np. szybki powrót do /dashboard) i ma limit czasu jako zabezpieczenie

Czytelniejszy opis demo na stronie głównej

• Opis sekcji demo skupia się na korzyści dla użytkownika, bez technicznych wzmianek o bazie danych

Większe demo na stronie głównej

• Sekcja demo na / jest nieco szersza i wyższa, żeby lepiej pokazać panel

Sprint stabilizacji: kalendarz, UX i mobile

• Kalendarz rodziny w nawigacji, wyszukiwaniu i demo; lepsze stany pusty/ładowanie/błąd
• Naprawa wyścigów przy odhaczaniu zakupów i obowiązków; powiadomienia aktualizują się dopiero po sukcesie
• Wspólne puste stany modułów, tokeny statusów, rounded-none w UI, mobilna nawigacja landingu i krótsze etykiety dolnego paska
• Nimbus: przewodnik po /calendar, podpowiedzi kontekstowe i podsumowanie touru

Interaktywne demo na stronie głównej

• Sekcja demo na / z podglądem panelu i wszystkich modułów bez logowania
• Pełne demo pod /demo - zakupy, obowiązki i notatki reagują lokalnie, bez zapisu w bazie
• Przycisk „Wypróbuj demo” w hero i link Demo w nawigacji

Naprawa przeskakiwania ilości w liście zakupowej

• Szybkie klikanie +/- zbiera zmiany i wysyła jedną synchronizację zamiast wielu równoległych requestów
• Realtime nie nadpisuje lokalnej ilości przestarzałymi wartościami podczas edycji

Naprawa zapisu ustawienia szybkiego dodawania

• Zapis quick_add_enabled weryfikuje odpowiedź bazy i pokazuje błąd przy niepowodzeniu
• Po zapisie profil jest odświeżany z serwera

Szybkie dodawanie: pełniejsze formularze i ustawienie profilu

• Obowiązki: termin i przypisanie osoby w szybkim dodawaniu
• Notatki: kategoria i widoczność rodzinna w szybkim dodawaniu
• Profil: opcja włączenia/wyłączenia szybkiego dodawania (Ctrl+K i +)

Szybkie dodawanie: lista i kategoria zakupów

• Szybkie dodawanie produktu: wybór listy zakupów i opcjonalnej kategorii

Spójna typografia: zwykły myślnik

• Wszystkie teksty w aplikacji: długie myślniki zastąpione zwykłym -
• Zasada w regułach repo: nie używać em dash ani en dash w copy

Kalendarz rodziny i większe szybkie dodawanie

• Kalendarz rodziny: breadcrumbs jak w innych modułach
• Szybkie dodawanie (Ctrl+K / +): szerszy modal i czytelniejsze przyciski opcji
• Na mobile w kalendarzu rodziny ukryty przycisk + - tylko podgląd

Kalendarz rodziny, szybkie dodawanie i panel „Dziś”

• Kalendarz rodziny (/calendar): urodziny, grafik i obowiązki w jednym widoku
• Szybkie dodawanie: Ctrl+K oraz przycisk + na mobile (obowiązek, notatka, produkt)
• Panel „Dziś” na dashboardzie obok „Wymaga uwagi”
• Push: grupowanie powiadomień od tej samej osoby w module (okno 2 min)
• Testy integracyjne widoczności multi-user (migracja 048)

Uzupełnienie modułów, naprawy i dostępność

• Budżet: edycja wpisów; RLS budżetów zgodny z dostępem członków
• Zakupy: edycja pozycji (treść i kategoria); notatki: edycja/usuwanie kategorii
• Zwierzęta: usuwanie pupila; restauracje: szybka zmiana statusu wizyty
• Obowiązki: cofnięcie ukończenia terminu; urodziny: opcjonalny rok i wiek
• Powiadomienia: usuwanie z listy; apteczka: edycja przez przypisaną osobę
• Push: wyłączenie synchronizuje profil; włączenie nie nadpisuje wyłączonych modułów
• Naprawa hydracji nawigacji mobile; etykiety delete i focus dla czytników ekranu
• Dalszy polish wizualny: akcenty modułów, kontrast, pierścienie obramowań

Czytelniejszy wygląd i unikalne kolory modułów

• Wyższy kontrast tekstu pomocniczego, cieplejsze tło w jasnym motywie i wyraźniejsze karty w ciemnym
• Każdy moduł na dashboardzie ma własny kolor akcentu (m.in. obowiązki, notatki, zwierzęta)
• Domyślny motyw: system (jasny/ciemny według urządzenia)
• Wyraźniejsze obramowania kart, dolna nawigacja na mobile i opisy w kartach

Landing i rejestracja: push zamiast informacji o karcie

• Strona główna: usunięto wzmianki o karcie kredytowej i kartach dashboardu - w zamian copy o push i powiadomieniach per moduł
• Rejestracja: podtytuł o powiadomieniach i push zamiast „bez karty kredytowej”

Push do przypisanego i Nimbus na mobile

• Push do innego członka rodziny: serwer czyta jego preferencje modułu (RLS blokowało push_enabled)
• Menu Nimbusa na telefonie: naprawione pozycjonowanie arkusza nad dolną nawigacją

Widoczność przypisań w rodzinie

• Obowiązki i apteczka: przypisane wpisy widzi tylko osoba przypisana i autor (nieprzypisane - cała rodzina)
• Budżet: ograniczenie do wybranych członków działa w RLS; prezenty dla członka rodziny domyślnie tylko dla niego
• Powiadomienia i digest e-mail respektują te same zasady widoczności

Naprawa powiadomień push PWA

• Ustawienia → Powiadomienia: przycisk subskrypcji push na telefonie (wcześniej niedostępny po odrzuceniu banera)
• Po włączeniu push automatycznie aktywuje się kanał globalny i push we wszystkich modułach

Naprawa crashy PWA splash na /login

• Statyczny splash PWA jest tylko chowany (CSS), nie usuwany z DOM - koniec z błędem removeChild/insertBefore przy starcie

Naprawa removeChild przy nawigacji

• Dolna nawigacja i overlay przejścia bez useSearchParams - shell nie jest odmontowywany przy zmianie trasy
• Usunięto auto-reset error boundary podczas nawigacji (konflikt DOM)

Naprawa crashy przy nawigacji

• Dolna nawigacja mobile: usunięty portal do body - koniec z błędem hydracji przy przejściach między ekranami
• Strony błędów: twarde przeładowanie przy zmianie trasy i komunikat błędu w UI

Usunięcie Sentry

• Wyłączono integrację Sentry i tunel /monitoring - mniej requestów przy nawigacji
• Strony błędów zostają z i18n PL/EN i twardym odświeżeniem aplikacji

iOS PWA: layout zakupów i ekran startowy

• Lista zakupów na mobile: wyższy tytuł sheeta i stopka „Dodaj nowy produkt” nad zaokrąglonymi rogami iPhone
• PWA: ciemne tło zamiast białego ekranu przy starcie; loader z logo do momentu załadowania aplikacji

Mobile: zakupy, urodziny i kategorie dla admina

• Zakupy na mobile: pełnoekranowy widok listy z nazwą; plus otwiera dialog dodawania produktu z wyborem kategorii
• Urodziny na mobile: lista w accordionie nad kalendarzem; pełne etykiety dni i tygodni; klik w zajęty kafelek otwiera edycję
• Kategorie zakupów: zarządzanie także dla administratora rodziny (nie tylko założyciel)
• Kalendarz modułów: zakres tygodnia z odstępami przy myślniku (np. 6 - 12 Lipiec)

Mniejsze zużycie baterii w PWA na iOS

• Mobile/PWA: statyczne tło zamiast animowanych blobów i blur
• Wstrzymanie animacji Nimbus, timerów i realtime powiadomień w tle
• Wyszukiwarka globalna nie subskrybuje wszystkich modułów, gdy jest zamknięta
• Zakupy: zmiana nazwy i usunięcie listy synchronizują się na żywo w rodzinie
• Kalendarz modułów: na mobile widok tygodniowy z dużymi kafelkami dni

Rodzina, notatki i szybszy panel

• Strona /family - zarządzanie rodziną poza ustawieniami profilu
• Notatki: Markdown, przypinanie i załączniki (obrazy/PDF do 5 MB)
• Kategorie zakupów także na kontach solo
• Powiadomienia: godziny ciszy push i tygodniowy digest e-mail (poniedziałek)
• Dashboard ładuje powiadomienia, kategorie i pozycje list zakupów; lazy search
• Skeletony stron modułów; cookie onboardingu czyszczone przy wylogowaniu

Szybsze ładowanie aplikacji

• Statyczny landing i marketing bez blokującego render cookies() w root layout
• Middleware: mniej zapytań Supabase na publicznych ścieżkach i cache onboardingu
• Fonty z display: swap; dashboard z jednym server fetch i skeletonem pod CLS
• PWA i Nimbus ładowane dynamicznie - mniejszy initial JS na pierwszym malowaniu

Powiadomienia per moduł

• Ustawienia → Powiadomienia: macierz 11 modułów × in-app, push i e-mail
• Jednolity dispatch z filtrowaniem kanałów; usunięto obserwację pojedynczych list i budżetów
• Codzienny digest e-mail: sekcje „Dziś ważne” i „Aktywność (24 h)” z wybranych modułów
• Odświeżony dzwonek i widok /notifications z etykietami modułów

Wersja i Nimbus na telefonie

• Wersja aplikacji widoczna w ustawieniach profilu (link do historii zmian)
• Pełnoekranowy panel Nimbusa i podpowiedzi wysuwane od dołu na mobile
• Licznik nieprzeczytanych powiadomień na dzwonku w dolnej nawigacji mobilnej

Płynne przejścia między stronami

• Pełnoekranowy loader z pulsującym logo podczas nawigacji w aplikacji
• Docelowa strona pojawia się dopiero po załadowaniu - z miękkim fade-out

Powiadomienia na żywo, preferencje i deep linki

• Dzwonek powiadomień odświeża się na żywo (Supabase Realtime)
• Preferencje w profilu: push z serwera i codzienny digest e-mail
• Push i deep linki do listy zakupów (/shopping?list=…) i budżetu
• Poprawka notify-family - sprawdzanie błędu RPC przed pushem
• ESLint wymusza importy @/ zamiast ../ w kodzie produkcyjnym
• Yarn jako menedżer pakietów (yarn.lock, CI i dokumentacja)
• Sentry aktywny tylko na produkcji - szybszy yarn dev
• Usunięte podpisy „wkrótce” i placeholdery funkcji w UI

Sentry - śledzenie błędów

• Sentry dla błędów frontu, Server Actions, API routes i cronów
• Filtrowanie wrażliwych danych (tokeny, e-mail) przed wysyłką
• Strona global-error z i18n PL/EN i raportowaniem do Sentry
• Opcjonalne source mapy przez SENTRY_AUTH_TOKEN na Vercel

Vercel Analytics i Speed Insights

• Vercel Web Analytics - ruch i odwiedziny w panelu Vercel
• Vercel Speed Insights - metryki wydajności (Core Web Vitals) na produkcji

Push i powiadomienia obserwatorów

• iOS - stabilniejsza subskrypcja push (service worker, walidacja VAPID, ponowna próba)
• Push na Vercel - await wysyłki przed zakończeniem server action
• Listy zakupów i budżet - powiadomienia dla obserwatorów (RPC create_watcher_notifications, migracja 039)
• Naprawa RLS - serwer widzi wszystkich obserwatorów listy, nie tylko aktora
• Poprawka VAPID subject (mailto:) przy wysyłce push

Powiadomienia push w PWA

• Web Push po zainstalowaniu aplikacji - Android i iOS 16.4+ z ekranu głównego
• Włączanie w ustawieniach profilu i baner po instalacji PWA
• Push przy powiadomieniach rodzinnych i przypomnieniach budżetu
• Klucze VAPID (yarn push:vapid) - migracja push_subscriptions

PWA - ikona na ekranie głównym iOS

• Ikony PNG (180, 192, 512 px) i apple-touch-icon - iOS nie obsługuje SVG na ekranie głównym
• Manifest i metadane strony wskazują na PNG zamiast samego SVG
• Skrypt yarn pwa:icons do regeneracji ikon z public/pwa-icon.svg

Mobile, PWA i jakość testów

• Manifest PWA z tłumaczeniami PL/EN (opis, skróty, język)
• Dashboard synchronizuje zakładki z parametrem ?view=modules w URL
• Stałe Nimbus dla actionLabel i zdarzenia zakładek ustawień
• Testy E2E: dolna nawigacja mobile, offline, prompt instalacji PWA
• Stabilniejszy selektor menu konta (data-testid)

Nimbus - toury na driver.js

• Przewodniki Nimbusa korzystają z driver.js zamiast własnego overlay
• Popover touru: avatar, nagłówek z nazwą kroku, ramka ze skrótami klawiatury
• Skróty A/D i strzałki do nawigacji między krokami; Esc - pauza touru
• Nimbus pozostaje widoczny podczas touru (mobile i desktop)
• Style popovera poza warstwą Tailwind, aby nadpisać domyślne CSS driver.js

Mobile-first i PWA

• Układ pod telefon: dolna nawigacja, większe cele dotykowe, bezpieczne strefy (notch)
• Dialogi i formularze dostosowane do małego ekranu
• Manifest PWA, service worker, strona offline i prompt instalacji
• Panel modułów dostępny z dolnego paska (?view=modules)

Jakość, testy i synchronizacja na żywo

• Naprawiono panel „Wymaga uwagi” dla płatności budżetu (przekazywanie daty, przeterminowane wpisy)
• Realtime we wszystkich modułach rodzinnych + sekcja planowanych uprawnień w ustawieniach
• Testy E2E CRUD/smoke dla budżetu, urodzin, grafiku, watchlisty, restauracji i powiadomień
• Testy integracyjne Server Actions i deterministyczne testy jednostkowe dat

Nimbus - towarzysz po aplikacji

• Nimbus w prawym dolnym rogu: menu, toury, FAQ, podpowiedzi i tryb cichy
• Przewodniki po aplikacji, każdym module (12), koncie rodzinnym, powiadomieniach i ustawieniach solo
• Zaktualizowane toury i FAQ: scalone zarządzanie rodziną, typ konta tylko przy rejestracji
• Hinty kontekstowe, sugestie cross-modułowe z przyciskami „Pokaż tour” / „Przejdź”, celebracje pierwszych akcji
• Powitanie po zalogowaniu i lekkie żarty Nimbusa między podpowiedziami
• Wznowienie touru (Esc), wyciszenie sugestii, reakcja na panel „Wymaga uwagi”, przypinanie wpisów na górze, skrót Ctrl+K w navbarze
• Sekcja o Nimbusie na stronie głównej oraz testy jednostkowe modułu Nimbus

Spójność UI i panel uwagi

• Wspólne pickery członków rodziny i widoczności w notatkach oraz prezentach
• Ujednolicone kafelki wyboru we wszystkich formularzach
• Panel „Wymaga uwagi”: terminy płatności budżetu, kończące się wpisy grafiku, pilne notatki (!)
• Testy integracyjne Server Actions, E2E CRUD modułów i testy komponentów

Budżet, panel i wersjonowanie

• Budżet: cykliczne wydatki i dochody, ukrywanie budżetów, przypomnienia o terminie płatności
• Notatki: własne kategorie z emoji i widocznością w rodzinie
• Grafik: zakresy dat dla urlopów i wydarzeń wielodniowych
• Panel: zakładki Podsumowanie / Moduły, sekcja „Wymaga uwagi” w kolorze brązowym
• Publiczna strona historii zmian (/change-log) i badge wersji

Pierwsza wersja Nimbusly

• Budżet, listy zakupów, prezenty, urodziny i grafik pracy
• Apteczka, filmy i seriale, restauracje, zwierzęta, obowiązki domowe
• Konta solo i rodzinne, powiadomienia, zaproszenia do rodziny