amneziavpnphp/TESTING_PANEL_IMPORT.md

# 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