Glosario

Esta página reúne los términos que encontrarás en la documentación de Timers Studio. La mayoría se corresponden directamente con una ruta, un componente o una columna del esquema Supabase, así que la misma palabra designa la misma cosa en el producto y en los docs.

Conceptos base

Room (sala) Un evento en Timers Studio. Una room posee un rundown, un tema, una contraseña de moderador y un conjunto de URLs públicas. Se identifica con un slug corto presente en todas las URLs (/id/<room>, /player/<room>, etc.).

Rundown La lista ordenada de timers dentro de una room. El Studio la muestra en la columna central, el Moderator la lee, el Agenda la presenta al público, el Player anima un item cada vez.

Timer Una fila del rundown. Un timer lleva un título, opcionalmente un subtítulo y un ponente, una duración y un modo (DURATION, FINISH_TIME, TIME_OF_DAY, COUNT_UP).

Controller La fila Supabase que representa la room del lado del servidor (tabla controllers). UUID, studio_slug, player_slug, idioma admin, estado del timer. Cada canal realtime se indexa sobre ese UUID.

Los cuatro módulos

Studio — /id/<room> La consola de dirección. Edita el rundown, conduce al Player, es la dueña del show. Requiere login.

Player — /player/<room> La pantalla frente al escenario. Una cuenta atrás a pantalla completa con algunas sobreimpresiones opcionales. Público, sin login.

Moderator — /moderator/<room> El espacio backstage para un segundo operador (presentador, regidor). Rejilla de widgets personalizable, intercomunicador, contadores en vivo. Protegido con contraseña por room.

Agenda — /agenda/<room> La agenda pública. Solo lectura, tres modos de visualización (LIST, FOCUS, CURRENT_NEXT). Sin login.

Gateway — /ask/<room> + embebido en el Studio Dos caras del mismo módulo. La ruta /ask/<room> es el formulario público donde los espectadores envían preguntas o votan. Dentro del Studio, la pestaña operator workspace da acceso a LiveMonitor, StageConfigurator, Tombola y Polls.

Estados y modos del timer

TimerState Uno entre STOPPED, RUNNING, PAUSED. Cada Player de la room refleja el cambio en menos de 100 ms.

DURATION Cuenta atrás desde una longitud (por ejemplo 10:00 para diez minutos).

FINISH_TIME Cuenta atrás hasta una hora de reloj (por ejemplo 14:30 local).

TIME_OF_DAY Reloj en vivo que muestra la hora local actual en lugar de una cuenta atrás.

COUNT_UP Cronómetro que arranca en 00:00.

Tweak Un ajuste en vivo del timer en curso (+1m, +30s, -30s, -1m). Emitido por el Studio, recibido por el Player en tiempo real.

Rutas y URLs

Tablas Supabase que encontrarás

controllers — la room en sí (UUID, slugs, estado del timer, idioma admin).

spectators — las personas que abrieron /ask/<room> para una room (nombre/apellido, asiento opcional, huella de navegador).

spatial_questions — preguntas enviadas por los espectadores (status: pending, approved, answered, rejected, sentimiento, vector de asiento opcional).

polls — encuestas en vivo creadas desde el Moderator (status: draft, active, closed).

poll_votes — una fila por voto. Un voto por huella y por encuesta.

Visualización y tema

Tema Tokens de color, tipografía, efecto cristal, fondo. Aplicado al Player y al Agenda. Editado desde el customiser del Studio.

Display mode (Agenda) Uno entre LIST, FOCUS, CURRENT_NEXT. Cambiado por el operador, reflejado al público sin recargar.

Safe area Inset de viewport aplicado sobre el Player para evitar el overscan en televisores. Default, 90%, 80%, off.

Tiempo real

Channel Un canal realtime Supabase indexado sobre un UUID de controller. Cada página Studio, Player, Moderator, Agenda y Gateway de la misma room se suscribe al mismo canal.

Envoltura de latencia Retardo objetivo entre una acción en el Studio y su efecto visible en el Player. Timers Studio apunta a ≤ 100 ms de punta a punta.

Lectura siguiente

• Quickstart — primer show en cinco minutos.
• Crea tu primer timer — el tutorial piloto.
• Atajos de teclado — el mapa completo.