Projeto eCosif 05/2026

Instrução Técnica de Implantação

versão: 0.7.05.202605280

Índice

1. Introdução e versões
2. Arquitetura geral e mapeamento de URLs
3. Pré-requisitos e criação do banco de dados
4. Variáveis de ambiente (visão geral)
5. ecosif-angular (frontend)
6. ecosif-auth
7. ecosif-masterdata
8. ecosif-moviments
9. ecosif-querys
10. ecosif-reports
11. ecosif-compliance
12. ecosif-automations (Lambda + SQS)
13. Implementação na AWS (ECS, API Gateway, Lambda, SQS)
14. Ordem sugerida de implantação
15. Checklist pós-implantação

Modelo de entrega ao cliente

O cliente não recebe os fontes do projeto. A entrega é feita por:

• imagens Docker para módulos ECS (angular, auth, masterdata, moviments, querys, reports, compliance)
• pacote ZIP para ecosif-automations executado em AWS Lambda

Não há build no cliente (mvn, npm, etc.). O processo é configuração de ambiente, deploy dos artefatos e integração com AWS.

Referências de infraestrutura no repositório:

• ecosif-structure/aws/exemple/task-definitions/
• ecosif-structure/aws/exemple/dev/task-definitions/
• ecosif-structure/aws/exemple/ecosif-automations/ecosif-automations-lambda-sqs-minimal.yaml
• ecosif-structure/aws/exemple/dev/ecosif-automations/ecosif-automations-lambda-sqs-dev.yaml

1. Introdução e versões

O eCosif é um ecossistema com frontend Angular e APIs backend para autenticação, cadastros, lançamentos, consultas, relatórios, conformidade e automação de importação.

1.1 Versões dos módulos (release 0.7.05)

2. Arquitetura geral e mapeamento de URLs

2.1 Domínio único (produção)

Exemplo: https://app.ecosif.banco.com.br

2.2 Automations no fluxo

O ecosif-automations não expõe rota HTTP pública via ECS/API Gateway. O fluxo ocorre por:

• upload de arquivo no bucket S3
• Lambda import
• filas SQS (entries, consolidation.fifo, consolidation-defer)
• Lambdas entries e consolidation

3. Pré-requisitos e criação do banco de dados

3.1 Pré-requisitos gerais

• PostgreSQL 12+
• AWS: ECS, ECR, API Gateway, ACM, Lambda, SQS, S3, Secrets Manager
• domínio e certificado TLS
• chave JWT única para serviços Java (AUTH_TOKEN_SECRET)
• AWS CLI autenticado para operações de deploy

3.2 Criação do banco (exemplo SQL)

CREATE DATABASE ecosif
  WITH ENCODING = 'UTF8'
  LC_COLLATE = 'pt_BR.UTF-8'
  LC_CTYPE = 'pt_BR.UTF-8'
  TEMPLATE = template0;

-- conectar: \c ecosif

CREATE USER ecosif_auth WITH PASSWORD '<senha-auth>';
GRANT ALL PRIVILEGES ON DATABASE ecosif TO ecosif_auth;
GRANT ALL ON SCHEMA public TO ecosif_auth;

CREATE USER ecosif_masterdata WITH PASSWORD '<senha-masterdata>';
GRANT CONNECT ON DATABASE ecosif TO ecosif_masterdata;
GRANT USAGE ON SCHEMA public TO ecosif_masterdata;

CREATE USER ecosif_moviments WITH PASSWORD '<senha-moviments>';
GRANT CONNECT ON DATABASE ecosif TO ecosif_moviments;
GRANT USAGE ON SCHEMA public TO ecosif_moviments;

CREATE USER ecosif_querys WITH PASSWORD '<senha-querys>';
GRANT CONNECT ON DATABASE ecosif TO ecosif_querys;
GRANT USAGE ON SCHEMA public TO ecosif_querys;

CREATE USER ecosif_reports WITH PASSWORD '<senha-reports>';
GRANT CONNECT ON DATABASE ecosif TO ecosif_reports;
GRANT USAGE ON SCHEMA public TO ecosif_reports;

CREATE USER ecosif_compliance WITH PASSWORD '<senha-compliance>';
GRANT CONNECT ON DATABASE ecosif TO ecosif_compliance;
GRANT USAGE ON SCHEMA public TO ecosif_compliance;

Observação: ecosif-auth deve subir primeiro com Flyway para criar/atualizar schema.

4. Variáveis de ambiente (visão geral)

4.1 Compartilhadas

4.2 Referência operacional

As tabelas detalhadas por módulo estão nos release notes da pasta releases/0.7.05.202605280/.

5. ecosif-angular (frontend)

5.1 Função e tecnologia

• Função: Interface web (login, cadastros, lançamentos, consultas, relatórios e administração).
• Stack: Angular, TypeScript, CoreUI, Bootstrap, Nginx (servir estáticos).
• Versão: 0.7.05.202605280 (disoft/ecosif-angular:0.7.05.202605280).

5.2 Variáveis de ambiente

