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

Задачи чат-бота: Чек лист для менеджеров продавцов. Продукт: Розничные магазины. Техзадание есть. 1. Цель проекта Автоматизировать контроль состояния розничных мебельных магазинов «Все спим» через Telegram-бот: каждые 3 дня менеджеры заполняют чек-лист из 15 вопросов (часть с фото), руководители видят, кто заполнил/не заполнил, аналитику по датам / магазинам / менеджерам, система отправляет напоминания нарушителям периодичности, отчёты доступны в Telegram и в виде выгрузок (CSV/Excel), опционально — веб-панель. 2. Роли и права Администратор сети (mr.bulushev / HQ) настройка магазинов, пользователей, ролей; просмотр всех отчётов; выгрузки; изменение расписаний напоминаний. Директор магазина просмотр отчётов своего магазина, статусы менеджеров, выгрузки по своему магазину. Менеджер магазина (исполнитель чек-листа) заполнение чек-листов, просмотр собственной истории. Сервис-аккаунт бота системные уведомления, напоминания. 3. Чек-лист (вопросы) Обязательные к реализации 15 пунктов (исходные формулировки заказчика): Чистота зала — полы, витрины, стёкла, зеркала — всё чистое? (Фото) Чистота мебели — протёрты ли витринные образцы от пыли? (Фото 1–2 изделий) Ценники — на всех товарах есть актуальные ценники, без ошибок и повреждений? Актуальность акций — размещены ли материалы по действующим акциям? (Фото) Состояние мебели — нет ли царапин, повреждений, пятен на выставочных образцах? (Фото проблемных мест, если есть) Освещение — все лампы и подсветка работают? Касса — порядок на кассовом месте, нет лишних предметов? (Фото) Рабочее место менеджера — чистый стол, нет мусора и посторонних вещей? (Фото) Униформа/внешний вид персонала — сотрудники в опрятном виде, с бейджами? Рекламные материалы — буклеты, каталоги на месте, аккуратно разложены? Складская зона — порядок, нет посторонних вещей и мусора? (Фото) Входная зона — чистота у входа, коврики, стеклянные двери без разводов? (Фото) Полнота экспозиции — нет ли пустых мест, все ли группы мебели представлены в зале? Музыка/фон — играет ли фоновая музыка, комфортна ли громкость? Общее впечатление — магазин готов к приёму покупателей? (короткий комментарий) Правила ответов: Для пп. 1,2,4,7,8,11,12 — обязательное фото. Для п.5 — фото обязательно, если отмечены повреждения. Пп. 3,6,9,10,13,14 — кнопки Да/Нет. П.15 — текстовый комментарий (минимум 10 символов). 4. Бизнес-правила и логика периодичности Периодичность: раз в 3 дня на каждого менеджера/магазин. Чек-лист считается «сданным» при ответах на все 15 пунктов, включая обязательные фото. Просрочка: если прошло ≥72 часа с момента последней сдачи — бот помечает пользователя как «просрочено» и включает сценарий напоминаний. Внутренняя тайм-зона: Europe/Berlin. Все отчёты и расписания — в этой TZ. 5. Пользовательские сценарии (Telegram UX) 5.1 Менеджер /start — приветствие, привязка к магазину (выбор из списка) и подтверждение роли. /newcheck — старт опроса; пошаговая навигация с инлайн-кнопками; в фото-вопросах бот принимает 1–3 снимка; п.5 — ветка «всё ок» или «есть повреждения» (тогда просит приложить фото(а)). /my — список своих последних сдач (дата/время, статус, ссылка на сводку). Напоминания в личку: «Пора пройти чек-лист /newcheck». 5.2 Директор магазина /store_today — сводка по магазину за сегодня: кто сдал, кто нет; ссылки на отчёты. /store_range — сводка за период (даты), доля выполненных, проблемные пункты (топ по «Нет»). /export_store — выгрузка CSV/Excel за период. 5.3 Администратор сети /all_today, /all_range — аггрегированная сводка по всей сети. /overdue — список всех просроченных менеджеров (3+ дней). /users — управление пользователями (поиск, блокировка/разблокировка). /settings — настройка расписания напоминаний (час, дни), периодичности (по умолчанию 3 дня), формулировок. /export_all — выгрузка по сети. 6. Отчётность и аналитика Карточка сдачи: дата/время старта/финиша, магазин, менеджер, ответы по каждому пункту, миниатюры фото, комментарий. Статусы: «в срок», «просрочка», «не завершён» (брошен опрос). Фильтры в отчётах: период (дата-от-до), магазин(и), менеджер(ы), статус, наличие повреждений (п.5=«есть»). Метрики: % сдачи по магазинам, среднее время прохождения, топ-3 проблемных пунктов (по «Нет»). Экспорт: CSV/Excel (разделитель «;», кодировка UTF-8). Уведомления администратору: по завершении каждой сдачи — краткое резюме + CSV вложением + фото (как в демонстрационном коде). 7. Напоминания Ежедневная проверка в 10:00 Europe/Berlin: кому нужно напомнить. Канал: личные сообщения менеджерам; опционально — директору магазина сводка «кто просрочил». Шаблоны сообщений — настраиваемые. Защита от спама: не более 1 напоминания в сутки на пользователя. 8. UX-детали и валидации Фото-вопросы: запрет перехода без хотя бы 1 фото (пп. 1,2,4,7,8,11,12). П.5: если ответ «есть повреждения» — минимум 1 фото; допускается несколько фото до команды «готово». П.15: минимум 10 символов. Унификация ответов Да/Нет: инлайн-кнопки. При отмене — явное подтверждение и маркировка как «abandoned». Антидубликат: нельзя запустить новый чек, пока предыдущий не завершён (или не отменён). 9. Безопасность и доступ Белый список пользователей (регистрация через админа). Хранение токена бота и конфигурации в .env. Резервное копирование БД и отчётов (ежедневно). Обработка ошибок: логи с уровнем INFO/ERROR, маскирование секрета токена. 10. Производительность и надёжность Одновременная работа 50+ менеджеров. Время ответа бота ≤1 сек при нормальной нагрузке. Повторная отправка сообщений при сетевых сбоях. Хранение фото — по file_id; загрузка из Telegram по необходимости. 11. Критерии приёмки Все 15 вопросов реализованы с указанными типами ответов и валидацией. Видна аналитика «кто сдал/не сдал» по датам, магазинам и менеджерам. Работают напоминания раз в 3 дня (10:00 Europe/Berlin), нет спама. Экспорт CSV/Excel из Telegram-команд. Админ и директор видят только свои зоны ответственности. Фото корректно привязываются к ответам; администратору приходят вместе с резюме и CSV. Документация по установке и запуску (README) предоставлена.