# МойОблак — Ръководство за инсталация на cPanel
# =====================================================

## ИЗИСКВАНИЯ
- PHP 7.4+ (препоръчително PHP 8.1+)
- MySQL 5.7+ или MariaDB 10.3+
- cPanel хостинг с FTP/FileManager достъп
- SSL сертификат (Let's Encrypt е безплатен)

---

## СТЪПКА 1 — Качване на файловете

1. Влезте в cPanel → File Manager
2. Навигирайте до `public_html/` (или поддиректория)
3. Качете всички файлове от zip архива
   - ИЛИ използвайте FTP клиент (FileZilla)

**Структура на файловете:**
```
public_html/
├── admin/          ← Супер-админ панел (ВИЕ)
├── api/            ← Backend API
├── includes/       ← Config и функции
├── uploads/        ← Файловете на клиентите
├── login.php       ← Вход за клиенти
├── dashboard.php   ← Главна страница
├── users.php       ← Управление потребители
├── share.php       ← Публично споделяне
└── logout.php
```

---

## СТЪПКА 2 — Създаване на база данни

1. cPanel → MySQL Databases
2. Създайте нова база: `youraccount_cloud`
3. Създайте потребител: `youraccount_cuser` + силна парола
4. Дайте ALL PRIVILEGES на потребителя към базата
5. cPanel → phpMyAdmin → изберете базата
6. Кликнете "SQL" и поставете съдържанието на `install/database.sql`
7. Кликнете "Изпълни"

---

## СТЪПКА 3 — Конфигурация

Отворете `includes/config.php` и редактирайте:

```php
define('DB_HOST', 'localhost');
define('DB_NAME', 'youraccount_cloud');   // базата от Стъпка 2
define('DB_USER', 'youraccount_cuser');    // потребителят
define('DB_PASS', 'СИЛНА_ПАРОЛА_ТУК');    // паролата

define('APP_URL', 'https://cloud.vashsait.bg'); // вашият домейн
define('APP_NAME', 'МойОблак');                  // може да смените
```

---

## СТЪПКА 4 — Права на папките

В cPanel → File Manager, задайте права (chmod):
- `uploads/` → **755**
- `includes/` → **750**

В SSH (ако имате достъп):
```bash
chmod 755 uploads/
chmod -R 750 includes/
find uploads/ -type f -exec chmod 644 {} \;
```

---

## СТЪПКА 5 — Смяна на супер-админ паролата

В phpMyAdmin изпълнете:
```sql
UPDATE super_admins
SET password = '$2y$10$HASH_ОТ_PHP'
WHERE email = 'admin@moisoblak.bg';
```

За да генерирате hash, създайте временен PHP файл:
```php
<?php echo password_hash('ВАШАТА_ПАРОЛА', PASSWORD_DEFAULT); ?>
```

После го изтрийте!

---

## СТЪПКА 6 — ТЕСТ

1. Отворете `https://вашдомейн.bg/admin/` → влезте като супер-админ
2. Добавете тестова фирма с slug `test`
3. Запомнете показаната парола!
4. Отворете `https://вашдомейн.bg/login.php?firma=test`
5. Влезте с email и паролата
6. Качете тестов файл

---

## ДОБАВЯНЕ НА НОВ КЛИЕНТ

1. Влезте в `/admin/`
2. Кликнете "Добави фирма"
3. Въведете: Наименование, Slug (напр. `firma-petrov`), Email, План
4. Системата автоматично:
   - Създава фирмата
   - Създава admin потребител
   - Показва паролата (запазете я!)
5. Изпратете на клиента:
   - URL: `https://вашдомейн.bg/login.php?firma=SLUG`
   - Email и парола

---

## URL СТРУКТУРА ЗА КЛИЕНТИ

Всяка фирма влиза от:
`https://вашдомейн.bg/login.php?firma=SLUG`

Например:
- `https://cloud.vashsait.bg/login.php?firma=firma-abc`
- `https://cloud.vashsait.bg/login.php?firma=petrov-ood`

За по-добро усещане може да правите redirect от поддомейни:
`https://firma-abc.cloud.vashsait.bg` → `https://cloud.vashsait.bg/login.php?firma=firma-abc`

---

## СИГУРНОСТ — ВАЖНО!

1. SSL е задължителен — Let's Encrypt е безплатен в cPanel
2. Не качвайте config.php на публично място
3. Папката `includes/` е защитена с .htaccess
4. Папката `uploads/` блокира PHP изпълнение
5. CSRF protection е вградена
6. XSS protection е вградена

---

## ТАРИФНИ ПЛАНОВЕ (по подразбиране)

| План       | Хранилище | Потребители |
|------------|-----------|-------------|
| Starter    | 10 GB     | 10          |
| Business   | 50 GB     | 25          |
| Enterprise | 100 GB    | 100         |

Можете да ги промените в `admin/index.php` в масива `$limits`.

---

## ПОДДРЪЖКА

При проблеми проверете:
1. PHP error log в cPanel → Errors
2. Правата на папките
3. Конфигурацията в config.php
4. MySQL връзката

---
Версия 1.0 | МойОблак Cloud Storage System