- Defined architecture (mautrix-telegram) - Outlined prerequisites, implementation steps, and acceptance criteria - Documented risks (E2EE, rate limiting) and next steps for future sprint
2.5 KiB
2.5 KiB
📋 Pre-Audit Task: 6-1 Интеграция моста Matrix ↔ Telegram
Статус: 📝 ЗАПЛАНИРОВАНО (Backlog)
Приоритет: Высокий (для отказоустойчивости каналов связи)
Ответственный: Admin-Buryans (Roman)
1. Цель задачи
Обеспечить прозрачную, надежную и двустороннюю ретрансляцию сообщений между чатами Telegram и комнатами Matrix.
2. Выбранная архитектура
Использование mautrix-telegram (Docker) на VPS, подключенного к Synapse (CT 155) через AppService API. Режим работы: Double Puppeting (предпочтительно) или Relay Mode.
3. Предварительные требования
- Действующий Matrix Synapse (CT 155) с правами администратора.
- Новый Telegram Bot Token (с отключенным Privacy Mode).
- Резервная копия конфигурации Synapse перед внесением изменений.
4. Этапы реализации
- Развертывание контейнера
mautrix-telegramи генерация конфигов. - Регистрация
registration.yamlвhomeserver.yamlSynapse. - Запуск моста и аутентификация администратора через команду
loginв Telegram. - Связывание чатов командой
bridgeи тестирование.
5. Критерии приемки
- Двусторонняя передача текста и медиа работает стабильно.
- Автоматический рестарт контейнера при сбоях.
- Отсутствие критических ошибок (ERROR) в логах моста.
6. Риски и ограничения
- Ограничения API Telegram (rate limiting, возможные блокировки бота).
- Сложность настройки E2EE (на первом этапе использовать незашифрованные комнаты).
7. Следующие шаги перед спринтом
- Аудит настроек Synapse на совместимость с AppServices.
- Создание нового бота в @BotFather.
- Включение задачи в планирование следующего спринта.