← /teuka

teuka

state: production

Un 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.

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

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".

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.

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.

  • ~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.

  • 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.