release_notes_moviments_v0.7.05.202605280

Projeto eCosif 02/2026

ecosif-moviments (API Java) — versão: 0.7.05.202605280
Notas de versão e impacto na execução

versão documento	data	responsável
0.7.05.202605280	28/05/2026	José Augusto de Lima Pereira

Versão anterior (publicada): 0.7.01.202601282
Versão atual: 0.7.05.202605280
Referência Git: v0.7.01.202601282 … v0.7.05.202605280 (27 commits)

1. Resumo executivo

Aspecto	0.7.01.x	0.7.05.202605280
Imagem	`disoft/ecosif-moviments:0.7.01…`	`disoft/ecosif-moviments:0.7.05.202605280`
ecosif-database	0.7.01.x	0.7.05.202605280
Importação IPL	Limitada / legado	API REST + monitor + S3 alinhada a `ecosif-automations`
Entrypoint	Variáveis legadas	*`ECOSIF_MOVIMENTS_`** canónicas
AWS	Credenciais estáticas possíveis	Role ECS preferida para clientes S3

2. Novidades e melhorias

2.1 Importação IPL (principal evolução desde 0.7.01)

ImportIplController / ImportIplService: API para gestão de importação IPL (upload, regras, integração com bucket).
ImportMonitorController: API administrativa de monitorização de jobs de importação (estado, filas, erros).
IplImportRules e relatórios: regras de validação IPL, relatórios detalhados e totalização decimal corrigida.
Documentação: docs/importacao-ipl-api.md, docs/guia-equiparacao-automations.md.
Compatibilidade com automations: ajustes de busca documento/lançamento para o pipeline Lambda/SQS.

2.2 Runtime e infraestrutura

Entrypoint modular com variáveis canónicas e Hibernate configurável (HIBERNATE_DDL_AUTO).
Resolução de secrets AWS no arranque (Secrets Manager).
OAuth2 condicional; correções de arranque e healthcheck.
Imagens AMD64/ARM; CI de exclusão de tag Docker Hub.

2.3 Outras correções

Batch / documentos: melhorias em BatchController, DocumentService e repositórios associados.
ecosif-database 0.7.05: UK ct_lote e suporte a lote IPL.

3. Mudanças que afetam a execução do serviço

3.1 Variáveis canónicas (Docker)

Variável	Exemplo
`ECOSIF_MOVIMENTS_PORT`	`8080`
`ECOSIF_MOVIMENTS_CONTEXT_PATH`	`/ecosif-moviments`
`POSTGRES_*`	JDBC
`AUTH_TOKEN_SECRET`	Igual ao auth
`HIBERNATE_DDL_AUTO`	`validate`
`ECOSIF_CORS`	Frontend

3.2 S3 (importação IPL — obrigatório se usar import)

Variável	Descrição
`AWS_S3_BUCKET` / `AWS_S3_IMPORT_BUCKET`	Bucket de entrada IPL
`AWS_S3_ERROR_BUCKET`, pastas `importError/`, `imported/`	Conforme entrypoint
`AWS_DEFAULT_REGION`	Região
Credenciais	Preferir task role IAM; chaves estáticas apenas se necessário

3.3 Equivalência 0.7.01.x → 0.7.05

0.7.01.x	0.7.05
`SERVER_SERVLET_CONTEXT_PATH`	`ECOSIF_MOVIMENTS_CONTEXT_PATH`
`ecosif_s3_*`	`AWS_S3_*`

3.4 Docker

Item	Valor
Health check	`/ecosif-moviments/actuator/health`

4. Checklist (0.7.01.x → 0.7.05.202605280)

[ ] Imagem 0.7.05.202605280 + JAR database 0.7.05.
[ ] Variáveis canónicas §3.1.
[ ] Bucket S3 e permissões IAM para importação IPL.
[ ] Lambdas ecosif-automations na mesma versão e filas SQS configuradas.
[ ] Frontend Angular 0.7.05 com ecrãs de import/monitor.
[ ] Teste ponta a ponta: upload IPL + CT32.LD → moviments + automations.