release_notes_database_v0.7.05.202605280

Projeto eCosif 02/2026

ecosif-database (biblioteca Java partilhada) — versão: 0.7.05.202605280
Notas de versão e impacto nos serviços que consomem o JAR

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.202512010
Versão atual: 0.7.05.202605280
Referência Git: v0.7.01.202512010 … v0.7.05.202605280 (13 commits)

Serviços afetados: ecosif-auth, ecosif-masterdata, ecosif-moviments, ecosif-querys, ecosif-reports (todos devem usar o mesmo JAR na mesma release).

1. Resumo executivo

Aspecto	0.7.01.x	0.7.05.202605280
Artefacto	`ecosif-database-0.7.01.*.jar`	`ecosif-database-0.7.05.202605280.jar`
Distribuição	Maven / `libs/` nos serviços	`distribute-jar.sh` → `libs/` de cada API
Impacto	Modelo de dados base	Correção crítica UK `ct_lote` + tipos de saldo

Ação obrigatória: rebuild e redeploy de todos os serviços Java que embutem o JAR; misturar versões causa falha de arranque Hibernate (AnnotationException em Batch / ct_lote).

2. Alterações no modelo e entidades

2.1 `Batch` (`ct_lote`) — crítico

Unique constraint JPA: columnNames passam a usar nomes de coluna da base (lote, empresa, filial, ano, mes) em vez de nomes de propriedades Java.
Motivo: sem esta correção, serviços como ecosif-querys e ecosif-masterdata falham no startup com org.hibernate.AnnotationException.
Migrações Flyway (auth): V0.7.00.5 / V0.7.00.6 alinham schema e UK no PostgreSQL.

2.2 Saldos mensais

MonthlyAccountBalance / MonthlyAccountBalanceHistory: campos numéricos (accumulatedBalance, movimentos) com obrigatoriedade e tipos Double coerentes com a BD.
Impacto em querys: consultas de balancete deixam de receber null indevido quando a BD tem valores default.

2.3 `StandardRelease` (ECS-324)

Ajuste de tipos Integer / Double em campos do modelo de release padrão.

3. CI e publicação

Publicação Maven apenas em tags v* (evita conflito 409 no repositório).
Artefacto gerado na tag v0.7.05.202605280.

4. Checklist para equipas de serviço

[ ] Compilar ecosif-database e executar ./distribute-jar.sh (ou pipeline equivalente).
[ ] Atualizar libs/ecosif-database-0.7.05.202605280.jar em auth, masterdata, moviments, querys, reports.
[ ] mvn package e nova imagem Docker de cada serviço na mesma versão 0.7.05.202605280.
[ ] Aplicar migrações Flyway no auth antes de subir querys/masterdata se UK/schema mudou.
[ ] Validar arranque: log sem AnnotationException em Batch.