LISBONBUSDRIVER — COMANDOS DE TRABALHO

1. Na aplicação online, abre Stream > Ligação à Twitch / StreamElements e carrega em Gerar chave de ligação.
2. No StreamElements, abre o overlay e o widget que tem os comandos !g / !v.
3. Guarda uma cópia do JS e FIELDS atuais antes de os substituir.
4. Cola JS.txt no separador JS e FIELDS.json no separador FIELDS. Mantém HTML, CSS e as imagens atuais.
5. No campo Chave privada de ligação à aplicação, cola a chave gerada pela aplicação. Guarda o overlay.
6. Mantém o overlay carregado no OBS. A aplicação indica Ligado ao StreamElements após o primeiro envio.
7. Só o dono do canal e moderadores podem usar os comandos. Não é necessário criar comandos de bot: o widget recebe as mensagens do chat.

COMANDOS
!trabalho — inicia um novo dia ou retoma o atual depois de uma pausa; repeti-lo enquanto trabalhas não reinicia o tempo.
!p — inicia uma pausa no trabalho e mantém a função de pausa já existente na live.
!fim — termina o dia e fixa o ganho, os km e a média final; a pausa ativa também termina.
!inicio 08:30 — corrige o início no dia em que o trabalho começou, na hora de Lisboa. Mantém as pausas e recalcula o tempo.
!inicio 2026-11-01 23:00 — corrige também a data, para turnos de noite.
!km 150 — define 150 km acumulados.
!km +10 — acrescenta 10 km. !km -5 corrige 5 km a menos.
!g 10 / !g-5 — continuam a somar/retirar ganhos no campo existente; a aplicação recebe o ganho desse campo.
!v / !l / !m / !total / !meta — mantêm a função atual da live e não iniciam nem retomam o novo contador de trabalho.
!r — mantém a reposição do widget antigo; não apaga o contador de trabalho. Depois de !fim, usa !r se quiseres limpar os ganhos antes de !trabalho no novo dia.

MÉDIAS
Ganho acumulado / horas efetivas sem pausas = média por hora.
Ganho acumulado / km acumulados = média por km.
Sem horas ou km, a média fica a zero/indisponível. !fim fixa os valores finais, mesmo que outro comando altere depois o campo de ganhos.
Usa Guardar no Stream se quiseres guardar também uma cópia dos totais Stream manuais. A sincronização Twitch é independente e não altera os registos de viagens, ponto, despesas ou valor diário.

PRIVACIDADE E FUNCIONAMENTO
A chave só permite enviar os totais e o contador do widget. Não dá acesso aos teus registos privados. Não a coloques no chat nem partilhes o código do overlay com a chave preenchida.
O widget envia apenas ganhos acumulados, km, início/fim e pausas. Não envia mensagens nem nomes do chat. O endpoint público existente mostra só totais e duração.
O contador continua pelo relógio ao fechar o overlay, mas comandos só são recebidos enquanto o overlay estiver carregado. Os dados mais recentes são reenviados após falha de rede. Fecha cópias antigas do mesmo widget e instala este JS em todas as cópias que usas.
A aplicação atualiza a informação aproximadamente a cada cinco segundos; a média e o tempo avançam a cada segundo. Em Usar controlo manual, os dados anteriores ficam preservados e podes voltar a Usar dados da Twitch.
