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

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

• Гостевой режим (Бесплатный вход):
  • Пользователь может начать пользоваться приложением без регистрации.
  • Лимит: 10 бесплатных сканирований на устройство (ID устройства).
  • Цель: Показать ценность "Shazam для продуктов" мгновенно.
• Регистрация и Подписка:
  • После 10 сканирований — обязательная регистрация (Google/Apple/Email).
  • Предложение: 1 месяц бесплатно при оформлении подписки.
• Ценовые планы (Годовая оплата):
  • Стартовый план: Бесплатно (лимит: до 10 сканирований в месяц).
  • Базовый план: $49.99 / год (лимит: до 1000 сканирований в месяц).
  • Премиум план: $99.99 / год (лимит: до 5000 сканирований в месяц).

2. Онбординг и Персонализация

• Настройка ограничений (User Tags):
• Пользователь выбирает (просто тапает по тегам) критически важные для него параметры (на английском для AI):
  • Еда: Gluten-free, Lactose-free, Nuts, Eggs, Seafood, Vegan, Sugar-free.
  • Уход и Дом: 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):
  • Модель: 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)

• История сканирований: Хранение истории всех сканирований (доступно только зарегистрированным юзерам).
• Избранное: Список "избранных" товаров для быстрого доступа.
• Ручной поиск: Текстовый поиск (если камера не распознала бренд или этикетка повреждена).
• Обратная связь: Возможность пожаловаться на неверные данные для дообучения системы.

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

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