# Setup Hyvä independiente en server Madrid (hyva.elganso.com)

Entorno de referencia compartido para que el equipo trabaje en la migración Hyvä **sin** depender del symlink al release ScandiPWA de test.elganso.com.

**Server**: Madrid EC2 `51.94.239.98` (instance `i-0a39d37d263b3bcb9`)
**Dominio**: https://hyva.elganso.com (basic auth `test` / `!test123!`)
**Path real**: `/home/elganso-hyva/htdocs/hyva.elganso.com/current/` (sin symlinks a `elganso-test`)

## Acceso para compañeros

### SSH

```bash
ssh -i /ruta/dev-test-andres.pem elganso-hyva@51.94.239.98
# o root para tareas admin
ssh -i /ruta/dev-test-andres.pem root@51.94.239.98
```

Key SSH: la misma `dev-test-andres.pem` (4096 bit RSA) que ya usabais para el server original Madrid.

### CloudPanel UI (gestión)

- URL: https://hyva.elganso.com:8443/
- User: `andres`
- Pass: `ElGansoCloud2026Mr`

### Code Deploy panel (CareUcom Deploy fork)

- URL: https://dev-code-deploy-test.elganso.com/
- User: `andres.fernandez`
- Pass: `mL3mH3UJwARUasp`
- Target hyva.elganso.com: ver sección "Code Deploy targets" abajo

### MySQL

- Host: `127.0.0.1`
- Port: `3306`
- **Master (root)**: `root` / `ElGansoHyva2026Mr` (en `/root/.my.cnf`, sin pass desde shell root)
- **Magento DB**: `elganso-hyva` / `elganso-hyva` / `HyvaDb2026Mr`
- Magento DB es clone de `elganso-test` (datos reales del catalog)

### Redis (compartido con test, distinct DB numbers)

- Host: `127.0.0.1`
- Port: `6379`
- Pass: ninguno
- Magento cache DB: `0`
- Magento sessions DB: `1`
- Page cache: `2`

### OpenSearch (compartido)

- Host: `127.0.0.1`
- Port: `9200`
- Índices propios prefijo `hyva_` (configurar via Magento `setup:upgrade`)

## Arquitectura del setup

```
Internet → nginx :443 (SSL Let's Encrypt) → Varnish :6081 → nginx :8080 backend → PHP-FPM :sock
                                                                                       │
                                                              /home/elganso-hyva/htdocs/hyva.elganso.com/current/
                                                              └── Magento 2.4.8 + theme ander3024/hyva-elganso
```

- **nginx vhost**: `/etc/nginx/sites-enabled/hyva.elganso.com.conf`
- **PHP-FPM pool dedicado**: `/etc/php/8.3/fpm/pool.d/elganso-hyva.conf` (sock en `/run/php/php8.3-fpm-elganso-hyva.sock`)
- **User Linux**: `elganso-hyva` (home `/home/elganso-hyva`)
- **PHP version**: 8.3.30
- **Composer**: 2.9.2

## Setup desde cero (para nuevo dev / replicar)

```bash
# 1. SSH como elganso-hyva
ssh elganso-hyva@51.94.239.98

# 2. Ir al path Magento
cd ~/htdocs/hyva.elganso.com/current

# 3. Verificar composer + PHP
php --version    # 8.3.x
composer --version    # 2.9.x

# 4. Ya tienes vendor/ y app/ instalados — no necesitas composer install. Si quieres re-install:
composer install --prefer-dist --no-dev

# 5. Magento status
bin/magento module:status | head
bin/magento cache:status
```

## Workflow desarrollo

### Theme `ander3024/hyva-elganso`

El theme vive en `vendor/ander3024/hyva-elganso/` (vía composer require). Para iterar:

```bash
# 1. Clonar repo theme en tu local
git clone git@github.com:ander3024/hyva-elganso.git
cd hyva-elganso

# 2. Hacer cambios en templates/CSS

# 3. Rebuilds Tailwind local
cd web/tailwind && npm install && npm run build

# 4. Commit + push
git add Magento_Catalog/templates/product/list/item.phtml
git commit -m "PLP: refactor algo"
git push

# 5. En el server hyva, pull los cambios
ssh elganso-hyva@51.94.239.98
cd ~/htdocs/hyva.elganso.com/current
composer update ander3024/hyva-elganso
bin/magento cache:clean block_html layout full_page
```

Para cambios de CSS (`tailwind-source.css`), tras `composer update` también:

