# SWChat — журнал проекта Дата старта: 2026-05-08 Репозиторий: https://github.com/viktor138irk/WSMessenger Рабочее имя продукта: SWChat Проект: собственный мессенджер Android/Web на базе Matrix-сервера. ## Главное правило проекта Не ломать существующие проекты на сервере. Защищённые production-активы: - ArtistFlow / artistflow.ru; - основной виджет StackWorks / https://widget.stackworks.ru/; - текущие сайты и домены FastPanel. ## Жёсткое правило про FastPanel Самостоятельно не трогать всё, что касается FastPanel. Запрещено без отдельной явной команды пользователя: - менять настройки FastPanel; - менять vhost/config доменов FastPanel; - применять proxy-настройки в FastPanel; - перезаписывать nginx-конфиги, которыми управляет FastPanel; - перезапускать/переустанавливать FastPanel; - ставить новый Nginx поверх FastPanel; - менять SSL-сертификаты через FastPanel; - менять webroot существующих сайтов; - трогать production-домены. Разрешено: - готовить инструкции; - готовить шаблоны proxy-конфигов; - готовить безопасные команды проверки; - готовить backup-скрипты; - описывать, что пользователь может сделать вручную в FastPanel. Применение любых изменений в FastPanel — только после отдельной явной команды пользователя. ## Постоянное правило ведения .sw Файл .sw является главным журналом проекта и ведётся постоянно. Обязательно записывать в .sw: - каждый значимый шаг разработки; - архитектурные решения; - запреты и ограничения; - защищённые домены и сервисы; - изменения версий; - что было создано или изменено; - текущий статус; - следующий шаг; - важные ошибки и выводы после исправлений. В новом диалоге продолжение проекта начинается с чтения .sw. ## Важно про имя проекта Пользовательское имя продукта: SWChat. Репозиторий пока остаётся viktor138irk/WSMessenger, но в интерфейсах, документации, установщике и дальнейшем планировании использовать название SWChat. ## Важно про widget.stackworks.ru widget.stackworks.ru — отдельный действующий production-проект StackWorks. На текущем этапе SWChat НЕ связывается с widget.stackworks.ru и НЕ создаёт новый виджет. Запрещено без отдельной явной команды: - менять vhost/config домена widget.stackworks.ru; - менять webroot виджета; - затирать файлы виджета; - менять SSL и настройки домена; - интегрировать виджет с Matrix; - создавать новый параллельный виджет для SWChat. ## Важно про ArtistFlow ArtistFlow должен оставаться нетронутым: - не менять vhost/config домена artistflow.ru; - не перезаписывать общий nginx.conf FastPanel; - не ставить новый Nginx поверх FastPanel; - не трогать MySQL/БД ArtistFlow; - не занимать порты FastPanel и текущих сайтов; - перед изменениями nginx/FastPanel делать backup конфигов. ## Принятая архитектура SWChat SWChat разворачивается отдельно от FastPanel-сайтов, ArtistFlow и widget.stackworks.ru. Базовая схема: - FastPanel/Nginx — reverse proxy и SSL-витрина, но изменения только вручную пользователем или по отдельной явной команде; - Matrix Synapse — отдельный сервис на 127.0.0.1:8008; - PostgreSQL — отдельная база для Matrix/SWChat; - backend/админка SWChat — отдельный локальный сервис; - web-client — отдельный web-клиент мессенджера; - Android-приложение — отдельный клиент Matrix, позже брендированный под SWChat/StackWorks. ## Домены проекта Рекомендуемая безопасная схема: - matrix.stackworks.ru — Matrix API / Synapse; - chat.stackworks.ru или messenger.stackworks.ru — web-клиент; - admin-messenger.stackworks.ru — админ-панель; - turn.stackworks.ru — TURN/STUN для звонков, если потребуется; - widget.stackworks.ru — отдельный production-виджет StackWorks, не часть Matrix/SWChat на текущем этапе. ## Предварительные директории - /opt/swchat/source — исходники GitHub; - /opt/swchat/app — backend/админка; - /opt/swchat/matrix — Matrix/Synapse; - /opt/swchat/element — web-клиент, если используем Element/Web; - /opt/swchat/backups — резервные копии; - /var/www/swchat/public — webroot для фронта, если нужен. Запрещено автоматически использовать webroot widget.stackworks.ru. ## Что понадобится Сервер: - Ubuntu; - FastPanel уже может быть установлен; - Docker Compose или systemd-сервисы; - PostgreSQL; - Matrix Synapse; - coturn для звонков; - Nginx/FastPanel reverse proxy; - SSL Let’s Encrypt. Клиенты: - Android-клиент на базе Matrix SDK / форка Element; - web-клиент, желательно сначала Element Web или собственный лёгкий клиент. ## MVP проекта Первая рабочая цель: 1. Подготовить базовый репозиторий. 2. Добавить installer/config wizard. 3. Поднять Matrix Synapse локально. 4. Добавить FastPanel proxy-инструкции без автоматического применения. 5. Добавить healthcheck. 6. Добавить backup перед изменениями. 7. Подготовить Android-план. Минимальные функции: - регистрация/вход; - личные сообщения; - групповые комнаты; - отправка файлов/изображений; - операторы/админы; - безопасная установка рядом с FastPanel; - журнал состояния проекта в этом файле .sw. ## Правила ведения проекта 1. Каждый заметный шаг записывать в этот файл .sw. 2. Новые версии фиксировать в VERSION и changelog. 3. Не плодить мусорные директории. 4. Все сервисы SWChat держать отдельно от ArtistFlow и widget.stackworks.ru. 5. Не вносить изменения в существующие домены без явной команды. 6. Для FastPanel давать точные proxy-конфиги, но не затирать чужие. 7. Перед потенциально опасными действиями добавлять backup-скрипт. 8. Любые действия с widget.stackworks.ru только после отдельной явной команды. 9. Ведение .sw обязательно на протяжении всего проекта. 10. Всё, что касается FastPanel, не трогать самостоятельно: только инструкции/шаблоны до отдельной команды пользователя. ## Текущий статус 2026-05-08: - Репозиторий viktor138irk/WSMessenger подключён. - Репозиторий был пустой. - Создан первый файл .sw. - Созданы VERSION, README.md и базовый docker-compose.yml. - Созданы docs/ARCHITECTURE.md и docs/FASTPANEL_PROXY.md. - Созданы scripts/healthcheck.sh и scripts/install.sh. - Подготовлен автоустановщик. - Зафиксировано пользовательское имя продукта: SWChat. - Зафиксировано, что widget.stackworks.ru — отдельный production-виджет StackWorks. - Зафиксировано, что widget.stackworks.ru пока никак не связывается с Matrix/SWChat. - Зафиксировано, что новый виджет SWChat не планируется. - Зафиксировано постоянное правило: файл .sw ведётся всегда и обновляется после каждого значимого шага. - Зафиксировано жёсткое правило: всё, что касается FastPanel, самостоятельно не трогать; только готовить инструкции и шаблоны до отдельной явной команды пользователя. ## Следующий шаг Следующий этап: - привести README, install.sh, healthcheck.sh и docs к имени SWChat; - .gitignore; - update system foundation; - auto backup scripts; - Matrix registration helper; - diagnostics; - web-client skeleton; - Android architecture draft.