# HelioHost / Plesk

## Flujo recomendado

El código se modifica en VS Code, se confirma con Git y se envía a GitHub. Plesk obtiene el repositorio y despliega el contenido en `httpdocs`.

```text
VS Code -> GitHub -> Plesk Git -> httpdocs
```

Las credenciales de producción no deben formar parte del repositorio.

## Base de datos local y servidor

La aplicación busca la configuración de base de datos en este orden:

1. variables de entorno `DB_HOST`, `DB_DATABASE`, `DB_USERNAME`, `DB_PASSWORD`;
2. `../private/database.php`;
3. `config/database.php`.

En XAMPP se usa normalmente `config/database.php`, que está ignorado por Git.

En HelioHost se recomienda crear, fuera de `httpdocs`:

```text
/home/USUARIO.helioho.st/private/database.php
```

con esta estructura:

```php
<?php

declare(strict_types=1);

return [
    'host' => 'localhost',
    'port' => 3306,
    'database' => 'NOMBRE_REAL_DE_LA_BASE',
    'username' => 'USUARIO_REAL_DE_LA_BASE',
    'password' => 'CONTRASENA_REAL',
    'charset' => 'utf8mb4',
    'timezone' => '-06:00',
];
```

No se debe guardar ese archivo con credenciales reales dentro del repositorio.


## MapTiler / mapa Satélite

`config/map.local.php` está ignorado por Git a propósito. Por ello, una key que funciona en XAMPP no viaja a GitHub ni aparece automáticamente en un deploy de Plesk.

La aplicación busca la key de MapTiler en este orden:

1. `../private/map.php`;
2. `config/map.local.php`;
3. variable de entorno `MAPTILER_API_KEY`.

Para HelioHost se recomienda crear una sola configuración privada fuera de `httpdocs`:

```text
/home/USUARIO.helioho.st/private/map.php
```

Contenido:

```php
<?php

declare(strict_types=1);

return [
    'maptiler_api_key' => 'TU_API_KEY_REAL',
];
```

No hagas `git add` de una key real. `config/map.local.php` continúa disponible para XAMPP y como alternativa manual dentro de `httpdocs/config`, pero el archivo externo evita depender de que el proceso de despliegue conserve archivos locales del directorio publicado.

Si MapTiler responde 403 en producción aunque la configuración exista, revisa en la cuenta de MapTiler que **Allowed HTTP origins** incluya el dominio real de HelioHost. El acceso mediante `/public` no requiere una ruta especial para MapTiler y las rutas internas del proyecto se calculan desde `public/index.php`.

## Rutina normal de actualización

```bash
git add .
git commit -m "Descripcion del cambio"
git push
```

Después del `push`, Plesk debe obtener el nuevo commit. Si no existe un webhook que dispare el pull automáticamente, se puede usar `Pull now` en el repositorio Git de Plesk.

## Producción

Mantener `APP_DEBUG=false`. La raíz web recomendada es `public/`.
