Glossário do projeto

Vocabulário do domínio transporte que este app usa. Termos da plataforma X-Adm (Forgejo, Coolify, Garage…) não são redefinidos aqui — linkam para o glossário da plataforma.

Planilha e domínio

Aba 10

Aba do Excel com o período/configuração do relatório (metadados lidos pelo processador).

Aba 20

Aba com os registros de faturamento de fretes.

Aba 30

Aba com os registros de movimento de frota (movimentação contábil).

Período

Intervalo de datas coberto pelo relatório, extraído da aba 10 da planilha (E1 = data inicial, F1 = data final). É o que delimita o DELETE seletivo do diff-aware. Não confundir com a data de referência (data/hora do upload = quando o relatório foi gerado, metadado) — ver decisão 0016.

dt_frete

Data do frete no layout importado (ddMMyyyy no Excel).

dt_em

Data de emissão do documento fiscal.

data_lcto

Data de lançamento contábil.

tipo_frota

Indica se a placa é frota da empresa ou de terceiros — valores típicos EMPRESA ou TERCEIROS (importado das colunas AH / AB nas abas 20 / 30).

marca_veiculo

Marca do caminhão (colunas AI / AC).

modelo_veiculo

Modelo do caminhão (colunas AJ / AD).

ano_construcao / ano_modelo

Anos derivados do texto AAAA/AAAA na planilha (colunas AK / AE): à esquerda da barra = construção; à direita = modelo.

Checksum

SHA-256 do conteúdo binário do .xlsx; chave de idempotência — evita reprocessar o mesmo arquivo após sucesso.

Infraestrutura específica

PowerSync

Serviço de sincronização que replica as tabelas bi_* do PostgreSQL para os clientes móveis (SQLite). Aqui as tabelas bi_faturamento, bi_movimento e bi_configuracao sincronizam; as xls_* são locais por design.

Resetar Powersync

Operação destrutiva que zera o estado replicado (slot do PostgreSQL + MongoDB do PowerSync) e força o re-sync dos clientes. No código, o serviço se chama ResetarPowersyncService. Procedimento no runbook de operação.