Telegram-бот «Опросник мотивации» и Веб-админка

Техническое задание
Telegram-бот «Опросник мотивации» и Веб-админка
________________________________________
1. Общая концепция
В компании внедряется мотивационная программа с геймификацией, где сотрудники и руководители обмениваются баллами через Telegram-бот, а администрация управляет процессом через веб-интерфейс.
________________________________________
2. Telegram-бот
2.1 Роли и регистрация
• Руководитель
o При первом входе, если Telegram user_id не найден в базе, бот спрашивает только пароль (никаких ФИО, телефона, отделов).
o После ввода правильного пароля user_id запоминается как руководитель, далее показывается меню руководителя.
o При повторных входах бот сразу узнаёт user_id и ведёт к меню руководителя (данные не запрашиваются повторно).
• Сотрудник
o Если Telegram user_id не найден в базе, бот пошагово запрашивает:
1. ФИО (только "Фамилия Имя", проверка наличия пробела).
2. Номер телефона (строго +7 или 8, ровно 11 цифр, не считая символа +).
3. Отдел/группу из предложенного списка.
o После регистрации user_id привязывается к сотруднику с введёнными данными.
o При повторных входах — пользователь сразу попадает в меню сотрудника.
• Повторная регистрация
o Для всех пользователей повторный ввод данных не требуется — бот узнаёт их по user_id.
2.2 Основное меню
(Одинаково для обеих ролей, без кнопки "Назад"!)
• Передать балл
o Руководитель: раздаёт баллы сотрудникам своего отдела (от 1 до 10 баллов в месяц, не себе).
o Сотрудник: может 1 раз в месяц отдать 1 балл любому другому сотруднику (не себе).
o Баллы не накапливаются — если не потрачены за месяц, сгорают. В новом месяце лимит обновляется.
• ТОП лучших
o Показывается список отделов/групп с количеством баллов сотрудников.
o При выборе отдела видно всех сотрудников этого отдела — отсортировано по количеству баллов (от большего к меньшему), видно сколько баллов у каждого.
• Меню должно быть интуитивно простым, все проверки и сообщения — на русском языке.
2.3 Особенности
• Система запрещает отдавать баллы самому себе.
• После завершения лимита баллов (у руководителя 10, у сотрудника 1) — дальнейшая передача до следующего месяца невозможна.
• Все новые сотрудники/руководители сразу доступны для выбора и отображения в "ТОП лучших".
• Исключена “массовка” (фейковые сотрудники) — только реальные пользователи.
• Бот корректно валидирует вводимые данные (ФИО, телефон).
• Все уведомления (например, “Вам начислен балл!”) оформлены с красивыми эмодзи и текстом.
________________________________________
3. Веб-админка (Web-панель)
3.1 Авторизация
• Доступ только по логину и паролю (выдаётся администратору).
3.2 Возможности администратора
• Просмотр всех сотрудников и руководителей, фильтрация по отделам/группам и ролям.
• Добавление новых сотрудников или руководителей вручную.
• Удаление сотрудников и руководителей.
• Просмотр статистики:
o Сколько баллов получил и отдал каждый сотрудник за любой выбранный месяц.
o История передач баллов (кто, кому, когда, сколько баллов).
o Количество оставшихся нераспределённых баллов у руководителя (например: "у Иванова И.И. осталось 5/10 баллов на июнь").
• Экспорт статистики за выбранный месяц в формат Excel (xls/xlsx).
• Интерфейс должен быть понятным и адаптивным.
3.3 Требования к интеграции
• Веб-админка и бот работают на одной базе данных (единая актуальная информация).
________________________________________
4. База данных
• Хранит:
o Всех пользователей (user_id, роль, ФИО, телефон, отдел, дата регистрации и др.)
o Историю баллов (кто, кому, когда, сколько)
o Статистику по каждому месяцу (отдано/получено)
o Логин/пароль админа
• База проектируется с учётом возможности масштабирования (добавление отделов, групп, новых ролей).
________________________________________
5. Бизнес-логика
• Руководитель
o 10 баллов на раздачу в месяц (обнуляются каждый месяц).
o Себе баллы дать нельзя.
o Остаток баллов всегда виден в админке.
• Сотрудник
o 1 балл на раздачу в месяц (обнуляется каждый месяц).
o Себе баллы дать нельзя.
o Балл не накапливается.
• ТОП лучших
o Сотрудники в отделе видны в порядке убывания баллов.
• Вся история действий (передачи, регистраций) сохраняется для аудита.
________________________________________
6. Прочее
• Вся система работает на русском языке.
• Админка развёрнута на имеющемся домене, защищена паролем.
• Возможность дальнейшего расширения (новые отделы, дополнительные роли, отчёты).