# Instalación en VPS con cPanel

## Requisitos

- PHP 8.2 o superior con extensiones BCMath, Ctype, Fileinfo, JSON, Mbstring, OpenSSL, PDO, PDO MySQL, Tokenizer y XML.
- Composer 2.
- MySQL o MariaDB.
- Un subdominio recomendado, por ejemplo `lpm.tudominio.com`.

## 1. Crear la base de datos

En **cPanel > Bases de datos MySQL** crea una base, un usuario y una contraseña segura. Asigna el usuario a la base con **todos los privilegios**. Conserva los nombres completos que cPanel genera con el prefijo de la cuenta.

## 2. Subir archivos

Descomprime el proyecto en una carpeta como `/home/TU_CUENTA/lpm-esencial`. Configura el documento raíz del subdominio hacia `/home/TU_CUENTA/lpm-esencial/public`. No expongas la raíz completa del proyecto dentro de `public_html`.

## 3. Configurar entorno

Copia `.env.example` a `.env`. Ajusta `APP_URL`, `DB_DATABASE`, `DB_USERNAME`, `DB_PASSWORD` y los campos `ADMIN_*`. La contraseña inicial debe tener al menos 10 caracteres.

## 4. Ejecutar comandos

Desde Terminal de cPanel, dentro de la carpeta del proyecto:

```bash
composer install --no-dev --optimize-autoloader
php artisan key:generate
php artisan migrate --seed
php artisan optimize
```

## 5. Permisos

Las carpetas `storage` y `bootstrap/cache` deben ser escribibles por PHP. En la mayoría de los VPS funcionan con permisos 775. No uses 777 salvo indicación expresa del proveedor.

## 6. Primera entrada

Abre el subdominio e inicia sesión con los datos `ADMIN_EMAIL` o `ADMIN_USERNAME` y `ADMIN_PASSWORD`. Después verifica Usuarios, Áreas y Configuración.

## Actualizaciones futuras

Antes de cada actualización crea respaldo de archivos y base de datos. Las siguientes entregas agregarán archivos y migraciones; se aplicarán con `php artisan migrate --force`, nunca con `migrate:fresh`.