Onboarding

Przegląd

Po pierwszym zalogowaniu każdy klient (rola client) musi wypełnić proces onboardingu, aby skonfigurować swój profil. Dialog onboardingowy jest wyświetlany automatycznie i nie można go pominąć (modal nie pozwala na zamknięcie).

---

Przepływ

Krok 1 — Wybór typu konta

Użytkownik wybiera jedną z dwóch opcji:

Opcja	Opis
🎓 Jestem uczniem (self_student)	Użytkownik jest sam uczniem
👨‍👩‍👧 Jestem rodzicem (parent)	Użytkownik rejestruje swoje dzieci

Krok 2 — Dane szczegółowe

Wariant „Uczeń"

Pole	Walidacja
Data urodzenia	Opcjonalne, wybór z kalendarza (2000–2020)
Poziom nauki	Wymagane: Szkoła podstawowa / Średnia — podstawa / Średnia — rozszerzenie

Wariant „Rodzic"

Dla każdego dziecka:

Pole	Walidacja
Imię	Wymagane
Nazwisko	Wymagane
Data urodzenia	Opcjonalne, wybór z kalendarza
Poziom nauki	Wymagane: Szkoła podstawowa / Średnia — podstawa / Średnia — rozszerzenie

• Przycisk „Dodaj kolejne dziecko" dodaje nowy formularz.
• Ikona kosza usuwa dziecko z listy.

---

API

POST /api/onboarding

Wymagane uwierzytelnienie. Body (JSON):

{
  "accountType": "self_student | parent",
  "dateOfBirth": "2005-06-15",
  "level": "podstawowa",
  "children": [
    {
      "firstName": "Anna",
      "lastName": "Kowalska",
      "dateOfBirth": "2010-03-20",
      "level": "podstawowa"
    }
  ],
  "invitationToken": "abc-123"
}

Kody odpowiedzi

Kod	Opis
200	Onboarding ukończony
400	Nieprawidłowe dane lub onboarding już ukończony
401	Niezalogowany
404	Nieprawidłowy token zaproszenia
500	Błąd transakcji bazodanowej

---

Wynik

Po ukończeniu onboardingu:

• Tworzony jest rekord client z onboardingCompleted = true.
• Tworzeni są rekordowie student (jeden lub więcej).
• Jeśli podano token zaproszenia → zaproszenie oznaczane jako accepted.
• Dialog nie pojawia się ponownie.