- Nuevo trigger pull_request: el job 'build' valida dependencias, build, smoke de noindex y sintaxis de scripts/deploy.sh sin tocar el host. - El job 'deploy' queda condicionado a github.event_name != 'pull_request': sólo despliega en push a master o workflow_dispatch. - Workflow renombrado a 'pipeline' (fichero sigue siendo deploy.yml) y concurrency agrupada por ref. - README: documentado el comportamiento en PRs vs master.
116 lines
3.9 KiB
Markdown
116 lines
3.9 KiB
Markdown
# 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 **<http://remigracion.jumpingcrab.com/>**
|
|
(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 `<meta name="robots">` 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.
|