═══════════════════════════════════════════════════════════════════
    📊 АНАЛИТИКА AI-КАЛОРИЯ БОТА - ИНСТРУКЦИЯ НА РУССКОМ
═══════════════════════════════════════════════════════════════════

🚀 3 СПОСОБА ПОСМОТРЕТЬ АНАЛИТИКУ:

┌────────────────────────────────────────────────────────────────┐
│ 1️⃣  КОНСОЛЬ (самый быстрый)                                    │
└────────────────────────────────────────────────────────────────┘

python3 analytics.py --days 30

Покажет в терминале:
✓ Сколько пользователей
✓ Сколько записей
✓ Топ пользователей
✓ Топ продуктов
✓ График активности


┌────────────────────────────────────────────────────────────────┐
│ 2️⃣  ВЕБ-ИНТЕРФЕЙС (самый красивый)                             │
└────────────────────────────────────────────────────────────────┘

# Установить Flask (один раз):
pip3 install Flask

# Запустить:
./start_analytics_web.sh

# Открыть в браузере:
http://localhost:5001

Покажет:
✓ Интерактивные графики
✓ Красивый дизайн
✓ Можно менять период (7-365 дней)


┌────────────────────────────────────────────────────────────────┐
│ 3️⃣  ЭКСПОРТ В EXCEL (для отчетов)                              │
└────────────────────────────────────────────────────────────────┘

# Все записи:
python3 export_to_csv.py --all

# Конкретный пользователь:
python3 export_to_csv.py --user 23916354

# Сводка по дням:
python3 export_to_csv.py --daily

Создаст CSV файл, который можно открыть в Excel


═══════════════════════════════════════════════════════════════════
📊 ЧТО МОЖНО УЗНАТЬ:
═══════════════════════════════════════════════════════════════════

👥 О ПОЛЬЗОВАТЕЛЯХ:
   • Сколько всего пользователей
   • Кто самый активный
   • Сколько новых/возвращающихся

📝 О ЗАПИСЯХ:
   • Сколько всего записей
   • Активность по дням
   • Активность по часам

🔥 О КАЛОРИЯХ:
   • Общая сумма калорий
   • Средние калории на запись
   • Калории по дням

🍽️  О ПРОДУКТАХ:
   • Топ-20 популярных продуктов
   • Сколько раз добавляли
   • Средняя калорийность


═══════════════════════════════════════════════════════════════════
🔧 ДОБАВИТЬ В БОТА:
═══════════════════════════════════════════════════════════════════

Можно добавить команды прямо в Telegram бота:

/stats - Моя статистика
/globalstats - Общая статистика (для админов)
/top - Топ продуктов

Как добавить:
1. Открыть файл: bot_analytics_integration.py
2. Скопировать код в telegram_bot.py
3. Перезапустить бота


═══════════════════════════════════════════════════════════════════
📅 АВТОМАТИЧЕСКИЕ ОТЧЕТЫ:
═══════════════════════════════════════════════════════════════════

Можно настроить автоматическую отправку отчетов каждую неделю:

crontab -e

Добавить строку:
0 9 * * 1 cd /var/www/u0236315/data/www/consultsolution.ru/ai-calories-app && python3 analytics.py --days 7 --save

Будет создавать отчет каждый понедельник в 9:00


═══════════════════════════════════════════════════════════════════
💡 ПРИМЕРЫ КОМАНД:
═══════════════════════════════════════════════════════════════════

# Посмотреть за неделю:
python3 analytics.py --days 7

# Посмотреть за месяц:
python3 analytics.py --days 30

# Посмотреть за год:
python3 analytics.py --days 365

# Сохранить в файл:
python3 analytics.py --days 30 --save

# Сохранить с именем:
python3 analytics.py --days 30 --save --output отчет_октябрь.json

# Экспорт всех данных в Excel:
python3 export_to_csv.py --all --output все_данные.csv


═══════════════════════════════════════════════════════════════════
🆘 ПОМОЩЬ:
═══════════════════════════════════════════════════════════════════

Ошибка "No module named 'flask'":
→ pip3 install Flask

Ошибка "No such file or directory":
→ cd /var/www/u0236315/data/www/consultsolution.ru/ai-calories-app

Порт занят:
→ kill $(lsof -t -i:5001)

Нет данных:
→ Проверьте, что бот работает и есть записи


═══════════════════════════════════════════════════════════════════
📚 ДОКУМЕНТАЦИЯ:
═══════════════════════════════════════════════════════════════════

ANALYTICS_SUMMARY.md     - Краткий обзор (на русском)
QUICKSTART_ANALYTICS.md  - Быстрый старт
ANALYTICS.md             - Полная документация
README.md                - Общая информация


═══════════════════════════════════════════════════════════════════
✅ БЫСТРЫЙ СТАРТ ПРЯМО СЕЙЧАС:
═══════════════════════════════════════════════════════════════════

1. Откройте терминал
2. Выполните:
   
   cd /var/www/u0236315/data/www/consultsolution.ru/ai-calories-app
   python3 analytics.py --days 30

3. Готово! Увидите всю статистику

Для веб-интерфейса:

   pip3 install Flask
   ./start_analytics_web.sh
   
   Откройте браузер: http://localhost:5001


═══════════════════════════════════════════════════════════════════
🎉 Всё готово к использованию!
═══════════════════════════════════════════════════════════════════