0012 — Preservação de cadastro de veículo no UPSERT¶

Status: Aprovado · Responsável: Gustavo Madruga · Atualizado em: 2026-06-11 · Decidido em: 2026-05-08

Contexto¶

Correções de cadastro de veículo (marca, modelo, ano de construção, ano de modelo, tipo de frota) feitas direto no banco eram sobrescritas por reprocessamentos do Excel quando a planilha trazia aquelas colunas vazias.

Decisão¶

As colunas em ColunasConteudo.PRESERVAR_SE_VAZIO_NA_ENTRADA recebem tratamento especial no UPSERT: quando o valor de entrada é "vazio" (NULL, string vazia ou 0), o UPSERT mantém o valor já gravado em vez de sobrescrever.

Consequências¶

Correções manuais de cadastro sobrevivem a reprocessamentos de Excel.
O XLS só sobrescreve essas colunas quando traz um valor real (não-vazio).

Alternativas consideradas¶

Sobrescrever sempre (UPSERT cego): perde as correções manuais a cada reupload. Descartado — era o bug que motivou a decisão.
Nunca sobrescrever essas colunas: impediria a atualização legítima via XLS quando a planilha de fato traz o dado novo. Descartado.