Telegram Feedback Bot 🤖

Change language: English

---

🌟 Особенности

👤 Для пользователей 🌐 Поддержка мультиязычности (русский и английский) 📩 Отправка сообщений администратору трёх типов: 💡 Предложение 🚫 Жалоба 💬 Сообщение ⏳ Одно активное сообщение (новое можно отправить только после ответа)

👨‍💻 Для администратора 🌐 Поддержка мультиязычности (русский и английский) 🔔 Просмотр неотвеченных сообщений ✉️ Ответ на конкретные сообщения 📜 Просмотр полной истории переписки с пагинацией

---

🛠 Технологии

Компонент	Версия	Описание	Бейдж
Python	3.10+	Основной язык разработки
python-telegram-bot	20.0+	API для работы с Telegram
SQLite3	-	Хранение данных
Logging	-	Стандартный модуль логирования
Архитектура	-	Полностью асинхронная

---

🔐 Установка и настройка

📋 Требования

Требование	Описание	Бейдж
Python	Версия 3.10 или новее
Telegram	Аккаунт Telegram
BotFather	Созданный бот через @BotFather

🔍 Получение Telegram ID

1. Найдите бота @userinfobot в Telegram
2. Отправьте ему команду /start
3. Бот ответит вам сообщением с вашим ID (это число вида 123456789)

🔑 Получение токена бота

1. Откройте @BotFather в Telegram
2. Используйте команду /newbot для создания нового бота
3. После создания получите токен (выглядит как 123456:ABC-DEF1234ghIkl-zyx57W2v1u123ew11)

⚙️ Настройка конфигурации

Откройте файл config.py и замените следующие значения в начале файла:

# Ваш персональный ID администратора (полученный от @userinfobot)
YOUR_CHAT_ID = '!!!⚠️ your chat id ⚠️!!!'  # Замените на ваш ID

# Токен вашего бота (полученный от @BotFather)
TELEGRAM_BOT_TOKEN = '!!!⚠️ your bot token ⚠️!!!'  # Замените на токен бота

📦 Установка зависимостей

pip install -r requirements.txt

🚀 Запуск бота

python main.py

---

📋 Структура проекта

telegram-feedback-bot/
├── bot/
│   ├── config.py         # Конфигурация и локализация
│   ├── database.py       # Модели и работа с БД
│   ├── handlers.py       # Обработчики сообщений
│   ├── keyboards.py      # Генерация клавиатур
│   └── main.py           # Главный исполняемый файл
├── .gitignore            # Игнорируемые файлы для Git
├── bot.log               # Файл логов (создается автоматически)
├── feedback_bot.db       # База данных (создается автоматически)
├── LICENSE               # Лицензия проекта
├── README.md             # Документация на английском
├── README.ru.md          # Документация на русском
└── requirements.txt      # Зависимости

---

💡 Советы:

• 📊 Все сообщения сохраняются в БД, даже после перезапуска бота
• 🔍 Для просмотра логов проверьте файл bot.log
• ⚡ Файл БД и логов создаются автоматически при первом запуске

⚠️ Важное примечание

Этот проект был разработан начинающим программистом-самоучкой. Код может содержать:

• ❌ Ошибки и баги
• ⚡ Неоптимальные решения
• 🛡️ Недочёты в архитектуре

---

📩 Контакты

Я открыт для конструктивной критики и предложений по улучшению кода. Если вы нашли ошибку или знаете, как сделать что-то лучше - пожалуйста, свяжитесь со мной!