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: geraassets/config/config.jsoneassets/env.js; valida paridade token/URLs antes do Nginx.environment.prod.ts: produção depende dewindow.envinjetado 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=trueem 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.mdecosif-angular/docs/variaveis-angular.mdecosif-angular/conf/scripts/ecosif-env-map.manifest