Job Description
Descrição da vaga
Venha fazer parte de uma empresa que ama transformar com tecnologia e abraça a diversidade em todas as suas formas!
Requisitos e qualificações
Arquiteto(a) de Integrações (foco: desenho de integrações e mapeamento de interfaces)
2) Escopo de atuação (responsabilidades principais)
2.1 Arquitetura de Integração (Solução)
Levantar e detalhar requisitos de integração com negócio e times técnicos (funcionais e não funcionais).
Definir o estilo de integração adequado por cenário:
síncrono (REST/gRPC),
assíncrono (eventos/pub-sub, filas),
batch/arquivo (SFTP, object storage),
integração via ESB/iPaaS/API Gateway.
Desenhar fluxos ponta a ponta (request/response, eventos, compensações, retries, idempotência).
Definir padrões arquiteturais:
API-led connectivity, event-driven, saga/orquestração, choreography,
anti-corruption layer, strangler pattern (modernização),
canonical model vs. mapeamento ponto-a-ponto (trade-offs).
Avaliar alternativas e recomendar solução com base em custo, risco, time-to-market e maturidade da plataforma.
2.2 Mapeamento de Interfaces e Catálogo de Integrações
Construir e manter o Mapa de Interfaces (inventário de integrações):
sistema origem/destino,
tipo (API/evento/fila/arquivo),
contrato (schema), versão, owner e SLA,
criticidade, dependências e consumidores.
Definir taxonomia e padrões de nomenclatura:
APIs (paths, resources), eventos (namespaces, topics), filas e arquivos.
Produzir e evoluir documentação viva (OpenAPI/AsyncAPI, runbooks, diagramas).
2.3 Design de Contratos (APIs e Eventos)
Definir contratos e guidelines:
APIs: OpenAPI, versionamento, compatibilidade retroativa, paginação, filtros, erros, rate limit.
Eventos: AsyncAPI/JSON Schema/Avro/Protobuf, versionamento de schema, compatibilidade, DLQ.
Definir regras de integração:
idempotência, deduplicação, ordenação, correlação (correlation-id), tracing distribuído,
timeouts, retries, circuit breaker, backoff, bulkheads,
padrões de erro e mensagens.
Definir políticas de publicação e consumo (governança de eventos e APIs).
2.4 Segurança e Conformidade nas Integrações
Definir padrões de autenticação e autorização:
OAuth2/OIDC, mTLS, JWT, API Keys (quando aplicável), service-to-service.
Requisitos LGPD e dados sensíveis:
minimização de dados nos payloads, mascaramento, logging seguro, retenção.
Definir trilhas de auditoria e requisitos de evidência.
2.6 Governança de Arquitetura e Habilitação dos Times
Conduzir Architecture Reviews de integrações e contratos.
Criar e manter padrões, templates e checklists (API checklist, event checklist, security checklist).
Atuar com times de Plataforma (API Gateway, mensageria, iPaaS/ESB) e Segurança.
Mentoria e “office hours” para times consumidores/produtores.
4) Entregáveis (artefatos)
4.1 Desenho de Integração (por iniciativa/epic)
HLD (High Level Design) da integração (visão macro, componentes, fluxos, NFRs).
LLD (Low Level Design) quando necessário:
contratos, sequência, regras de erro, idempotência, estratégias de retry/DLQ.
Diagramas:
contexto (C4),
sequência (UML) para fluxos síncronos/assíncronos,
fluxo de dados e integrações,
deployment lógico (se aplicável).
ADRs (Architecture Decision Records) com decisões e trade-offs.
4.2 Catálogo / Mapa de Interfaces
Inventário de APIs, eventos e integrações com metadados mínimos:
owner, criticidade, ambientes, endpoints/topics, versionamento,
consumidores, dependências, SLA/SLO, dados sensíveis.
Matriz “sistema ↔️ interfaces” por domínio/linha de produto.
Roadmap de racionalização (integrações duplicadas, legados, pontos de falha).
4.3 Contratos e Padrões
Especificações OpenAPI (APIs) e AsyncAPI (eventos) revisadas/aprovadas.
Guidelines de versionamento e compatibilidade.
Padrões de segurança e headers/correlation-id.
Checklist de prontidão (go-live) para integrações.
5) Metodologia de execução (como o serviço acontece)
Discovery: entendimento do processo de negócio, sistemas envolvidos, SLAs e riscos.
As-is: mapeamento das interfaces existentes, dores, gargalos e incidentes recorrentes.
To-be: desenho da integração alvo + alternativas e trade-offs.
Validação: sessões com Arquitetura, Segurança, Plataforma e times executores.
Acompanhamento: checkpoints durante implementação (revisão de contratos, governança de mudanças).
Evolução contínua: manutenção do mapa de interfaces e padrões.