release_notes_querys_v0.7.05.202605280

Projeto eCosif 02/2026

ecosif-querys (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.202601280
Versão atual: 0.7.05.202605280
Referência Git: v0.7.01.202601281 … v0.7.05.202605280 (16 commits)

1. Resumo executivo

Aspecto	0.7.01.x	0.7.05.202605280
Imagem	`disoft/ecosif-querys:0.7.01…`	`disoft/ecosif-querys:0.7.05.202605280`
Stack	Java 17, Spring Boot 2.7	Mantido
ecosif-database	0.7.01.202512010	0.7.05.202605280
Consultas	Saldo, razão, plano de contas	+ correção saldos nulos em consulta de balancete
Entrypoint	Legado / Spring direto	*`ECOSIF_QUERYS_`** canónicas

2. Novidades e melhorias

2.1 Funcionalidades e correções

Consulta de saldo / balancete (BalanceInquiryController): tratamento de accumulatedBalance nulo (evita erro 500 e valores incorretos no frontend).
Repositório MonthlyAccountBalanceRepository: consultas alinhadas a saldos iniciais com validação de null.
Validação de acesso: ajustes em AccessValidationService.
ecosif-database 0.7.05: tipos numéricos obrigatórios em entidades de saldo; UK ct_lote corrigida para Hibernate.

2.2 Runtime e operação

Entrypoint padronizado (ECOSIF_QUERYS_PORT, ECOSIF_QUERYS_CONTEXT_PATH, POSTGRES_*).
Healthcheck e arranque: melhorias de inicialização em contentor (multi-arch).
Documentação: docs/ambiente/variaveis_operacionais.md, docs/aws-ecs-api-gateway.md, scripts de teste API.

2.3 Mantido desde 0.7.01.x

APIs somente leitura (saldo, razão, plano de contas).
SpringDoc OpenAPI 3.0, Actuator /actuator/health, métricas Prometheus.
Flyway opcional via ECOSIF_FLYWAY_ENABLED.

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

3.1 Variáveis canónicas (Docker)

Variável	Exemplo
`ECOSIF_QUERYS_PORT`	`8080`
`ECOSIF_QUERYS_CONTEXT_PATH`	`/ecosif-querys`
`POSTGRES_*`	JDBC
`AUTH_TOKEN_SECRET`	≥ 32 bytes, igual ao auth
`HIBERNATE_DDL_AUTO`	`validate`
`ECOSIF_CORS`	Frontend

Opcionais: TOKEN_EXPIRATION, logs (ECOSIF_LOGSHOW, LOG_FORMAT), S3, OAuth Google.

3.2 Equivalência 0.7.01.x → 0.7.05

0.7.01.x	0.7.05
`ecosif_port`	`ECOSIF_QUERYS_PORT`
`SERVER_SERVLET_CONTEXT_PATH`	`ECOSIF_QUERYS_CONTEXT_PATH`
`ecosif_db_server`	`POSTGRES_HOST`
`auth_token_secret`	`AUTH_TOKEN_SECRET`

3.3 Docker

Item	Valor
Health check	`/ecosif-querys/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 (crítico: UK ct_lote — serviço não sobe com JAR antigo).
[ ] Task com variáveis canónicas §3.1.
[ ] Validar consultas de saldo/balancete no frontend após deploy.
[ ] Health check ALB no path do context.