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:
1 parent
7a3e292c86
commit
df25de8adf
1 file changed
+37
@@ -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. Включение задачи в планирование следующего спринта.
|
||||
Reference in new issue
Block a user