Specyfikacja funkcjonalna
Przepływy, ekrany, stos technologiczny i gotowe prompty systemowe użyte w tej aplikacji.
Przepływ użytkownika
Start (Home)
├─ "Umów wizytę" ──────────────► Rezerwacja ──► Potwierdzenie + przypomnienia SMS
├─ "Asystent AI"
│ ├─ tryb: Badania ──► dobór pakietu ──► checklista ──► Rezerwacja
│ ├─ tryb: Estetyka ──► wywiad skóry ──► zabieg + przeciwwskazania ──► Rezerwacja
│ └─ tryb: Recepcja ──► FAQ 24/7 / rezerwacja w języku naturalnym
└─ "Przygotowanie" ──────────► wybór badań ──► checklista ──► przypomnieniaWireframe – kluczowe ekrany
Home
- Hero: nazwa placówki, obietnica („asystent 24/7”), 2 CTA: Umów wizytę / Zapytaj AI
- Trzy karty modułów: badania, estetyka, recepcja
- Pasek zaufania: RODO, personel medyczny, wyniki tego samego dnia
- Sekcja FAQ + stopka z godzinami, dojazdem i disclaimerem
AI Assistant Chat
- Górny przełącznik trybów (Badania / Estetyka / Recepcja)
- Lista wiadomości: awatar AI po lewej, bąbel pacjenta po prawej, markdown w odpowiedziach
- Chipsy z podpowiedziami startowymi
- Kompozytor: textarea (Enter = wyślij), przycisk wyślij, stały disclaimer pod polem
Test Preparation Guide
- Lewa kolumna: checkboxy badań w grupach Krew / Mocz / Kał
- Prawa kolumna: wygenerowana checklista z możliwością odhaczania
- Kafelki skrótów: post, nawodnienie, leki
- CTA: włącz przypomnienia, umów termin
Booking Confirmation
- Ikona sukcesu + nagłówek „Rezerwacja przyjęta”
- Podsumowanie: usługa, termin, pacjent, kontakt
- Informacja o SMS-ach 24 h i 1 h przed wizytą
- CTA: przejdź do przygotowania / zmień rezerwację
Stos technologiczny
- Frontend
- React 19 + TanStack Start (SSR), Tailwind CSS v4, shadcn/ui, Lucide
- Warstwa AI
- Vercel AI SDK (streamText, useChat) + Lovable AI Gateway
- Model
- google/gemini-3.7-flash dla czatu (niski koszt, szybka odpowiedź)
- Backend
- Server routes / server functions TanStack Start (klucz API tylko po stronie serwera)
- Baza i auth
- Lovable Cloud (Postgres + RLS, storage, auth) – rezerwacje, checklisty, zgody
- Powiadomienia
- Webhook + dostawca SMS/e-mail wyzwalany harmonogramem (cron) przed wizytą
- Zgodność
- RODO: minimalizacja danych, szyfrowanie w tranzycie, rejestr zgód, retencja logów 30 dni
Prompty systemowe
Te instrukcje są realnie używane przez asystenta w tej aplikacji.
Prywatność i zgodność
- Minimalizacja danych: asystent nie prosi o PESEL, dokumenty ani historię choroby.
- Rejestr zgód marketingowych i komunikacyjnych, wycofywalny jednym kliknięciem.
- Dane wrażliwe wyłącznie w bazie z RLS; klucze API tylko po stronie serwera.
- Obowiązkowy disclaimer medyczny na każdym ekranie z poradą AI.
- Ścieżka eskalacji: objawy alarmowe → komunikat o kontakcie z 112 / SOR.

