Manual
LOCARTELE v · Sistema de carteleras en vivo para eventos
Índice rápido
› Roles y acceso› Modos visuales
› Flujo del evento› Modo Redes (video)
› Las pestañas› Encuestas
› Vista Pública› Mensajes Destacados
› Panel Mensajes› Efectos premium
› Videos› Ajustes
› Output Stage› Filtro de palabras
› Pausa y reanudar› Estadísticas
› Eventos múltiples› Tips de uso
🔑 Roles y acceso
Hay tres niveles de acceso al sistema:
- ★ Master — acceso total. Puede entrar a Ajustes, Manual, Output y administrar usuarios.
- Staff — modera mensajes y videos pendientes. NO puede entrar a Ajustes ni al Output. Se crea desde Ajustes › Usuarios S.U.
- Público — sin login. Ve la pestaña de envío de mensaje.
💡 El usuario master no se puede borrar desde el panel de usuarios.
🎬 Flujo típico del evento
- Antes: en Ajustes configurás título, fondo, estilo de output, modo de video y los modos visuales habilitados.
- Compartís el QR con el público desde el botón ◉ QR de la Vista Pública.
- El público manda mensajes (texto, foto o video) desde su celular.
- El staff modera en Mensajes/Videos: aprueba o rechaza. Los aprobados van a la cola.
- El operador da ▶ Iniciar en el Output. Los mensajes pasan con la duración configurada.
- Durante el show podés pausar, saltar, emitir manualmente, lanzar encuestas y alternar contenido.
- Al final: ■ Detener. Exportá el log si necesitás registro de lo que pasó.
📑 Las pestañas del nav
- Público — la vista que ven los asistentes. Formulario para enviar mensaje, foto o video.
- Mensajes — panel de moderación de texto y fotos. Aprueba, rechaza y reordena la cola.
- Videos — moderación separada para videos. Misma lógica que Mensajes.
- Pantalla ★ — la proyección 16:9 lista para enviar al proyector.
- Encuesta ★ — crear y emitir encuestas en vivo.
- Stats ★ — estadísticas del evento en tiempo real.
- Ajustes ★ — toda la configuración del evento.
- Manual ★ — este documento.
★ = solo accesibles para el master.
🌐 Vista Pública
Lo que ve el asistente desde su celular. Tiene:
- Selector de tipo: ✍️ Texto, 📷 Foto, ▶ Video.
- Campo nombre — si lo deja vacío aparece como "Anónimo".
- Texto hasta 200 caracteres / Foto hasta 20 MB / Video hasta 50 MB y 30 segundos.
- Opción ⭐ Destacar mensaje — si está habilitada en Ajustes, aparece un checkbox en el formulario de texto. El usuario paga vía MercadoPago y el mensaje recibe efectos visuales premium en el output.
- Encuesta activa (si la hay) — visible e independiente del formulario.
- Botón WhatsApp — configurable en Ajustes.
- Botón Carta — link a la carta de tragos.
- ◉ QR — muestra el QR del evento en un modal.
Envío bloqueado: cuando el staff desactiva el envío ("Envío: OFF"), el público ve una pantalla de espera con countdown hasta la próxima ventana. Si los mensajes destacados están habilitados, aparece igual un formulario para enviar mensajes pagos aunque el envío general esté bloqueado.
🛡 Panel Mensajes
Acá llegan en tiempo real los mensajes de texto y fotos del público.
Envío rápido desde el panel
- En la parte superior hay un campo de texto para que el staff o master pueda enviar mensajes directamente sin ir a la vista pública. El remitente se llena automáticamente con el nombre del evento (tomado de la URL). El mensaje va directo a la cola de reproducción. También se puede enviar con Enter.
Acciones por mensaje pendiente
- ✓ Este sí — aprueba. Pasa a la cola.
- ✕ Este no — rechaza. Queda en historial, recuperable.
- Duplicado automático — si el texto es idéntico a uno ya existente, el sistema lo rechaza solo. No se puede recuperar.
Acciones sobre la cola aprobada
- ⚡ Emitir ahora — salta el orden y lo manda directo al output.
- ⠿ Drag & drop — arrastrá las tarjetas para reordenar la cola.
- Quitar — saca de la cola (vuelve a rechazado).
- ✨ Destacar ★ — visible solo para el master. Marca el mensaje como destacado sin necesidad de pago, activando todos los efectos premium en el output.
Botones globales
- 🔔/🔕 — beep al llegar mensaje nuevo. Toggle guardado en el navegador.
- ✉️ Envío: ON/OFF — habilita o bloquea el formulario público.
- ✦ Prueba — inyecta un mensaje de demo para testear el flujo.
- ↩ Recuperar (historial) — devuelve un rechazado a la cola.
- 🧹 Limpiar reproducidos — marca los mensajes ya emitidos como finalizados. No toca pendientes ni afecta el log.
- Limpiar DB — borra TODO de Firebase (mensajes, fotos, videos). Irreversible.
- Exportar log — descarga un .txt con todo lo procesado durante el evento.
🎥 Pestaña Videos
- Mismo flujo: Pendientes → Aprobar/Rechazar → Cola.
- El staff puede previsualizar el video con player integrado antes de aprobar.
- Al emitirse, se muestra en modo Redes (TikTok o Reels según Ajustes).
- Independiente del estilo de texto/foto: los videos siempre van en formato Redes.
- Límite: 50 MB y 30 segundos. Se valida antes del envío.
💳 Mensajes Destacados
Sistema de mensajes pagos integrado con MercadoPago. Requiere Cloud Functions desplegadas y Access Token configurado en Ajustes.
Tres niveles configurables en Ajustes › Modo de mensajes
- ✍️ Envíos normales habilitados — permite enviar mensajes de texto, foto o video sin pago. Si se desactiva, el formulario público acepta solo mensajes pagos.
- ⭐ Mensajes destacados opcionales — aparece un checkbox en el formulario de texto para que el usuario elija pagar y destacar su mensaje.
- 🔒 Solo mensajes pagos (override) — cuando está activo desactiva los dos niveles anteriores. TODOS los mensajes deben ser pagos. El formulario soporta texto, foto y video pero siempre requiere pago vía MercadoPago.
Flujo del usuario que paga
- En la vista pública activa el checkbox ⭐ (modo opcional) o directamente envía (modo solo-pagos).
- Al enviar, la app crea el mensaje en Firebase con estado
pending y redirige a MercadoPago.
- Tras el pago, el webhook actualiza el mensaje a
paid con prioridad en la cola.
- En el panel de Mensajes aparece el badge 💳 PAGADO (solo visible para master).
- Al reproducirse, el output aplica los efectos visuales configurados.
Destacar sin pago (master)
- En la cola de aprobados, el master ve el botón ✨ Destacar en la esquina inferior derecha de cada mensaje.
- Al usarlo, el mensaje recibe todos los efectos premium sin pasar por MercadoPago.
- El staff no puede ver ni usar este botón.
Con envío bloqueado
- Si el envío está OFF pero hay mensajes pagos o solo-pagos habilitado, el público ve igual el formulario de pago debajo del cartel de espera.
✨ Efectos para mensajes destacados
Configurables en Ajustes › Efectos para mensajes destacados. Se aplican al mensaje en el output cuando es destacado (pago o por master). Cambiables en cualquier momento de la noche — aplican desde la próxima reproducción.
- 💛 Texto dorado — shimmer animado en el texto y el nombre del remitente.
- ❤ Corazones flotantes — corazones rojos subiendo desde la esquina inferior izquierda.
- ✨ Glow pulsante — borde luminoso que late alrededor del card.
- 👑 Badge animado — corona en la esquina superior derecha, con animación de rebote.
- 💎 Sparkle / Glitter — estrellas que aparecen y desaparecen aleatoriamente.
- 📱 Text shadow 3D — sombra profunda en el texto para mayor presencia.
- 👾 Hologram / Glitch — distorsión periódica con scanlines tipo holograma.
- 🌀 Rotación 3D — card flotando y rotando en tres ejes con marco y reflexión de luz. Color del marco configurable.
- 🎨 Partículas — lluvia, burbujas o humo animados sobre el mensaje.
- 🎉 Confetti explosion — ráfaga de papelitos de colores al aparecer el mensaje (one-shot).
- 🌈 Rainbow border — el borde del card cicla por todos los colores del espectro.
- 🔥 Llamas — llamas subiendo desde el borde inferior del card en loop.
- 🌟 Shooting stars — estrellas fugaces cruzando el card en diagonal.
- 💡 Neon flicker — el texto parpadea como un cartel de neón encendiendo.
- 📳 Shake / Terremoto — el card tiembla al aparecer y ocasionalmente durante la reproducción.
- 🪃 Bounce entrance — el card entra con rebote dramático en lugar del fade normal.
- 🪩 Disco lights — puntos de luz de colores orbitando alrededor del card como una bola de discoteca.
- ❄️ Nieve — copos cayendo sobre el mensaje. Útil para eventos temáticos.
- ⚡ Relámpago — destello blanco ocasional que cubre el card entero.
Con texto dorado y rotación 3D activados simultáneamente, el efecto de extrusión usa filter: drop-shadow para no alterar el gradiente dorado.
📺 Pantalla (Output Stage)
La vista 16:9 que se manda al proyector. Controles en la barra superior.
Controles
- ▶ Iniciar — empieza desde el primer mensaje de la cola.
- ■ Detener — para todo, muestra el logo.
- ⏸ Pausa / ▶ Reanudar — congela el mensaje actual. Ver sección Pausa.
- ⏭ Siguiente — salta al próximo mensaje sin esperar el timer.
- ⛶ Full — pantalla completa del stage.
- 🎛 Tomar control — solo visible si esta ventana es Display. Reclama el rol de Controlador.
Roles de ventana (multi-pantalla)
- 🎛 Controlador — la pestaña que avanza y controla. Solo una a la vez.
- 📺 Display — espeja la proyección pero no controla.
- — Pruebas — — sin reproducción activa.
Setup típico: Pantalla abierta en la laptop del operador (controlador) y en la PC conectada al proyector (display).
⏸ Pausa y reanudar
El botón ⏸ Pausa congela lo que esté en el output sin perder el lugar ni el timer.
- Para texto/foto: congela el timer. Al reanudar, sigue con el tiempo restante.
- Para video: pausa el video. Al reanudar, retoma desde el frame exacto.
- Para Spotify: congela el progreso de la "canción".
- El estado se sincroniza entre todas las ventanas abiertas.
Usos comunes: alguien quiere leer un mensaje largo · momento foto del público · pausa técnica del evento · interrupción del DJ.
🎨 Modos visuales
Se configuran dos estilos visuales independientes: uno para mensajes de solo texto y otro para mensajes con foto. La configuración está en Ajustes › Estilo de pantalla.
- Solo texto — mensaje centrado con tipografía grande adaptable al largo del texto.
- Post de Instagram — simula un post con avatar configurable, usuario, tick de verificación, foto (si hay) y caption.
- Notificación iPhone — push notification de iOS con animación slide-in/out y sonido. Usa logo.png y el nombre LOCARTELE de forma fija.
- 🎵 Spotify Player — reproductor de Spotify con carátula, nombre del tema (el texto), artista (el nombre del remitente) y barra de progreso animada.
- 📷 Polaroid — mensaje como foto polaroid con caída y rotación aleatoria. Tipografía manuscrita (Caveat), fecha estilo cámara, fondo de papel cálido. Funciona con texto o foto.
- Videos: siempre en modo Redes (TikTok/Reels), independiente de estos modos.
Transiciones: Fade · Scroll (TikTok) · Slide · Zoom · Flash · Blur · Flip 3D · Drop · Glitch
📱 Modo Redes (video)
Cuando llega un video al output, se proyecta en formato Redes.
- ▶ TikTok — pestañas Siguiendo/Para ti/En vivo, sidebar con likes/comments/share, disco giratorio, fondo blur del propio video.
- ◎ Instagram Reels — header Reels/Amigos, contadores en miles, botón Seguir, barra de comentarios inferior.
Config: en Ajustes cargás la foto de perfil y el nombre del evento que aparecen en el avatar y el disco giratorio.
📊 Encuestas
El público vota en tiempo real desde su celular. Solo puede haber una encuesta activa a la vez.
Dos modos
- ☑ Opciones fijas — definís 2+ opciones, el público elige una. Barras con porcentajes en tiempo real.
- ✏ Respuesta libre — el público escribe su respuesta. Se agrupa por texto similar y ordena por frecuencia.
Acciones durante la encuesta activa
- 📺 Mostrar/Ocultar en pantalla — proyecta los resultados con barras animadas. Los mensajes se pausan mientras está visible.
- ↺ Reiniciar — votos a cero, pregunta sigue activa.
- ✕ Cerrar — finaliza la encuesta, desaparece del formulario público.
⚙ Ajustes
Solo accesible para el master. Todo se guarda en Firebase y sincroniza en vivo. Tocá Guardar cambios para confirmar.
- Título del evento — texto o imagen/logo.
- Carta de tragos — URL del botón "Carta" en la vista pública.
- WhatsApp — número (ej: 549111234567), texto del botón, mensaje prellenado.
- Output visual — tipo de fondo (color / imagen URL / video URL en loop), color de texto, duración por cartel (5–120 seg), transición, tipografía.
- Estilo de pantalla — dos selects independientes: "Modo para texto" y "Modo para foto".
- Estilo de video — TikTok o Reels. Configs de avatar/nombre para cada uno.
- Config Instagram — usuario (@), tick de verificación, avatar.
- Config Spotify — carátula por defecto cuando el usuario no sube foto.
- QR — URL personalizada y próximo horario estimado de envío (countdown público).
- 💳 Modo de mensajes — sistema jerárquico de tres niveles. Ver sección Mensajes Destacados.
- ✨ Efectos para mensajes destacados — 8 toggles + selector de partículas. Ver sección dedicada.
- Usuarios S.U. — agregar/borrar usuarios de staff.
- Filtro de palabras — ver sección dedicada abajo.
🚫 Filtro de palabras
Los mensajes que contengan alguna palabra del filtro son rechazados automáticamente sin avisarle al usuario.
- Una palabra por línea.
- No distingue mayúsculas ni tildes (normalización Unicode).
- Match parcial: "puta" también filtra "putada", "reputo", etc.
- Quedan en historial con el motivo "RECHAZADO — FILTRO" en el log exportado.
⚠ El match parcial puede generar falsos positivos. "computación" contiene "puta". Probá el filtro antes del evento.
📊 Estadísticas
Resumen en vivo del evento. Tocá ↻ Actualizar para refrescar.
- Totales: recibidos / aprobados (%) / rechazados (%) / pendientes.
- Distribución por tipo: texto, foto, video.
- Motivos de rechazo: por moderador / duplicados / filtro.
- Gráfico de actividad por hora del evento.
- Ranking de los 10 participantes más activos.
🎟 Eventos múltiples
La app soporta múltiples eventos usando el path de la URL como ID.
locartele.com/ → evento default
locartele.com/cumple-juan → evento cumple-juan
Cada evento tiene su propia config, mensajes, encuestas y stats en Firebase bajo /eventos/{id}/.
💡 Tips de uso
- Dry run antes del evento: dos pestañas — mandá mensajes desde Público y moderalos desde Mensajes. Probá 5 y verificá en el Output.
- Carta de tragos: cargala en Ajustes. El botón lleva directo al bar.
- QR físico: imprimí stickers y pegalos en mesas. El público que no ve la pantalla lo escanea de ahí.
- Duración del cartel: 20–30 segundos es el rango ideal. Menos de 15 pasan muy rápido; más de 40 aburren.
- Bloqueá el envío entre tandas para no acumular mensajes sin moderar.
- ⏸ Pausa cuando alguien quiere sacar una foto del cartel o el DJ genera un momento especial.
- ✦ Demo para chequear el output antes de que llegue gente real.
- Exportá el log al final: sirve para reportes con la marca o archivo del evento.
- Dual style: combiná Polaroid para fotos y Spotify para texto — el output se ve variado sin hacer nada extra.
🔧 Datos técnicos
- Backend: Firebase Realtime Database + Firebase Storage.
- App: HTML single-file, sin build, sin dependencias de servidor.
- Estructura: /eventos/{id}/messages · /state · /poll · /config
- Estados de mensaje:
p pendiente · a aprobado · r rechazado · x reproducido