Pular para conteúdo

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.