feat: initial commit - ServerManager Pro v2.0.0

2025-11-26 23:21:44 +03:00
commit af51c68d7f
39 changed files with 23191 additions and 0 deletions
@@ -0,0 +1,86 @@
+# ServerManager Pro - Руководство разработчика
+
+## 🏗️ Структура проекта
+wireguard-manager/
+├── 📁 installers/           # Скрипты установки
+├── 📁 public/              # Статические файлы Electron
+├── 📁 scripts/             # Вспомогательные скрипты
+├── 📁 src/                 # Исходный код React
+│   ├── 📁 components/      # Компоненты приложения
+│   └── 📄 App.js          # Главный компонент
+├── 📄 build.sh            # Основной скрипт сборки
+├── 📄 build.prod.sh       # Продакшен сборка
+└── 📄 package.json        # Конфигурация проекта
+
+## 🎯 Назначение компонентов
+
+### Основные компоненты:
+- **Dashboard** (`Dashboard.js`) - Главная панель управления
+- **ServerList** (`ServerList.js`) - Управление серверами
+- **ServerMonitoring** (`ServerMonitoring.js`) - Мониторинг серверов
+- **NetworkMonitor** (`NetworkMonitor.js`) - Мониторинг сети
+- **PasswordManager** (`PasswordManager.js`) - Менеджер паролей
+- **CommandTemplates** (`CommandTemplates.js`) - Шаблоны команд
+- **Notes** (`Notes.js`) - Система заметок
+- **Settings** (`Settings.js`) - Настройки приложения
+
+### Вспомогательные компоненты:
+- **BatchOperations** - Пакетные операции
+- **NetworkTools** - Сетевые инструменты
+- **ServerHealth** - Проверка здоровья серверов
+
+## 🔧 Ключевые файлы
+
+### Electron файлы:
+- `public/electron.js` - Главный процесс Electron
+- `public/preload.js` - Безопасный мост между процессами
+- `public/index.html` - Базовая HTML структура
+
+### Конфигурационные файлы:
+- `package.json` - Зависимости и скрипты
+- `tailwind.config.js` - Конфигурация Tailwind CSS
+- `.env` - Переменные окружения
+
+## 🚀 Быстрый старт при разработке
+
+# Установка зависимостей
+npm install
+
+# Запуск в режиме разработки
+./build.sh dev
+
+# Сборка для продакшена
+./build.sh build     # Сборка Linux (.deb) + Windows (.exe)
+
+# Только Linux сборка
+./build.sh build-linux
+
+# Очистка сборок
+./build.sh clean    
+
+# !! ВАЖНО !! Настройка Wine для сборки Windows приложений
+
+## Установка Wine на Ubuntu/Debian:
+sudo apt update
+sudo apt install -y wine  
+
+
+
+## 🎨 Архитектура
+
+### Frontend (React):
+- **Тёмная тема** по умолчанию
+- **Tailwind CSS** для стилей
+- **Компонентный подход**
+- **Состояние через useState/useEffect**
+
+### Backend (Electron):
+- **Главный процесс** - управление окнами
+- **Предзагрузка** - безопасный API мост
+- **Файловая система** - хранение данных
+
+### Хранение данных:
+- **servers.json** - список серверов
+- **passwords.json** - менеджер паролей
+- **notes.json** - система заметок
+- **command-templates.json** - шаблоны команд