Tecnología

Biblioteca estándar de Go, SQLite, htmx y templ. Sin framework. Sin ORM. Sin empaquetador. Un único binario desplegable.

Backend

Go: biblioteca estándar primero

net/http maneja el enrutamiento y el servicio. Sin Gin, sin Echo, sin Chi. El multiplexor de la biblioteca estándar obtuvo enrutamiento por método y comodín en Go 1.22, eliminando la última justificación práctica para un framework de enrutamiento en la mayoría de las aplicaciones.

El paquete html/template proporciona auto-escape que previene XSS por construcción. Este proyecto usa templ en su lugar, para seguridad de tipos en tiempo de compilación en los muchos parciales htmx. La salida compilada es Go estándar.

SQLite mediante modernc.org/sqlite

SQLite en Go puro: sin cgo, sin biblioteca compartida externa. La base de datos se compila en el binario. El despliegue es una copia de un único archivo. SQLite es la elección de implementación de referencia. No es un requisito del patrón SAUI.

El modo WAL se activa al inicio. WAL permite lecturas concurrentes sin bloquear escrituras, lo que es apropiado para un sitio de contenido con muchas lecturas y mutaciones ocasionales de estado. Se aplica un único escritor; el modelo de concurrencia de SQLite lo requiere y el registro de eventos solo-adjuntar es naturalmente secuencial.

Lo que SAUI requiere de una capa de persistencia

Tres cosas. Un registro de eventos solo-adjuntar: los eventos se insertan, nunca se actualizan ni se eliminan. Lecturas de proyección secuenciales: SELECT ... ORDER BY id ASC para derivar el estado actual del registro. Escrituras serializadas: las mutaciones concurrentes deben ordenarse para que no se apliquen dos eventos simultáneamente a la misma sesión.

SQLite satisface el tercero por construcción. Cualquier base de datos lo satisface explícitamente. El esquema del registro de eventos, la interfaz Action y todas las consultas de proyección son SQL simple y son independientes de la base de datos.

Adaptación a Postgres

Reemplazar modernc.org/sqlite con pgx. Eliminar la configuración WAL. En el método Dispatch de la pasarela, adquirir un bloqueo advisory de Postgres antes de aplicar la acción y liberarlo después de añadir el evento. Todo lo demás permanece igual.

-- Serialise writes per session; released automatically on transaction commit
SELECT pg_advisory_xact_lock(hashtext($1));  -- $1 = session_id

-- Event log schema: same structure, database-native types
CREATE TABLE events (
    id          BIGSERIAL    PRIMARY KEY,
    session_id  TEXT         NOT NULL,
    type        TEXT         NOT NULL,
    payload     JSONB        NOT NULL,
    occurred_at TIMESTAMPTZ  NOT NULL DEFAULT now()
);

MySQL y MariaDB usan GET_LOCK() para el mismo propósito. El alcance del bloqueo cambia; el contrato de la pasarela no. Cualquier base de datos que admita bloqueos a nivel de fila o bloqueos advisory puede satisfacer el modelo de escritura de SAUI.

SSE para tiempo real

Server-Sent Events sobre net/http estándar. Sin WebSocket a menos que un caso de uso requiera genuinamente un encuadre bidireccional. SSE es unidireccional, trivial de implementar y se reconecta automáticamente. Es suficiente para enviar actualizaciones de proyección al cliente.

Frontend

htmx

htmx intercepta envíos de formularios y clics en enlaces, los envía como solicitudes AJAX e intercambia el fragmento HTML devuelto en el DOM. El servidor decide qué HTML devolver. El cliente decide dónde colocarlo.

Esta es la única dependencia JS. Se carga desde un archivo local sin dependencia de CDN para su funcionalidad, fijada a una versión específica y verificada con un hash de integridad de subrecurso.

JS vanilla: Baseline 2023

Sin framework. Sin paso de compilación. Sin empaquetador. Los archivos JS se sirven directamente. Módulos ES mediante type="module". Anotaciones de tipo JSDoc para inferencia del IDE sin paso de compilación.

Objetivo: navegadores modernos evergreen. El público objetivo son desarrolladores. Sin polyfills.

CSS vanilla

Propiedades personalizadas de CSS como tokens de diseño. Grid y Flexbox para el diseño. Consultas de contenedor para la adaptabilidad a nivel de componente. Sin CSS-in-JS. Sin preprocesador. Sin framework de utilidades.

Despliegue

Un único binario Go. Base de datos SQLite en un volumen persistente. Fly.io gestiona TLS. Sin dependencias de tiempo de ejecución externas. Sin servidor de base de datos. Sin capa de caché. No se requiere CDN para la corrección.

# build
go build -o saui .

# deploy
fly deploy

Toda la pila de producción cabe en un proceso. La complejidad operativa es proporcional a lo que la aplicación realmente requiere, no a lo que la arquitectura asume.

Ver la arquitectura aplicada a dominios reales