Definir na task/contentor do frontend. O entrypoint usa-as para gerar window.env / config.json. Com domínio único, as bases das APIs são paths relativos.

Variáveis opcionais (ecosif-angular)

5.3 Passo a passo de implantação (ecosif-angular)

1. Obter a imagem Docker do registo (ex.: ECR).
2. Configurar variáveis de ambiente na task definition (ECS) ou no contentor.
3. Executar o contentor (porta HTTP do Nginx) e validar health check /health.
4. Expor o serviço na raiz (path /) no API Gateway ou ALB.
5. Validar: abrir https://<domínio> e verificar login.

6. ecosif-auth

6.1 Função e tecnologia

• Função: Autenticação, emissão e validação de JWT.
• Stack: Java 17, Spring Boot, Flyway, PostgreSQL.
• Versão: 0.7.05.202605280 (disoft/ecosif-auth:0.7.05.202605280).

6.2 Variáveis de ambiente

Variáveis opcionais (ecosif-auth)

6.3 Passo a passo de implantação (ecosif-auth)

1. Obter imagem Docker do registo.
2. Configurar variáveis na task ECS; segredos via Secrets Manager.
3. Subir o serviço ECS com Flyway ativo na primeira execução.
4. Configurar health check: /ecosif-auth/actuator/health.
5. Mapear /ecosif-auth e /ecosif-auth/{proxy+} no API Gateway.

7. ecosif-masterdata

7.1 Função e tecnologia

• Função: Gestão de dados mestres (empresas, filiais, fundos e entidades base).
• Stack: Java 17, Spring Boot, PostgreSQL.
• Versão: 0.7.05.202605280 (disoft/ecosif-masterdata:0.7.05.202605280).

7.2 Variáveis de ambiente

Variáveis opcionais (ecosif-masterdata)

7.3 Passo a passo de implantação (ecosif-masterdata)

1. Obter imagem Docker do registo.
2. Configurar variáveis de ambiente da task ECS.
3. Subir serviço ECS após ecosif-auth disponível.
4. Configurar health check /ecosif-masterdata/actuator/health.
5. Mapear /ecosif-masterdata e /ecosif-masterdata/{proxy+}.

8. ecosif-moviments

8.1 Função e tecnologia

• Função: Processamento de lançamentos e movimentações contábeis.
• Stack: Java 17, Spring Boot, PostgreSQL.
• Versão: 0.7.05.202605280 (disoft/ecosif-moviments:0.7.05.202605280).

8.2 Variáveis de ambiente

Variáveis opcionais (ecosif-moviments)

8.3 Passo a passo de implantação (ecosif-moviments)

1. Obter imagem Docker do registo.
2. Configurar variáveis de ambiente da task ECS.
3. Subir serviço ECS após auth e masterdata.
4. Configurar health check /ecosif-moviments/actuator/health.
5. Mapear /ecosif-moviments e /ecosif-moviments/{proxy+}.

9. ecosif-querys

9.1 Função e tecnologia

• Função: Consultas e leitura de dados operacionais/contábeis.
• Stack: Java 17, Spring Boot, PostgreSQL.
• Versão: 0.7.05.202605280 (disoft/ecosif-querys:0.7.05.202605280).

9.2 Variáveis de ambiente

Variáveis opcionais (ecosif-querys)

9.3 Passo a passo de implantação (ecosif-querys)

1. Obter imagem Docker do registo.
2. Configurar variáveis de ambiente na task ECS.
3. Subir serviço ECS após moviments.
4. Configurar health check /ecosif-querys/actuator/health.
5. Mapear /ecosif-querys e /ecosif-querys/{proxy+}.

10. ecosif-reports

10.1 Função e tecnologia

• Função: Geração e disponibilização de relatórios.
• Stack: Java 17, Spring Boot, PostgreSQL.
• Versão: 0.7.05.202605280 (disoft/ecosif-reports:0.7.05.202605280).

10.2 Variáveis de ambiente

Variáveis opcionais (ecosif-reports)

10.3 Passo a passo de implantação (ecosif-reports)

1. Obter imagem Docker do registo.
2. Configurar variáveis de ambiente na task ECS.
3. Subir serviço ECS após querys.
4. Configurar health check /ecosif-reports/actuator/health.
5. Mapear /ecosif-reports e /ecosif-reports/{proxy+}.

11. ecosif-compliance

11.1 Função e tecnologia

• Função: Execução de regras e validações de conformidade.
• Stack: Python, Flask, Gunicorn, PostgreSQL.
• Versão: 0.7.05.202605280 (disoft/ecosif-compliance:0.7.05.202605280).

11.2 Variáveis de ambiente

Variáveis opcionais (ecosif-compliance)

11.3 Passo a passo de implantação (ecosif-compliance)

1. Obter imagem Docker do registo.
2. Configurar variáveis de ambiente na task ECS.
3. Subir task/service do compliance.
4. Configurar health check /health.
5. Mapear /ecosif-compliance e /ecosif-compliance/{proxy+}.
6. No frontend, definir ECOSIF_ANGULAR_API_COMPLIANCE_URL=/ecosif-compliance.

