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

Задачи чат-бота: Трекер задач. Продукт: для геодезической компании. Техзадание есть. # Техническое задание на разработку Telegram-бота “ГеоТрекер“ ## 1. Цель проекта Создать Telegram-бота для автоматизации трекинга геодезических файлов (CSV, DWG, PDF) между полевыми и камеральными сотрудниками. Бот исключит потерю файлов, обеспечит прозрачность workflow и автоматизирует перемещение задач между темами “В работу“ и “Выполнено“. ## 2. Основной функционал ### 2.1. Пересылка CSV-файлов в трекер - Бот отслеживает сообщения в рабочем чате. - При обнаружении CSV-файла: - Пересылает его в тему “В работу“ трекера. - Добавляет inline-кнопку “Взять в работу“. - Сохраняет связь между сообщениями (рабочий чат ↔ трекер). ### 2.2. Введение кнопки “Взять в работу“ - В теме “В работу“ под каждым тикетом появляется **кнопка “Взять в работу“**. - После нажатия: - В метаданных тикета добавляется статус “▶️@взявший\_в\_работу“. - Под сообщением появляются две новые кнопки: **“🔄Вернуть“** и **“✅Выполнить“**. ### 2.3. Обработка задач камеральщиком Для завершения задачи камеральщик может: - Отправить DWG/PDF ответом (reply) на сообщение с CSV в трекере. - Нажать кнопку “✅Выполнить“. - При любом сценарии: - Бот переносит сообщение с CSV в тему “Выполнено“. - В метаданных указывается **username исполнителя**. - Тикет удаляется из темы “В работу“. - В исходном рабочем чате на оригинальное сообщение с CSV ставится “👍“. - Если отправлена схема (DWG/PDF), бот пересылает её в рабочий чат с метаданными тикета. ### 2.4. Кнопка “🔄Вернуть“ в темах “В работу“ и “Выполнено“ - В теме **“В работу“** кнопка “🔄Вернуть“: - Обновляет метаданные тикета: “Ссылка ⬇️@исх\_отправитель 🔄@возвративший“. - Если прошло более **24 часов**, бот пересылает тикет заново и добавляет **статус “🔴“ (просроченный тикет)**. - В теме **“Выполнено“** кнопка “🔄Вернуть“: - Возвращает тикет в “В работу“. - В исходном рабочем чате снимается реакция “👍“. ### 2.5. Добавление метаданных в тикеты При изменении статуса задачи бот добавляет в текстовую часть тикета метаданные: - **Ссылку на исходное сообщение** (“Ссылка“). - **Username исходного отправителя** (полевого геодезиста). - **Username взявшего в работу**. - **Username выполнившего задачу**. - **Username возвратившего в работу**, если задача отменена. - **Примеры отображения:** - “Ссылка ⬇️@исх\_отправитель ✅@выполнивший“ - “Ссылка ⬇️@исх\_отправитель 🔄@возвративший“ - “Ссылка ⬇️@исх\_отправитель ▶️@взявший_в_работу“ ### 2.6. Добавление метаданных при пересылке выполненного тикета в рабочий чат - Когда тикет выполнен и PDF/DWG пересылаются в рабочий чат, к пересланному сообщению добавляются метаданные: - **Ссылка на исходное сообщение** (“Ссылка“). - **Username исходного отправителя**. - **Username исполнителя**. ### 2.7. Настройка правил маршрутизации тикетов - **Поддерживаемые сценарии:** - Из нескольких исходных тем в **один** трекер. - Из **одной** темы в **несколько** трекеров. - **По префиксу, суффиксу или REGEXP выражению имени файла**. - **По ключевым словам в тексте сообщения**. - **По ID отправителя**. - **Алгоритм работы:** - Бот проверяет **все правила**. - Если тикет подходит **под несколько правил**, исполняются **все подходящие маршруты**. ## 3. Технические требования ### 3.1. Стек технологий - **Библиотека:** Aiogram v3 (Python). - **Сервер:** Serverless-решение на Yandex.Cloud (Cloud Functions / Serverless Containers). - **База данных:** Yandex Database (YDB) для хранения: - Связей между сообщениями. - Статистики по задачам и пользователям. - Метаданных (ID чатов, тем, исполнителей). - **Конфигурация:** Файл config.yaml с параметрами: - Токен бота. - ID рабочего чата и трекера. - Настройки подключения к YDB. ### 3.2. Безопасность - Писать в трекер могут только камеральщики (настройка через права Telegram). - Бот имеет права администратора для управления темами и реакциями. ## 4. Сценарии использования ### 4.1. Полевой геодезист отправляет CSV - CSV загружается в рабочий чат. - Бот пересылает файл в тему “В работу“ с кнопкой “Взять в работу“. ### 4.2. Камеральщик завершает задачу #### Сценарий 1: Отправка схемы - Камеральщик отправляет DWG/PDF ответом на CSV в трекере. - Бот: - Переносит цепочку (CSV + схема) в “Выполнено“ с отметкой исполнителя. - Ставит “👍“ в рабочем чате и пересылает схему с метаданными. #### Сценарий 2: Без схемы - Камеральщик нажимает “✅Выполнить“ в трекере. - Бот: - Переносит CSV в “Выполнено“ с отметкой исполнителя. - Ставит “👍“ в рабочем чате. ### 4.3. Статистика - Пользователь отправляет команду `/statistic`. - Бот выводит кнопки с выбором периодов. - Бот выводит статистику по задачам за: - День - 3 дня - Неделю - Месяц - Данные группируются по пользователям и периодам. ## 5. Интерфейс - **Команды:** - `/help` — правила использования и примеры. - `/statistic` — статистика по задачам. - **Элементы UI:** - Inline-кнопки: “Взять в работу“, “✅Выполнить“, “🔄Вернуть“. - Реакция “👍“ в рабочем чате. - Метка исполнителя в теме “Выполнено“ (формат: ✅@username). ## 6. Этапы разработки 1. Настройка YDB и серверной инфраструктуры. 2. Разработка логики бота на Aiogram v3. 3. Интеграция с Telegram API (темы, кнопки, реакции). 4. Тестирование и отладка. 5. Разработка инструкции по деплою.