Pular para conteúdo

🔌 Integrações do Nexus

Esta seção da wiki é para quem vai programar contra o Nexus ou operar o que ele conecta: um ERP que cria tarefas, o Stripe que cobra os planos, o servidor de e-mail, o Redis, os monitores de disponibilidade e os dois repositórios que se espelham.

Mapa

flowchart LR
    subgraph Entram["Entram no Nexus"]
        ERP["ERP / scripts\n(API de integração)"]
        Stripe["Stripe\n(webhook de cobrança)"]
        Monitor["Monitores\n(/health, /version)"]
    end
    subgraph Nexus["Nexus.Web"]
        API["/api/v1"]
        Hook["/stripe/webhook"]
        Health["/health/live · /health/ready"]
    end
    subgraph Saem["O Nexus usa"]
        SMTP["Relay SMTP → Resend\n(e-mails transacionais)"]
        Redis["Redis\n(chat, docs e rate limit\nentre instâncias)"]
        PG[("PostgreSQL")]
    end
    ERP -->|chave de API| API
    Stripe -->|assinatura do evento| Hook
    Monitor --> Health
    Nexus --> SMTP
    Nexus --> Redis
    Nexus --> PG
    GH["GitHub\n(deploy para produção)"] <-->|código e issues| GL["GitLab\n(repositório do TCC)"]

Onde está cada coisa

Integração Direção Página Código
API de integração (tarefas, listas, membros) entrada API de Integração · Referência · Receitas src/Nexus.Web/Api/, Services/WorkItemService.cs, Services/WorkspaceApiKeyService.cs
Webhooks de saída (o Nexus avisa o ERP quando a tarefa muda) saída Webhooks de saída Services/Webhooks/, BackgroundServices/WebhookDeliveryHostedService.cs
Stripe (cobrança do plano Pro) entrada (webhook) e saída (Checkout, portal) Stripe src/Nexus.Web/Services/Billing/
E-mail (confirmação, convites, atribuições, prazos) saída E-mail, Redis e Monitoramento src/Nexus.Web/Services/Mailer.cs
Redis (tempo real com mais de uma instância) infraestrutura E-mail, Redis e Monitoramento src/Nexus.Web/Services/Backplane/
Health checks e versão entrada (monitores) E-mail, Redis e Monitoramento Program.cs
GitHub ↔ GitLab (código, issues, MR → PR → produção) DevOps GitHub ↔ GitLab .github/workflows/, .gitlab-ci.yml

Regras que valem para todas

  • Nada de segredo no repositório. Chaves do Stripe, senha do banco, string do Redis e credenciais de SMTP entram por variável de ambiente do container (Secao__Chave). O que está em appsettings.Production.json é só o esqueleto.
  • Quem entra se autentica no próprio canal. A API usa chave de API por workspace; o webhook do Stripe usa a assinatura do evento; os health checks são anônimos de propósito e não revelam nada além de um status. Nenhum deles usa o cookie de login.
  • Isolamento por workspace. Uma chave de API só enxerga o workspace em que foi criada. Não existe chave "global".
  • Toda ação administrativa deixa rastro. Criar e revogar chave de API entram no log de auditoria (AuditLogEntries), como convites e mudanças de papel.

O que vem a seguir

Issue O quê Depende de
#67 Servidor MCP para assistentes de IA (Claude, ChatGPT, Copilot) operarem tarefas do workspace, hospedado em /mcp com o SDK oficial em C# chaves de API (#66)
#68 Feed iCal (.ics) por usuário, para assinar as tarefas datadas no Google, Outlook e Apple Calendar —