# Remigración — React
Proyecto base para migrar el sitio de WordPress (`Remigracion/20260329_remigracionorg_...`) a un stack moderno con **React + Vite**.
## Requisitos
- Node.js 18 o superior
- npm (o pnpm / yarn si lo prefieres)
## Instalación
Desde esta carpeta (`remigracion-react/`):
```bash
npm install
```
## Desarrollo
```bash
npm run dev
```
Vite arrancará el servidor de desarrollo, normalmente en `http://localhost:5173`.
## Build de producción
```bash
npm run build
npm run preview
```
El resultado se genera en `dist/`.
## Estructura
```
remigracion-react/
├── index.html # punto de entrada HTML
├── package.json
├── vite.config.js
├── public/ # assets estáticos servidos tal cual
└── src/
├── main.jsx # bootstrap de React
├── App.jsx # componente raíz
├── App.css
├── index.css
└── assets/
```
## Cómo se pobló el contenido
`src/content/site.json` se generó extrayendo la home (`wp_posts` ID 10044) y sus metadatos Elementor (`_elementor_data`) del dump SQL del export. Ver `../GUIA_WORDPRESS.md` para el detalle del proceso.
El JSON tiene tres claves:
- `site` — `name`, `description`, `url`, `lang`.
- `menu` — ítems del menú principal con `title` y `url` (la mayoría son anclas `#seccion`).
- `sections` — lista de secciones con `anchor`, `headings`, `paragraphs`, `images`, `lists`.
## Despliegue
Entorno de previsualización privado en ****
(mismo host que `localesp.es` y `git.localesp.es`).
- **Sin TLS a propósito:** el DNS de `remigracion.jumpingcrab.com` no permite
emitir un certificado Let's Encrypt, así que se sirve sólo por HTTP.
- **No indexable:** el entorno no debe aparecer en buscadores, agregadores ni
crawlers de IA. Se aplica en tres capas independientes:
1. nginx devuelve `403` a los user-agents de rastreadores conocidos.
2. Cabecera `X-Robots-Tag: noindex, nofollow, noarchive, nosnippet,
noimageindex, notranslate, noai, noimageai` en todas las respuestas.
3. `public/robots.txt` (`Disallow: /`) y `` en
`index.html`.
Automatización: `.gitea/workflows/deploy.yml` (workflow `pipeline`) tiene dos
jobs:
- **`build`** (siempre): `npm ci`, `npm run build`, comprobación de que el
bundle lleva `meta robots` + `robots.txt`, y `bash -n` del script de deploy.
- **`deploy`** (sólo si NO es una PR): repite el build y ejecuta
`scripts/deploy.sh`.
En las **pull requests** el pipeline corre entero menos el despliegue, así que
sirve para verificar el CI antes de mergear. Se despliega en cada push a
`master` y también a mano con `workflow_dispatch`. El runner self-hosted de
Gitea corre como root en el mismo host, así que el job no necesita SSH ni
secretos.
Artefactos y servicios en el host (mismo patrón que
`prototipo-yb01-ef.localesp.es`):
| Elemento | Ruta |
|---|---|
| Build estático (raíz de nginx) | `/opt/remigracion/dist` |
| vhost nginx (fuente en `deploy/nginx.conf`) | `/etc/nginx/conf.d/remigracion.jumpingcrab.com.conf` |
| Script de despliegue | `scripts/deploy.sh` |
Despliegue manual:
```bash
npm ci && npm run build
sudo bash scripts/deploy.sh
```
El script sincroniza `dist/`, etiqueta el árbol para SELinux
(`httpd_sys_content_t`), instala el vhost si cambió (con rollback si
`nginx -t` falla), recarga nginx y verifica `200` + `X-Robots-Tag`.
## Próximos pasos
1. Añadir las páginas legales (`/cookies`, `/aviso-legal`) con React Router.
2. Reemplazar los `dangerouslySetInnerHTML` por un sanitizador (`DOMPurify`) antes de producción.
3. Descargar las imágenes del `wp-content/uploads` del export y servirlas desde `/public/img/` en lugar de hotlinkear a `http://remigracion.es/`.
4. Revisar el contenido extraído — algunas secciones tienen 2 versiones (desktop y móvil) en el HTML original; el extractor se queda con la primera.