Planejado

Janus

Gateway de entrada do Logos Server

Uma API em ASP.NET Core planejada para proteger, validar, normalizar e direcionar as futuras entradas públicas do ecossistema antes que elas alcancem o Hermes, a Sophia ou outros serviços privados.

A arquitetura ainda está sendo definida e será desenvolvida progressivamente. Nenhuma API ou rota apresentada nesta página está disponível publicamente hoje.

Entender a arquitetura Ver o Logos Server

Papel no ecossistema

Um porteiro entre a internet e os serviços privados

Planejado

Em vez de expor diretamente o Hermes, bancos de dados ou interfaces administrativas, chamadas externas passarão primeiro pelo Janus. O gateway terá quatro responsabilidades centrais.

Janus será o porteiro, Hermes continuará como o mensageiro e Sophia permanecerá como a memória do ecossistema.

01

Entrada segura

Centralizar webhooks, formulários, callbacks e chamadas públicas sem expor diretamente os serviços internos.

02

Validação

Verificar assinaturas, origem, formato, tamanho e duplicidade de cada evento recebido.

03

Roteamento

Direcionar eventos autorizados ao Hermes, à Sophia ou aos futuros serviços do Logos.

04

Inteligência artificial

Proteger e disponibilizar a futura API do assistente inteligente do portfólio.

Arquitetura futura

Uma entrada controlada para o ecossistema

O Janus será executado em container Docker dentro do Logos e conectado à rede privada Starlink. Cloudflare será a camada externa prevista para encaminhar as chamadas ao gateway.

Situação atualInternet → Tailscale Funnel → HermesEntrada necessária para webhooks e callbacks, sem divulgação da URL.
Desenho planejadoInternet → Janus → HermesO Hermes recebe somente eventos validados; interfaces administrativas permanecem privadas.

Fluxo planejado

Do webhook à automação autorizada

  1. 01

    Uma plataforma externa envia um webhook.

  2. 02

    O Cloudflare direciona a chamada ao Logos.

  3. 03

    O Janus identifica a origem.

  4. 04

    A assinatura do provedor é validada.

  5. 05

    A requisição recebe um correlation ID.

  6. 06

    O evento é normalizado.

  7. 07

    Eventos duplicados são bloqueados.

  8. 08

    O evento pode ser registrado na Sophia.

  9. 09

    O Hermes recebe somente o evento validado.

  10. 10

    A automação correspondente é executada.

Papéis complementares

Cada componente com uma responsabilidade

Janus

Recebe, protege, valida, normaliza e direciona.

Hermes

Processa, integra e executa automações no n8n.

Sophia

Armazena eventos, estados e históricos no PostgreSQL.

Starlink

Conecta os componentes de forma privada.

Logos

Hospeda e organiza todo o ecossistema.

Hermes

O Janus não será outro orquestrador. O Hermes continuará responsável por automações, APIs, processamento, publicação, mensagens, notificações, aprovações, agentes de IA e tarefas agendadas. Editor e interfaces administrativas continuarão em caminhos privados, como Tailscale ou rede local.

Sophia

A Sophia poderá registrar identificador, provedor, tipo, data, status, tentativas, erro resumido, correlation ID, métricas e feedbacks. A retenção deverá evitar dados pessoais desnecessários e payloads sensíveis, apoiando idempotência, investigação, retentativas e acompanhamento operacional.

Segurança planejada

Proteções previstas, ainda não implantadas

Estes mecanismos compõem a direção arquitetural do Janus. Eles serão implementados e validados por etapas; não representam garantias atuais.

  • Assinatura por provedor
  • Rate limiting
  • Limite de requisição
  • Proteção contra repetição
  • Idempotência
  • Validação de payloads
  • Identificação de origem
  • Correlation IDs
  • Logs estruturados
  • Health checks
  • Erros padronizados
  • Autenticação interna
  • CORS controlado
  • Cloudflare Turnstile
  • Secrets seguros
  • Políticas de retenção

Primeiro caso de uso

Assistente de IA do portfólio

Um dos primeiros usos planejados é proteger a comunicação entre visitantes do GitHub Pages e um serviço de inteligência artificial, sem expor a chave do provedor no navegador.

  • Receber e validar a pergunta.
  • Limitar uso abusivo e aplicar Turnstile.
  • Carregar somente o contexto profissional necessário.
  • Chamar o provedor de IA com a chave protegida.
  • Devolver uma resposta segura e limitada ao escopo.
Escopo planejado das respostas
Gustavo SoaresExperiênciasTecnologiasCurrículoProjetosLogos ServerAutomações.NETInfraestruturaContato

Exemplos conceituais

Possíveis contratos de entrada

As rotas abaixo ilustram a organização futura. Elas não são endpoints ativos e não representam um endereço público disponível.

Planejado · não disponível 
POST /api/v1/portfolio/chat
POST /api/v1/contact
POST /webhooks/v1/github
POST /webhooks/v1/meta
POST /webhooks/v1/linkedin
POST /webhooks/v1/youtube
GET  /health

Entradas previstas

WebhooksPortfólioAssistente de IAContatoOAuthGitHubMetaLinkedInYouTubeFuturos serviços

Roadmap planejado

Evolução progressiva do Janus

Os marcadores representam intenção e sequência de trabalho — não conclusão.

  1. 01

    Construir a API em ASP.NET Core.

  2. 02

    Criar o container logos-janus.

  3. 03

    Conectar o Janus à Starlink.

  4. 04

    Publicar a API por um túnel seguro.

  5. 05

    Implementar validação por provedor.

  6. 06

    Criar persistência de eventos na Sophia.

  7. 07

    Integrar os webhooks ao Hermes.

  8. 08

    Implementar o assistente de IA do portfólio.

  9. 09

    Restringir a exposição pública direta do Hermes.

  10. 10

    Adicionar observabilidade, tentativas e retenção.