Files
buryan-infra/ops/audit/6-1-matrix-tg-bridge-design.md
T
root df25de8adf docs(audit): add pre-audit design document for Task 6-1 Matrix-TG Bridge
- Defined architecture (mautrix-telegram)
- Outlined prerequisites, implementation steps, and acceptance criteria
- Documented risks (E2EE, rate limiting) and next steps for future sprint
2026-10-07 21:56:47 +03:00

2.5 KiB
Raw Blame History

📋 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. Этапы реализации

  1. Развертывание контейнера mautrix-telegram и генерация конфигов.
  2. Регистрация registration.yaml в homeserver.yaml Synapse.
  3. Запуск моста и аутентификация администратора через команду login в Telegram.
  4. Связывание чатов командой bridge и тестирование.

5. Критерии приемки

  • Двусторонняя передача текста и медиа работает стабильно.
  • Автоматический рестарт контейнера при сбоях.
  • Отсутствие критических ошибок (ERROR) в логах моста.

6. Риски и ограничения

  • Ограничения API Telegram (rate limiting, возможные блокировки бота).
  • Сложность настройки E2EE (на первом этапе использовать незашифрованные комнаты).

7. Следующие шаги перед спринтом

  1. Аудит настроек Synapse на совместимость с AppServices.
  2. Создание нового бота в @BotFather.
  3. Включение задачи в планирование следующего спринта.