MIZIN · SIGNAL MONITOR 1.1 — GUIA RÁPIDO
==========================================

Central de monitoramento multissalas para eventos: mostra, em um só painel,
REC, MultiCorder, transmissão (TX), SRT, áudio, disco e conexão de cada sala
(vMix e OBS), com alarmes, ocorrências auditáveis e relatórios.
A central é SOMENTE LEITURA: nunca inicia, para ou altera gravações/transmissões.


1) NO DIA DO EVENTO — 5 PASSOS
------------------------------
1. Abra "MIZIN Signal Monitor".
2. Clique em "Descobrir na rede" -> "Buscar". O padrão "auto" procura em todas
   as redes desta máquina. Marque as fontes encontradas -> "Adicionar às salas".
   - Outra VLAN: digite a faixa, ex.: 10.20.30.0/24 ou 192.168.5.10-80
   - Internet/VPN: digite IP público ou DNS, ex.: sala1.ddns.net
3. "Configurar evento": nome, perfil (Gravação / Transmissão / Híbrido) e o que
   é obrigatório (REC, MultiCorder, TX, SRT, Áudio).
4. Em cada sala (⚙ ou "Fontes / Salas"): confira nome, IP e clique
   "Testar conexão". Se o vMix/OBS tiver senha, informe-a ali.
5. Confirme que o botão do topo mostra "● ALERTAS ARMADOS".
   Use "Desarmar" na preparação e após o encerramento.


2) DUAS FORMAS DE MONITORAR AS SALAS (podem ser misturadas)
------------------------------------------------------------
A) VIA AGENTE (recomendado) — instale este mesmo programa em cada máquina
   vMix/OBS marcando "AGENTE: esta é uma máquina de sala".
   - O agente fica na BANDEJA do Windows (perto do relógio) e inicia com o
     Windows. Ícone verde = enviando; âmbar = aguardando/atenção; vermelho =
     sem central.
   - Lê o vMix localmente pela API TCP 8099 (não precisa ligar o Web
     Controller) e o OBS pelo WebSocket local.
   - ENVIA os dados para a central: atravessa outra VLAN, NAT e Internet.
     Na mesma rede ele encontra a central sozinho; em outra rede, informe o
     IP/DNS da central (bandeja › Configurar…).
   - Entra direto com a CHAVE DE PAREAMENTO (central › Agentes) ou aparece
     na central para você clicar em "Aprovar".
   - Mede também: disco e TEMPO RESTANTE de gravação, arquivo crescendo,
     CPU/RAM, GPU NVIDIA, energia (tomada/bateria), rede e link até a central.
   - Análise SRT (latência, perda, retransmissões): marque "Com análise de
     SRT" no instalador (o agente roda como administrador). É passiva: não
     entra no caminho do sinal.

B) DIRETO — a central consulta cada máquina pela rede:
   vMix : Settings > Web Controller > ativar (porta 8088) — ou a API TCP 8099.
   OBS  : Ferramentas > Configurações do Servidor WebSocket (porta 4455) + senha.

Portas usadas: Central TCP 8765 (agentes e acesso remoto) e UDP 8766
(descoberta) · vMix 8088/8099 · OBS 4455 · Agente 8799.
Em outra VLAN, o roteador/firewall deve permitir essas portas a partir da central.
Pela Internet prefira VPN (WireGuard / ZeroTier / Tailscale). Se usar
redirecionamento de porta, ative a senha do Web Controller do vMix.


3) O QUE GERA ALERTA
--------------------
Crítico : gravação parada · arquivo de gravação sem crescer (agente) ·
          MultiCorder parado · transmissão parada · destino obrigatório sem sinal ·
          SRT desconectado · máquina sem comunicação · disco crítico
Atenção : gravação pausada · silêncio prolongado · master mutado ·
          TX reconectando/congestionada · SRT instável · disco baixo · quadros perdidos
- Um item "não exigido" nunca vira falha (aparece N/A).
- Cada falha precisa persistir alguns segundos (aba Alertas) antes de virar
  ocorrência — evita alarmes falsos.
- Fora da janela do evento ou com alertas desarmados: nada dispara.
- "Reconhecer" registra ciência do operador; não apaga o problema.
  Quando a sala volta ao normal a ocorrência é encerrada com horário e duração.
- Alarme sonoro repete enquanto houver crítico não reconhecido (🔔 silencia a tela).
- Webhook (Discord/Slack/Teams) e Telegram: em "Sistema".


4) TELA
-------
Clique em uma sala: telemetria à direita (REC, arquivo, disco, áudio, PGM…).
Duplo clique: foco na sala (vídeo grande + VU L/R).
F11: parede de monitores (tela cheia) · Esc: sair · teclas 1–9: selecionar sala.
Prévia de vídeo: OBS mostra a cena automaticamente. vMix: informe na sala uma URL
de vídeo/imagem/página (MP4, MJPEG/snapshot, VDO.Ninja…), opcional.
"Ouvir sala": toca a URL de pré-escuta (ou o áudio da prévia de vídeo).


5) RELATÓRIOS
-------------
Topo: "Relatório CSV", "Relatório JSON" e "Relatório PDF" (abre no navegador
para imprimir/salvar em PDF). Ficam salvos na pasta "relatorios" dos dados.
Inclui: tempo monitorado, % online, % REC, tempo em falha, ocorrências
(detecção -> recuperação), reconhecimentos e trilha de auditoria.


6) ACESSO REMOTO À CENTRAL (opcional)
-------------------------------------
"Sistema" -> marcar "Permitir acesso pela rede" + senha -> reiniciar o app.
Outros computadores/celulares abrem http://IP-DA-CENTRAL:8765 e entram com a senha.
(No instalador, a opção "Liberar a porta 8765 no firewall" faz a liberação.)


7) MODOS DE EXECUÇÃO
--------------------
MizinSignalMonitor.exe                  central com janela
MizinSignalMonitor.exe --headless       central sem janela (acesso pelo navegador)
MizinSignalMonitor.exe --agent          agente da máquina de sala (bandeja)
MizinSignalMonitor.exe --agent --headless   agente sem ícone (serviço)
MizinSignalMonitor.exe --mock-vmix 9    9 vMix simulados (ensaio/treinamento):
     depois cadastre 127.0.0.1 portas 18088…18096
Modo demonstração: botão no topo ("Leitura real ativa" -> demo).

Dados: instalado -> %APPDATA%\MIZIN Signal Monitor
       portable  -> pasta "data" ao lado do executável
Senhas de vMix/OBS ficam criptografadas (DPAPI do Windows).


8) LIMITES CONHECIDOS (honestidade operacional)
-----------------------------------------------
- vMix streaming=True indica atividade GLOBAL; por destino use "Canal vMix"
  (canais 1–5) ou verificação de URL. YouTube = verificação da página pública.
- RTT/perda de pacotes SRT não são expostos pela API do vMix; a central mostra o
  estado da entrada SRT (vMix) ou da fonte de mídia (OBS).
- A central não é redundância: mantenha gravação de backup e operador atento.
- Requer Microsoft Edge WebView2 (já presente no Windows 10/11 atualizado).
  Sem ele a central abre automaticamente no navegador padrão.

MIZIN Produções · Signal Ops
