Cadastro manual de Gateway

Criar um Gateway e sua primeira revisão para configuração posterior. O cliente administrativo envia POST /gateway/api/v1/gateways ao BFF; o Core recebe POST /core/api/v1/gateways.

%%{init: {"theme":"base","themeVariables":{"fontFamily":"Arial, sans-serif","fontSize":"16px","lineColor":"#64748b","primaryTextColor":"#172b4d"},"flowchart":{"htmlLabels":true,"useMaxWidth":true,"nodeSpacing":28,"rankSpacing":38,"padding":14,"curve":"linear","subGraphTitleMargin":{"top":12,"bottom":16}},"sequence":{"useMaxWidth":true,"actorMargin":28,"width":145,"height":45,"diagramMarginX":32,"diagramMarginY":12,"messageMargin":24,"wrap":true,"mirrorActors":false},"themeCSS":".edgeLabel, .edgeLabel p {background-color:var(--diagram-surface)!important;color:var(--diagram-text)!important}\n.cluster rect {fill:var(--diagram-group)!important;stroke:var(--diagram-line)!important}\n.cluster-label span, .cluster-label text {color:var(--diagram-text)!important;fill:var(--diagram-text)!important}\n.flowchart-link, .actor-line {stroke:var(--diagram-line)!important}\nmarker path {fill:var(--diagram-line)!important;stroke:var(--diagram-line)!important}\n.actor {fill:var(--diagram-domain)!important;stroke:var(--diagram-domain-border)!important}\ntext.actor, .messageText, .loopText, .labelText {fill:var(--diagram-text)!important}\n.messageLine0, .messageLine1, .loopLine {stroke:var(--diagram-line)!important}\n.labelBox {fill:var(--diagram-surface)!important;stroke:var(--diagram-line)!important}\n.note {fill:var(--diagram-async)!important;stroke:var(--diagram-async-border)!important}\n.noteText {fill:var(--diagram-text)!important}\n.nodeLabel, .nodeLabel p, .nodeLabel span {color:var(--diagram-text)!important}\n.node .nodeLabel, .node .nodeLabel p {font-size:17px;font-weight:600;line-height:1.4;text-align:center}\n.nodeLabel small {display:inline-block;margin-top:4px;font-size:15px;font-weight:400;line-height:1.4;color:var(--diagram-description)!important}\ntext.actor, text.actor tspan {font-size:17px;font-weight:600}\n.node.entry rect, .node.entry polygon, .node.entry path, .node.entry circle {fill:var(--diagram-entry)!important;stroke:var(--diagram-entry-border)!important}\n.node.domain rect, .node.domain polygon, .node.domain path, .node.domain circle {fill:var(--diagram-domain)!important;stroke:var(--diagram-domain-border)!important}\n.node.security rect, .node.security polygon, .node.security path, .node.security circle {fill:var(--diagram-security)!important;stroke:var(--diagram-security-border)!important}\n.node.store rect, .node.store polygon, .node.store path, .node.store circle {fill:var(--diagram-store)!important;stroke:var(--diagram-store-border)!important}\n.node.async rect, .node.async polygon, .node.async path, .node.async circle {fill:var(--diagram-async)!important;stroke:var(--diagram-async-border)!important}\n.node.external rect, .node.external polygon, .node.external path, .node.external circle {fill:var(--diagram-external)!important;stroke:var(--diagram-external-border)!important}\n text.actor tspan, .loopText tspan, .labelText tspan, .messageText tspan, .noteText tspan {fill:var(--diagram-text)!important}\n\n"}}%%
%%{init: {"sequence":{"width":95,"actorMargin":16,"messageMargin":20,"wrap":true}}}%%
sequenceDiagram
    actor A as Cliente<br/>administrativo
    participant B as BFF
    participant C as Core
    participant M as MongoDB
    participant S as Security
    participant I as IP Policy
    participant R as Rate Limit
    participant K as Keycloak

    A->>B: Cadastrar Gateway
    B->>B: Validar JWT e entrada<br/>Resolver tenant e adaptar payload
    B->>C: Criar Gateway + x-tenant-id
    C->>M: Validar nome e inserir gateways<br/>(desabilitado)
    C->>C: Validar caminhos e referências
    Note over C,R: Validadores do Core sem ordem fixa<br/>Consultas abaixo somente para vínculos informados
    opt Autenticação informada
        C->>S: Validar autenticação
        opt OAUTH2_PROVIDED
            S->>K: Consultar client
            K-->>S: Dados do client
        end
        S-->>C: Autenticação encontrada
    end
    opt IP Policies informadas
        loop Cada política
            C->>I: Validar política
            I-->>C: Política encontrada
        end
    end
    opt Rate Limit informado
        C->>R: Validar limite
        R-->>C: Limite encontrado
    end
    C->>M: Inserir gateway_revisions<br/>DRAFT 0.1 e concluir transação
    M-->>C: Persistência concluída
    C-->>B: 201 — IDs do Gateway,<br/>revisão e vínculos

    Note over B,R: Enriquecimento após a persistência
    opt Autenticação vinculada
        B->>S: Consultar autenticação
        opt OAUTH2_PROVIDED
            S->>K: Consultar client
            K-->>S: Dados do client
        end
        S-->>B: Dados da autenticação
    end
    opt IP Policies vinculadas
        loop Cada política
            B->>I: Consultar política
            I-->>B: Dados da política
            B->>C: Contar rotas vinculadas à política
            C-->>B: Contagem
        end
    end
    opt Rate Limit vinculado
        B->>R: Consultar limite
        R-->>B: Dados do limite
        B->>C: Contar rotas vinculadas ao limite
        C-->>B: Contagem
    end
    B->>B: Montar resposta e ajustar caminhos
    B-->>A: 201 — Gateway cadastrado

O BFF valida o acesso ao aplicativo ipaas, obtém o tenant do claim companyId, adapta os caminhos e a referência de autenticação e monta a resposta enriquecida. O Core aplica as regras e persiste os documentos por tenant. Security, IP Policy e Rate Limit consultam os cadastros vinculados; Keycloak participa da consulta de autenticações OAUTH2_PROVIDED. MongoDB aparece no diagrama apenas nas persistências centrais; as leituras internas dos serviços foram omitidas.

Resultado: Gateway com enabled=false, favorite=false e fromTemplate=false, associado à revisão DRAFT 0.1. O cliente recebe id, revisionId e os dados enriquecidos. O cadastro não cria rotas nem publica o Gateway; enviar enabled=true não muda o estado inicial.

Alternativas e erros relevantes: sem vínculos, as respectivas consultas são omitidas. JWT/acesso inválido resulta em 401/403; entrada ou referências inválidas, 400; conflitos de nome ou basePath, 409. Erros HTTP downstream são propagados pelo BFF. Uma falha no enriquecimento pode retornar erro depois de o cadastro já ter sido persistido.

Consulte BFF, modelo do Core, versionamento e eventos e invalidação para os contratos e mecanismos complementares. O diagrama representa o caminho síncrono do cadastro; não atribui a ele eventos de publicação do Gateway.