docs: registrar sincronizacao do cronometro
This commit is contained in:
parent
090ebb9607
commit
0d82162a0e
1 changed files with 7 additions and 0 deletions
|
|
@ -153,6 +153,13 @@ Artefatos: `apps/desktop/src-tauri/target/release/bundle/`.
|
||||||
| Vitest trava em modo watch | Script `pnpm test` sem `--run` e CI detecta TTY | Ajustado para `vitest --run --passWithNoTests`. Localmente, use `pnpm test -- --watch` se quiser. |
|
| Vitest trava em modo watch | Script `pnpm test` sem `--run` e CI detecta TTY | Ajustado para `vitest --run --passWithNoTests`. Localmente, use `pnpm test -- --watch` se quiser. |
|
||||||
| Desktop não encontra updater | Falta `latest.json` ou assinatura inválida | Publicar release com `*.sig` e `latest.json` apontando para os pacotes corretos. |
|
| Desktop não encontra updater | Falta `latest.json` ou assinatura inválida | Publicar release com `*.sig` e `latest.json` apontando para os pacotes corretos. |
|
||||||
|
|
||||||
|
## Cronômetro dos tickets
|
||||||
|
|
||||||
|
- A UI e o backend agora compartilham um relógio real alinhado via `serverNow`. Toda resposta de `tickets.workSummary`, listagens de tickets e mutations `startWork/pauseWork` envia `serverNow` (epoch UTC).
|
||||||
|
- O frontend (`ticket-summary-header` e tabela) calcula um deslocamento (`offset = Date.now() - serverNow`) e projeta `Date.now()` para a linha do tempo do servidor usando `toServerTimestamp`. Isso elimina drift quando o navegador está adiantado/atrasado.
|
||||||
|
- Durante o `startWork`, se a mutation retornar `status = already_started` sem `startedAt`, a UI usa `getServerNow()` como fallback, e assim que o Convex reenviar a sessão ativa, o reconciliador (`reconcileLocalSessionStart`) substitui o valor local.
|
||||||
|
- O tempo em execução exibido “ao vivo” torna-se idêntico ao acumulado após pausar, com tolerância de ±1 s por conta do tick do cronômetro. Ao depurar inconsistências, verifique se `serverNow` está chegando (painel de rede) e se o offset em `ticket-timer.utils.ts` está sendo calibrado.
|
||||||
|
|
||||||
## Referências úteis
|
## Referências úteis
|
||||||
|
|
||||||
- **Deploy (Swarm)**: veja `docs/DEPLOY-RUNBOOK.md`.
|
- **Deploy (Swarm)**: veja `docs/DEPLOY-RUNBOOK.md`.
|
||||||
|
|
|
||||||
Loading…
Add table
Add a link
Reference in a new issue