W.I.P.: OpenMAX 0.1.0 (#28)

* Различные фиксы (#14) * Исключаем только ошибку валидации * Небольшие правки вебсокета тамтама * Теперь номера брутить чутка сложнее * Авторизация теперь проверяется для некоторых команд * Теперь проверяется orign у вебсокета тамтама * Дополнил пример env * Починил немного сокет тамтама * Теперь все должно работать исправно * Документация: описал про SESSION_INIT * Update deviceId description in tamtam_ws.md * feat: 16 опкод для обновления профиля * feat: 23 опкод для регистрации, смс шлюз, докер * SQLite: Ошибка И вообще не юзайте sqlite пожалуйста, он баганный * Серверный конфиг снова сломался * Починил изменение профиля * История сообщений (вроде как даже работает) * Дополнил немного 48 опкод, и починил отдачу истории в избранном (избранное все равно не работает) * Доделал авторизацию в ТамТаме * Швырнул архитектуру, чтобы позже объединить контроллеры веба и сокета в одно, а также разделить процессоры * Удалил tamtam.proto, поскольку нигде больше не используется * Поделил процессоры в таме * Коды стран * Генерируем айди, за вместо того, чтобы писать его попорядку * Вынес список участников чата в отдельную таблицу * Теперь мы не должны отправлять 128 опкод самому себе. вроде * ТамТам: реализация 32 опкода. Надеюсь, будет работать * ТамТам: обработчик 5 и 1 опкода * ТамТам: починил 32 опкод и добавил серверный конфиг. Избранное больше не добавляется в список чатов MAX: починил 32 опкод * TT: oops * MAX: заглушка в 158 опкоде * Common: поправил 1 прикол * TamTam: websocket transport for web version * TamTam && MAX: история (в мохе она вроде теперь получше работает) * Правка контроллеров небольшая * MAX: Разделил процессоры * TG Bot: переписал на aiogram * Common: фикс года * Начальная реализация транспорта ws для max web и прочие улучшения * Common: добавил сжатие lz4 * Исправление конфликтов * TT: фикс вебсокета * Fix OpenMAX mobile compatibility and Telegram auth fallback (#30) * Fix OpenMAX mobile compatibility and Telegram auth fallback * Common: Убрал скобку в конфиге --------- Co-authored-by: Alexey Polyakov <starwear3000@mail.ru> * MAX: заглушка для баннеров, правка пакета со списком жалоб, отдача контактов и прочие улучшения * oops * MAX: Рабочие баннеры * MAX: обновление настроек приватности * MAX: пуши через firebase (особо не тестил, вроде работает) * MAX: Рефактор папок * MAX: фикс версий < 25.8.0 * MAX: отдача черного списка * Теперь ID пользователей идут по порядку, как и раньше * MAX: создание папок * MAX: oops * MAX: добавление/удаление контактов, статусы * MAX & TT: теперь в качестве страны локации используется настоящая страна пользователя, а также зафиксировал версии библиотек в зависимостях * TT: ну вроде шире поддержка, а вообще обратная совместимость с максом клас * oops * TG Bot: возможность включения белого списка * Решение проблемы обработки sigterm * nothing * fix * TG Bot: fix * TG Bot: fix username * MAX && TT: общение в таме, и корректировки под веб морду * MAX: Почистил серверный конфиг * nothing * MAX: web fix * MAX: web fix 2 * oops * nothing * MAX: теперь для избранного не сравниваем айди с нулём * Вынес sqlite в отдельный модуль * MAX: блокировка и разблокировка контакта * oops * TT: тоже самое что в макс * MAX && TT: обновление контакта * MAX: добавление контакта по номеру телефона * MAX: исправление уязвимости с избранными * Генерируем айди пользователей рандомно (опять, да) * update sql scheme * Фикс сборки избранного * Попытка починить историю (спойлер, нихуя не получилось) * MAX: история таки заработала — cid/link/reactionInfo обязательны в схеме Десктопный MAX подключается через TCP (mobile-протокол) и парсит msgpack по фиксированной схеме. Если в сообщении выпадает любое из полей — клиент молча обрывает соединение. После 87cfc19 как раз такие условные `if elements: ...` / `if link: ...` (а link и reaction_info там всегда были `{}`, то есть falsy) вырезали поля из ответа CHAT_HISTORY и MSG_SEND, чем и сломали историю. - src/common/tools.py: новый build_message_dict() — единая сборка тела сообщения, где все поля (id, cid, time, type, sender, text, attaches, elements, reactionInfo, link) присутствуют ВСЕГДА. get_last_message переписан через него. - src/oneme/processors/history.py: chat_history использует build_message_dict вместо ручной логики с условными if-ками. - src/oneme/processors/messages.py: msg_send.bodyMessage теперь отдает cid / reactionInfo / link даже пустыми и приводит id к int для mobile, str для web. Цепная польза: auth.py LOGIN bootstrap (через generate_chats → get_last_message) и search.py тоже теперь шлют корректную схему. * MAX: bootstrap-история в LOGIN — клиент перестал думать что всё уже синканулось В ответе LOGIN сервер слал messages: {} и chatMarker: 0. Десктопный клиент в этом случае считает, что локальная история уже синхронизирована со старого запуска, и НЕ отправляет CHAT_HISTORY (49) при открытии чата. В окне видно только lastMessage из chats[], а вся реальная переписка — ничерта. - src/common/tools.py: collect_bootstrap_history(chatIds, ...) — собирает карту {chatId: [последние N сообщений]}, в т.ч. избранное под клиентским id = senderId ^ senderId. - src/oneme/processors/auth.py: подсовываем эту карту в payload.messages, chatMarker = текущее время вместо 0. * fix(chat history): фикс * fix(chat history): фикс * fix(chat history): фикс * fix(chat history): фикс * fix(chat history): фикс * fix(chat history): фикс * fix(chat history): фикс * MAX & TT: теперь полноценный чёрный список * TT: регистрация через клиент * Вроде как нормальные заглушки под ассеты * maybe fixes --------- Co-authored-by: WowInceptionGood <143893762+WowInceptionGood@users.noreply.github.com> Co-authored-by: zavolo <me@kirillka.ru> Co-authored-by: Aleksandr Kosachev <38947781+gohryt@users.noreply.github.com>
2026-07-11 06:20:12 +03:00 · 2026-07-08 00:11:48 +03:00
parent c53c3cd195
commit fc6ec5eec5
94 changed files with 8955 additions and 2756 deletions
@@ -1,18 +1,80 @@
 # Установка

+## Вручную
+
 1. Склонируйте репозиторий
 2. Установите зависимости
-
 ```bash
 pip install -r requirements.txt
 ```
-3. Настройте сервер (пример в `.env.example`)
-4. Импортируйте схему таблиц в свою базу данных из `tables.sql`
-5. Запустите сервер

+3. Сгенерируйте сертификат
+
+Для тестирования (самоподписанный):
+```bash
+openssl req -x509 -newkey rsa:2048 -nodes -keyout key.pem -out cert.pem -days 365
+```
+
+Для прода — [Let's Encrypt](https://certbot.eff.org/):
+```bash
+apt install certbot
+certbot certonly --standalone -d openmax.su
+```
+
+4. Настройте сервер (пример в `.env.example`)
+5. Импортируйте схему таблиц в свою базу данных из `tables.sql`
+6. Запустите сервер
 ```bash
 python3 main.py
 ```

-6. Создайте пользователя
-7. Зайдите со своего любимого клиента
+7. Создайте пользователя через Telegram бот (`/register`)
+8. Зайдите со своего любимого клиента
+
+---
+
+## Docker
+
+1. Склонируйте репозиторий
+2. Настройте `.env` (пример в `.env.example`), укажите `db_user` отличный от `root`
+3. Получите сертификат Let's Encrypt:
+```bash
+apt install certbot
+certbot certonly --standalone -d openmax.su
+```
+
+Укажите домен и пути в `.env`:
+```
+certfile=/certs/cert.pem
+keyfile=/certs/key.pem
+domain=openmax.su
+```
+
+4. Запустите
+```bash
+docker compose up -d
+```
+
+База данных инициализируется автоматически из `tables.sql`.
+
+5. Создайте пользователя через Telegram бот (`/register`)
+6. Зайдите со своего любимого клиента
+
+---
+
+## SMS-шлюз
+
+По умолчанию коды авторизации доставляются через Telegram бот. Если вы хотите принимать пользователей с произвольными номерами без привязки к Telegram — поднимите [SMS Gateway](https://github.com/openmax-server/server/sms-gateway), укажите его адрес в `.env` и отключите Telegram бот:
+```
+telegram_bot_enabled=false
+sms_gateway_url=http://localhost:8100/sms-gateway
+```
+
+Клиент MAX ожидает 6-значный код. Если ваш SMS-провайдер отправляет 5-значные коды и не поддерживает настройку длины — сервер автоматически дублирует последнюю цифру: `26541` → `265411`. Пользователь получает SMS с 5 цифрами и вводит их дважды последнюю: `2-6-5-4-1-1`.
+
+---
+
+## Автопродление сертификата
+```bash
+certbot renew --deploy-hook "docker compose -f /opt/server/docker-compose.yml restart app"
+```
@@ -23,5 +23,25 @@
 3. Заходим в папку проекта и заменяем во всех классах "api.oneme.ru" на свой адрес сервера
 4. Производим повторную сборку с помощью команды: `apktool b max -o max_modified.apk`

-> [!WARNING]
-> Если у вас возникает ошибка при при повторной сборке, попробуйте декомпилировать клиент с параметром -r
+---
+
+# Патчинг Firebase для push-уведомлений
+
+> [!Important]
+> Без замены Firebase-конфига пуши от вашего сервера не будут работать.
+
+1. Создайте проект в [Firebase Console](https://console.firebase.google.com/) и добавьте Android-приложение с пакетом `ru.oneme.app`
+2. Скачайте `google-services.json`
+3. В декомпилированном APK откройте `res/values/strings.xml` и замените следующие строки на значения из вашего `google-services.json`:
+
+| Строка | Оригинал | Откуда взять |
+|---|---|---|
+| `google_api_key` | `AIzaSyABuDYeeDXIOrKTXLkUj30Ii143ofPe63Q` | `client[0].api_key[0].current_key` |
+| `google_app_id` | `1:659634599081:android:9605285443b661167225b8` | `client[0].client_info.mobilesdk_app_id` |
+| `gcm_defaultSenderId` | `659634599081` | `project_info.project_number` |
+| `project_id` | `max-messenger-app` | `project_info.project_id` |
+| `google_crash_reporting_api_key` | `AIzaSyABuDYeeDXIOrKTXLkUj30Ii143ofPe63Q` | `client[0].api_key[0].current_key` |
+| `google_storage_bucket` | `max-messenger-app.firebasestorage.app` | `project_info.storage_bucket` |
+
+4. Соберите и подпишите APK
+5. В настройках проекта Firebase создайте сервисный аккаунт и укажите путь в `.env`