Skip to content

Adiciona investigação 09: fuso horário misturado na mesma coluna - #23

Merged
ThomasTDS merged 1 commit into
mainfrom
investigacao/09-fuso-horario
Oct 19, 2026
Merged

ThomasTDS merged 1 commit into
mainfrom
investigacao/09-fuso-horario

Conversation

@ThomasTDS

Copy link
Copy Markdown
Owner

O que muda

Novo defeito (sql/03_seed_quebrado.sql): dois pedidos feitos pelo app na noite de 31/01 (22:30 e 23:10 em Brasília) estão gravados em UTC, já em 01/02 (01:30 e 02:10). O gateway grava o pagamento em hora local, então o pagamento parece ter sido feito 2h55 antes do pedido. Os pedidos usam clientes e produtos que já existem e não têm vendedor, porque pedido feito pelo app não passa por vendedor.

investigacoes/09-fuso-horario/, no formato das anteriores:

  • Sintoma: no fechamento de janeiro, os relatórios de vendas (pela data do pedido) e de recebimentos (pela data do pagamento) não batem.
  • Os dois pedidos são os únicos sem vendedor e fora do horário comercial.
  • Descontadas as 3 horas do fuso, o pagamento cai exatamente 5 minutos depois do pedido, o padrão de todos os outros.
  • Contraste com a investigação 04: o mesmo sintoma ("pagamento antes do pedido") tem outra causa lá. Descontar o fuso não explica o pagamento 10, que continua quase 2 dias antes do pedido.
  • Impacto: janeiro fica R$ 149,80 abaixo do real, e fevereiro, R$ 149,80 acima.
  • Causa raiz: as colunas de data são timestamp without time zone e não guardam o fuso.
  • Correção proposta (não executada): converter os dois pedidos com AT TIME ZONE, mudar as colunas de data para timestamptz e escrever os relatórios com o fuso explícito.

Efeitos em outras partes

Todos foram apontados pelo teste de regressão dos relatórios antes da atualização:

  • Investigação 04: a detecção de datas implausíveis passa de 1 para 3 casos. O relatório explica que os pagamentos 12 e 13 são da investigação 09, e as estatísticas foram atualizadas.
  • Investigação 02: totais do chamado (15 pedidos, R$ 2.318,70 × R$ 2.218,80). A diferença continua R$ 99,90.
  • Investigação 03: a matriz de status ganha os pedidos 14 e 15, em combinações válidas.
  • Investigação 08: o ranking de vendas muda, porque os planos 1 e 2 venderam mais.
  • As investigações 01, 05, 06 e 07 não mudam.
  • READMEs (português e inglês), diagrama e comentários: 9 defeitos.

Testes feitos

  • Correção, numa cópia descartável: os pedidos ficam às 22:30 e 23:10 de 31/01. Só o pagamento 10 continua anterior ao pedido. Janeiro fecha em R$ 1.589,00, e um pedido novo enviado pelo app em UTC é gravado e lido corretamente.
  • Teste negativo: com a janela do "padrão normal" reduzida para 1 minuto, a detecção acha 0 em vez de 2, e a validação falha com código 1.

Como validar

npm run validate     # 23 checks
npm run relatorios   # 9 relatórios

Novo defeito na massa quebrada: dois pedidos feitos pelo app na noite de
31/01 (horario de Brasilia) gravados em UTC, ja em 01/02, enquanto o
gateway grava o pagamento em hora local. O pagamento parece ter sido
feito 2h55 antes do pedido.

Relatorio, exploracao.sql e deteccao.sql no formato das anteriores. A
deteccao procura pagamentos que voltam ao padrao normal quando se
descontam as 3 horas do fuso. O relatorio contrasta com a investigacao
04, em que o mesmo sintoma tem outra causa.

Efeitos em outras partes, todos apontados pelo teste de regressao:
- investigacao 04: deteccao com 3 casos (2 sao desta), estatisticas e
  textos atualizados;
- investigacoes 02, 03 e 08: totais, matriz de status e ranking;
- READMEs (dois idiomas), diagrama e comentarios com 9 defeitos;
- validacao com 23 checks.
@ThomasTDS
ThomasTDS merged commit 292199d into main Oct 19, 2026
2 checks passed
@ThomasTDS
ThomasTDS deleted the investigacao/09-fuso-horario branch October 19, 2026 17:45
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant