# Despliegue de Groff Metal Landing en InMotion (cPanel)

> Índice de documentación: [docs/README.md](README.md).

Guía para publicar la landing y su dashboard en el mismo hosting de groff-metal. Antes de empezar, leer la guía de groff-metal (`groff-metal/deployment.md`): esta sigue las mismas reglas de seguridad y estructura de carpetas.

> El aviso de leads por correo es opcional y usa el comando `landing:notify-lead` de groff-metal. No requiere colas ni cron: la landing lo ejecuta después de responder al visitante. Esta guía cubre su configuración y verificación sin enviar correos reales de prueba.

## 1. Requisitos

- PHP 8.2 o superior, con las extensiones `pdo_mysql`, `mbstring`, `openssl`, `fileinfo` y `gd` (genera las imágenes WebP). groff-metal ya usa `gd` en el mismo servidor, así que si groff-metal sube imágenes correctamente, esta extensión está disponible.
- Composer en el servidor (o subir `vendor/` armado localmente con la misma versión de PHP).
- Una base MySQL nueva para la landing, con su propio usuario.
- Node solo en la máquina local: el build de CSS y JS se compila localmente y se sube.

## 2. Estructura de carpetas

La landing va **al lado** de groff-metal. El importador busca groff-metal en `../groff-metal` por defecto.

```text
/home/CPANEL_USER/apps/
├── groff-metal/              ← proyecto existente (no se modifica)
└── groff-metal-landing/      ← este repositorio
    ├── .env
    ├── vendor/
    ├── storage/
    └── public/               ← raíz pública del dominio de la landing
        ├── index.php
        ├── .htaccess
        ├── assets/
        ├── build/
        └── storage -> ../storage/app/public
```

En **Domains**, la raíz del dominio o subdominio de la landing debe ser `/home/CPANEL_USER/apps/groff-metal-landing/public`. No publicar la raíz del repositorio ni copiar el proyecto dentro de `public_html`: `.env`, `.git` y `vendor` nunca deben quedar dentro de la raíz web.

## 3. Clonar el repositorio

```bash
cd /home/CPANEL_USER/apps
git clone git@github.com:desarrollo-branar/-groff-metal-landing.git groff-metal-landing
cd groff-metal-landing
git checkout main
```

El repositorio es privado: usar una deploy key de solo lectura, igual que en groff-metal.

## 4. `.env` y dependencias

```bash
cp .env.example .env
composer install --no-dev --optimize-autoloader
php artisan key:generate
```

Valores a completar en `.env`:

| Variable | Valor |
|---|---|
| `APP_ENV` | `production` |
| `APP_DEBUG` | `false` |
| `APP_URL` | URL pública de la landing, con `https://` |
| `DB_CONNECTION` | `mysql` |
| `DB_HOST`, `DB_PORT`, `DB_DATABASE`, `DB_USERNAME`, `DB_PASSWORD` | base MySQL **de la landing** |
| `LANDING_*` | opcional: los valores por defecto ya son los datos reales del negocio. Después se editan desde el dashboard |

`LANDING_WHATSAPP` por defecto es `19549558161` (+1 (954) 955-8161), confirmado por el cliente.

### Conexión de solo lectura a groff-metal (para la importación)

| Variable | Valor |
|---|---|
| `GROFF_DB_CONNECTION` | `mysql` |
| `GROFF_DB_HOST`, `GROFF_DB_PORT`, `GROFF_DB_DATABASE` | base de groff-metal |
| `GROFF_DB_USERNAME`, `GROFF_DB_PASSWORD` | un usuario MySQL creado solo para esto, con permiso **SELECT** únicamente |
| `GROFF_STORAGE_PATH` | dejarla comentada (sin definir) si groff-metal está en `../groff-metal`; si no, la ruta absoluta a `groff-metal/storage/app/public`. Ojo: `GROFF_STORAGE_PATH=` vacía no usa el valor por defecto |

En cPanel, **MySQL Databases** permite crear ese usuario y asignarle solo `SELECT` sobre la base de groff-metal. El importador solo lee, pero el permiso mínimo evita cualquier escritura por error.

### Aviso de leads por correo (opcional)

La landing no envía correo ni guarda tokens. Ejecuta `php artisan landing:notify-lead` en la carpeta de groff-metal, con un JSON por STDIN; groff-metal valida y envía con su mailer configurado (Graph en producción). El visitante no espera ese proceso.

Variables en `.env` de la landing:

