O kliencie
PyziSmakosz to nowoczesna aplikacja Progressive Web App stworzona dla cukierni PyziPyzi (Kamila Kowalska). Aplikacja zrewolucjonizowała program lojalnościowy tradycyjnej cukierni, łącząc świat offline (wizyty w lokalu) z online (sklep WooCommerce) i wykorzystując sztuczną inteligencję do weryfikacji zakupów.
Wyzwanie
Cukiernia PyziPyzi prowadziła tradycyjny program lojalnościowy oparty na papierowych kartach z pieczątkami. System generował liczne problemy operacyjne — od zgubionych kart po brak jakichkolwiek danych o klientach.
Zgubione karty — klienci tracili karty tuż przed nagrodą
Zero danych — brak informacji o klientach i ich preferencjach
Dwa oddzielne światy — osobne bazy klientów online (WooCommerce) i offline
Brak komunikacji — niemożność wysłania powiadomień o promocjach
Brak targetowania — każdy klient traktowany identycznie
100% digitalizacja programu lojalnościowego
Jedna baza klientów dla online + offline
Wzrost retencji powracających klientów o 25%
Budowa bazy kontaktów ze zgodami marketingowymi
Czas ładowania aplikacji poniżej 3 sekund
Rozwiązanie
1. Architektura systemu
Stworzono trójwarstwową aplikację PWA z wyraźnym podziałem odpowiedzialności: warstwa prezentacji (React 18 + TypeScript), warstwa logiki (Supabase Edge Functions) i warstwa danych (PostgreSQL + Auth + Storage).
Discovery i Research (Tydzień 1-2)
Analiza obecnego procesu (shadowing w lokalu), wywiady z klientami, audyt techniczny WooCommerce, mapowanie user journey
UX/UI Design (Tydzień 2-3)
Wireframes dla 3 ról użytkowników, design system zgodny z brandingiem PyziPyzi, mobile-first, Dark/Light mode
Development Frontend (Tydzień 3-5)
React + TypeScript + Vite, komponenty shadcn/ui, konfiguracja PWA (manifest, service worker, ikony), system autoryzacji i ról
Development Backend (Tydzień 4-6)
Schemat bazy PostgreSQL, Row Level Security (RLS), Edge Functions (SMS, AI verification, WordPress sync), integracja API WordPress
Integracje i Launch (Tydzień 6-8)
Google Gemini AI, SMSapi.pl, dwukierunkowa synchronizacja WordPress, GTM + Consent Mode v2, testy i deployment na Cloudflare Pages
2. Funkcjonalności dla klienta
Aplikacja oferuje pełny ekosystem lojalnościowy z trzema rolami użytkowników: klient, pracownik i administrator.
-
Cyfrowa karta lojalnościowa
Animowane pieczątki, kod QR do identyfikacji w lokalu, historia aktywności i kolekcja ukończonych kart -
System nagród
5. pieczątka = rabat -20%, 7. = przypomnienie SMS, 9. = darmowe „KILOO CIACHO” — automatyczny reset karty po realizacji -
Gamifikacja
Kolekcja ukończonych kart z rankingiem „PyziPożeracz” — motywacja do powrotów -
„Co dziś świeżego?”
Harmonogram wypieków na każdy dzień tygodnia — informacja o aktualnej ofercie
3. Panel pracownika i administratora
-
Skaner QR z retry
Mechanizm retry z exponential backoff, opóźnione inicjalizowanie, stan isStarting — niezawodne skanowanie na 95%+ urządzeń -
Dashboard administracyjny
Statystyki, rankingi, wykresy, zarządzanie użytkownikami, masowa wysyłka SMS, eksport CSV -
Zarządzanie zgodami RODO
Tabela user_consents z timestampami, panel klienta do zarządzania zgodami, funkcja „Usuń konto”
4. Wyzwania techniczne
Wtyczka WP przechwytująca hasła podczas logowania
Edge Function sync-from-wordpress
Automatyczne tworzenie konta w Supabase Auth
Dwukierunkowa synchronizacja — zmiany propagują do WP
Google Gemini Vision API — OCR + analiza kontekstu
Weryfikacja: nazwa cukierni, data, kwota, produkty
Automatyczne przyznanie pieczątki lub odrzucenie
Klienci zdobywają pieczątki bez angażowania pracownika
Technologie
TypeScript
Vite
Tailwind CSS
shadcn/ui
Framer Motion
Supabase (PostgreSQL + Auth)
Edge Functions (Deno)
Row Level Security
Google Gemini AI
SMSapi.pl
Web Push API (VAPID)
WordPress REST API
Cloudflare Pages
Google Tag Manager
Consent Mode v2
Rezultaty
PyziSmakosz to przykład udanej transformacji cyfrowej tradycyjnego biznesu. Projekt obejmował stworzenie aplikacji PWA (React + TypeScript + Supabase) z cyfrowym programem lojalnościowym, weryfikację paragonów przez Google Gemini AI, Single Sign-On z istniejącym sklepem WooCommerce, systemem powiadomień Push/SMS, gamifikacją (rankingi, kolekcje kart) oraz pełną zgodnością z RODO. Aplikacja wyeliminowała papierowe karty, zwiększyła identyfikację klientów z 20% do 100% i umożliwiła kontakt SMS z 85% bazy klientów.