Files
remigracion/README.md
T
danoloan10 7af3e36de4
pipeline / Build + comprobaciones (pull_request) Successful in 15s
pipeline / Desplegar en el host (pull_request) Skipped
ci(deploy): el pipeline corre entero en las PRs menos el despliegue
- 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.
2026-10-26 15:54:23 +01:00

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.