max2telegram

Асинхронный мост для двусторонней синхронизации переписки между мессенджером MAX и Telegram (форум-канал с топиками).

Архитектура

Приложение построено по слоям:

Слой	Назначение
max_layer	WebSocket-клиент MAX (PyMAX WebClient), listener и worker
telegram_layer	Aiogram dispatcher, TG worker, admin-команды
router	Маршрутизация по ID, дедупликация, постановка в очереди
queue	Redis-очереди max2tg_queue и tg2max_queue
storage	SQLite: маппинги, маркеры, связи сообщений

Быстрый старт

1. Скопируйте .env.example в .env и заполните переменные.
2. Создайте папку data/ (монтируется для SQLite и сессии PyMAX).
3. Запустите:

docker compose up -d

Переменные окружения

См. tech-specs.md, раздел 6, и .env.example.

Команды (только FALLBACK_USER_ID в ЛС с ботом)

• /start — статус подключения
• /help — справка
• /list — список маппингов
• /join <ссылка> — вступить в MAX-группу
• /leave <id или название> — выйти из MAX-чата
• /last_messages <id или название> — последние 10 сообщений

Локальная разработка

pip install -r requirements.txt
export $(cat .env | xargs)   # Linux/macOS
python -m app.main

Redis должен быть доступен по REDIS_URL.