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
This commit is contained in:
root committed 2026-10-07 21:56:47 +03:00
1 parent 7a3e292c86
commit df25de8adf
1 file changed
+37
+37
View File
@@ -0,0 +1,37 @@
# 📋 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. Включение задачи в планирование следующего спринта.