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.

01 / Problema

Coordinar participantes, representantes, criterios y etapas desde herramientas separadas volvía frágil una ceremonia que no admite perder el hilo.

02 / Solución

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

  1. 01Borrador
  2. 02Lista
  3. 03Abierta
  4. 04Cerrada
  5. 05Resultados calculados
  6. 06Aprobada
  7. 07Publicada

Ceremonia

  1. 01Inactiva
  2. 02Próxima
  3. 03Presentando
  4. 04Votación
  5. 05Completada

Etapas

  1. 01Gala · estado propio
  2. 02Representación principal · estado propio
  3. 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.

Mapa funcional de actores
ActorNecesidad principalLímite visible
SuperadminConfigurar y supervisar el sistemaAcceso administrativo controlado
Presidencia, directiva y administraciónPreparar y operar el certamen según su alcanceAcciones habilitadas por rol
FederaciónGestionar el contexto federativoÁmbito definido por permisos
Jurado / representanteEvaluar sus asignaciones con identificador y PINSin voto a la fraternidad propia
PúblicoConsultar la experiencia publicadaSin 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

  1. 01Configura elección
  2. 02Prepara participantes y asignaciones
  3. 03Abre etapa
  4. 04Sigue avance
  5. 05Cierra y calcula
  6. 06Aprueba
  7. 07Publica

Jurado

  1. 01Accede con identificador y PIN
  2. 02Ve asignación vigente
  3. 03Evalúa
  4. 04Revisa
  5. 05Confirma una vez

Público

  1. 01Entra al sitio
  2. 02Consulta contexto publicado
  3. 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

  1. 01Elección y etapa
  2. 02Asignación · jurado + participante
  3. 03Evaluación confirmada
  4. 04Resultado por categoría

Lectura

  1. 01Contexto de elección
  2. 02Suscripción por rol
  3. 03Vista administrativa, jurado o pública
  4. 04Interfaz

Confirmación

  1. 01Validar asignación
  2. 02Comprobar fraternidad
  3. 03Transacción
  4. 04Evaluación inmutable
  5. 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.

Riesgos y respuesta del sistema
RiesgoRespuesta
Doble clic o retryIdentidad estable y transacción idempotente
Reconexión después de confirmarRecuperación de la evaluación canónica
Voto a fraternidad propiaRechazo en dominio, persistencia y reglas
Alias de categoríaNormalización a categoría canónica
Empate en primer puestoResultado sin resolver hasta el desempate
Asignaciones incompletasTransició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.