Arquitectura

El servidor posee el estado. El navegador no retiene nada. La seguridad no es una capa añadida encima: es una consecuencia de dónde vive el estado.

Intención de entrada, proyección de salida. El estado vive en el servidor. El navegador no retiene nada entre solicitudes.

Seleccione un paso para ver el detalle de implementación.

El modelo de estado de dos capas

El estado se separa en dos capas con diferentes duraciones de vida, almacenamiento diferente y una regla estricta de sentido único sobre cuál puede influir en la otra. La regla se aplica estructuralmente, no por convención.

Estado durable lo que realmente ocurrió

  • Registro de eventos solo-adjuntar: los eventos se insertan, nunca se modifican
  • Los eventos pasados no pueden ser alterados por ninguna ruta de código
  • Auditable por construcción: el registro es la pista de auditoría
  • Todas las escrituras requieren autorización de la pasarela
  • Sobrevive al reinicio del servidor; sin pérdidas por diseño
solo en un sentido

Estado efímero contexto de sesión actual

  • Solo en memoria, indexado por ID de sesión
  • Mantiene contexto de UI: vista actual, flujos en curso, mensajes flash
  • Derivado del estado durable, nunca al revés
  • Nunca se usa como entrada para transiciones de estado durable
  • Descartado al finalizar la sesión; nada persiste en el cliente

El estado efímero fluye en un solo sentido. El estado durable alimenta el estado efímero. El estado efímero nunca influye en las transiciones de estado durable. Esta regla hace que la manipulación del estado del lado del cliente sea estructuralmente imposible: no hay estado del cliente que manipular.

El contrato de la pasarela

La pasarela es el límite de seguridad del sistema. Todo acceso al estado, lectura o escritura, pasa por ella. Ningún manejador, ningún middleware, ningún otro paquete toca el estado directamente. Esto no es una convención: el tipo Store no se exporta desde el paquete de estado; solo se expone la pasarela. No hay forma de evitarla.

// Reading state — returns a named projection
gateway.Project(ctx, sessionID, "projection-name")

// Writing state — submits a validated intent
gateway.Dispatch(ctx, sessionID, action)

Cada llamada a través de la pasarela aplica el mismo contrato:

  • La sesión está autenticada
  • El actor está autorizado para esta acción o proyección
  • La acción es válida contra el estado actual antes de aplicar cualquier cambio
  • Cada transición se añade al registro de auditoría

La autorización no es middleware. Se ejecuta dentro de la pasarela, dentro de cada solicitud. No hay una capa de tiempo de ejecución separada que pueda ser eludida con una cabecera manipulada.

El patrón de acción

Los cambios de estado se expresan como intenciones validadas, no como mutaciones directas. Un manejador nunca escribe el estado directamente; envía una acción a la pasarela.

type Action interface {
    Type()     string
    Validate(ctx, store, sessionID) error
    Apply(ctx, store, sessionID)    (Event, error)
}

El ciclo de vida de un cambio de estado:

  1. El manejador analiza la solicitud y construye una acción
  2. La pasarela llama a Validate contra el estado actual; rechaza si es inválido
  3. La pasarela llama a Apply; produce un nuevo evento
  4. El evento se añade al registro durable
  5. La pasarela devuelve la proyección actualizada al manejador
  6. El manejador renderiza la proyección como HTML: parcial para htmx, página completa en caso contrario

Sin aplicación parcial. Sin fallos silenciosos. Sin estado del cliente que reconciliar.

Seguridad por construcción

La seguridad en la mayoría de los sistemas se aplica como una capa: comprobaciones de middleware, bibliotecas de validación, reglas WAF, cabeceras de seguridad. Cada capa puede estar mal configurada, ser eludida u olvidada. SAUI adopta una posición diferente: la arquitectura excluye estructuralmente clases enteras de vulnerabilidades, antes de que se ejecute cualquier código de aplicación.

  • Sin estado del cliente. La manipulación del estado, el clásico ataque "isAdmin: true", requiere estado en el cliente para manipular. El navegador no retiene nada. La clase de ataque no aplica.
  • Sin límite de hidratación. El estado del servidor nunca se serializa en HTML en línea para reconstrucción en el cliente. La clase de ataque XSS de hidratación requiere este límite. Aquí no existe.
  • Sin puerta de seguridad de middleware. La autorización se ejecuta dentro de la pasarela, dentro de cada manejador de solicitudes. No hay una capa de tiempo de ejecución separada que eludir. El patrón de evasión de middleware que produjo CVE-2025-29927 (CVSS 9.1) en Next.js no puede ocurrir.
  • Registro de eventos solo-adjuntar. Los eventos pasados no pueden ser alterados por ninguna ruta de código. Un atacante con acceso a la base de datos no puede reescribir el historial. La pista de auditoría es una propiedad estructural, no una política.
  • Sin grafo de dependencias npm. htmx es un único archivo gestionado. El resto de la pila es la biblioteca estándar de Go. No hay dependencias de paquetes transitivas y por tanto no hay superficie de ataque en la cadena de suministro.

Estas no son mitigaciones. Son la consecuencia de una arquitectura donde los patrones peligrosos no pueden existir.

Mejora progresiva

Cada función se construye en cuatro niveles de degradación. Los cuatro deben producir estado correcto; el servidor posee la verdad independientemente de la capacidad del cliente.

L0Sin JS, sin CSS
Formularios HTML nativos, envío POST, patrón PRG. Siempre debe funcionar.
L1Solo CSS
Diseño completo aplicado. Sin estado visual que dependa del cambio de clases JS.
L2JS presente, htmx aún no cargado
El envío de formulario nativo funciona. Respuestas de página completa.
L3htmx cargado
Actualizaciones parciales del DOM activas. Formularios interceptados. hx-boost en la navegación.
L4JS base completo
Conexión SSE para actualizaciones de proyección en tiempo real. Transiciones de vista si se admite.

Ver la implementación en Go