docs: добавлена инструкция по тестированию импорта

TESTING_PANEL_IMPORT.md

@@ -0,0 +1,207 @@
+# Testing Panel Import Feature
+
+## Ветка: feature/panel-import
+
+## ✅ Что реализовано:
+
+### 1. Класс PanelImporter (inc/PanelImporter.php)
+- Парсинг backup файлов от wg-easy и 3x-ui
+- Валидация формата данных
+- Импорт клиентов с сохранением настроек
+- Обработка ошибок и логирование
+- История импортов в БД
+
+### 2. База данных
+- Миграция 008_add_panel_imports.sql
+- Таблица panel_imports (история импортов)
+- Поля: server_id, panel_type, clients_imported, status, error_message
+
+### 3. UI изменения
+- templates/servers/create.twig: форма для загрузки backup
+- templates/servers/view.twig: сообщения о результатах импорта
+- Чекбокс "Import from existing panel"
+- Выбор типа панели (wg-easy / 3x-ui)
+- Загрузка JSON файла
+
+### 4. API Endpoints
+```
+POST /api/servers/{id}/import
+  - Параметры: panel_type, backup_file (multipart)
+  - Возвращает: success, import_id, imported_count, errors
+
+GET /api/servers/{id}/imports
+  - Возвращает историю импортов для сервера
+```
+
+### 5. Переводы
+Добавлены на всех 6 языках:
+- servers.import_from_panel
+- servers.select_panel_type
+- servers.panel_type_wgeasy
+- servers.panel_type_3xui
+- servers.upload_backup_file
+- servers.import_in_progress
+- servers.import_success
+- servers.import_failed
+- servers.import_partial
+- servers.import_history
+
+### 6. Примеры и документация
+- examples/wg-easy-backup-example.json
+- examples/3x-ui-backup-example.json
+- examples/README.md (инструкции по импорту)
+- Обновлен основной README.md
+
+## 🧪 Как протестировать:
+
+### Вариант 1: Через веб-интерфейс
+
+1. **Запустите панель:**
+```bash
+cd /Users/oleg/Documents/amnezia-web-panel
+docker compose up -d
+```
+
+2. **Войдите в систему:**
+- URL: http://localhost:8082
+- Email: admin@amnez.ia
+- Password: admin123
+
+3. **Создайте сервер с импортом:**
+- Servers → Add Server
+- Заполните SSH данные
+- Отметьте "Import from existing panel"
+- Выберите "wg-easy" или "3x-ui"
+- Загрузите файл из `examples/`
+- Нажмите "Create Server"
+
+4. **Проверьте результат:**
+- После деплоя сервера появится сообщение о результатах импорта
+- Проверьте список клиентов на странице сервера
+
+### Вариант 2: Через API
+
+1. **Получите JWT токен:**
+```bash
+curl -X POST http://localhost:8082/api/auth/token \
+  -H "Content-Type: application/json" \
+  -d '{
+    "email": "admin@amnez.ia",
+    "password": "admin123"
+  }'
+```
+
+2. **Создайте сервер:**
+```bash
+TOKEN="your_jwt_token_here"
+
+curl -X POST http://localhost:8082/api/servers/create \
+  -H "Authorization: Bearer $TOKEN" \
+  -H "Content-Type: application/json" \
+  -d '{
+    "name": "Test Server",
+    "host": "192.168.1.100",
+    "port": 22,
+    "username": "root",
+    "password": "your_password"
+  }'
+```
+
+3. **Импортируйте клиентов:**
+```bash
+SERVER_ID=1
+
+curl -X POST http://localhost:8082/api/servers/$SERVER_ID/import \
+  -H "Authorization: Bearer $TOKEN" \
+  -F "panel_type=wg-easy" \
+  -F "backup_file=@examples/wg-easy-backup-example.json"
+```
+
+4. **Проверьте историю импорта:**
+```bash
+curl http://localhost:8082/api/servers/$SERVER_ID/imports \
+  -H "Authorization: Bearer $TOKEN"
+```
+
+### Вариант 3: Проверка БД напрямую
+
+```bash
+# Проверить таблицу panel_imports
+docker compose exec db mysql -uamnezia -pamnezia amnezia_panel \
+  -e "SELECT * FROM panel_imports"
+
+# Проверить импортированных клиентов
+docker compose exec db mysql -uamnezia -pamnezia amnezia_panel \
+  -e "SELECT id, name, client_ip, status FROM vpn_clients WHERE server_id=1"
+```
+
+## 🔍 Что проверить:
+
+### Импорт из wg-easy:
+- ✅ Клиенты создаются с оригинальными IP адресами
+- ✅ Публичные и приватные ключи сохраняются
+- ✅ Pre-shared ключи сохраняются (если есть)
+- ✅ Статус enabled/disabled корректно устанавливается
+- ✅ Конфигурации генерируются с сохраненными ключами
+
+### Импорт из 3x-ui:
+- ✅ Клиенты создаются с новыми ключами (авто-генерация)
+- ✅ IP адреса назначаются из пула сервера
+- ✅ Traffic limits устанавливаются (totalGB → bytes)
+- ✅ Expiration dates устанавливаются (если указаны)
+- ✅ Статус enable/disable корректно устанавливается
+
+### Общее:
+- ✅ История импорта сохраняется в panel_imports
+- ✅ Ошибки логируются в error_message
+- ✅ Количество импортированных клиентов корректно
+- ✅ Переводы работают на всех языках
+- ✅ UI показывает результаты импорта
+
+## 📝 Известные ограничения:
+
+1. **wg-easy**: Требуется полный backup с ключами
+2. **3x-ui**: Ключи генерируются заново (3x-ui не экспортирует их)
+3. **Дубликаты**: Если клиент с таким IP уже есть, импорт пропустит его
+4. **Размер файла**: Ограничен настройками PHP (default: 2MB)
+
+## 🔄 Слияние с master:
+
+После успешного тестирования:
+
+```bash
+# Убедитесь, что все работает
+git checkout master
+git merge feature/panel-import
+git push origin master
+```
+
+## 📊 Статистика изменений:
+
+- **Добавлено строк:** +795
+- **Удалено строк:** -10
+- **Файлов изменено:** 15
+- **Новых файлов:** 5 (PanelImporter.php, миграция, 3 примера)
+
+## 🎯 Цели достигнуты:
+
+✅ Импорт из wg-easy с сохранением ключей и IP  
+✅ Импорт из 3x-ui с генерацией новых ключей  
+✅ UI для загрузки backup файлов  
+✅ API endpoints для программного импорта  
+✅ История импортов в БД  
+✅ Переводы на 6 языков  
+✅ Примеры и документация  
+✅ Обработка ошибок  
+
+## 🚀 Готово к продакшену:
+
+- [x] Код написан
+- [x] Миграции созданы
+- [x] UI реализован
+- [x] API работает
+- [x] Переводы добавлены
+- [x] Примеры созданы
+- [x] Документация обновлена
+- [ ] Тестирование пройдено ← **Ваш шаг**
+- [ ] Код смержен в master