Pular para conteúdo

UNRELEASED

Rascunho acumulado em develop. A nota publicada desta versão nasce só na tag (CHANGELOG.md e docs/release-notes/v*.md).

Adicionado

  • Contrato do resultado único da importação IPL: o mesmo fechamento, os mesmos relatórios e os mesmos erros na API Java e na lambda. docs/desenvolvimento/paridade_importacao_ipl.md.
  • BatchDTO expõe iplSourceFile (ct_lote.arquivo_ipl) e consolidated (derivado de ct_calendario.consolidado da competência). Digitação/API de lote não sobrescrevem o nome do arquivo.

Corrigido

  • Reprocessamento IPL com consolidação OK: reports ativos em error/ (*.REPORT.csv, ERRO_CONSOLIDATION_*, ERRO_*) são arquivados em history/{arquivo}/{importId}/ e removidos da caixa ativa. O mensal continua com append (linha do tempo por ImportId); a UI deixa de mostrar erro vigente quando a falha era de configuração e o arquivo passou depois.
  • Import IPL S3: ImportId passa a ir nos CSVs (mensal, REPORT, CHANGES, ERRO); pastas AWS_S3_IMPORTED_FOLDER / AWS_S3_ERROR_FOLDER / AWS_S3_REPORTS_FOLDER ligam no Spring; reports no bucket de report em imported/ · error/ · changes/; mensal na raiz da pasta de report; removido o marcador .CHANNEL; IPL ok/erro usam as pastas configuradas (sem …/files/ fixo).
  • Cálculo de cota: quando o indicador do calendário não tem dia livre (indexOf('0') == -1), deixa de montar a data inválida YYYYMM-1 (NumberFormatException). Resolve o dia do saldo via CalendarIndicator.quotaBalanceDay (primeiro livre na convenção legada, ou último processado/encerrado).
  • Consolidação manual do mês: após recalcular saldos, a marcação ct_lote.consolidado passa a avançar dia a dia na mesma passada (antes só o primeiro dia batido recebia ✓). Lotes divergentes continuam bloqueando os dias seguintes; divergência de lanctos no documento também é excluída da lista de candidatos.
  • Listagem/upload IPL (ImportIplServiceImpl) usa aws.s3.region (AWS_DEFAULT_REGION) no S3Client. Antes o SDK caía no DefaultAwsRegionProviderChain e exigia AWS_REGION.
  • Na importação/gravação de lançamento, se o movimento é no dia N e os dias anteriores ainda estão livres (0) no calendário, esses dias passam a * (processados). Assim, consolidar o dia 2 sem lançamento no dia 1 não deixa o dia 1 livre e evita SEM DIA LIVRE no cálculo de cota.
  • A listagem de /admin/import-ipl/files percorre os buckets AWS_S3_BUCKET, AWS_S3_ERROR_BUCKET, AWS_S3_IMPORT_BUCKET e AWS_S3_REPORT_BUCKET (quando distintos) nas pastas de origem, importados, erro e relatório. O download recebe o bucket de origem do arquivo.
  • Monitor e upload IPL (AWS_S3_BUCKET_NAME) passam a usar, se vazios, IMPORT_MONITOR_BUCKET, depois AWS_S3_BUCKET e ECOSIF_S3_FILE.
  • Falhas de S3 (put/copy/delete) na importação IPL são registradas sem gerar 500 na API. O POST /importMoviment captura exceções e tenta gravar a rejeição; IllegalStateException (ex.: bucket ausente) responde 400 com a mensagem.
  • A subida do ecosif-moviments exige AWS_DEFAULT_REGION e AWS_S3_BUCKET. AWS_ACCESS_KEY_ID e AWS_SECRET_ACCESS_KEY são opcionais. Valor vazio ou só uma das duas é removido do ambiente. Com as duas preenchidas, o S3 usa a chave estática. Sem as duas, usa a task role do ECS. Se a chave estática for recusada, inclusive com AccessDenied, o processo passa a usar a task role até o restart. Timeout em put, copy ou delete não repete a operação. A task definition precisa de task role quando esse caminho for usado.
  • POST /importMoviment/{empresa}/{filial}/{arquivo} lê a data da linha IPL como YYMMDD no século 20. Rejeita o arquivo quando há mais de uma data de movimento ou quando essa data não é a do nome (FUNDO_YYYYMMDD.IPL).
  • O corpo do IPL é partido por CR/LF nos bytes e decodificado por linha: UTF-8 só quando já tem 156 caracteres válidos; senão CP1252/Latin-1/IBM860 (1 byte = 1 char). Assim arquivos Windows com ç/ã (ex.: 57447_20261002.IPL) não encolhem nas linhas 1/7/19. Espaços do layout não são removidos antes da validação de tamanho.
  • O lote novo da importação IPL grava usuario_id do usuário autenticado. O valor -1 violava a chave estrangeira fk_ct_lote_usuario.
  • A limpeza dos saldos diários na consolidação executa o DELETE como atualização. Antes, a consulta sem resultado marcava a transação para rollback.
  • Quando o IPL já está na raiz do bucket, a importação copia essa chave para imported/files/ ou importError/files/ e apaga a origem. Quando a chamada traz só o conteúdo, o corpo é gravado direto na pasta de destino, sem criar objeto na raiz.
  • Sem documento, o lote informa a quantidade de lançamentos do arquivo, e débito e crédito com duas casas. O digitado do lote fica com a mesma quantidade, para a consolidação não parar na diferença 7 x 1. O log registra o início e o resultado da consolidação.

