Admin panel for Telegram bot

Технічне завдання (ТЗ) для адмін-панелі Telegram-бота з реферальною системою та перенаправленням на покерний додаток може включати такі розділи:

1. Мета проєкту

Створити адмін-панель для керування Telegram-ботом, який забезпечує:

 • управління користувачами;
 • реферальну систему для відстеження нових користувачів за запрошеннями;
 • перенаправлення користувачів на покерний додаток через бот.

2. Функціонал адмін-панелі

2.1 Аутентифікація та авторизація

• Логін/логін через Telegram: Аутентифікація адміністратора через облікові дані або через обліковий запис Telegram.
• Ролі користувачів: Можливість призначення різних рівнів доступу (наприклад, адміністратор, модератор).

2.2 Управління користувачами

• Перегляд списку користувачів: Таблиця з фільтрами (наприклад, за реферальним кодом, датою реєстрації, статусом).
• Деталі користувача: Ім’я, ID, реферальний код, дата приєднання, стан (активний/заблокований).
• Редагування: Можливість блокування/розблокування користувачів, зміна їхнього статусу.

2.3 Реферальна система

• Генерація реферальних посилань: Створення унікальних посилань для залучення нових користувачів.
• Аналітика реферальних посилань:
 • Загальна кількість переходів за посиланням.
 • Кількість нових зареєстрованих користувачів.
 • Відсоток конверсії (перехід → реєстрація).
• Статистика по рефералах: Відображення рейтингу найбільш активних користувачів, які запросили найбільше нових учасників.

2.4 Перенаправлення на покерний додаток

• Налаштування посилань: Можливість встановлення актуального посилання для перенаправлення на покерний додаток (наприклад, посилання на мобільну версію або окреме для iOS та Android).
• API для взаємодії з ботом: Можливість інтеграції з Telegram-ботом для автоматичного перенаправлення користувача після натискання певної кнопки.

2.5 Звіти та аналітика

• Аналітика користувачів: Графіки для відображення кількості реєстрацій за тиждень/місяць, активність користувачів, статистика по запрошеннях.
• Реферальна аналітика: Відстеження загальної кількості реєстрацій за кожним реферальним кодом.

3. Технічні вимоги

3.1 Система керування даними

• База даних: Реляційна база (PostgreSQL або MySQL) для зберігання користувачів, реферальних даних, логів активності.
• ORM: Використання SQLAlchemy (Flask) або Django ORM для роботи з базою даних.

3.2 Фреймворк та архітектура

• Backend: Flask або Django для серверної частини.
• Frontend: Використання шаблонів Jinja2 (для Flask) або вбудованих шаблонів (для Django); CSS-фреймворк (Bootstrap, Tailwind CSS) для адаптивності.
• Telegram API: Використання python-telegram-bot або альтернативної бібліотеки для інтеграції з Telegram-ботом.

3.3 Безпека

• Аутентифікація: JWT-токени або сесії.
• Захист API: Обмеження за кількістю запитів, захист від SQL-ін’єкцій та XSS-атак.
• Шифрування: Використання HTTPS для захищеного обміну даними.

4. Інтеграція з Telegram

 • Використання Telegram API для відправки повідомлень, обробки команд, надання реферального посилання через бот.
 • Відстеження дій користувачів через бот: переходи за реферальними посиланнями, перенаправлення до покерного додатка через команду в боті.

5. UI/UX дизайн

• Дизайн інтерфейсу: Простий і зручний для адміністраторів та модераторів.
• Адаптивність: Адаптація під різні пристрої (десктопи, планшети).

6. Тестування

• Юніт-тести для backend.
• Інтеграційні тести для Telegram-бота та перенаправлення на покерний додаток.
• Перевірка безпеки: тестування на XSS, CSRF, SQL-ін’єкції.

Приклад таблиць у базі даних

Таблиця Users

Поле Тип Опис
id INT Унікальний ідентифікатор
username VARCHAR(50) Ім’я користувача в Telegram
telegram_id INT Telegram ID
referral_id INT ID користувача, що запросив
joined_date TIMESTAMP Дата приєднання
status BOOLEAN Статус (активний/заблокований)

Таблиця Referrals

Поле Тип Опис
id INT Унікальний ідентифікатор
referrer_id INT ID користувача, що запросив
referred_id INT ID запрошеного користувача
referral_code VARCHAR(10) Унікальний код для відстеження рефералів > Олексій: Додавання функціоналу переписок в адмін-панель дозволить адміністраторам спілкуватися з користувачами бота через Telegram. Це може бути корисно для підтримки користувачів, вирішення питань, або надання додаткових інструкцій.

1. Функціонал переписок

1.1 Інтерфейс для переписок

• Список діалогів: Панель із переліком всіх активних переписок, упорядкованих за датою останнього повідомлення.
• Вибір діалогу: Можливість вибору конкретного користувача для перегляду історії переписки.
• Історія переписки: Відображення повідомлень у форматі “чат”, з розподілом на повідомлення від адміністратора та користувача.
• Поле для вводу тексту: Поле, де адміністратор може вводити нові повідомлення для відповіді користувачу.

1.2 Функціонал сповіщень

• Сповіщення про нові повідомлення: Відображення індикатора при новому повідомленні від користувача.
• Фільтрація: Сортування діалогів за непрочитаними повідомленнями для швидкого доступу до нових звернень.

1.3 Пошук за переписками

• Пошук по імені користувача або ID: Дозволяє швидко знайти певну переписку за Telegram ID або іменем користувача.
• Фільтрація за статусом переписки: Наприклад, “Відкриті”, “Закриті”, “Нові”.

