eCosif — Hub Central de Repositórios

Projeto eCosif 02/2026

ecosif-web (angular) -- versão: 0.7.01.202601282\ Notas de Versão e Impacto
versão documento data responsável
0.7.01.202601282 20/02/2026 José Augusto de Lima Pereira

Índice

Ecosif-angular - Release Notes e Impacto na Execução 2

1. Resumo executivo 2

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

2.1 Interface e funcionalidades 3

2.2 Configuração e build 4

2.3 Docker e deploy 4

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

3.1 Variáveis de ambiente --- ação recomendada 4

3.2 Docker e imagem de produção 5

3.3 Context path e API Gateway 6

3.4 Build (CI/CD) 6

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

\ {#section-1} =

Ecosif-angular - Release Notes e Impacto na Execução

Versão anterior: 0.6.00.x\ Versão atual: 0.7.01.x

Este documento descreve as alterações entre a versão 0.6.00.x e a versão 0.7.01.x, em formato de release notes para o cliente, e as mudanças que afetam a execução e a operação do serviço (build, Docker e variáveis de ambiente).

1. Resumo executivo {#resumo-executivo}

Aspecto 0.6.00.x (antes) 0.7.01.x (atual)
Versão (referência) 0.5.x / 0.6.00.x 0.7.01.202601282
Angular 14.2.x 14.2.x (mantido)
Configuração em runtime window.env (envsubst no entrypoint) window.env + config.json (entrypoint com sed/envsubst)
Variáveis de ambiente Nomes variados (API_AUTH, IS_DEBUG, APP_PORT, etc.) ECOSIF_ANGULAR_* (padronizado)
Docker (produção) Dockerfile único com envsubst Dockerfile.prod multi-stage (Node build + Nginx), entrypoint dedicado
Health check Conforme config Nginx (ex.: /healthcheck) /health (Nginx)
Documentação Dispersa / buildInfo docs/ (technical, operational, functional, aws-ecs-api-gateway)

A atualização pode exigir reconfigurar as variáveis de ambiente do contentor (ou do build) para os nomes ECOSIF_ANGULAR_* e garantir que o health check no ALB/API Gateway use o path /health.

2. Novidades e melhorias (release notes para o cliente) {#novidades-e-melhorias-release-notes-para-o-cliente}

2.1 Interface e funcionalidades {#interface-e-funcionalidades}

2.2 Configuração e build {#configuração-e-build}

2.3 Docker e deploy {#docker-e-deploy}

3. Mudanças que afetam a execução do serviço {#mudanças-que-afetam-a-execução-do-serviço}

3.1 Variáveis de ambiente --- ação recomendada {#variáveis-de-ambiente-ação-recomendada}

Os nomes das variáveis foram padronizados para o prefixo ECOSIF_ANGULAR_*. O entrypoint do contentor (0.7.01.x) espera essas variáveis para gerar window.env e, quando existir template, config.json.

Tabela de equivalência (0.6.00.x → 0.7.01.x):

0.6.00.x (antigo) 0.7.01.x (atual) Observação
API_AUTH, API_BASE_URL + sufixos ECOSIF_ANGULAR_API_AUTH_URL Base do ecosif-auth (ex.: /ecosif-auth).
(idem para masterdata, moviments, querys, reports) ECOSIF_ANGULAR_API_MASTERDATA_URL, ECOSIF_ANGULAR_API_MOVIMENTS_URL, ECOSIF_ANGULAR_API_QUERYS_URL, ECOSIF_ANGULAR_API_REPORTS_URL Bases das APIs; em domínio único use paths relativos.
(não existia) ECOSIF_ANGULAR_API_COMPLIANCE_URL Base do ecosif-compliance (ex.: /ecosif-compliance).
IS_PROD ECOSIF_ANGULAR_PRODUCTION true em produção; usado como fonte da verdade para ambiente.
IS_DEBUG ECOSIF_ANGULAR_DEBUG Modo debug (ex.: false em prod).
(não existia) ECOSIF_ANGULAR_HIDE_ADMIN_MENU true para ocultar menu "Ferramentas Administrativas" (ex.: Logs Docker).
APP_PORT ECOSIF_ANGULAR_PORT Porta em que o Nginx escuta (ex.: 80).
AUTH_TOKEN ECOSIF_ANGULAR_AUTH_TOKEN Chave localStorage do JWT (opcional).
(build) ECOSIF_API_BASE_URL Em dev ou quando não há domínio único; em prod com domínio único não é necessário.
(Azure) ECOSIF_AZURE_CLIENT_ID, ECOSIF_AZURE_AUTHORITY, ECOSIF_AZURE_TENANT_ID Login Azure AD (MSAL).
(não existia) ECOSIF_PAGINATION_SIZE Tamanho padrão de paginação (ex.: 100).

Importante: Em produção com domínio único (ex.: https://app.ecosif.banco.com.br), as bases das APIs são apenas paths relativos (/ecosif-auth, /ecosif-masterdata, etc.); não é obrigatório definir ECOSIF_API_BASE_URL no frontend.

3.2 Docker e imagem de produção {#docker-e-imagem-de-produção}

3.3 Context path e API Gateway {#context-path-e-api-gateway}

3.4 Build (CI/CD) {#build-cicd}

4. Checklist de atualização (0.6.00.x → 0.7.01.x) {#checklist-de-atualização-0.6.00.x-0.7.01.x}