SERVICIO NDC DE AGENCIA 0.1.0 — CANDIDATO, NO DESPLEGADO

Necesita un servidor con Node 24, almacenamiento persistente, HTTPS y Chromium con sandbox. No basta con subir el ZIP PHP a WordPress. El Dockerfile y el código están incluidos; la imagen completa aún no se ha construido/probado en un alojamiento real.

Instalación desde la carpeta servicio-agencia:
npm ci
npx playwright install --with-deps chromium
npm start
O construir el Dockerfile y ejecutar como usuario sin privilegios. No deshabilitar el sandbox de Chromium para resolver errores de instalación. El servicio escucha 127.0.0.1:8788 por defecto; en contenedor configurar NDC_BIND=0.0.0.0 y publicar sólo tras un proxy HTTPS. Proporcionar volumen persistente escribible a /data, configurado en el Dockerfile; verificar UID del usuario node.

VARIABLES (valores proporcionados por canal seguro, nunca en chat ni dentro del ZIP)
NDC_SERVICE_TOKEN: secreto maestro aleatorio de al menos 32 caracteres, distinto de todos los tokens de sitios. Sólo servicio y WordPress central de agencia.
NDC_SITE_TOKENS_JSON: objeto {"https://sitio.example":"TOKEN_ALEATORIO_UNICO"}; cada token al menos 32 caracteres, origen exacto HTTPS, sin barra final ni ruta. Nunca compartir el token maestro con clientes.
NDC_ALLOWED_HOSTS: dominios exactos separados por comas, del sitio y de sus recursos públicos. Sin comodines. Permitir únicamente los necesarios.
NDC_PUBLIC_URL: URL HTTPS pública de este servicio, para OAuth de gestión central.
NDC_DATA_DIR: carpeta privada persistente; DB 0600 y directorio 0700. Los resultados duran siete días. Jobs/intercambios OAuth almacenados cifrados AES-GCM.
PORT, NDC_BIND: escucha local.
UNSPLASH_ACCESS_KEY: opcional, sólo búsqueda de imágenes.

En wp-config.php de cada sitio que use servicios:
define('NDC_SERVICE_URL', 'https://servicio.example');
define('NDC_SERVICE_TOKEN', 'TOKEN_EXCLUSIVO_DE_ESTE_SITIO');

Además, sólo en el WordPress central que administre lotes:
define('NDC_FLEET_SERVICE_TOKEN', 'SECRETO_MAESTRO_DEL_SERVICIO');

En cada destino que autorice lotes por OAuth:
define('NDC_AGENCY_CALLBACK_URL', 'https://servicio.example/oauth/callback');
El callback es único y exacto, sin query/fragmento, no una lista abierta. ndc_fleet connect genera la autorización para el administrador existente del destino. Cada sitio debe aprobarla. No usar login automático ni generar cuentas ocultas.

En esta candidata la identidad es el origen y se supone WordPress instalado en la raíz del dominio. No conectar dos instalaciones en subdirectorios bajo un mismo origen. No soporta multisite. Cada lote indica sitio, tipo plugin/theme, slug y versión exacta (máximo 20); lectura previa, versión disponible fijada y lectura posterior. No hay rollback de migraciones de base de datos ni transacción entre sitios. Si necesita aprobación, se detiene para mostrarla. No repetir automáticamente jobs interrumpidos.

La clave de cifrado del almacén se deriva del secreto maestro. NO rotarlo sin un procedimiento de migración/descifrado: invalidaría el acceso a las conexiones y trabajos guardados. Esta candidata no incluye herramienta de migración de clave. Para reiniciar con otra clave, revocar previamente las conexiones WP afectadas y volver a emparejar; conservar o retirar datos antiguos según la política de la agencia. No exponer el fichero SQLite al servidor web.

QUÉ SALE DEL SITIO
Compilación: fuentes del tema borrador. PDF: bytes del PDF seleccionado (máximo 8 MiB, 100 páginas, sin OCR). Render/audit: URL pública del sitio, sin cookies de sesiones. Unsplash recibe sólo la consulta de búsqueda. El resultado de búsqueda proporciona atribución y download_location; esta versión no implementa importación ni registro de descarga en Unsplash.

TAILWIND
ndc_services action=compile crea un job. Consultar action=job hasta estado complete. Escribir result.css en dist/styles.css mediante ndc_workspace /file/write con expected_source_hash=result.source_hash. Releer fuentes si hay conflicto. Publicar el borrador con el mismo control de hash y comprobar la página. No publicar CSS compilado de una versión anterior. No se cargan plugins JS ni archivos locales arbitrarios de Tailwind.

VALIDACIÓN PENDIENTE EN ALOJAMIENTO
Compilación y PDF reales, cola/aislamiento/idempotencia y controles de red locales pasan. Descargar y arrancar Chromium; comprobar render JS y Lighthouse en una página de prueba, hosts de recursos y ausencia de errores. Luego OAuth entre dos dominios y un lote de actualización de fixture con versión fijada. No activar despliegue de clientes ni informar auditorías como realizadas antes de estas pruebas.
