🔌 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 |
— |