📋 Описание
Этот Telegram бот предназначен для автоматизации процесса записи клиентов на услуги маникюра, педикюра и прочих сфер бьюти индустрии. Бот предоставляет удобный интерфейс для просмотра расписания, записи на свободные слоты и получения информации об услугах.
🚀 Основные функции
Для клиентов:
📅 Просмотр расписания - выбор месяца и дня для записи
⏰ Выбор времени - бронирование конкретного временного слота
✅ Подтверждение записи - финальное подтверждение выбранного времени
❓ Задать вопрос - возможность отправить вопрос администратору
📸 Портфолио - просмотр примеров работ
ℹ️ Информация об услугах - подробная информация о вашей деятельности
💰 Цены и оплата - информация о стоимости услуг
🛡️ Безопасность - информация о мерах безопасности
Для администраторов:
📊 Статистика - просмотр активности пользователей
⚙️ Управление расписанием - включение/выключение записи
📝 Получение вопросов - все вопросы клиентов приходят в специальный канал
📅 Уведомления о записях - новые записи приходят в канал с контактной информацией
🎯 Как работает бот
1. Приветствие и главное меню
При первом запуске бота (/start) пользователь видит приветственное сообщение с главным меню, содержащим все доступные разделы.
2. Система записи
1. Выбор месяца - пользователь выбирает месяц из доступных
2. Выбор дня - отображаются только дни с доступными слотами
3. Выбор времени - показываются свободные временные слоты
4. Подтверждение - финальное подтверждение записи
5. Успешная запись - подтверждение и уведомление администратора
3. Проверка дублирования записей
- Система автоматически проверяет наличие активных записей у пользователя
- Одна запись на пользователя (до завершения или истечения даты)
- Прошедшие записи не учитываются
4. Уведомления
- Все новые записи отправляются в канал администратора
- Вопросы клиентов также приходят в канал
- Информация о пользователе включает контактные данные
👥 Инструкции для пользователей
Как записаться на прием:
1. Запустите бота командой /start
2. Выберите "📅 Записаться" в главном меню
3. Выберите месяц из доступных вариантов
4. Выберите день (отображаются только дни с доступными слотами)
5. Выберите время из свободных слотов
6. Подтвердите запись нажатием кнопки "✅ Подтвердить"
Как задать вопрос:
1. Выберите "❓ Задать вопрос" в главном меню
2. Напишите ваш вопрос в следующем сообщении
3. Отправьте сообщение - вопрос будет передан администратору
Важные моменты:
- ⚠️ Username в профиле: Для более удобной обработки заказа рекомендуется установить username в вашем Telegram профиле
- 📅 Одна запись: У вас может быть только одна активная запись одновременно
- ⏰ Время записи: Слоты отображаются в хронологическом порядке
- 📱 Контактная информация: Администратор сможет связаться с вами для подтверждения записи
🔧 Инструкции для администраторов
Управление ботом:
Команды администратора:
- /stats - просмотр статистики использования бота
- /schedule_on - включить запись на услуги
- /schedule_off - выключить запись на услуги
- /schedule_status - проверить статус записи
Каналы уведомлений:
Канал записей - получает уведомления о новых записях:
📅 Новая запись
Пользователь: @username или [ID: 123456](tg://user?id=123456)
Дата: 2025-09-12
Время: 15:24
Канал вопросов - получает вопросы от клиентов:
❓ Вопрос от пользователя
Пользователь: @username или [ID: 123456](tg://user?id=123456)
Вопрос: Текст вопроса
Настройка расписания:
Расписание настраивается через веб-интерфейс администратора:
- Добавление дней и временных слотов
- Управление доступностью записи
- Просмотр статистики записей
Обработка записей:
1. Получите уведомление в канале записей
2. Свяжитесь с клиентом используя предоставленную информацию
3. Подтвердите запись или обсудите детали
4. Отметьте слот как занятый в административной панели
⚙️ Технические особенности
Система пользователей:
- Автоматическое создание профилей пользователей
- Сохранение состояния диалога
- Отслеживание последних сообщений для корректного удаления
Управление сообщениями:
- Автоматическое удаление предыдущих сообщений
- Поддержка медиа-групп (несколько фото)
- Корректная обработка различных типов контента
Безопасность:
- Проверка прав администратора
- Валидация входных данных
- Защита от дублирования записей
📁 Структура проекта
├── modules/ # Основные модули бота
│ ├── Bot.php # Главный класс бота
│ ├── Schedule.php # Управление расписанием
│ ├── User.php # Управление пользователями
│ ├── FAQ.php # Система вопросов и ответов
│ ├── Keyboard.php # Генерация клавиатур
│ └── Stats.php # Статистика
├── data/ # Данные бота
│ ├── users.json # Профили пользователей
│ ├── schedule.json # Расписание
│ ├── messages.json # Тексты сообщений
│ └── faq.json # FAQ контент
├── images/ # Изображения для бота
├── logs/ # Логи работы
└── admin/ # Административная панель
🔄 Обновления и улучшения
Последние изменения:
- ✅ Исправлено определение пользователей без @username
- ✅ Добавлена сортировка дат в хронологическом порядке
- ✅ Реализована проверка дублирования записей
- ✅ Улучшено отображение дат в формате день.месяц.год
- ✅ Добавлены русские названия месяцев
- ✅ Оптимизировано удаление сообщений
Планируемые улучшения:
- 📱 Мобильная версия административной панели
- 📊 Расширенная аналитика
- 🔔 Напоминания о записи
- 💳 Интеграция с платежными системами
📞 Поддержка
При возникновении проблем или вопросов:
1. Проверьте логи в папке logs/
2. Убедитесь в корректности настроек в config/
3. Проверьте права доступа к файлам данных
📝 Лицензия
Проект разработан для внутреннего использования салона красоты.
Запрещено передавать бота третьим лицам, в случае передачи сделка аннулируется и бот отключается навсегда.
---
Документация обновлена: 17.09.2025
Версия бота: 2.0
