teuka
state: productionUn SaaS multi-organización para congresos científicos: envío de resúmenes, revisión por pares doble ciego, inscripciones, pagos y certificados. Lo desarrollo y lo opero de punta a punta, desde el esquema de la base de datos hasta el pipeline de despliegue.
teuka.app · código cerrado
- inicio
- primer commit en agosto de 2025; hoy en producción
- stack
- PHP 8.5 · Laravel 13 · Filament 5 · Livewire 4 · Octane sobre FrankenPHP · PostgreSQL
- pruebas
- ~290 archivos de pruebas con Pest, de funcionalidad y unitarias, más reglas de arquitectura
- equipo
- Nelson la desarrolla y opera; Derlis Gómez atiende a los comités organizadores
// arquitectura
Un monolito modular. Cada área del negocio es un módulo con sus propios modelos, migraciones, políticas y pruebas: resúmenes, evaluaciones, congresos, inscripciones, pagos, certificados, usuarios y organizaciones. Encima hay cuatro paneles de Filament, uno por tipo de usuario: administración de la plataforma, administración de cada organización, participantes del congreso y revisores.
- Las pasarelas de pago se conectan detrás de una única interfaz, así que agregar una pasarela no toca las inscripciones. En producción funciona una pasarela de pago en línea local.
- Los certificados se generan en PDF cuando se piden y se envían como enlaces firmados, así que no se guarda ningún archivo generado.
- Reglas de arquitectura en Pest mantienen los límites, por ejemplo "los socios de pago nunca llegan a la capa de presentación" y "ningún modelo de Eloquent vive fuera de un namespace Models".
// multi-organización
Hecho a medida, sin un paquete de tenancy: una sola base de datos PostgreSQL donde cada fila de una organización lleva su organización, y cada regla de aislamiento vive en código de la aplicación cubierto por pruebas.
- La organización se resuelve con una coincidencia exacta del dominio de la solicitud. A propósito no se normaliza: una coincidencia más laxa podría mostrar las páginas de una organización a otra.
- Scopes globales de Eloquent filtran cada consulta por organización, y scopes por rol la acotan más: los participantes ven sus propios envíos y los revisores solo los resúmenes que tienen asignados.
- Las políticas vuelven a verificar la organización, y los paneles responden 404 cuando no se resuelve ninguna organización.
// revisión doble ciego
Los revisores nunca ven quién escribió un resumen, y los autores nunca ven quién lo revisó. Solo el comité organizador ve ambas cosas. Lo aplican las políticas y lo que muestra cada panel, no una convención.
// pruebas
- ~290 archivos de pruebas con Pest: pruebas de funcionalidad a través de los paneles y la capa HTTP, y pruebas unitarias del dominio.
- Protecciones contra los fallos que más duelen en producción: rollbacks de migraciones, caché de rutas y consultas N+1.
- Cada pull request ejecuta la suite en paralelo contra PostgreSQL, además de Pint para el estilo de código.
- Larastan (nivel 5) se ejecuta localmente antes de subir los cambios.
Trabajo con agentes de IA para programar todos los días. La suite de pruebas y las reglas de arquitectura son lo que permite ir rápido sin ser imprudente.
// despliegue
- Cada merge a main construye una imagen de Docker sobre FrankenPHP, la sube al registro de contenedores de GitHub y la despliega con Coolify.
- Supervisor ejecuta Octane, el worker de colas y el scheduler dentro del contenedor.
- Sentry reporta errores y Laravel Pulse mide el rendimiento en producción.