Vistas previas y publicación

Lo más obstinado sobre Showly: la producción no recibe nada que no haya sido una vista previa. Esta página explica por qué y qué significa eso en la práctica.

Qué es una vista previa

Una vista previa es un artefacto de compilación inmutable más una URL enrutable. Lleva:

• el SHA de confirmación al que se aplicó el parche
• la diferencia con el artefacto de producción en vivo
• el registro de construcción
• comprobar resultados (pelusas, verificación de tipos, ganchos de CI personalizados)
• el agente o humano que lo produjo

Las vistas previas de un espacio de trabajo autenticado viven en un espacio de nombres aislado. Están bloqueadas para rastreadores (X-Robots-Tag: noindex), no caducan y nunca comparten secretos con producción. La prueba pública sin cuenta y no reclamada es un flujo independiente y sigue caducando después de aproximadamente una hora si no se reclama.

Cómo se activa una vista previa

Hay tres formas en que se produce una compilación:

• Su agente (Claude Code / Codex sobre MCP) llama a create_preview después de organizar un cambio.
• Usted construye desde la web GitHub. conectada y MCP puede resolver la rama conectada y crear una vista previa privada protegida con contraseña; Pro+ espacios de trabajo pueden elegir el acceso de miembros del espacio de trabajo. La implementación automática push está desactivada de forma predeterminada y, cuando se habilita explícitamente, crea solo una vista previa de miembro del espacio de trabajo privado, nunca una versión en vivo. La implementación automática desatendida actualmente requiere Pro+ y un objetivo de compilación estático; Los objetivos de tiempo de ejecución no compatibles se omiten con una notificación en la aplicación. (La fuente se clona con un token de aplicación GitHub de alcance breve y de corta duración que nunca ingresa al entorno de compilación).
• Un reintento/reconstrucción. Una implementación fallida o cancelada se puede reconstruir, desde el botón Reconstruir del panel o la herramienta retry_deployment MCP. Showly conserva el paquete fuente, por lo que una reconstrucción se realiza con un clic y no se debe volver a cargar.

Cada ruta llega al mismo artefacto + URL de vista previa. Las versiones preliminares son gratuitas. Una implementación de producción exitosa consume 15 créditos; producción fallida las implementaciones no lo hacen. Si una compilación falla, la implementación pasa por la etapa de falla, código de error, mensaje y un final del registro de compilación para que pueda ver por qué antes de volver a intentarlo.

Para el acceso con contraseña, Showly genera un breve código compartido XXX-XXX sin caracteres ambiguos. En su lugar, puede elegir cualquier contraseña de entre 6 y 128 caracteres. El texto sin formato se muestra solo cuando se crea la Vista previa o se gira su contraseña; utilice Copiar URL + contraseña para copiar un bloque de credenciales listo para reenviar. Las contraseñas existentes siguen siendo válidas hasta que las rote. Para revisiones internas confidenciales, prefiera el acceso a la organización Pro o elija una contraseña más larga.

Qué es una publicación

Una publicación es la promoción de un _artefacto de vista previa existente_ a la ruta de producción. Showly no se reconstruye al publicar. El artefacto que usted aprobó es el artefacto que se envía. Esto es lo que hace que la reversión sea segura: la reversión es "volver a intercambiar el puntero de ruta", no "volver a ejecutar la compilación".

Vista previa y En vivo son direcciones separadas. La Vista previa permanece privada y nunca se convierte en una URL pública; la publicación crea una implementación de producción para la dirección en vivo del sitio. La vista previa de origen permanece disponible para su revisión hasta que se elimine explícitamente, sin caducidad según el plan.

¿Qué es la aprobación?

La aprobación es una decisión registrada por parte de un miembro del espacio de trabajo a quien se le permite aprobar la publicación. Los roles son owner, admin, developer, deployer y viewer; una solicitud de publicación creada durante MCP requiere una aprobación de owner o admin. La decisión es duradera: incluso si el aprobador abandona el espacio de trabajo mañana, el registro de auditoría lo nombra como aprobador de la revisión N. Un solicitante no puede aprobar su propia solicitud y el rechazo es definitivo.

Los flujos de trabajo de aprobación están controlados por el derecho approvalWorkflows. cuando está deshabilitado, el solicitante publica con una acción explícita del navegador o el confirmación de dos pasos publish_site del agente. La inscripción OTP/MFA no es requerido, y la puerta de aprobación exenta se registra en el registro de auditoría.

¿Qué es la reversión?

El botón Retroceder en el editor cambia el puntero de ruta en vivo a un artefacto anterior. La reversión sigue siendo una acción separada de alto riesgo con sus propios controles de confirmación. El artefacto revertido se _conserva_; puede volver a promocionarlo más tarde si resulta que la reversión fue una llamada incorrecta.

Por qué es importante el ciclo de publicación

Una publicación típica Showly dice:

1. El agente llama al create_change_plan → un humano revisa el plan.
2. El agente llama a apply_site_patch + create_preview → URL de vista previa generada.
3. Vista previa de las visitas humanas, recorrido por flujos críticos.
4. Opcional: run_checks ejecuta la matriz de verificación personalizada del espacio de trabajo.
5. El agente llama request_publish → se crea una aprobación pendiente. La herramienta devuelve un sobre de aprobación (ver más abajo) con un enlace profundo webApprovalUrl.
6. Un miembro del espacio de trabajo abre el webApprovalUrl y aprueba (o rechaza) la solicitud.
7. Un humano hace clic en Publicar en la interfaz de usuario web; no se requiere configuración de OTP. La publicación promueve la implementación de vista previa aprobada a producción y lleva sourceDeploymentId configurado en la identificación de esa implementación de vista previa.

request_publish devuelve un sobre de aprobación:

{
  "approvalId": "apr_...",
  "deploymentId": "dep_...",
  "state": "pending",
  "expiresAt": "2026-05-31T10:00:00.000Z",
  "reused": false,
  "webApprovalUrl": "https://showly.ai/app/deployments/dep_.../publish"
}

state es uno de pending, approved, denied o expired, y reused es true cuando se devuelve una aprobación pendiente existente para la misma implementación en lugar de una nueva. publish_site también está disponible a través de MCP como un flujo de confirmación humana de dos pasos vinculado a la implementación.

Cada paso es auditable; cada paso tiene un modo de falla obvio que no llega a producción.

¿Qué pasa con las revisiones?

Las revisiones aún pasan primero por una vista previa privada. No hay bypass de emergencia: La publicación aún necesita una vista previa lista, la confirmación de publicación explícita y cualquier aprobación requerida por el espacio de trabajo, pero no la inscripción OTP.