release_notes_reports_v0.7.05.202605280

Projeto eCosif 02/2026

ecosif-reports (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 (13 commits)

1. Resumo executivo

Aspecto	0.7.01.x	0.7.05.202605280
Imagem	`disoft/ecosif-reports:0.7.01…`	`disoft/ecosif-reports:0.7.05.202605280`
ecosif-database	0.7.01.x	0.7.05.202605280
Entrypoint	Legado	*`ECOSIF_REPORTS_`** canónicas
Funcionalidade de negócio	Relatórios COSIF, S3	Mantida; foco desta release em runtime estável

2. Novidades e melhorias

2.1 Runtime e operação (principal delta desde 0.7.01)

Entrypoint padronizado com export de porta, context path, Postgres, CORS e S3 antes do JAR.
Precedência de variáveis e application.yml alinhado ao padrão ECS dos demais serviços Java.
OAuth2 condicional e correções de arranque (versões 0.7.02.202605110+ integradas).
ecosif-database 0.7.05: dependência obrigatória para UK ct_lote e entidades de saldo.
CI: exclusão de imagem Docker Hub ao remover tag Git.

2.2 Mantido desde 0.7.01.x

Geração de relatórios (balancetes, layouts regulatórios, etc.) conforme documentação funcional 0.7.01.
Integração S3 para armazenamento de relatórios (AWS_S3_REPORT_BUCKET / aliases).
SpringDoc OpenAPI 3.0, Java 17, Spring Boot 2.7.18.

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

3.1 Variáveis canónicas (Docker)

Variável	Exemplo
`ECOSIF_REPORTS_PORT`	`8080`
`ECOSIF_REPORTS_CONTEXT_PATH`	`/ecosif-reports`
`POSTGRES_*`	JDBC
`AUTH_TOKEN_SECRET`	Igual ao auth
`HIBERNATE_DDL_AUTO`	`validate`
`ECOSIF_CORS`	Frontend

3.2 S3 (relatórios)

AWS_ACCESS_KEY_ID, AWS_SECRET_ACCESS_KEY, AWS_DEFAULT_REGION, AWS_S3_BUCKET, AWS_S3_REPORT_BUCKET (aliases ecosif_s3_report / ECOSIF_S3_REPORT ainda mapeados no entrypoint).

3.3 Equivalência 0.7.01.x → 0.7.05

0.7.01.x	0.7.05
`SERVER_SERVLET_CONTEXT_PATH`	`ECOSIF_REPORTS_CONTEXT_PATH`

3.4 Docker

Item	Valor
Health check	`/ecosif-reports/actuator/health`
Referência	`ecosif-reports/docs/ambiente/variaveis_operacionais.md`

4. Checklist (0.7.01.x → 0.7.05.202605280)

[ ] Imagem 0.7.05.202605280 + JAR database 0.7.05.
[ ] Variáveis canónicas na task ECS.
[ ] Bucket S3 de relatórios e permissões IAM.
[ ] Regenerar relatórios críticos em ambiente de homologação após deploy.