Conceptos

Arquitectura

Cómo pasa un cambio del agente a una Vista previa privada, la aprobación humana y el sitio En vivo.

La arquitectura pública de Showly describe el ciclo de entrega en el que pueden confiar los clientes. El proveedor de nube, la región, la topología de red, los nombres de recursos y los límites de servicios internos son detalles de implementación y no forman parte de esta documentación.

Ciclo de entrega

Conectar un espacio de trabajo. Una persona conecta el sitio y decide qué miembros, tokens de API y clientes MCP pueden acceder a él.
Preparar un cambio. Un agente o una integración solo lee el contexto permitido por sus ámbitos, propone un plan y envía los archivos modificados.
Crear una Vista previa privada. Showly compila el cambio en un entorno aislado, ejecuta las comprobaciones solicitadas y devuelve una URL de Vista previa protegida. La versión En vivo actual no cambia.
Revisar y aprobar. Una persona revisa la Vista previa, las diferencias y los resultados. Los espacios con políticas de aprobación deben completarlas antes de publicar.
Publicar En vivo. Showly publica la versión revisada y registra la acción en el historial de auditoría. Las versiones anteriores permanecen disponibles para revertir según la retención y los límites del plan.

flowchart LR
  accTitle: Arquitectura de entrega de Showly
  accDescr: Los miembros del equipo, agentes y automatizaciones usan accesos con ámbitos. Los cambios pasan por la autorización del espacio, una Vista previa privada, aprobación humana, publicación En vivo e historial de versiones.

  subgraph access["Superficies de acceso"]
    direction TB
    member["Miembro del equipo"] --> web["Showly Web"]
    agent["Agente"] --> mcp["Herramientas MCP"]
    automation["Automatización"] --> api["API REST"]
  end

  subgraph workspace["Límite del espacio"]
    direction TB
    auth["Autorización por ámbitos"]
    change["Plan y archivos del cambio"]
    preview["Vista previa privada y comprobaciones"]
    gate{"Confirmación o aprobación humana"}
    auth --> change --> preview --> gate
  end

  subgraph delivery["Entrega gestionada"]
    direction TB
    live["Sitio En vivo"]
    versions["Historial de versiones"]
    live --> versions
    versions -->|"Revertir"| live
  end

  web --> auth
  mcp --> auth
  api --> auth
  gate -->|"Aprobado"| live
  gate -->|"Cambios solicitados"| change

Límites del producto

Límite del espacio de trabajo. Los sitios, despliegues, tokens, roles y registros de auditoría pertenecen a un espacio. Las solicitudes se autorizan contra ese espacio antes de devolver o modificar datos.

Límite de la Vista previa. Una Vista previa está separada del sitio En vivo y tiene control de acceso. Crear o actualizar una Vista previa no la publica.

Límite de publicación. Las acciones que cambian producción requieren una confirmación explícita o el flujo de aprobación del espacio. Un agente no puede omitir ese control.

Límite de versión. Cada publicación apunta a una versión revisada concreta. Revertir selecciona una versión anterior, en vez de editar directamente el resultado En vivo.

Autenticación y auditoría

Las personas usan la aplicación web de Showly con su sesión de usuario.
Los scripts usan tokens de acceso personal; los agentes usan tokens MCP con ámbitos.
Los tokens se limitan al espacio, los recursos y las acciones autorizados.
Los agentes y las integraciones no reciben credenciales de alojamiento de Showly.
Las acciones de lectura, compilación, publicación, reversión y eliminación se registran cuando la superficie correspondiente lo admite.

Consulta Ámbitos y tokens de MCP y RBAC y aprobaciones para conocer el contrato público de autorización.

Alojamiento y ubicación de los datos

Showly es un servicio gestionado. El proveedor de nube, la región, el diseño de red, la tecnología de almacenamiento y la topología de servicios pueden cambiar sin modificar la API pública ni el flujo de entrega.

No uses el código del repositorio, los metadatos de respuesta, los registros DNS ni documentación histórica para inferir una ubicación de alojamiento contractual. Si tu organización tiene requisitos de residencia de datos, normativos o de nube propia, confirma con Showly las opciones disponibles antes de incorporar datos de producción.

Modos de despliegue

Showly admite salida estática y determinadas aplicaciones renderizadas en el servidor. Los modos y capacidades pueden variar por espacio y entorno; usa las capacidades de destino que devuelve el producto como fuente de verdad. Showly gestiona la infraestructura subyacente y no es una superficie de configuración del cliente.

Siguiente lectura

Manifiesto del sitio — el contrato de compilación y ejecución controlado por el cliente.
Vistas previas y publicación — el flujo de Vista previa y En vivo.
RBAC y aprobaciones — reglas de acceso, confirmación y aprobación.