Przejdź do treści

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 ──► przypomnienia

Wireframe – 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.