Coordinar participantes, representantes, criterios y etapas desde herramientas separadas volvía frágil una ceremonia que no admite perder el hilo.
CASO 01 / Plataforma de certámenes
Tu Reina
Un producto para configurar, operar, evaluar y auditar certámenes con múltiples roles y avance en tiempo real.
Preparación, operación, evaluación y resultados conectados por recorridos específicos para administración y jurado.
ROL
- Diseño de producto
- UX / UI
- Ingeniería frontend
FUNCIONES CLAVE
- Configuración de certámenes
- Gestión de candidatas y fraternidades
- Representantes y criterios
- Control de ceremonia
- Seguimiento de evaluaciones
- Resultados y publicación
TECNOLOGÍA
- Next.js
- React
- TypeScript
- Firebase
- Tailwind CSS
CASE STUDY / DE LA REGLA A LA INTERFAZ
Cómo funciona de verdad.
Un recorrido por las decisiones de producto, las reglas y la arquitectura que permiten operar un certamen con múltiples actores sin perder trazabilidad.
01
Contexto
Tu Reina organiza la elección de reinas y representantes de una federación en un único producto: preparación, evaluación, ceremonia, resultados y publicación.
La interfaz debía servir antes y durante el evento. Eso cambia la prioridad: en una ceremonia en curso, saber qué falta y cuál es la próxima acción importa tanto como la configuración inicial.
Qué diseñé
- Arquitectura de información
- Flujos por rol
- Experiencia de votación
- Control de ceremonia
- Sistema UI
Qué construí
- Frontend en React y Next.js
- Integración con Firebase
- Suscripciones por contexto
- Validaciones de dominio
- Estados y recuperación
02
Problema
Una elección en vivo combina configuración, identidad, permisos, evaluaciones y publicación. Si esas piezas avanzan con reglas distintas, el resultado deja de ser confiable.
- La conducción necesita ver preparación y avance sin intervenir en cada voto.
- Cada jurado necesita un recorrido acotado a sus asignaciones.
- La ceremonia necesita saber si puede avanzar con evidencia persistida, no con una impresión visual.
- El público sólo debe ver aquello que ya fue aprobado y publicado.
03
Restricciones
El flujo debía tolerar presión operativa, reintentos y reconexiones sin flexibilizar las reglas que protegen la elección.
- Un representante no puede evaluar a su propia fraternidad.
- La etapa no puede avanzar hasta que estén confirmadas todas las asignaciones requeridas.
- Una evaluación confirmada es inmutable y un reintento debe recuperar la misma evaluación canónica.
- Gala y representación principal tienen configuración y avance independientes.
- Los resultados públicos pertenecen a una elección publicada; el contexto administrativo puede ser otro.
04
Arquitectura del producto
El producto separa el ciclo completo de la elección del ritmo de la ceremonia y del progreso particular de cada etapa.
Ciclo de la elección
- 01Borrador
- 02Lista
- 03Abierta
- 04Cerrada
- 05Resultados calculados
- 06Aprobada
- 07Publicada
Ceremonia
- 01Inactiva
- 02Próxima
- 03Presentando
- 04Votación
- 05Completada
Etapas
- 01Gala · estado propio
- 02Representación principal · estado propio
- 03Cálculo combinado configurable
La configuración de referencia pondera Gala en 30% y la etapa principal en 70%. Los criterios internos pertenecen a la configuración del certamen y no están fijados en la interfaz.
05
Roles
La experiencia traduce un contrato de permisos amplio a recorridos humanos comprensibles, sin reducir la autorización a una condición visual.
| Actor | Necesidad principal | Límite visible |
|---|---|---|
| Superadmin | Configurar y supervisar el sistema | Acceso administrativo controlado |
| Presidencia, directiva y administración | Preparar y operar el certamen según su alcance | Acciones habilitadas por rol |
| Federación | Gestionar el contexto federativo | Ámbito definido por permisos |
| Jurado / representante | Evaluar sus asignaciones con identificador y PIN | Sin voto a la fraternidad propia |
| Público | Consultar la experiencia publicada | Sin acceso al contexto administrativo |
El contrato técnico distingue SUPER_ADMIN, PRESIDENT, DIRECTIVE, ADMIN, FEDERATION y JURY. La tabla agrupa necesidades de producto; no reemplaza ese contrato.
06
Reglas de negocio
Las reglas centrales viven en el dominio y en la persistencia. La UI las comunica y previene errores tempranos, pero no es la única barrera.
- Categorías canónicas: Palla, Predilecta, Princesa, Ñusta y Predilecto.
- Los aliases conocidos se normalizan; una categoría desconocida se rechaza.
- Cada categoría admite como máximo una candidatura ganadora.
- Una categoría queda sin ganadora sólo mientras un empate en el primer puesto siga sin resolverse.
- La ponderación entre etapas y los pesos de criterios son configurables por elección.
07
User flows
Cada actor recibe un recorrido corto, pero todos convergen en la misma elección y en las mismas transiciones válidas.
Administración
- 01Configura elección
- 02Prepara participantes y asignaciones
- 03Abre etapa
- 04Sigue avance
- 05Cierra y calcula
- 06Aprueba
- 07Publica
Jurado
- 01Accede con identificador y PIN
- 02Ve asignación vigente
- 03Evalúa
- 04Revisa
- 05Confirma una vez
Público
- 01Entra al sitio
- 02Consulta contexto publicado
- 03Ve resultados habilitados
08
Decisiones UX
La interfaz reduce incertidumbre operativa: muestra el estado actual, lo que falta y la acción válida siguiente.
Antes de confirmar
- Criterios y candidata visibles
- Validación inmediata
- Resumen de la evaluación
- Acción final inequívoca
Durante la ceremonia
- Avance por asignación
- Estados explícitos
- Bloqueos con causa
- Recuperación tras reconexión
09
System design
Firestore actúa como fuente canónica. Las suscripciones entregan vistas por rol y las escrituras críticas se protegen con reglas, validación de dominio y transacciones.
Relaciones del modelo
- 01Elección y etapa
- 02Asignación · jurado + participante
- 03Evaluación confirmada
- 04Resultado por categoría
Lectura
- 01Contexto de elección
- 02Suscripción por rol
- 03Vista administrativa, jurado o pública
- 04Interfaz
Confirmación
- 01Validar asignación
- 02Comprobar fraternidad
- 03Transacción
- 04Evaluación inmutable
- 05Asignación completada
10
Frontend architecture
Next.js, React y TypeScript componen las experiencias; una fachada de plataforma desacopla las pantallas del proveedor de datos y mantiene contratos compartidos para administración, jurado y público.
Capas
- Pantallas por contexto
- Estado derivado de suscripciones
- Servicios de plataforma
- Reglas de dominio
- Firebase / modo local
Criterios de implementación
- Una fuente de verdad
- Estados explícitos
- Validación antes de escribir
- Errores recuperables
- Componentes reutilizables
El modo local y Firebase comparten contratos, de modo que las pantallas no necesitan bifurcar su lógica de producto según el proveedor.
11
Edge cases
Los casos límite más importantes aparecen cuando la operación se repite, se interrumpe o recibe datos históricos inconsistentes.
| Riesgo | Respuesta |
|---|---|
| Doble clic o retry | Identidad estable y transacción idempotente |
| Reconexión después de confirmar | Recuperación de la evaluación canónica |
| Voto a fraternidad propia | Rechazo en dominio, persistencia y reglas |
| Alias de categoría | Normalización a categoría canónica |
| Empate en primer puesto | Resultado sin resolver hasta el desempate |
| Asignaciones incompletas | Transición de ceremonia bloqueada |
12
Testing
La cobertura automatizada del repositorio se concentra en las reglas que más comprometen integridad y continuidad del evento.
- Normalización de aliases, ganadora única y empates.
- Matrices de asignación y restricción de fraternidad propia.
- Escrituras concurrentes, reintentos y ausencia de duplicados.
- Reconexión y comportamiento de suscripciones en tiempo real.
- Transiciones y gates de la ceremonia.
13
Resultado
El producto convierte una operación ceremonial frágil en un flujo trazable, con responsabilidades claras y estados verificables.
- La conducción puede distinguir preparación, votación, cálculo, aprobación y publicación.
- Cada jurado trabaja sobre asignaciones válidas y confirmaciones persistidas.
- La publicación queda desacoplada de la operación administrativa.
- Las reglas críticas se sostienen más allá de la pantalla.
14
Aprendizajes
Diseñar un producto para una ceremonia real exige tratar la confianza como parte de la arquitectura, no como una capa de comunicación.
La claridad visual ayuda a operar; la integridad surge cuando estados, permisos, transacciones y reglas comparten el mismo modelo.
La mejor decisión fue hacer explícito cuándo el sistema puede avanzar y por qué. Esa explicación reduce errores, permite recuperar una sesión y deja una traza defendible del resultado.
EXPERIENCIA DE PRODUCTO
Del sistema
a la pantalla.
Capturas del producto con datos de demostración para recorrer su lógica, sus roles y su operación. No representan métricas de producción.



