Opis funkcjonalności i architektury

1. Dostęp i Monetyzacja (Lejek)

• Tryb Gościa (Darmowy Dostęp):
  • Użytkownik może zacząć korzystać z aplikacji bez rejestracji.
  • Limit: 10 darmowych skanów na urządzenie (ID urządzenia).
  • Cel: Pokazać wartość "Shazam dla produktów" natychmiast.
• Rejestracja i Subskrypcja:
  • Po 10 skanach — obowiązkowa rejestracja (Google/Apple/E-mail).
  • Oferta: 1 miesiąc za darmo przy wykupieniu subskrypcji.
• Plany cenowe (Płatność roczna):
  • Plan Startowy: Darmowy (limit: do 10 skanów miesięcznie).
  • Plan Podstawowy: 49,99 USD / rok (limit: do 1000 skanów miesięcznie).
  • Plan Premium: 99,99 USD / rok (limit: do 5000 skanów miesięcznie).

2. Onboarding i Personalizacja

• Ustawienia ograniczeń (Tagi Użytkownika):
• Użytkownik wybiera (po prostu dotykając tagów) krytyczne dla niego parametry (po angielsku dla AI):
  • Żywność: Bezglutenowe, Bez laktozy, Orzechy, Jaja, Owoce morza, Wegetariańskie, Bez cukru.
  • Pielęgnacja i Dom: Bez zapachu, Bez siarczanów/parabenów, Wrażliwa skóra, Bez okrucieństwa.
• Lokalizacja: Prośba o dostęp do GPS dla Grounding (wyszukiwanie cen i recenzji w konkretnej kraju/mieście).

3. Główny Cykl (Cykl skanowania)

• Proces robienia zdjęcia:
  1. Użytkownik robi zdjęcie 1 produktu. (lub dodaje z galerii)
  2. Przyciski: "Analizuj" (jeśli produkt jest jeden) lub "+ Dodaj produkt do porównania" (jeśli chce porównać).
  3. Podczas porównania użytkownik robi osobne zdjęcia 2. i 3. produktu. Analiza odbywa się asynchronicznie dla przyspieszenia.
• AI Backend (Silnik):
  • Model: Gemini 2.5 Flash (Temp = 0.0).
  • Grounding: Obowiązkowe pobieranie wyników z Google z uwzględnieniem lokalizacji użytkownika.
  • Wykrywanie trybu: AI otrzymuje zbiór zdjęć. Jeśli zdjęcie jest jedno — tryb Paszportu Produktu. Jeśli 2-3 — tryb Matrycy Porównawczej.

4. Wyniki analizy (UI/UX)

• Wyświetlane są zdjęcia produktów z cenami w lokalnych sieciach.
• System Świateł Drogowych: Wizualne kody kolorystyczne (Zielony/Żółty/Czerwony).
• Dlaczego NIE kupować: Kluczowy blok. AI koncentruje się na negatywnych aspektach: zawyżona cena, szkodliwe dodatki, zły ranking konsumencki.
• Protokół Prawdy: Wyświetlanie liczby przeanalizowanych źródeł (review_count) oraz bezpośrednie cytaty-wyciągi z Reddit, Amazon i lokalnych rynków.
• Werdykt (Główna część): Ostateczna rekomendacja (w trybie porównania AI wyraźnie wskazuje zwycięzcę lub jego brak i dlaczego).

5. Dodatkowa funkcjonalność (Użyteczność)

• Historia skanowania: Przechowywanie historii wszystkich skanów (dostępne tylko dla zarejestrowanych użytkowników).
• Ulubione: Lista "ulubionych" produktów dla szybkiego dostępu.
• Ręczne wyszukiwanie: Wyszukiwanie tekstowe (jeśli kamera nie rozpoznała marki lub etykieta jest uszkodzona).
• Opinie: Możliwość zgłoszenia błędnych danych do dalszego uczenia systemu.

6. Stos technologiczny (Wymagania Backend)

• Framework: FastAPI (Python), asynchroniczna praca z API Gemini.
• Baza danych: Supabase lub PostgreSQL (przechowywanie profili, limitów skanów i historii).
• Integracja AI:
  • Wejście: image_bytes, location, user_tags.
  • Wyjście: Ustrukturyzowany JSON do natychmiastowego budowania tabel i kart na frontendzie.