hesabixSite/docs/installation-guide.md

# راهنمای نصب خودکار حسابیکس

## مقدمه

این سیستم امکان نصب خودکار حسابیکس را بر روی هاست‌های اشتراکی با پنل‌های cPanel و DirectAdmin فراهم می‌کند.

## ویژگی‌ها

- ✅ تست اتصال خودکار به هاست
- ✅ دریافت لیست دامنه‌ها از پنل
- ✅ ایجاد دیتابیس خودکار
- ✅ دانلود و آپلود فایل‌های حسابیکس
- ✅ تنظیم فایل .env.local.php
- ✅ ایمپورت دیتابیس پیش‌فرض
- ✅ تنظیم مجوزهای فایل

## مراحل نصب

### 1. تست اتصال به هاست
کاربر اطلاعات اتصال به پنل هاست خود را وارد می‌کند:
- نوع پنل (cPanel یا DirectAdmin)
- آدرس هاست
- نام کاربری
- رمز عبور

### 2. انتخاب دامنه
سیستم لیست دامنه‌های موجود در هاست را دریافت کرده و کاربر دامنه مورد نظر را انتخاب می‌کند.

### 3. تنظیمات دیتابیس
کاربر اطلاعات دیتابیس جدید را وارد می‌کند:
- نام دیتابیس
- نام کاربری دیتابیس
- رمز عبور دیتابیس

### 4. آپلود فایل‌ها
سیستم فایل‌های حسابیکس را دانلود کرده و به هاست آپلود می‌کند.

### 5. تنظیمات نهایی
فایل .env.local.php تنظیم شده و دیتابیس ایمپورت می‌شود.

## API Endpoints

### تست اتصال
```
POST /api/installation/test-connection
```

### دریافت اطلاعات دامنه
```
POST /api/installation/get-domain-info
```

### ایجاد دیتابیس
```
POST /api/installation/create-database
```

### آپلود فایل‌ها
```
POST /api/installation/upload-files
```

### تنظیم فایل .env.local.php
```
POST /api/installation/configure-env
```

### نهایی‌سازی نصب
```
POST /api/installation/finalize
```

## ساختار فایل‌ها

```
src/
├── Controller/
│   └── InstallationController.php    # کنترلر اصلی نصب
├── Service/
│   └── InstallationService.php       # سرویس نصب
templates/
└── installation/
    └── index.html.twig               # صفحه نصب
assets/
└── controllers/
    └── installation_controller.js    # کنترلر Stimulus
```

## پیاده‌سازی API پنل‌ها

### cPanel API
- URL: `https://hostname:2083/execute/`
- احراز هویت: Basic Auth
- مستندات: https://api.docs.cpanel.net/

### DirectAdmin API
- URL: `https://hostname:2222/CMD_API_`
- احراز هویت: Basic Auth
- مستندات: https://www.directadmin.com/api.html

## نکات امنیتی

1. **رمزنگاری اطلاعات**: اطلاعات حساس مانند رمزهای عبور باید رمزنگاری شوند
2. **اعتبارسنجی ورودی**: تمام ورودی‌های کاربر باید اعتبارسنجی شوند
3. **محدودیت نرخ**: API calls باید محدود شوند
4. **لاگ‌گیری**: تمام عملیات نصب باید لاگ شوند

## عیب‌یابی

### خطاهای رایج

1. **خطا در اتصال به هاست**
   - بررسی صحت آدرس هاست
   - بررسی نام کاربری و رمز عبور
   - بررسی فعال بودن API در پنل

2. **خطا در ایجاد دیتابیس**
   - بررسی محدودیت‌های هاست
   - بررسی دسترسی‌های کاربر

3. **خطا در آپلود فایل‌ها**
   - بررسی فضای دیسک
   - بررسی مجوزهای فایل

## توسعه

برای اضافه کردن پشتیبانی از پنل‌های جدید:

1. متدهای مربوطه در `InstallationService` را پیاده‌سازی کنید
2. API endpoints جدید را اضافه کنید
3. تست‌های مربوطه را بنویسید

## تست

```bash
# تست واحد
php bin/phpunit tests/Service/InstallationServiceTest.php

# تست یکپارچگی
php bin/phpunit tests/Controller/InstallationControllerTest.php
```