12. ecosif-automations (Lambda + SQS)

12.1 Função e tecnologia

• Função: Processamento da importação IPL e consolidação por pipeline assíncrono.
• Stack: Python em AWS Lambda, SQS, S3 e Secrets Manager.
• Versão: 0.7.05.202605280 (pacote ZIP em https://files.disoft.com.br/). no endereço: itau-ecosif/0_7_05_X/aws/lambda/ecosif_automations_0_7_05_202605280.zip O ecosif-automations não roda como ECS Service em produção AWS.

12.2 Variáveis de ambiente

Variáveis opcionais (ecosif-automations)

12.3 Passo a passo de implantação (ecosif-automations)

1. Baixar o pacote da release:

export ZIP_URL="https://files.disoft.com.br/ecosif/aws/ecosif-automations-0.7.05.202605280.zip"
export ZIP_FILE="ecosif-automations-0.7.05.202605280.zip"
curl -fL "$ZIP_URL" -o "$ZIP_FILE"
unzip -t "$ZIP_FILE"

2. Criar filas SQS e DLQ:

export AWS_REGION=us-west-1
export ACCOUNT_ID=123456789012
export PROJECT=ecosif
export ENV=dev
export PREFIX="${PROJECT}-${ENV}-automations"

aws sqs create-queue --region "$AWS_REGION" --queue-name "${PREFIX}-entries-dlq"
aws sqs create-queue --region "$AWS_REGION" --queue-name "${PREFIX}-consolidation-dlq"
aws sqs create-queue --region "$AWS_REGION" --queue-name "${PREFIX}-consolidation-defer-dlq"

3. Criar Lambdas:

aws lambda create-function \
  --region "$AWS_REGION" \
  --function-name "${PROJECT}-${ENV}-automations-import" \
  --runtime python3.11 \
  --handler src.handlers.import_handler.lambda_handler \
  --zip-file "fileb://${ZIP_FILE}" \
  --role "arn:aws:iam::${ACCOUNT_ID}:role/ecosif-${ENV}-lambda-execution-role" \
  --timeout 120 \
  --memory-size 512 \
  --environment file://import-env.json

4. Repetir criação para entries e consolidation com os handlers corretos.
5. Mapear filas para Lambdas:

aws lambda create-event-source-mapping \
  --region "$AWS_REGION" \
  --function-name "${PROJECT}-${ENV}-automations-entries" \
  --event-source-arn "<entries-queue-arn>" \
  --batch-size 1 \
  --enabled

6. Repetir o mapeamento para consolidation.
7. Configurar trigger S3 (opcional/recomendado):

aws lambda add-permission \
  --region "$AWS_REGION" \
  --function-name "${PROJECT}-${ENV}-automations-import" \
  --statement-id "allow-s3-invoke-import" \
  --action "lambda:InvokeFunction" \
  --principal s3.amazonaws.com \
  --source-arn "arn:aws:s3:::ecosif-${ENV}-import-${ACCOUNT_ID}"

8. Validar funções e logs:

aws lambda get-function-configuration --region "$AWS_REGION" --function-name "${PROJECT}-${ENV}-automations-import"
aws logs tail "/aws/lambda/${PROJECT}-${ENV}-automations-import" --follow --region "$AWS_REGION"

13. Implementação na AWS (ECS, API Gateway, Lambda, SQS)

13.1 ECS + API Gateway (módulos HTTP)

• um serviço ECS por módulo HTTP
• roteamento por path no API Gateway para ALB/integração de cada serviço
• TLS final no domínio customizado do API Gateway (ACM)

13.2 Domínio e certificado

1. Criar certificado ACM (validação DNS)
2. Criar domínio customizado no API Gateway
3. Associar API e stage
4. Configurar DNS (Route53 ou externo)

13.3 Automations

• executar Lambda + SQS + S3
• sem ECS Service
• usar template de referência ou comandos CLI do item 12

14. Ordem sugerida de implantação

1. Infra base: VPC, subnets, RDS, secrets
2. ECS APIs: auth, masterdata, moviments, querys, reports, compliance
3. ECS frontend: angular
4. API Gateway + domínio customizado + certificado
5. Automations: SQS + Lambdas + trigger S3
6. Testes ponta a ponta

15. Checklist pós-implantação

• [ ] Todas as tasks ECS com tag 0.7.05.202605280
• [ ] Context paths ECOSIF_*_CONTEXT_PATH corretos
• [ ] AUTH_TOKEN_SECRET compartilhado corretamente entre serviços Java
• [ ] Frontend com ECOSIF_ENABLE_RUNTIME=true e APIs /ecosif-*
• [ ] Compliance respondendo em /ecosif-compliance
• [ ] Filas SQS/DLQ do automations criadas
• [ ] Lambdas import, entries, consolidation implantadas com ZIP da release
• [ ] Trigger S3 (quando aplicável) configurado
• [ ] Fluxo IPL + CT32.LD validado com sucesso

NOTAS

Para detalhes finos por módulo, consultar os release notes individuais em releases/0.7.05.202605280/.

Fim do documento.