Package br.com.xadm.comum.armazenamento

package br.com.xadm.comum.armazenamento

Núcleo de armazenamento do binário XLS (ADR 0019, raiz/001 Fase 5, plano 003 T2): a porta ArquivoXlsStorage e a implementação S3-compatível (Garage) S3ArquivoXlsStorage, mais a factory do cliente, o enum de modo e a config tipada (s3.*, app.storage.*).

Config por-app via S3Config e ArmazenamentoConfig — a lib não fixa endpoint, bucket nem credencial. Extração conservadora (R6): interface/enum/record são byte-idênticos onpetro↔vantroba; a impl S3 e a factory sobem no estilo @ConfigurationProperties (vantroba) como forma canônica da casa (onpetro usava @Value espalhado). Os serviços que acoplam entidade/repositório do app (ArmazenamentoArquivoService, StorageBackfillService) e a StorageIndisponivelException (lançada por eles) ficam no app — divergem em lógica, não sobem às cegas.

Class	Description
ArmazenamentoConfig	Configuração do modo de armazenamento do XLS — prefixo app.storage.*.
ArmazenamentoModo	Modo de armazenamento do binário XLS recebido, configurável por app.storage.modo (env S3_FILE_STORAGE, sempre em MAIÚSCULAS).
ArquivoXlsStorage	Seam de armazenamento do binário XLS recebido.
ReferenciaObjeto	Referência a um objeto no object storage S3-compatível (Garage).
S3ArquivoXlsStorage	Implementação de ArquivoXlsStorage sobre object storage S3-compatível (Garage em produção) via AWS SDK v2.
S3ClientFactory	Constrói o S3Client (AWS SDK v2) apontado ao object storage S3-compatível (Garage em produção).
S3Config	Configuração do object storage S3-compatível (Garage) — prefixo s3.*.