Initial commit: VK Sales Bot project structure

docs/user_guide.md

@@ -0,0 +1,22 @@
+# Руководство оператора "Сотрудник первой линии"
+
+## Быстрый старт
+1. Убедитесь, что установлен Python 3.11+ и все зависимости (`pip install -r requirements.txt`).
+2. Скопируйте `.env.example` в `.env` и укажите токен группы VK.
+3. Запустите бота: `python main.py`
+4. Проверьте статус: напишите боту `/status` (только для администраторов, указанных в ADMIN_IDS).
+
+## Управление
+- `/status` – проверить, работает ли бот.
+- `/export` – создать копию файла лидов с меткой времени.
+- `/backup` – вручную создать резервную копию.
+- `/stats` – показать статистику (всего лидов, за сегодня, по статусам).
+- `/reload` – перезагрузить текстовые фразы без перезапуска.
+
+## Просмотр данных
+Файл с лидами находится в `data/leads.xlsx`. Резервные копии – в `data/backups/`.
+
+## Решение проблем
+- Бот не отвечает: проверьте токен и права доступа группы (нужны `messages` и `groups`).
+- Ошибка записи в файл: убедитесь, что папка `data` существует и доступна для записи.
+- Бот не видит сообщения: группа должна быть публичной или добавьте бота в беседу.