# Guía de Integración Rápida: Módulo de Respaldo y Restauración

Este documento explica cómo integrar este módulo en cualquier proyecto PHP con base de datos MySQL o MariaDB.

---

## 1. Requisitos del Servidor
* **PHP:** Versión 7.4, 8.0, 8.1, 8.2, 8.3 o 8.4.
* **Extensiones PHP:**
  * `pdo_mysql` (habilitada por defecto en prácticamente todos los servidores).
  * `zip` (recomendada para respaldos de fotos y respaldo completo).
* **Compatibilidad de Hosting:**
  * 100% compatible con **BanaHosting**, cPanel, VPS, XAMPP, Laragon, Docker y servidores compartidos.
  * **No requiere** `exec()`, `shell_exec()`, `system()` ni `mysqldump.exe`.

---

## 2. Estructura de Archivos a Copiar

Copia los siguientes 5 archivos a tu proyecto:

```text
tu_proyecto/
├── respaldo.php                    <- Interfaz de usuario (colocar en la raíz pública)
└── backend/
    ├── auth_helper.php             <- Validación de permisos de Super Administrador
    ├── respaldo_helper.php         <- Motor SQL puro y empaquetador ZIP
    ├── generar_respaldo.php        <- Controlador de descargas
    └── procesar_restauracion.php   <- Controlador de restauraciones
```

---

## 3. Puntos de Adaptación en el Nuevo Proyecto

### A. Archivo de Conexión a la Base de Datos (`conexion.php`)
Los controladores requieren un objeto `$pdo` tipo `PDO`. Asegúrate de que `backend/conexion.php` cree la conexión:

```php
$pdo = new PDO("mysql:host=$host;dbname=$db;charset=utf8mb4", $user, $pass, [
    PDO::ATTR_ERRMODE => PDO::ERRMODE_EXCEPTION,
    PDO::ATTR_DEFAULT_FETCH_MODE => PDO::FETCH_ASSOC
]);
```

### B. Validación de Administrador Principal (`backend/auth_helper.php`)
Ajusta la función `esAdminPrincipal(PDO $pdo)` según la lógica de usuarios de tu sistema:

```php
function esAdminPrincipal(PDO $pdo): bool {
    if (empty($_SESSION['usuario'])) return false;
    
    // Opción 1: Por ID de usuario fijo (id = 1)
    $st = $pdo->prepare("SELECT id FROM usuarios WHERE usuario = ? LIMIT 1");
    $st->execute([$_SESSION['usuario']]);
    return ((int)$st->fetchColumn() === 1);

    // Opción 2: Por columna de rol (ej: rol = 'superadmin')
    // $st = $pdo->prepare("SELECT rol FROM usuarios WHERE usuario = ? LIMIT 1");
    // $st->execute([$_SESSION['usuario']]);
    // return ($st->fetchColumn() === 'superadmin');
}
```

### C. Carpetas de Archivos a Respaldar
En `backend/respaldo_helper.php`, `backend/generar_respaldo.php` y `backend/procesar_restauracion.php`:
* Cambia `img/fotos_personal` por la carpeta donde guardas tus archivos multimedia (ej: `uploads/`, `archivos/`, `fotos/`).

### D. Registro en Bitácora (`backend/bitacora_helper.php`)
Si tu proyecto ya cuenta con una función de auditoría o bitácora, simplemente úsala. Si no tiene, puedes registrar en un archivo `.log` o en una tabla sencilla:

```sql
CREATE TABLE IF NOT EXISTS bitacora_sistema (
  id INT AUTO_INCREMENT PRIMARY KEY,
  usuario VARCHAR(50) NOT NULL,
  accion VARCHAR(50) NOT NULL,
  detalles TEXT NOT NULL,
  fecha_hora DATETIME NOT NULL,
  ip_cliente VARCHAR(45) NOT NULL
);
```

---

## 4. Agregar el Enlace al Menú de Navegación

En las páginas de tu proyecto (`admin.php`, `index.php`, etc.), incluye el helper y muestra el enlace únicamente si el usuario tiene permiso:

```php
<?php require_once 'backend/auth_helper.php'; ?>

<nav>
  <a href="panel.php">Inicio</a>
  <?php if (esAdminPrincipal($pdo)): ?>
    <a href="respaldo.php">💾 Respaldo</a>
  <?php endif; ?>
  <a href="logout.php">Salir</a>
</nav>
```

---

## 5. Parámetros de PHP Recomendados en cPanel

En `cPanel > Seleccionar Versión de PHP > Opciones`:
* `upload_max_filesize = 64M` (o más si tienes muchas fotos)
* `post_max_size = 64M`
* `memory_limit = 512M`
* `max_execution_time = 300`
