NN-Agent

ARQUITETURA

O caminho de uma requisição

Cada chamada atravessa as mesmas etapas, da sua aplicação até o banco ou a API de destino.

  1. ETAPA 1

    Sua aplicação

    Faz a chamada HTTP, por exemplo GET /api/v1/usuarios/10.

  2. ETAPA 2

    Middlewares

    Registro, métricas, tracing, CORS e controle de timeout.

  3. ETAPA 3

    Controller

    Valida o token (rotas de configuração) e lê path, query, body e headers.

  4. ETAPA 4

    Executor

    Roda o step: QUERY, INSERT, POST, GET e os demais.

  5. ETAPA 5

    Banco ou API

    Oracle, PostgreSQL, MySQL, SQL Server ou uma API REST.

db/z-agent.db

Conexões, commands, rotas e certificados ficam guardados em um único arquivo local (BoltDB). Ao reiniciar o serviço, tudo é recarregado — nada se perde.

EXECUTORES

10 executores, dois grupos

Cada step de uma rota escolhe um executor pelo campo type. Os de SQL falam com bancos; os HTTP chamam APIs externas.

  • SQL

    QUERY

    Consulta (SELECT). Devolve uma lista de objetos.

  • SQL

    INSERT

    Insere linhas. Devolve a quantidade afetada.

  • SQL

    UPDATE

    Atualiza linhas. Exige WHERE.

  • SQL

    DELETE

    Remove linhas. Exige WHERE.

  • SQL

    PROCEDURE

    Executa uma procedure. Devolve o primeiro parâmetro OUT.

  • SQL

    ANONYMOUS

    Bloco anônimo (BEGIN…END). Aceita CLOB no Oracle.

  • HTTP

    GET

    Chama uma API externa com GET.

  • HTTP

    POST

    Envia JSON, formulário ou arquivo. Suporta mTLS.

  • HTTP

    PUT

    Atualiza dados em uma API externa.

  • HTTP

    REMOVE

    Remove dados em uma API externa (DELETE).

Próxima página

Steps

Continuar →