release_notes_masterdata_v0.7.05.202605280

Projeto eCosif 02/2026

ecosif-masterdata (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 (referência operacional): 0.7.01.202601280
Versão atual: 0.7.05.202605280
Referência Git: v0.7.02.202604231 … v0.7.05.202605280 (9 commits; linha 0.7.02→0.7.05)

1. Resumo executivo

Aspecto	0.7.01.x	0.7.05.202605280
Imagem	`disoft/ecosif-masterdata:0.7.01…`	`disoft/ecosif-masterdata:0.7.05.202605280`
ecosif-database	0.7.01.x	0.7.05.202605280
Entrypoint	Variáveis legadas	*`ECOSIF_MASTERDATA_`** canónicas
Hibernate DDL	`validate` recomendado	`HIBERNATE_DDL_AUTO` via env (produção: `validate`)

2. Novidades e melhorias

2.1 Runtime e operação

Entrypoint padronizado com entrypoint-common.sh (porta, context path, Postgres, CORS, logs).
Precedência de variáveis e tuning operacional no application.yml.
Build Docker AMD64/ARM.
CI: remoção de imagem Docker Hub ao apagar tag Git.

2.2 Correções funcionais

ClosureControllerold: correção de tipo em setAccumulatedBalance (Double em vez de int) — evita falha de compilação/deploy em pipelines que ainda referenciam o controller legado.
ecosif-database 0.7.05: alinhamento UK ct_lote e tipos em entidades de saldo mensal (MonthlyAccountBalance).

2.3 Mantido desde 0.7.01.x

Java 17, Spring Boot 2.7.18, SpringDoc OpenAPI 3.0.
Criação automática de saldos/configurações na criação de empresa.
Endpoint administrativo de logs Docker (quando socket montado).

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

3.1 Variáveis canónicas (Docker)

Variável	Exemplo
`ECOSIF_MASTERDATA_PORT`	`8080`
`ECOSIF_MASTERDATA_CONTEXT_PATH`	`/ecosif-masterdata`
`POSTGRES_*`	JDBC
`AUTH_TOKEN_SECRET`	Igual ao auth
`HIBERNATE_DDL_AUTO`	`validate`
`ECOSIF_CORS`	Frontend
S3 (opcional)	`AWS_S3_BUCKET`, credenciais AWS

3.2 Equivalência 0.7.01.x → 0.7.05

0.7.01.x	0.7.05
`SERVER_SERVLET_CONTEXT_PATH`	`ECOSIF_MASTERDATA_CONTEXT_PATH`
`ecosif_port`	`ECOSIF_MASTERDATA_PORT`
`ecosif_db_*`	`POSTGRES_*`

3.3 Docker

Item	Valor
Health check	`/ecosif-masterdata/actuator/health`
JAR	`ecosif-database-0.7.05.202605280.jar`

4. Checklist (0.7.01.x → 0.7.05.202605280)

[ ] Imagem e JAR database 0.7.05.
[ ] ECOSIF_MASTERDATA_CONTEXT_PATH=/ecosif-masterdata.
[ ] Postgres e JWT alinhados ao auth.
[ ] Rebuild obrigatório se pipeline falhou em ClosureControllerold (corrigido nesta versão).