2. Додаткові можливості

2.1 Шаблони відповідей

• Збережені відповіді: Набір часто використовуваних шаблонів відповідей, які адміністратор може вибрати для швидкого реагування на стандартні запити.

2.2 Можливість блокування користувача з чату

• Блокування користувача: Кнопка для блокування користувача прямо з переписки, якщо користувач порушує правила.

2.3 Записи історії

• Логи повідомлень: Зберігання всіх повідомлень у базі даних для подальшого аналізу або розв’язання спірних ситуацій.

3. Реалізація функціоналу переписок

3.1 Структура бази даних

 • Таблиця Messages для зберігання історії переписок.

Таблиця Messages

Поле Тип Опис
id INT Унікальний ідентифікатор
user_id INT ID користувача
sender VARCHAR(10) Відправник повідомлення (адмін/користувач)
content TEXT Текст повідомлення
timestamp TIMESTAMP Дата та час повідомлення
status BOOLEAN Статус (прочитано/непрочитано)

3.2 Функціонал обробки повідомлень

• Отримання повідомлень: Використовуйте Telegram API для отримання повідомлень від користувачів.
• Відправка повідомлень: Надсилайте відповіді адміністратора через Telegram API.

3.3 Створення інтерфейсу переписки

• Backend: Реалізуйте обробку запитів для отримання/відправлення повідомлень.
• Frontend: Створіть інтерфейс чату на основі JavaScript/AJAX або WebSocket для автоматичного оновлення переписки в реальному часі.

4. Технічні вимоги

• WebSocket або Long Polling: Для автоматичного оновлення чату без перезавантаження сторінки.
• Автоматичне збереження повідомлень: Збереження повідомлень у таблиці Messages.
• Фільтри безпеки: Валидація вхідних даних для захисту від XSS і SQL-ін’єкцій.

5. Можливий сценарій використання

 1. Користувач звертається до бота із запитанням або коментарем.
 2. Адміністратор отримує сповіщення про нове повідомлення в адмін-панелі.
 3. Адміністратор переглядає переписку, відповідає на запит або використовує шаблонну відповідь.
 4. Якщо користувач порушує правила, адміністратор може заблокувати його через інтерфейс чату.

Це забезпечить повний цикл спілкування адміністратора з користувачами, полегшуючи підтримку і модерування Telegram-бота. > Олексій: Щоб додати нарахування бонусів за запрошеного реферала, можна доповнити функціонал адмін-панелі наступним чином:

1. Функціонал нарахування бонусів

1.1 Автоматичне нарахування бонусів

• Бонус за реєстрацію реферала: Автоматичне нарахування бонусу рефереру (користувачу, який запросив нового учасника), коли новий користувач приєднується за реферальним посиланням.
• Бонус за активність реферала: Додатковий бонус для реферера, якщо запрошений користувач досягає певних активностей (наприклад, грає певну кількість ігор).

1.2 Відображення бонусів в адмін-панелі

• Баланс бонусів користувача: В адмін-панелі додати інформацію про баланс бонусів для кожного користувача.
• Історія бонусів: Перегляд історії нарахувань бонусів (хто запросив реферала, який бонус нараховано, за яку активність).

2. Структура бази даних для бонусів

Таблиця Bonuses

Поле Тип Опис
id INT Унікальний ідентифікатор
user_id INT ID користувача, який отримав бонус
referrer_id INT ID користувача, який запросив реферала
amount DECIMAL(10,2) Сума бонусу
type VARCHAR(50) Тип бонусу (за реєстрацію, за активність)
timestamp TIMESTAMP Дата та час нарахування бонусу
description TEXT Опис причини нарахування бонусу

Додавання поля bonus_balance до таблиці Users

 • Поле для зберігання поточного балансу бонусів у користувача.

3. Логіка нарахування бонусів

3.1 Нарахування бонусів при реєстрації реферала

 • Після реєстрації нового користувача за реферальним посиланням викликається функція, що:
 • Перевіряє, чи був цей користувач запрошений іншим користувачем.
 • Додає запис в таблицю Bonuses з інформацією про бонус.
 • Збільшує баланс бонусів реферера (bonus_balance у таблиці Users).

3.2 Нарахування бонусів за активність реферала

 • Перевірка активності реферала (наприклад, по завершенню певної кількості ігор):
 • Якщо умови виконані, викликається функція нарахування бонусу.
 • Додає відповідний запис у таблицю Bonuses та оновлює баланс.

4. Відображення та управління бонусами в адмін-панелі

4.1 Інтерфейс для перегляду бонусів

• Список бонусів: Відображення всіх нарахованих бонусів для вибраного користувача з фільтрами за типом бонусу, датою, сумою.
• Фільтрація за типом бонусу: Адміністратори можуть вибрати бонуси за реєстрацію, активність або інші.

4.2 Коригування бонусів

• Редагування балансу: Можливість вручну коригувати баланс бонусів користувача (наприклад, при необхідності виправлення помилки або видалення бонусу).

5. Сповіщення користувача про нарахування бонусу

• Telegram-сповіщення: При нарахуванні бонусу бот надсилає користувачу повідомлення із сумою нарахованого бонусу та його новим балансом.
• Історія бонусів у боті: Можливість для користувача запросити свій баланс бонусів та переглянути останні нарахування через команду в боті.



7. Тестування та верифікація

• Перевірка коректності нарахування бонусів: Юніт-тести для перевірки правильного нарахування бонусів при різних діях.
• Перевірка повідомлень: Перевірка правильного відображення повідомлень у боті для користувача після нарахування бонусу.