Reviewed-on: #1
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/):
npm install
Desarrollo
npm run dev
Vite arrancará el servidor de desarrollo, normalmente en http://localhost:5173.
Build de producción
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 contitleyurl(la mayoría son anclas#seccion).sections— lista de secciones conanchor,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.comno 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:
- nginx devuelve
403a los user-agents de rastreadores conocidos. - Cabecera
X-Robots-Tag: noindex, nofollow, noarchive, nosnippet, noimageindex, notranslate, noai, noimageaien todas las respuestas. public/robots.txt(Disallow: /) y<meta name="robots">enindex.html.
- nginx devuelve
Automatización: .gitea/workflows/deploy.yml (workflow pipeline) tiene dos
jobs:
build(siempre):npm ci,npm run build, comprobación de que el bundle llevameta robots+robots.txt, ybash -ndel script de deploy.deploy(sólo si NO es una PR): repite el build y ejecutascripts/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:
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
- Añadir las páginas legales (
/cookies,/aviso-legal) con React Router. - Reemplazar los
dangerouslySetInnerHTMLpor un sanitizador (DOMPurify) antes de producción. - Descargar las imágenes del
wp-content/uploadsdel export y servirlas desde/public/img/en lugar de hotlinkear ahttp://remigracion.es/. - 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.