Alterado

  • O primeiro bloco do nome IPL (FUNDO_YYYYMMDD.IPL) aceita de 5 a 8 caracteres alfanuméricos. Antes o limite era 5 a 6.
  • POST /importMoviment/{empresa}/{filial}/{arquivo} sempre responde em texto. Aceite: HTTP 200 e Importação aceita: {arquivo}. Recusa: HTTP 400 e o motivo (nome, corpo, data, empresa, filial, linha ou lote). Falha inesperada: HTTP 500 e a mensagem. Cada chamada recebe um importId (cabeçalho X-Import-Id e sufixo do corpo). O log registra as etapas recebido, validado, linhas, gravacao, lote, lancamentos, consolidacao, cota, fechamento e s3 com esse id e o nome do arquivo.
  • Monitor de importação (/admin/import-monitor): filas SQS e janelas Dynamo só aparecem quando configuradas; sem elas o modo é API (DB+S3). Cada arquivo traz channel (API / LAMBDA / UNKNOWN); a importação Java grava o marcador imported/reports/details/{arquivo}.CHANNEL. Flush/clear de janela respondem DISABLED quando o pipeline não está habilitado.
  • POST /importMoviment recusa, antes de gravar lançamento, nome fora do padrão, linha inválida e empresa ou filial inexistentes no cadastro. Empresa e filial são as da URL. O CT32.LD não é lido. O CSV vai para importError/ERRO_{arquivo}.csv com ;, e o IPL para importError/files/. Cabeçalho de layout é ignorado. Refs: #117.
  • O lote gravado é o próximo número da competência (000001, 000002…), marcado com o nome do arquivo. Reimportar o mesmo arquivo reutiliza esse lote. O documento fica 000001 e o texto Import:{arquivo}. Lançamento tipo 2 grava débito e crédito. Refs: #118.
  • Lote já existente segue loteencerra e lanencerra: as duas desligadas recusam o arquivo; só lanencerra exige o mesmo dia e substitui o código; só loteencerra zera o dia de referência e não apaga código existente; as duas ligadas substituem o lançamento. Refs: #119.
  • No fim da gravação, e antes da consolidação, nasce imported/reports/details/{arquivo}.REPORT.csv com uma linha por lançamento. Consolidation e Quota ficam --. imported/reports/{arquivo}.CHANGES.csv só nasce se houve substituição. Refs: #120.
  • Depois da gravação, com ao menos uma linha inserida, a consolidação percorre os meses pendentes até a competência, calcula a cota e fecha o dia no ult_dia do calendário. Mês já consolidado não recalcula cota nem fechamento. Não há mais fechamento marcado como falho e em seguida como sucesso. Refs: #121.
  • No fim da consolidação o .REPORT.csv é reescrito com Consolidation e Quota. Uma linha é acrescentada em imported/reports/{fundo}_{YYYYMM}_report.csv. Exceção grava importError/ERRO_CONSOLIDATION_{arquivo}.csv e manda o IPL para importError/files/. O IPL só vai para imported/files/ quando a consolidação conclui. Refs: #122.
  • Os testes de paridade conferem o fechamento, os relatórios dos dois pontos e o CSV de erro: lote novo, segundo arquivo do mês, as quatro combinações de flags, falha de consolidação e as recusas anteriores à gravação. Onde não há .REPORT.csv, o teste também não encontra esse arquivo. Refs: #123.

Removido

Breaking Changes

  • POST /importMoviment/** deixa de ser público. A chamada sem Authorization: Bearer responde 401. O token é o de serviço a serviço (client_credentials Entra ou Itaú STS), com ECOSIF_API_TOKEN_MODE híbrido ou gateway Azure, ECOSIF_ENABLE_AZURE_APP_ONLY=true e vínculo em identity_provider_link.