```bash
bin/magento setup:static-content:deploy es_ES en_US -t Yeboyebo/hyva_elganso -t Magento/luma -f --no-html-minify
# Si pub/static no se actualiza (bug conocido):
THEME=/home/elganso-hyva/htdocs/hyva.elganso.com/current/vendor/ander3024/hyva-elganso
CUR=/home/elganso-hyva/htdocs/hyva.elganso.com/current
for L in es_ES en_US; do
    cp $THEME/web/css/styles.css $CUR/pub/static/frontend/Yeboyebo/hyva_elganso/$L/css/styles.css
done
date +%s > $CUR/pub/static/deployed_version.txt
sudo systemctl reload nginx
varnishadm "ban req.url ~ ."
```

### Módulos custom `Yeboyebo_*`

Los módulos custom Hyvä viven en `vendor/ander3024/hyva-elganso/_modules/Yeboyebo_*/` (en el repo theme). Para deploy a `app/code/`:

```bash
THEME=/home/elganso-hyva/htdocs/hyva.elganso.com/current/vendor/ander3024/hyva-elganso
CUR=/home/elganso-hyva/htdocs/hyva.elganso.com/current
for MOD in HyvaCsp HyvaSearch HyvaCheckoutStripeFix RewardPointsHyva ValesHyva TarjetasMonederoHyva StorePickupHyva MrwPuntosRecogidaHyva; do
    rsync -a $THEME/_modules/Yeboyebo_$MOD/ $CUR/app/code/Yeboyebo/$MOD/
done
bin/magento setup:upgrade
bin/magento setup:di:compile
bin/magento cache:flush
```

## Code Deploy targets

Para que el panel **CareUcom Deploy** (https://dev-code-deploy-test.elganso.com/) pueda deployar a este path:

1. En el panel, ir a **Environments** → editar el environment `hyva` (o crearlo si no existe).
2. Configurar:
   - `aws_region`: `eu-south-2`
   - `aws_tag_value`: `hyva-elganso` (etiqueta EC2 a buscar)
   - Target path: `/home/elganso-hyva/htdocs/hyva.elganso.com/current/`
   - SSH user: `elganso-hyva`
3. Asegurar que la SSH key del MGT container está en `/home/elganso-hyva/.ssh/authorized_keys` (ya copiada de `/root/.ssh/`).

## Gotchas y limitaciones conocidas

### CloudPanel `clpctl site:add:*` no funciona

Tras el reset de MySQL root password, CloudPanel quedó con creds desfasadas. Workaround: hicimos el setup del site **manualmente** (user Linux + htdocs + vhost + PHP-FPM pool) sin pasar por `clpctl site:add:php`. El site SE PUEDE registrar en CloudPanel SQLite manualmente si queréis verlo en el panel UI (TODO).

### Espacio en `/`

La partición root `/` tiene solo **1.4G libre** (de 9.7G). Cuidado con:
- `/tmp/` (algunos installers escriben grande aquí)
- `/var/log/` (rotación está OK pero monitor)
- `/var/lib/` (datos varios)

`/home` tiene 166G libres holgados. Ahí van datos Magento, MySQL, logs aplicación.

### Acceso al ERP de El Ganso (`api.elganso.com`)

El firewall del bloque OVH `37.59.72.224/28` solo permite tráfico desde ciertas IPs (whitelist). El IP de este server (`51.94.239.98`) está **autorizado** (regla `permit 51.94.239.98/32 tcp dst-port 443`, añadida 2026-05-10 via OVH API). Si la IP del server cambia, hay que reabrir.

### Stripe checkout

Las 4 clases virtualType de `Hyva\CheckoutStripe\Magewire\View\PaymentRequestButton*` viven en `app/code/Yeboyebo/HyvaCheckoutStripeFix/StripeClasses/` con PSR-4 mapping en `composer.json` root. Si hacéis `composer update hyva-themes/magento2-hyva-checkout-stripe`, las clases siguen funcionando (no se borran como sí pasaría si vivieran en vendor).

## Backups y rollback

### Sites originales (referencia)

- nginx vhost backup: `/etc/nginx/sites-enabled/hyva.elganso.com.conf.bak.preindep.20260512_182845`
- Symlink viejo eliminado: `/home/elganso-test/htdocs/hyva.elganso.com` (era → `dev-test.elganso.com` → `test.elganso.com`)

### CloudPanel SQLite

DB original (malformed): `/home/clp/htdocs/app/data/db.sq3.malformed.YYYYMMDD_HHMMSS`
Nueva DB (schema vacío con `clpctl vhost-templates:import` aplicado).

### MySQL

- Backup root pass anterior: desconocido (CloudPanel cacheaba un valor que ya no funciona).
- DB `elganso-test` intacta, no afectada por el reset.

## Contacto / dueño

**Andrés Fernández** — `andres@careucom.com` — setup 2026-05-12.
