From 96274df2551a0fe6648848f0f4cb30fff2005434 Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?=D0=92=D0=B8=D0=BA=D1=82=D0=BE=D1=80?=
 <78488229+viktor138irk@users.noreply.github.com>
Date: Fri, 8 May 2026 22:46:41 +0900
Subject: [PATCH] =?UTF-8?q?=D0=94=D0=BE=D0=B1=D0=B0=D0=B2=D0=BB=D0=B5?=
 =?UTF-8?q?=D0=BD=20README.md?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

---
 README.md | 57 +++++++++++++++++++++++++++++++++++++++++++++++++++++++
 1 file changed, 57 insertions(+)
 create mode 100644 README.md

diff --git a/README.md b/README.md
new file mode 100644
index 0000000..8f4fdb4
--- /dev/null
+++ b/README.md
@@ -0,0 +1,57 @@
+# WSMessenger
+
+WSMessenger — собственный Android/Web мессенджер на базе Matrix.
+
+Проект создаётся как независимая экосистема StackWorks:
+- Android-приложение;
+- web-клиент;
+- Matrix homeserver;
+- встраиваемый чат-виджет;
+- админ-панель;
+- операторские панели;
+- self-hosted установка рядом с FastPanel.
+
+## Главная цель
+
+Создать современный self-hosted мессенджер с:
+- собственным брендом;
+- независимой инфраструктурой;
+- Android-клиентом;
+- web-клиентом;
+- поддержкой виджета для сайтов;
+- возможностью масштабирования;
+- безопасной установкой рядом с существующими проектами.
+
+## Базовая архитектура
+
+- Matrix Synapse;
+- PostgreSQL;
+- coturn;
+- FastPanel reverse proxy;
+- Docker Compose;
+- Android Matrix SDK;
+- собственный backend/панель.
+
+## Безопасность
+
+WSMessenger никогда не должен ломать существующие проекты:
+- ArtistFlow;
+- сайты FastPanel;
+- nginx-конфиги;
+- существующие базы данных.
+
+Все сервисы запускаются отдельно и наружу публикуются только через reverse proxy.
+
+## Структура проекта
+
+- docs/ — документация;
+- scripts/ — installer/healthcheck;
+- public/widget/ — web widget;
+- docker-compose.yml — инфраструктура Matrix;
+- .sw — главный журнал проекта.
+
+## Текущий статус
+
+Версия: 0.1.0
+
+Подготовлен базовый фундамент проекта.