| Variable | Valor |
|---|---|
| `LANDING_NOTIFY_ENABLED` | `true` para enviar aviso; por defecto `false` |
| `GROFF_PATH` | ruta absoluta a groff-metal; por defecto `../groff-metal` |
| `LANDING_PHP_BINARY` | binario PHP; por defecto `php` |
| `LANDING_NOTIFY_TIMEOUT` | segundos máximos; por defecto `20` |

En groff-metal:

| Variable | Valor |
|---|---|
| `LANDING_LEAD_RECIPIENT` | destinatario del aviso; por defecto `sales@groffmetal.com`. Debe estar en `mail.graph.allowed_recipients` si el transporte Graph está activo |

- Sin `LANDING_NOTIFY_ENABLED=true`, no se ejecuta ningún proceso.
- Éxito: el lead guarda `notified_at`; el dashboard muestra la fecha en **Leads**. Fallo: el lead se conserva, `notified_at` queda vacío y el error se registra en el log (sin el payload).
- No hace falta worker de colas, cron ni reiniciar procesos.

## 5. Base de datos, roles y primer administrador

```bash
php artisan migrate --force
php artisan db:seed --force
php artisan cms:create-admin
```

- `db:seed` crea los permisos y los roles `admin`, `publisher` y `editor`, y la solución Aluminum Railings con sus 4 productos y 4 proyectos usando las fotos del prototipo (`proposal/assets/images`). El contenido solo se crea si falta: no duplica ni pisa ediciones hechas en el dashboard. **Correrlo una sola vez**: si se vuelve a ejecutar, restablece los permisos de `publisher` y `editor` y borra los cambios hechos a mano en esos roles desde el dashboard.
- `cms:create-admin` sin opciones pide nombre, email y contraseña por teclado. No pasar `--password=` en el servidor: queda visible en la lista de procesos y en el historial.
- No existe registro público. Los demás usuarios se crean desde **Users** en el dashboard.

## 6. Importar contenido desde groff-metal

```bash
php artisan landing:import-groff --dry-run
php artisan landing:import-groff
```

- `--dry-run` muestra qué se crearía o actualizaría, sin escribir nada.
- Se puede volver a correr sin duplicar: compara por slug, actualiza solo lo que cambió y no copia de nuevo las imágenes idénticas.
- `--solution=aluminum-railings` limita la importación a una sola solución y sus productos y proyectos.
- Si falta una imagen en groff-metal, lo avisa en el resumen y sigue.

## 7. Storage y build

```bash
php artisan storage:link
```

Crea solo el enlace `public/storage`. No crear otros enlaces a mano.

El build (`public/build/`) no está en Git. Compilarlo en la máquina local y subirlo:

```bash
npm ci
npm run build
# subir la carpeta public/build/ completa a groff-metal-landing/public/build/
```

## 8. Caché y permisos

```bash
php artisan config:cache
php artisan route:cache
php artisan view:cache
```

`storage/` y `bootstrap/cache/` deben poder escribirse por el usuario de PHP. Después de cada cambio en `.env`, volver a correr `php artisan config:cache`.

## 9. Verificación antes de anunciar

1. La landing abre con la solución elegida, sus fotos y la galería.
2. Los botones de WhatsApp y Call abren el número correcto, en móvil y en escritorio.
3. Enviar una cotización de prueba: aparece en **Leads** del dashboard con estado `pending`.
4. Con `LANDING_NOTIFY_ENABLED=true`, el mismo lead muestra fecha en **Notified**. Si aparece **Not notified**, revisar el log de la landing y de groff-metal.
5. Comprobar que el comando de groff-metal existe y responde, **sin enviar correo**: mandarle un JSON inválido a propósito.

   ```bash
   cd ../groff-metal
   php artisan list | grep landing:
   echo '{}' | php artisan landing:notify-lead; echo $?
   ```

   Esperado: `exit 1` (datos inválidos, no envía nada). No anteponer `MAIL_MAILER=log` para "probar sin enviar": con `config:cache` activo esa variable se ignora y el correo saldría por Graph de verdad. La prueba real de envío es el paso 4 (una cotización de prueba llega a `sales@groffmetal.com`).
6. `/register` responde 404.
7. Entrar al dashboard como admin y revisar **Business Settings** y **Landing Settings**: guardar un cambio y confirmar que se ve en la landing.
8. `APP_DEBUG=false`: forzar una URL inexistente y comprobar que no muestra detalles técnicos.

## 10. Actualizaciones posteriores

```bash
php artisan down
git pull
composer install --no-dev --optimize-autoloader
php artisan migrate --force
php artisan config:cache && php artisan route:cache && php artisan view:cache
# subir el nuevo public/build/ si cambió el CSS o el JS
php artisan up
```

No correr `db:seed` en las actualizaciones (ver sección 5).
