RTC-02 — Mezcla compartida dirigida por facilitación con handoff suave

[nicoechaniz]

Problema

La mezcla Beacon/Sesión hoy es personal. Durante momentos dramaturgicos concretos, facilitación necesita conducir temporalmente ese balance para toda la audiencia sin producir saltos, dobles fuentes ni pérdida de control local posterior.

Resultado

Un override de mezcla session-scoped, temporal, explícito y observable. Mientras está activo, cada participante ve el valor dirigido y entiende por qué su control personal no gobierna. Al liberarse o expirar, la app vuelve suavemente al valor local que la persona ya tenía.

Diseño de estado antes de código

• Comparar transporte y persistencia (estado durable + canal de actualización) y documentar por qué la opción elegida reconcilia refresh, reconnect y clientes tardíos.
• Estado mínimo: sessionId, valor normalizado, revisión monotónica, actor/capability, activación, vencimiento y estado released/expired; sin PII en broadcast.
• Sólo el facilitador asignado o FACILITATOR_OP asignado puede dirigir la mezcla; admin conserva únicamente liberación de emergencia según UX-02 — Define capabilities and add FACILITATOR_OP safely #66.
• El valor local nunca se destruye. Override y preferencia personal son estados separados y producen un único effectiveMix.
• Eventos stale/out-of-order no pueden restaurar un override vencido. Ausencia de conectividad converge al estado durable actual.
• Release, expiry, cierre de evento y pérdida de autorización convergen al mix personal mediante una rampa acotada y medible, no un salto.

Experiencia

• Cockpit: control con valor, duración/estado y acción clara de liberar.
• Participante: mensaje ES/EN “La facilitación está guiando el balance”, valor visible y control personal preservado pero temporalmente no efectivo.
• El cambio nunca vuelve a pedir activación de audio, remonta rooms ni crea elementos/tracks adicionales.
• Reduced motion no elimina la rampa acústica necesaria para evitar discontinuidad.

Bucle reproducir → medir → implementar → verificar

• Prototipo de estados active/released/expired/offline aprobado antes de tocar runtime acústico.
• Unit tests cubren curva/rampa, extremos, release, expiry, revisiones stale y conservación del mix personal.
• Integración cubre dos clientes, late join, refresh, reconexión y reloj desfasado.
• E2E instrumentado exige un room por propósito, un elemento por track, cero disconnects y una sola activación durante múltiples overrides.
• Escucha física en iPhone Safari, Android Chrome y escritorio confirma transición audible, predecible y sin clicks/saltos.
• Al cerrar/revocar evento no queda override huérfano.

Guardrail obligatorio

Este trabajo modifica gain/crossfader compartido: lleva audio-touching, requiere evidencia acústica y aprobación explícita de Nico antes de merge/deploy. No cambiar codec, bitrate, sample rate o buffer como efecto lateral.

Relaciones

• Parent product: UX-00 — Build Harmonic Beacon as a room entered, not an app used #64
• Cockpit: UX-04 — Build the single-mount live shell and unified conductor cockpit #70
• Audio research: RTC-01 — Diagnosticar inteligibilidad y routing móvil del audio dual-LiveKit #93
• Quality gate: UX-09 — Establish browser, accessibility, visual, and media-continuity quality gates #69 / WS5-03 — Run capacity test, full dress rehearsal, and production freeze #24

[nicoechaniz]

Claim limitado y explícito: Nico+Codex avanza diseño del estado sincronizado, UI y tests. No se fusionará ni desplegará ningún cambio de gain/crossfader/audio runtime sin aprobación acústica específica de Nico sobre la evidencia.

[AnnieScigliano]

Fases dramaturgicas confirmadas después del 2 de agosto

Precisar el override compartido:

1. Inicio: facilitación mantiene bloqueado el balance; attendee conserva máster pero su mix personal no gobierna.
2. Viaje: override lleva la mezcla a Beacon según el valor dirigido; la voz puede quedar en cero.
3. Retorno: cada attendee ve “Volver” y copy que explica que recuperará su balance personal.
4. Al pulsar “Volver”: esa persona recupera el control mediante rampa suave sin esperar al resto.
5. Release/expiry/cierre: todo cliente converge al mix personal guardado, sin salto ni estado huérfano.

El cockpit debe mostrar cuántas personas siguen bajo override y permitir liberación global de emergencia según #66.

[nicoechaniz]

Auditoría de coordinación 2026-08-04: no hay PR activa y el cambio de mezcla compartida está detenido por el guardrail audio-touching hasta aprobación acústica explícita de Nico. Se mueve a Todo; diseño y criterios permanecen vigentes.