Разработка ботов Telegram — удалённая работа в Москве

Задачи чат-бота: Автоматизация подменного персонала. Продукт: Телеграмм N8N. Техзадание есть. Пожелания и особенности: Создать цепочку для телеграмм бота - для администрирования подменных сотрудников. 1) Цель проекта Создать Telegram-бота для управления и автоматизации выхода на смены подменных сотрудников: • уведомлять подменных сотрудников о свободных сменах; • позволять взять смену (бронь/назначение) и привязать сотрудника к смене; • напоминать сотруднику о предстоящих сменах; • в конце рабочего дня в 09:00 запрашивать подтверждение закрытия смены: • от сотрудника; • от админа; • фиксировать статусы и историю. ⸻ 2) Роли и права 2.1 Роли 1. Админ • создаёт/редактирует/отменяет смены; • управляет списком подменных сотрудников; • видит расписание, кто на каких сменах; • подтверждает закрытие смен; • видит отчёты/историю. 2. Подменный сотрудник • получает уведомления о свободных сменах; • берёт смену; • видит свои смены; • подтверждает закрытие смены (в 09:00). 2.2 Авторизация • Идентификация по Telegram ID. • Доступ к админ-командам — только из списка админов (в конфиге/БД). ⸻ 3) Основные сущности (данные) 3.1 Сотрудник (SubstituteEmployee) • id (внутренний) • telegram_id • ФИО / отображаемое имя • телефон (опционально) • активен/неактивен • доступность (опционально: дни недели/время/локации) 3.2 Смена (Shift) • id • дата (и при необходимости интервал времени, например 09:00–09:00) • объект/локация (если есть) • описание/комментарий • статус: Свободна / Забронирована / Завершена / Отменена • назначенный сотрудник (nullable) • дедлайн подтверждения закрытия: 09:00 (по Europe/Berlin или заданной TZ) • отметка закрытия сотрудником: да/нет + timestamp • отметка закрытия админом: да/нет + timestamp 3.3 Уведомление (NotificationLog) • id • тип (свободная смена / напоминание / запрос закрытия / прочее) • получатель • смена (nullable) • время отправки • статус доставки (если трекается) ⸻ 4) Пользовательские сценарии (User Stories) 4.1 Подменный сотрудник: регистрация/доступ • При первом запуске бот показывает: “Вы подменный сотрудник? Нажмите «Запросить доступ»”. • Админ подтверждает/добавляет сотрудника (либо сотрудник уже предзаведён). 4.2 Уведомление о свободной смене • Админ создаёт смену со статусом “Свободна”. • Бот отправляет уведомление всем активным подменным сотрудникам (или по фильтрам). • В уведомлении кнопки: • Взять смену • Подробнее 4.3 Взять смену (защита от гонок) • Сотрудник нажимает “Взять смену”. • Если смена всё ещё свободна — бот: • назначает сотрудника на смену; • меняет статус на “Забронирована”; • уведомляет: • сотрудника: “Смена закреплена за вами” • админа: “Смена взята сотрудником X” • Если смена уже занята — бот сообщает: “Смена уже взята другим сотрудником”. Важно: бронирование должно быть атомарным (транзакция/lock), чтобы два человека не взяли одну смену. 4.4 Мои смены • Команда/кнопка “Мои смены” • Вывод списка будущих и последних смен со статусами и кнопками: • “Открыть смену” • “Подтвердить закрытие” (активно после наступления времени закрытия или по правилам) 4.5 Напоминания о смене • За N часов/дней до смены бот присылает напоминание (настраиваемо): • например: за 24 часа и за 2 часа. • Настройки времени напоминаний — в админке. 4.6 Закрытие смены в 09:00 (двойное подтверждение) • В 09:00 бот автоматически отправляет: • сотруднику: “Подтвердите закрытие смены за (дата/локация)” кнопки Подтвердить / Сообщить проблему • админу: “Подтвердите закрытие смены сотрудником X” кнопки Подтвердить / Отклонить / Запросить уточнение • Статус “Завершена” выставляется только когда: • сотрудник подтвердил и • админ подтвердил (или иной бизнес-правилом — но по умолчанию так). 4.7 Проблема/невыход/замена • Если сотрудник нажимает “Сообщить проблему”: • бот просит выбрать причину/ввести текст • уведомляет админа с деталями и ссылкой на смену. ⸻ 5) Функциональные требования 5.1 Для админа • Добавить/удалить/деактивировать сотрудника • Создать смену (дата, время, описание, локация) • Просмотр списка смен по датам • Принудительно назначить сотрудника на смену • Отменить смену (уведомить назначенного/всех заинтересованных) • Подтверждение закрытия смен • Отчёт: • смены за период • кто сколько смен взял • список неподтверждённых закрытий 5.2 Для сотрудника • Посмотреть доступные смены • Взять смену • Посмотреть свои смены • Подтвердить закрытие смены • Отправить сообщение о проблеме ⸻ 6) Интерфейс бота (команды и кнопки) 6.1 Главное меню (кнопки) Для сотрудника: • Доступные смены • Мои смены • Помощь Для админа: • Создать смену • Смены (список) • Сотрудники • Отчёты • Настройки 6.2 Команды (минимум) /start — запуск /help — помощь (остальное можно кнопками) ⸻ 7) Уведомления и расписание (Scheduler) • Рассылка о свободных сменах — событие при создании/переводе в “Свободна”. • Напоминания — по расписанию (cron-like). • Закрытие смены — строго в 09:00 по заданной TZ: • проверять смены, которые должны закрываться/подтверждаться; • слать запросы сотруднику и админу; • эскалация: если нет подтверждения до, например, 11:00 — повторный пуш админу (настраиваемо). ⸻ 8) Статусы смен и логика Статусы: 1. Свободна 2. Забронирована 3. Завершена 4. Отменена Переходы: • Свободна → Забронирована (сотрудник взял / админ назначил) • Забронирована → Завершена (подтвердил сотрудник + подтвердил админ) • Любая → Отменена (админ) ⸻ 11) MVP-объём (первый релиз) 1. Роли: админ/сотрудник 2. Создание смен админом 3. Рассылка свободных смен 4. Взятие смены сотрудником (с защитой от гонок) 5. “Мои смены” 6. Авто-запрос подтверждения закрытия в 09:00 сотруднику и админу 7. Отчёт: смены за период + неподтверждённые закрытия ⸻ 12) Критерии приёмки • При создании смены бот уведомляет сотрудников и даёт возможность взять смену. • Два сотрудника не могут закрепиться за одной сменой. • После взятия смены админ получает уведомление. • В 09:00 бот отправляет запрос закрытия сотруднику и админу. • Смена становится “Завершена” только после двух подтверждений. • Админ видит список смен и статусы подтверждения.