— PROYECTO

Sorteum.app

Java Spring Boot PostgreSQL JWT OpenAPI Astro Docker Caddy

Rol: Arquitectura y desarrollo full stack (end-to-end) Estado: En desarrollo · próximo a producción

Ver demo Código privado

— DESCRIPCIÓN

Sobre el proyecto

Sorteum es una plataforma SaaS que permite a negocios crear, publicar y administrar rifas con su propia marca (white-label). Desarrollé la arquitectura completa de principio a fin: una API contract-first definida con OpenAPI 3.1, autenticación stateless con JWT (HS256) transportado por header o cookie HttpOnly, y errores estandarizados bajo RFC 9457 (Problem Details). El frontend usa SSR híbrido con middleware de autorización por roles. Actualmente se encuentra en etapa previa a su salida a producción, pendiente de despliegue.

— ARQUITECTURA

Arquitectura

API-first / contract-first, con contrato OpenAPI 3.1 como fuente de verdad.
Autenticación stateless con JWT HS256 y doble transporte: header Authorization o cookie HttpOnly.
Errores estandarizados según RFC 9457 (Problem Details).
SSR híbrido con middleware de autorización por roles.
Backend Java + Spring Boot + PostgreSQL; frontend con Astro; despliegue con Docker sobre VPS (DigitalOcean) detrás de Caddy.

— RETOS Y DECISIONES

Retos y decisiones

Autenticación sin estado y segura

Diseñé un esquema JWT que sirve tanto a clientes de API como al navegador, aceptando el token por header o por cookie HttpOnly para reducir la exposición a XSS.

Contrato antes que código

Definir la API con OpenAPI 3.1 primero permitió mantener frontend y backend sincronizados y validar los endpoints contra un contrato explícito.

Respuestas de error consistentes

Adoptar RFC 9457 unificó el formato de errores de toda la API, simplificando el manejo en el cliente.

— RESULTADOS

Resultados

Plataforma funcional y accesible en demo (versión previa a producción).
Base de código contract-first preparada para generar clientes y SDKs desde OpenAPI.