153 строки
5.3 KiB
Markdown
153 строки
5.3 KiB
Markdown
# SWChat
|
|
|
|
SWChat — self-hosted Android/Web мессенджер на базе Matrix для экосистемы StackWorks.
|
|
|
|
Проект строится как собственная платформа связи:
|
|
- Matrix Core на отдельном сервере;
|
|
- PostgreSQL;
|
|
- официальный Matrix/Element-клиент для первого тестирования;
|
|
- будущий web-клиент;
|
|
- будущий Android-клиент;
|
|
- будущая админ-панель;
|
|
- безопасная архитектура без вмешательства в существующий production.
|
|
|
|
## Текущая стратегия
|
|
|
|
Сначала поднимаем и проверяем серверное ядро через официальные Matrix-клиенты.
|
|
|
|
Порядок:
|
|
|
|
1. Поднять SWChat Core на отдельном сервере.
|
|
2. Проверить Matrix/Synapse локально.
|
|
3. Настроить публичный домен `matrix.stackworks.ru`.
|
|
4. Проверить работу через официальные клиенты Matrix/Element.
|
|
5. Только после стабильной проверки начинать разработку собственного Android/Web-клиента.
|
|
|
|
Это нужно, чтобы не путать проблемы сервера с проблемами будущего собственного UI.
|
|
|
|
## Архитектура
|
|
|
|
SWChat работает по split-server архитектуре.
|
|
|
|
### Новый сервер: SWChat Core
|
|
|
|
На новом сервере размещаются:
|
|
- Matrix Synapse;
|
|
- PostgreSQL;
|
|
- media storage;
|
|
- будущий TURN/STUN;
|
|
- будущий backend API;
|
|
- backups;
|
|
- diagnostics.
|
|
|
|
Рекомендуемые домены:
|
|
|
|
```text
|
|
matrix.stackworks.ru -> новый SWChat Core сервер
|
|
turn.stackworks.ru -> новый SWChat Core сервер, позже
|
|
api-chat.stackworks.ru -> новый SWChat Core сервер, позже
|
|
```
|
|
|
|
### Старый сервер с FastPanel
|
|
|
|
Старый сервер с FastPanel используется только для будущего frontend/web-клиента.
|
|
|
|
На нём остаются отдельно:
|
|
- ArtistFlow;
|
|
- widget.stackworks.ru;
|
|
- текущие сайты StackWorks/FastPanel.
|
|
|
|
SWChat installer не меняет FastPanel, не меняет vhost, не меняет SSL и не трогает существующие сайты.
|
|
|
|
Будущий frontend-домен:
|
|
|
|
```text
|
|
chat.stackworks.ru
|
|
```
|
|
|
|
## Что нельзя трогать
|
|
|
|
Защищённые production-активы:
|
|
- `artistflow.ru`;
|
|
- `widget.stackworks.ru`;
|
|
- текущие сайты FastPanel;
|
|
- настройки FastPanel без отдельной явной команды.
|
|
|
|
`widget.stackworks.ru` на текущем этапе никак не связан с Matrix/SWChat. Новый виджет SWChat не планируется.
|
|
|
|
## Установка SWChat Core
|
|
|
|
На новом сервере Ubuntu:
|
|
|
|
```bash
|
|
sudo mkdir -p /opt/swchat
|
|
sudo git clone https://github.com/viktor138irk/SWChat.git /opt/swchat/source
|
|
cd /opt/swchat/source
|
|
sudo SERVER_NAME=matrix.stackworks.ru bash scripts/install.sh
|
|
```
|
|
|
|
Installer:
|
|
- создаёт структуру `/opt/swchat`;
|
|
- устанавливает Docker, если он отсутствует;
|
|
- создаёт `.env`;
|
|
- генерирует Synapse config;
|
|
- настраивает PostgreSQL для Synapse;
|
|
- запускает контейнеры;
|
|
- не трогает FastPanel.
|
|
|
|
## Проверка после установки
|
|
|
|
```bash
|
|
sudo bash /opt/swchat/source/scripts/healthcheck.sh
|
|
curl http://127.0.0.1:8008/_matrix/client/versions
|
|
```
|
|
|
|
Ожидаемый результат `curl` — JSON с версиями Matrix API.
|
|
|
|
## Тестирование официальными клиентами
|
|
|
|
До разработки собственного клиента проверяем сервер через:
|
|
- Element Web;
|
|
- Element Desktop;
|
|
- Element Android;
|
|
- любые совместимые Matrix-клиенты.
|
|
|
|
Проверяем:
|
|
- регистрацию/логин;
|
|
- личные сообщения;
|
|
- комнаты;
|
|
- отправку файлов;
|
|
- стабильность Synapse;
|
|
- работу публичного домена.
|
|
|
|
## Структура проекта
|
|
|
|
```text
|
|
.sw главный журнал проекта
|
|
docker-compose.yml Matrix/PostgreSQL stack
|
|
scripts/install.sh автоустановщик Core-сервера
|
|
scripts/healthcheck.sh диагностика
|
|
docs/ документация
|
|
VERSION версия проекта
|
|
```
|
|
|
|
## Правило `.sw`
|
|
|
|
Файл `.sw` — главный журнал проекта.
|
|
|
|
В него обязательно записываются:
|
|
- архитектурные решения;
|
|
- изменения версий;
|
|
- текущий статус;
|
|
- следующий шаг;
|
|
- ошибки и исправления;
|
|
- запреты и защищённые production-активы.
|
|
|
|
Новый диалог по проекту начинается с чтения `.sw`.
|
|
|
|
## Текущий статус
|
|
|
|
Версия: `0.1.0`
|
|
|
|
Сейчас идёт этап запуска SWChat Core на отдельном сервере и тестирования через официальные Matrix-клиенты.
|
© 2026 StackWorks