commit 1460386706f6fb43146ca465c92780104bdff013
Author: ochenstarik-ui <ochenstarik@gmail.com>
Date:   Tue Jul 14 16:03:19 2026 +0700

    Initialize repository

diff --git a/README.md b/README.md
new file mode 100644
index 0000000..73eec8a
--- /dev/null
+++ b/README.md
@@ -0,0 +1,29 @@
+# Mobile Server Manager
+
+Мобильная система управления Linux-серверами: отчёты, безопасные команды, резервные копии и прямые SSH-сессии.
+
+## Структура
+
+- `mobile/` — Flutter-клиент для Android и iOS;
+- `src/ServerManager.Api/` — ASP.NET Core 10 API, Identity, TOTP 2FA и SignalR;
+- `src/ServerManager.Agent/` — исходящий агент управляемого Linux-сервера;
+- `deploy/` — установщик и systemd-файлы агента;
+- `docs/` — архитектура и модель безопасности.
+
+## Статус
+
+Проект находится на раннем этапе разработки. Первая версия API содержит базовую модель пользователей и серверов. Опасные команды, удалённое восстановление и SSH-терминал будут включаться только после реализации аудита, повторного подтверждения и проверки полномочий.
+
+Сейчас форма мобильного входа является интерфейсным прототипом и намеренно не пропускает пользователя без API. Управление серверами в API требует включённой TOTP-2FA. Production-запуск заблокирован до подключения PostgreSQL и миграций; агент пока только собирает локальные метрики и не отправляет их без защищённой регистрации.
+
+## Требования для разработки
+
+- .NET 10 SDK;
+- Flutter stable с Android SDK;
+- Android Studio или Android command-line tools;
+- для сборки iOS — macOS с Xcode;
+- PostgreSQL для production; SQLite используется только при локальной разработке.
+
+Секреты, токены агентов и приватные SSH-ключи не должны попадать в Git.
+
+Подробный результат проверки ПК и порядок подготовки среды находятся в [`docs/development-setup.md`](docs/development-setup.md).