Package br.com.xadm.ingestao

package br.com.xadm.ingestao

Seam de ingestão XLS/CSV (ADR 0019, raiz/001 Fase 5, plano 003 T6): o esqueleto agnóstico de domínio + as SPIs que os apps implementam. O reader, o motor de upsert e os processadores de domínio divergem de verdade entre onpetro (POI-SAX + executeBatch) e vantroba (leitura própria + COPY) — por isso são SPIs, não código compartilhado.

Esqueleto (aqui): ZipXlsExtrator (anti-zip-bomb), ConjuntoLote(+Repository+Service) (tracking de lote com fechamento atômico single-winner), ResultadoProcessamento (métricas no retorno — mata os 3 Consumer callback), UpsertResultado (superconjunto das duas métricas) e DespachanteXlsProcessor (dispatch por Map — mata o switch).

SPIs (o app implementa): XlsReader (SAX/CSV), BulkUpsertStrategy (executeBatch/COPY), XlsProcessor (processador de domínio), ContadorProcessamentosFinalizados (contagem sobre o schema do app) e ResumoLoteNotificador (entrega do resumo).

A tabela xls_conjunto_lote é da lib (o adotante provê a migration). A paridade do app (dedupe, anti-deadlock 40P01, linhas_efetivas) é verificada no e2e do T7 — fora do gate deste módulo.

Class	Description
BulkUpsertStrategy<T>	SPI do motor de upsert em lote.
ConjuntoLote	Tabela xls_conjunto_lote: rastreia um lote de arquivos enviados juntos num .zip.
ConjuntoLoteRepository	Persistência de ConjuntoLote (lote por zip).
ConjuntoLoteService	Coordena o ciclo de vida de um lote (.zip).
ContadorProcessamentosFinalizados	SPI de contagem de processamentos finalizados de um lote.
DespachanteXlsProcessor	Despacha um arquivo para o XlsProcessor do seu tipo.
ResultadoProcessamento	Resultado de um processamento de arquivo — carrega as métricas no retorno, eliminando os Consumer<...> callback que onpetro usava para acumular linhas_efetivas/linhas_removidas (over-eng menor do BI, R5).
ResultadoProcessamento.Ignorado	Arquivo ignorado por regra de negócio.
ResultadoProcessamento.Sucesso	Processamento concluído com sucesso.
ResumoLoteNotificador	SPI de notificação do resumo de um lote fechado.
UpsertResultado	Métrica de um upsert em lote — superconjunto que serve as duas técnicas: executeBatch (onpetro, que só conhece enviadas/efetivas) e COPY+CTE RETURNING xmax=0 (vantroba, que separa inseridas/atualizadas/removidas).
XlsProcessor	SPI do processador de um tipo de arquivo.
XlsReader	SPI de leitura de planilha: transforma os bytes de um arquivo em linhas de String[], sem conhecimento de domínio.
ZipXlsExtrator	Desempacota o .zip de lote em suas entradas .xlsx (o zip É o lote).
ZipXlsExtrator.EntradaXls	Uma entrada .xlsx do zip.