Опис функціоналу та архітектури 

1. Доступ та Монетизація (The Funnel)

• Guest Mode (Free Entry):
  • Користувач може почати користуватися додатком без реєстрації.
  • Ліміт: 10 безкоштовних сканувань на пристрій (ID пристрою).
  • Мета: Показати цінність "Shazam для продуктів" миттєво.
• Registration & Subscription:
  • Після 10 сканувань — обов'язкова реєстрація (Google/Apple/Email).
  • Пропозиція: 1 місяць безкоштовно при оформленні підписки.
• Pricing Plans (Річна оплата):
  • Starter Plan: Free (ліміт: до 10 сканувань на місяць).
  • Basic Plan: $49.99 / рік (ліміт: до 1000 сканувань на місяць).
  • Premium Plan: $99.99 / рік (ліміт: до 5000 сканувань на місяць).

2. Onboarding та Персоналізація

• Налаштування обмежень (User Tags):
• Користувач обирає (просто тапає по тегам) критичні для нього параметри (англійською для AI):
  • Food: Gluten-free, Lactose-free, Nuts, Eggs, Seafood, Vegan, Sugar-free.
  • Care & Home: Fragrance-free, Sulfate/Paraben-free, Sensitive Skin, Cruelty-free.
• Локація: Запит доступу до GPS для Grounding (пошук цін та відгуків у конкретній країні/місті).

3. Core Loop (Цикл сканування)

• Процес зйомки:
  1. Юзер робить фото 1 товару. (або ж додає з галереї)
  2. Кнопки: "Analyze" (якщо товар один) або "+ Add product to compare" (якщо хоче порівняти).
  3. При порівнянні юзер робить окремі фото 2-го та 3-го товару. Аналіз відбувається асинхронно для пришвидшення
• AI Backend (The Engine):
  • Model: Gemini 2.5 Flash (Temp = 0.0).
  • Grounding: Обов'язковий Google Search Retrieval з урахуванням локації юзера.
  • Mode Detection: AI отримує масив фото. Якщо фото одне — режим Product Passport. Якщо 2-3 — режим Comparison Matrix.

4. Результати аналізу (UI/UX)

• Відображаються фото товарів з ціною в локальних мережах
• Traffic Light System: Візуальні кольорові коди (Зелений/Жовтий/Червоний).
• Why NOT to Buy: Ключовий блок. AI фокусується на негативних аспектах: завищена ціна, шкідливі додатки, поганий споживчий рейтинг.
• Truth Protocol: Відображення кількості проаналізованих джерел (review_count) та прямі цитати-витяги з Reddit, Amazon та локальних маркетплейсів.
• Verdict (Основна частина): Фінальна рекомендація (у режимі порівняння AI чітко вказує переможця або його відсутність і чому).

5. Додатковий функціонал (Utility)

• Scan History: Зберігання історії всіх сканувань (доступно лише зареєстрованим юзерам).
• Favorites: Список "обраних" товарів для швидкого доступу.
• Manual Search: Текстовий пошук (якщо камера не розпізнала бренд або етикетка пошкоджена).
• Feedback: Можливість поскаржитися на невірні дані для донавчання системи.

6. Технічний стек (Backend Requirements)

• Framework: FastAPI (Python), асинхронна робота з Gemini API.
• Database: Supabase або PostgreSQL (зберігання профілів, лімітів сканувань та історії).
• AI Integration:
  • Вхід: image_bytes, location, user_tags.
  • Вихід: Структурований JSON для миттєвої побудови таблиць та карток на фронтенді.