﻿================================================================================
   FOXYGIFT ANALYTICS DASHBOARD — ИНСТРУКЦИЯ ПО УСТАНОВКЕ И НАСТРОЙКЕ
================================================================================

📌 ВНИМАНИЕ: Для наглядной иллюстрированной инструкции в стиле IKEA
откройте файл:
   FoxyGift_Installation_Guide_IKEA.pdf
или
   client_manual_ikea.html (в любом браузере)

--------------------------------------------------------------------------------
1. ЧТО ЭТО ТАКОЕ?
--------------------------------------------------------------------------------
FoxyGift Analytics Dashboard — это локальный аналитический центр для владельца
бизнеса. Он принимает Z-отчеты с кассовых POS-терминалов FoxyGift через
Telegram-бота или Email (IMAP), сохраняет историю смен, строит графики выручки,
отслеживает балансы подарочных карт и позволяет печатать официальные аудиторские
отчеты.

Работает полностью автономно на вашем компьютере под Windows.
Интерфейс открывается в любом современном браузере (Chrome, Edge, Opera, Firefox).

--------------------------------------------------------------------------------
2. БЫСТРЫЙ СТАРТ В 3 ШАГА
--------------------------------------------------------------------------------

ШАГ 1: РАСПАКОВКА
Распакуйте архив в удобную постоянную папку, например:
   C:\FoxyGift_Analytics\
(Не запускайте прямо из архиватора ZIP!).

ШАГ 2: СОЗДАНИЕ ЯРЛЫКОВ
Запустите файл:
   setup_shortcuts.bat
Он автоматически создаст на вашем Рабочем столе два ярлыка:
   • "FoxyGift Analytics" — запуск панели управления с окном консоли
   • "FoxyGift Analytics (Фоновый режим)" — бесшумный запуск без черного окна

ШАГ 3: ПЕРВЫЙ ЗАПУСК
Дважды кликните по ярлыку "FoxyGift Analytics" на Рабочем столе.
В окне консоли выберите режим запуска:
   [1] Стандартный (консольное окно)
   [2] Фоновый (без окна)
   [3] Автозапуск с Windows (рекомендуется для постоянного приема отчетов!)
Браузер откроется автоматически по адресу:
   http://127.0.0.1:8989/client_analytics_dashboard.html

--------------------------------------------------------------------------------
3. НАСТРОЙКА КАНАЛА ПРИЕМА ДАННЫХ
--------------------------------------------------------------------------------
В панели дашборда перейдите на вкладку «⚙️ Настройки» (Settings):

ВАРИАНТ А: TELEGRAM БОТ (Рекомендуется)
1. Создайте бота через @BotFather в Telegram и скопируйте Bot Token.
2. Введите Bot Token в поле «Telegram Bot Token» и нажмите «Проверить».
3. Введите Chat ID администратора (куда терминалы отправляют Z-отчеты).
4. Включите переключатель «Автоматический опрос» (Auto-sync).
5. Нажмите «Сохранить настройки».

ВАРИАНТ Б: EMAIL (IMAP)
Если кассы отправляют Z-отчеты по почте:
1. Заполните адрес IMAP-сервера (например, imap.gmail.com), порт 993 (SSL).
2. Укажите логин и пароль приложения (App Password).
3. Нажмите «Проверить подключение» и сохраните настройки.

ВАРИАНТ В: РУЧНАЯ ЗАГРУЗКА CSV
Вы можете просто перетащить файл Z-отчета (.csv) мышью прямо в окно дашборда
на вкладку «📥 Импорт / Z-отчеты».

--------------------------------------------------------------------------------
4. РЕЗЕРВНОЕ КОПИРОВАНИЕ
--------------------------------------------------------------------------------
На вкладке «⚙️ Настройки» доступна кнопка «💾 Скачать резервную копию».
Рекомендуется периодически сохранять архив базы данных на внешний диск
или в облачное хранилище.

--------------------------------------------------------------------------------
5. ТЕХНИЧЕСКАЯ ПОДДЕРЖКА
--------------------------------------------------------------------------------
При возникновении вопросов или необходимости консультации обращайтесь к вашей
обслуживающей организации FoxyGift.
================================================================================
