FOXYGIFT
ANALYTICS STATION
Инструкция по установке v2.4
Art. № 8989-CLNT
Пошаговое руководство по сборке и запуску
Рабочее место аналитика подарочных карт FoxyGift POS. Просмотр выручки, Z-отчетов, остатков на картах и журнал транзакций без облачных подписок.
⏱ Время сборки: ~5 минут 💻 ОС: Windows 10 / 11
1. Комплектация поставки (Папка client_distribution)
setup_shortcuts.bat
Мастер ярлыков и автозагрузки (1 шт.)
run_client.bat
Скрипт прямого запуска (1 шт.)
client_analytics_dashboard.html
Веб-интерфейс аналитики (1 шт.)
🛠 Что потребуется для работы:
  • Компьютер / Ноутбук под управлением Windows 10 или Windows 11.
  • Браузер: Chrome, Edge, Firefox, Yandex или Opera.
  • Подключение к сети для приема отчетов из Telegram / Почты.
  • Токен Telegram-бота (или логин/пароль IMAP-ящика).
📁 Каталоги данных (создаются сами):
  • data/archive/ — архив всех входящих CSV отчетов кассы.
  • data/backups/ — резервные копии базы (JSON).
  • data/config.json — настройки соединения и токенов.
  • Важно: Все данные хранятся только локально на вашем ПК!
2. Важные правила установки (Сделайте / Не делайте)
✓
ПРАВИЛЬНО (РАСПАКУЙТЕ В ПАПКУ)
Перед запуском извлеките всю папку из архива в постоянное место (например, C:\FoxyGift\client_distribution).
✕
НЕ ДЕЛАЙТЕ (НЕ УДАЛЯЙТЕ DATA)
Не удаляйте папку data/ и не запускайте скрипты внутри временного архива .zip без распаковки.
FOXYGIFT POS • Руководство по сборке станции аналитики
1 / 4
FOXYGIFT
ШАГИ 01 – 02
Установка и автозагрузка
Art. № 8989-CLNT
01
Распаковка и размещение папки на компьютере
Выберите удобное постоянное место на диске C:\ или в документах пользователя.
.ZIP Архив Извлечь всё C:\FoxyGift\client_distribution\ setup_shortcuts.bat ← Запустить первым делом run_client.bat ← Ручной запуск станции client_analytics_dashboard.html data/
💡
Совет IKEA: Не храните рабочую папку на съемной USB-флешке! При случайном отключении флешки связь с кассовым сервером может временно прерваться. Разместите папку на внутреннем диске C:.
02
Создание ярлыка и автозагрузки (setup_shortcuts.bat)
Автоматическая настройка рабочего стола и фонового автозапуска Windows в один клик.
setup_shortcuts.bat Двойной клик мышкой 2x Командная строка FoxyGift [1] Ярлык на Рабочий стол [2] Автозапуск Windows [3] Всё сразу (1 + 2) ★ РЕКОМЕНДУЕТСЯ Выберите пункт [1-4]: 3 ↵ Нажмите [3], затем [Enter] РАБОЧИЙ СТОЛ FoxyGift Analytics
1. Запустите setup_shortcuts.bat двойным кликом.
2. Нажмите клавишу 3 и нажмите Enter.
3. Готово! Ярлык создан, а сервер добавлен в автозапуск.
FOXYGIFT POS • Руководство по сборке станции аналитики
2 / 4
FOXYGIFT
ШАГИ 03 – 04
Запуск и каналы связи
Art. № 8989-CLNT
03
Запуск аналитической панели в браузере
Двойной клик по ярлыку на Рабочем столе автоматически откроет дашборд.
FoxyGift Analytics 2x http://127.0.0.1:8989/ 📊 Обзор 💳 Карты 🧾 Транзакции 📑 Z-отчеты ⚙ Импорт & Настройки ОБОРОТ СМЕН +1 450.00 € СПИСАНИЯ ПО КАРТАМ -620.00 € АКТИВНЫЕ КАРТЫ 48 шт.
04
Подключение источника отчетов (Telegram или Email)
Перейдите во вкладку «Импорт» и укажите, откуда дашборд будет получать Z-отчеты.
КАНАЛ А Telegram Bot (Рекомендуется)
📱
  1. Создайте бота у @BotFather в Telegram и скопируйте Bot Token.
  2. В дашборде выберите радиокнопку ● Telegram Bot.
  3. Вставьте токен в поле Telegram Bot Token.
  4. Включите галочку ☑ Авто-синхронизация (каждые 60 сек).
  5. Нажмите «Проверить подключение» → появится зеленый статус «Подключено!».
  6. Нажмите кнопку «Сохранить настройки».
✓ Касса сама присылает Z-отчеты в бота после закрытия смены!
КАНАЛ Б Корпоративный Email (IMAP)
✉️
  1. В настройках дашборда выберите ● Email (IMAP).
  2. Укажите IMAP-сервер: например imap.yandex.ru (порт 993, SSL включен).
  3. Введите Логин ящика и Пароль приложения.
  4. Папка входящих: оставьте по умолчанию INBOX.
  5. Нажмите «Проверить связь» для валидации подключения.
  6. Нажмите «Сохранить настройки».
✓ Удобно для сетей с политикой внутренней почты.
⚠️
Важное правило IKEA: Выберите только один активный канал (Telegram ИЛИ Email). Выбранный канал подсвечивается синим цветом, а второй автоматически отключается для исключения дублирования отчетов.
FOXYGIFT POS • Руководство по сборке станции аналитики
3 / 4
FOXYGIFT
ШАГИ 05 – 06 & ЧЕКЛИСТ
Синхронизация и бэкапы
Art. № 8989-CLNT
05
Прием отчетов и CSV импорт
Каждый раз, когда кассир на Android POS закрывает смену (Z-отчет), файл автоматически летит в программу:
POS КАССА Z-отчет TG / MAIL ДАШБОРД data/archive/
Ручной импорт: Вы также можете перетащить файл ZReport_*.csv прямо мышкой в пунктирную зону на вкладке «Импорт».
06
Резервные копии базы
Все данные карт и смен надежно защищены на вашем компьютере:
📥 Бэкап
Нажмите кнопку со стрелочкой в правом верхнем углу дашборда. Файл сохранится в папку data/backups/.
Восстановление: Если вы переустановили систему, нажмите «Импорт из бэкапа» на вкладке «Импорт» и выберите сохраненный JSON-файл.
? IKEA Чеклист: Решение возможных вопросов
Простые решения за 1 минуту
❌ «Не удается открыть сайт 127.0.0.1:8989»
Решение: Сервер выключен. Запустите ярлык FoxyGift Analytics на Рабочем столе (или файл run_client.bat). Черное окно консоли закрывать не нужно!
⚠️ «Новые Z-отчеты не появляются»
Решение: Откройте вкладку «Импорт» → проверьте Bot Token → нажмите «Проверить подключение». Убедитесь, что галочка «Авто-синхронизация» включена.
🔄 «Как перенести на другой компьютер?»
Решение: Скопируйте всю папку client_distribution на флешку и перенесите на новый ПК. Запустите setup_shortcuts.bat — все отчеты останутся на месте!
🦊
Сборка завершена успешно!
Ваша станция аналитики готова к ежедневному учету подарочных карт и выручки.
Поддержка: support@foxygift.com
Веб-сайт: www.foxygift.com
FOXYGIFT POS • Руководство по сборке станции аналитики
4 / 4