Плагин для Bambu Farm Manager с Telegram-уведомлениями

1. Цель проекта

Создать расширение (плагин) для системы Bambu Farm Manager, которое автоматически отправляет сообщения в Telegram (на мобильный телефон) о следующих событиях: завершение печати, постановка на паузу и возможно другие критические изменения статуса работы.

2. Ключевые требования

2.1 Интеграция с системе

• Плагин должен корректно устанавливаться и запускаться в среде Bambu Farm Manager.
• Использовать существующие хуки или механизмы расширений для получения событий о статусе печати.
• Конфигурация через интерфейс системы или простой файл настроек.

2.2 Уведомления в Telegram

• Отправка сообщения владельцу через Telegram Bot API при окончании печати.
• Отправка уведомления при переводе печати на паузу (ручная или аварийная).
• Типовое сообщение должно содержать имя задания, статус, время события и ссылка на прибор.

2.3 Настройка безопасности

• Поддержка суперсекретного токена бота - хранить только на сервере, не прошивать в коде.
• Добавить базовые усилия аутентификации: проверка sender сессии бота с ID от владельца системы (номер/id).

2.4 Простота эксплуатации

• После установки плагин должен быть instantly working - минимум шагов для конфигурации.
• Лёгкое обновление через пару команд. Предссветная документация для обычного пользователя.

3. Технические детали

3.1 Язык реализации

Ожидается использование либо TypeScript/Node.js, либо Python в зависимости от API системы (уточнить в процессе обсуждения ТЗ). Главное - интеграция будет происходить напрямую, библиотеки telegram отправляющие запросы простые.

3.2 Документирование

Создать README с пошаговой инструкцией: как установить файлы, указать свой chatID, получить botToken от BotFather, протестировать.

Также небольшая заметка с example message и формат JSON-хуков которого следует ожидать.

4. Ограничения

• Имена проектов в заголовках не указывать, бренды скрыты.
• Код должен быть открытым, модульным - фрилансер предоставляет исходники и может лицензировать MIT для дальнейших модификаций.

5. Дополнительно

Все обсуждения ведём в рамках данного открытого заказа. Примерный бюджет зависит от качества документации и реализуемых фич - фиксируем договорённостью. Указание: внимательно следить за полями кэширований повторов нотификаций (deduplication) чтобы не спамить. [Общие контакты убраны]