senzapaura_es/despliegue/estudio.md

Puesta en marcha de Estudio

Estudio es la aplicación nueva de administración, con artefacto build-estudio y servicio senzapaura-estudio en 127.0.0.1:3002. Su instalación es independiente del panel anterior. Estos pasos son un procedimiento para el servidor; no se han ejecutado en producción.

Preparación

1. Conservar una copia PostgreSQL completa y una copia de los medios antes de importar. La exportación JSON editorial no sustituye esas copias.
2. Preparar la release mediante desplegar.sh, que construye sitio, panel y Estudio. El instalador general instala sitio y panel; Estudio se instala expresamente con los pasos siguientes.
3. Crear /var/www/senzapaura/.env.estudio, propiedad del usuario de servicio y con permisos 600. Debe contener la misma DATABASE_URL de producción que usa el sitio, ORIGIN con el dominio HTTPS elegido para Estudio y la configuración de correo necesaria para el acceso normal. No copiar .env.estudio.local ni las credenciales demo. El código fijo de desarrollo no está habilitado en el build de producción.
4. Crear /var/www/senzapaura/media/estudio/imagenes con permisos para el usuario senzapaura. El servicio fija rutas absolutas para imágenes, audio y ondas. Se necesitan ffmpeg y ffprobe.

Desde la release, ejecutar como el usuario de servicio:

node --env-file=/var/www/senzapaura/.env.estudio scripts/estudio/preparar.mjs
node --env-file=/var/www/senzapaura/.env.estudio scripts/estudio/administrar.mjs ver

La preparación crea las tablas editoriales, importa una instantánea, aplica la unificación de Personas y sitúa la inspiración en la ficha de Canción sin modificar el catálogo público. Si ya se importó, conserva los borradores y ejecuta esas migraciones de forma idempotente. Para un almacén importado por una versión anterior también pueden ejecutarse explícitamente scripts/estudio/actualizar-personas.mjs y scripts/estudio/actualizar-inspiracion.mjs con el mismo archivo de entorno.

Servicio y revisión

sudo install -m 644 despliegue/senzapaura-estudio.service /etc/systemd/system/senzapaura-estudio.service
sudo systemctl daemon-reload
sudo systemctl enable --now senzapaura-estudio
curl -fsS -o /dev/null http://127.0.0.1:3002/entrar

Configurar el proxy para el dominio elegido hacia 127.0.0.1:3002, conservando cabecera Host y protocolo HTTPS. El límite de carga es 260 MiB. Los archivos privados deben pasar por los endpoints de la aplicación; no publicar el directorio de medios mediante un alias genérico.

Revisar los recorridos con una cuenta administradora real y códigos enviados por correo. Preparar no equivale a activar: mientras esté en preparación, publicar una ficha editorial no cambia el sitio público.

Cambio de escritor

Detener la edición durante el cambio. Si el catálogo legado cambió desde la importación, conciliarlo antes de continuar; la activación rechaza una fuente distinta. Revisar también los intérpretes reales que falten en el catálogo, sin inventarlos.

Guardar la exportación fuera del directorio de release, con nombre nuevo y permisos restringidos:

node --env-file=/var/www/senzapaura/.env.estudio scripts/estudio/administrar.mjs exportar /ruta/privada/estudio-previo.json
node --env-file=/var/www/senzapaura/.env.estudio scripts/estudio/administrar.mjs activar /ruta/privada/estudio-previo.json

La activación comprueba el esquema del respaldo, la revisión editorial y la huella del catálogo. Instala guardas para que Estudio sea el escritor editorial del catálogo. No publica todos los borradores automáticamente. Cambiar entonces el acceso administrativo al dominio de Estudio y retirar el acceso editorial al panel antiguo.

Las actualizaciones de código reinician Estudio y comprueban su endpoint de acceso cuando el servicio está habilitado. No activan el almacén editorial automáticamente.

Suspensión y recuperación

administrar.mjs desactivar suspende las publicaciones desde Estudio y elimina el bloqueo efectivo del escritor legado al cambiar el modo. No revierte contenido publicado ni restaura una copia. La vuelta a una versión de código anterior tampoco revierte la base: si se necesita recuperar datos, debe seguirse el procedimiento de restauración de PostgreSQL y medios, comprobando compras y referencias.