0004 — Período de referência vem do upload

Decisão obsoleta — superada pela decisão 0016

Status: Obsoleto · Responsável: Gustavo Madruga · Atualizado em: 2026-06-19 · Decidido em: 2026-04-01

Obsoleta — superada pela decisão 0016. A premissa abaixo ("o layout de transporte não expõe o período de forma confiável") é falsa: o período do diff-aware vem da aba-10; data/hora são apenas metadado.

Contexto

Cada upload precisa de um período de referência (para particionar storage e delimitar o DELETE seletivo do diff-aware). O projeto irmão Comercial detecta o período pelo conteúdo do arquivo; o layout de transporte não traz um período confiável o suficiente para isso.

Decisão

O POST /api/transporte/processar exige data (LocalDate) e hora (LocalTime) como parâmetros multipart obrigatórios. Eles viram data_referencia / hora_referencia em xls_processamento e alimentam o periodoInicial usado na chave de storage.

Consequências

• Quem controla o período é o cliente (ERP/job agendado), não a heurística.
• Divergência legítima do Comercial (que detecta do conteúdo) — documentada na convenção cross-project.
• A partição do storage Garage usa periodoInicial quando disponível.

Alternativas consideradas

• Detectar do conteúdo (como o Comercial): o layout de transporte não expõe o período de forma confiável. Descartado.
• Inferir da data de recebimento: impreciso para reprocessamento de períodos históricos. Descartado.