release_notes_angular_v0.7.05.202605280

Projeto eCosif 02/2026

ecosif-angular (frontend) — 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.02.202605181 … v0.7.05.202605280 (23 commits)

1. Resumo executivo

Aspecto	0.7.01.x	0.7.05.202605280
Imagem Docker	`disoft/ecosif-angular:0.7.01…`	`disoft/ecosif-angular:0.7.05.202605280`
Configuração runtime	`window.env` + `config.json` (entrypoint com aliases legados)	Pipeline ECOSIF_ → INT_; validação obrigatória no arranque; sem defaults silenciosos
Artefatos na imagem	Possível `config.json` / `env.js` no build	Removidos do estágio final; gerados só no entrypoint
Health check	`/health`	`/health` (inalterado)
Funcionalidades	Base 0.7.01 (compliance, relatórios, sessão)	+ importação IPL (UI), monitor admin, produtividade em lançamentos, correções saldo/razão

Mudança crítica de operação: o contentor falha no startup se faltar qualquer variável ECOSIF_* obrigatória documentada em conf/scripts/ecosif-env-map.manifest. Não usar API_AUTH, IS_PROD, etc. em tasks novas.

2. Novidades e melhorias (release notes para o cliente)

2.1 Importação IPL e administração

Ecrã de importação IPL: upload e acompanhamento de ficheiros IPL alinhado ao fluxo ecosif-automations + ecosif-moviments.
Monitorização de importação (admin): consulta de estado de processos de importação em fila/S3.
Integração runtime Docker/AWS: documentação e scripts em docs/config-runtime-troubleshooting.md.

2.2 Lançamentos e produtividade

Digitação rápida: atalhos em conta e histórico nos lançamentos (release intermédia 0.0.00.202605275).
Typeahead e cache de histórico em lançamentos em lote (melhoria de performance).
Correções: combo histórico, contagem de lançamentos, contas reduzidas e texto de rendimento variável (encerramento).

2.3 Consultas e cadastros

Consulta saldo razão: ajustes na consulta de saldo do razão.
Replicação de localização nos cadastros (consistência entre ecrãs).
AppConfig: carregamento sem interceptors HTTP no bootstrap (evita falha de arranque com MSAL/auth).

2.4 Configuração runtime (0.7.05 — técnico)

ecosif-env-map.sh: mapeamento fechado SYS (ECOSIF_*) → INT (INT_*) usado apenas no entrypoint.
docker-entrypoint.sh: gera assets/config/config.json e assets/env.js; valida paridade token/URLs antes do Nginx.
environment.prod.ts: produção depende de window.env injetado em runtime (sem URLs MSAL/API no bundle).
CloudFormation: parâmetros Angular em ecosif-backend.yaml (versão, ambiente, URLs, flags Azure/local).

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

3.1 Variáveis de ambiente — ação obrigatória

O entrypoint não lê API_AUTH, API_MASTERDATA, IS_PROD ou APP_PORT como fonte principal. Usar exclusivamente o conjunto abaixo (ver também tabela-equivalencia-variaveis-0.7.01-para-0.7.05.md).

Variável	Exemplo	Obrigatória
`ECOSIF_ENABLE_RUNTIME`	`true`	sim
`ECOSIF_ANGULAR_PORT`	`8080`	sim
`ECOSIF_ENVIRONMENT`	`dev` / `prd`	sim
`ECOSIF_VERSION`	`0.7.05.202605280`	sim
`APP_NAME` ou `ECOSIF_APP_NAME`	`ECOSIF`	sim
`ECOSIF_ANGULAR_AUTH_TOKEN`	`ecosif-jwt`	sim
`TOKEN_EXPIRATION`	`1800000`	sim
`ECOSIF_ANGULAR_DEBUG`	`false`	sim
`ECOSIF_ANGULAR_HIDE_ADMIN_MENU`	`false`	sim
`ECOSIF_PAGINATION_SIZE`	`100`	sim
`ECOSIF_ENABLE_LOCAL_AUTH`	`true`	sim
`ECOSIF_ENABLE_AZURE_AUTH`	`false`	sim
`ECOSIF_ANGULAR_API_AUTH_URL`	`/ecosif-auth/`	sim*
`ECOSIF_ANGULAR_API_MASTERDATA_URL`	`/ecosif-masterdata/`	sim*
`ECOSIF_ANGULAR_API_MOVIMENTS_URL`	`/ecosif-moviments/`	sim*
`ECOSIF_ANGULAR_API_QUERYS_URL`	`/ecosif-querys/`	sim*
`ECOSIF_ANGULAR_API_REPORTS_URL`	`/ecosif-reports/`	sim*
`ECOSIF_ANGULAR_API_COMPLIANCE_URL`	`/ecosif-compliance/`	sim*

* Ou ECOSIF_API_BASE_URL + sufixos por serviço (domínio único).

Se ECOSIF_ENABLE_AZURE_AUTH=true: obrigatórios ECOSIF_AZURE_CLIENT_ID, ECOSIF_AZURE_TENANT_ID, ECOSIF_AZURE_AUTHORITY (sem placeholder 00000000-…).

Diagnóstico (opcional): ECOSIF_STORE_VARIABLES=true grava snapshot em /var/log/ecosif/.

3.2 Docker e imagem de produção

Item	Valor
Imagem	`disoft/ecosif-angular:0.7.05.202605280`
Dockerfile	`Dockerfile.prod` (Node build + Nginx Alpine)
Entrypoint	`/ecosif/scripts/docker-entrypoint.sh`
Health check	`GET /health`

3.3 Equivalência 0.7.01.x → 0.7.05 (resumo)

0.7.01.x (evitar em tasks novas)	0.7.05 (usar)
`API_AUTH`, `API_MASTERDATA`, …	`ECOSIF_ANGULAR_API_*_URL`
`IS_PROD` / `ECOSIF_ANGULAR_PRODUCTION` (legado)	`ECOSIF_ENABLE_RUNTIME`
`IS_DEBUG`	`ECOSIF_ANGULAR_DEBUG`
`APP_PORT`	`ECOSIF_ANGULAR_PORT`
`MS_CLIENTID`, …	`ECOSIF_AZURE_*`

4. Checklist de atualização (0.7.01.x → 0.7.05.202605280)

[ ] Atualizar imagem para 0.7.05.202605280.
[ ] Task definition com todas as variáveis §3.1 (sem nomes legados).
[ ] ECOSIF_ENABLE_RUNTIME=true em Docker/ECS (config runtime do container).
[ ] Paths /ecosif-* alinhados ao API Gateway.
[ ] Logs do contentor: Validacao config.json <-> env.js concluida.
[ ] Testar login local e/ou Microsoft conforme flags Azure.
[ ] Validar ecrãs de importação IPL e APIs de moviments/automations.

5. Referências

ecosif-angular/docs/config-runtime-troubleshooting.md
ecosif-angular/docs/variaveis-angular.md
ecosif-angular/conf/scripts/ecosif-env-map.manifest