✅ АВТОМАТИЧЕСКОЕ СОЗДАНИЕ ПАПОК И ФАЙЛОВ
==========================================

🎉 ХОРОШАЯ НОВОСТЬ!

Система аналитики теперь АВТОМАТИЧЕСКИ создает все необходимые
папки и файлы при первом использовании.

Вам НЕ НУЖНО ничего создавать вручную!


📦 ЧТО СОЗДАЕТСЯ АВТОМАТИЧЕСКИ:
-------------------------------

При первом запуске автоматически создаются:

1. analytics/                  # Главная папка
2. analytics/months/           # Папка для данных по месяцам
3. analytics/queue.json        # Очередь событий
4. analytics/lock.txt          # Файл блокировки

При сохранении данных:

5. analytics/months/2025-12.json  # Файл текущего месяца
6. analytics/months/2026-01.json  # Следующие месяцы...


⚡ КАК ЭТО РАБОТАЕТ:
-------------------

Функция analytics_init() вызывается автоматически при:

1. Добавлении события (analytics_queue_event)
2. Обработке очереди (analytics_process_queue)
3. Сохранении события (analytics_save_event)
4. Получении списка месяцев (analytics_get_available_months)

Вы просто используете бота - система сама создаст всё необходимое!


🧪 ТЕСТИРОВАНИЕ:
---------------

Чтобы проверить автосоздание, запустите:

```bash
php test_init.php
```

Этот скрипт:
1. Проверит начальное состояние
2. Загрузит модуль analytics.php
3. Вызовет функцию (триггер инициализации)
4. Проверит, что всё создалось
5. Добавит тестовое событие
6. Покажет созданную структуру


📋 ПРИМЕР ВЫВОДА test_init.php:
-------------------------------

✅ СОЗДАНО - analytics/
✅ СОЗДАНО - analytics/months/
✅ СОЗДАНО - analytics/queue.json
✅ СОЗДАНО - analytics/lock.txt
✅ Файл 2025-12.json создан
✅ ТЕСТ ПРОЙДЕН УСПЕШНО!


🚀 БЫСТРЫЙ СТАРТ:
----------------

Вариант 1 - Сразу с тестовыми данными:
```bash
php test_analytics.php
# Откройте analytics_dashboard.html
```

Вариант 2 - Сначала проверка автосоздания:
```bash
php test_init.php
php test_analytics.php
# Откройте analytics_dashboard.html
```

Вариант 3 - Сразу работа с ботом:
# Просто используйте бота - всё создастся автоматически!


⚠️ ЕСЛИ ЧТО-ТО НЕ РАБОТАЕТ:
---------------------------

1. Проверьте права доступа:
   chmod 755 /путь/к/папке/tg/
   (PHP должен иметь право создавать файлы)

2. Проверьте логи PHP:
   tail -f /var/log/php_errors.log
   (там будут сообщения "Analytics: Created directory...")

3. Запустите проверку:
   php check_analytics.php

4. Создайте папку вручную (если всё остальное не помогло):
   mkdir analytics
   mkdir analytics/months
   chmod 755 analytics
   chmod 755 analytics/months


💡 ТЕХНИЧЕСКИЕ ДЕТАЛИ:
---------------------

1. Функция analytics_init() использует static переменную
   для однократной инициализации

2. Проверка существования папок/файлов перед созданием
   (можно запускать многократно)

3. Логирование всех действий через error_log()

4. Безопасное создание с правами 0755

5. Автоматическое создание пустых файлов:
   - queue.json = []
   - lock.txt = пустой файл


✅ ГОТОВО!
---------

Всё настроено и работает автоматически!

Просто используйте бота или запустите:
php test_analytics.php

И всё создастся само!