ESTA DOCUMENTAÇÃO ESTÁ EM DESENVOLVIMENTO E CONSTANTE ATUALIZAÇÃO.

Conceitos Fundamentais

Entenda os conceitos-chave do sistema DevCod antes de explorar as funcionalidades.

Arquitetura Geral

O DevCod é um sistema SaaS multi-tenant construído sobre o padrão DevCod Agency. Cada instância (tenant) opera de forma isolada, com seus próprios dados, configurações e automações.

Frontend Multi-Portal NEXT.JS 14+

Admin, Dashboard, Central de Documentação & Landing Pages.

Next.js API Engine SERVER ACTIONS

Controladores de rotas, middleware de autenticação & SSE Streaming.

DevCod Mail E-MAIL ENGINE

Compilador MJML & réguas automáticas.

DevCod AI Core Engine 19 AGENTS SWARM

Enxame cognitivo autônomo & Tool Calling.

DevCod Data Lake POSTGRESQL + RLS

Isolamento estrito por Tenant e auditoria.

Entidades Principais

Tenant

Representa uma organização/cliente. Todo dado pertence a um tenant específico, garantindo isolamento através de Row Level Security (RLS).

User

Usuários do sistema com roles específicas (admin, manager, member). Cada user pertence a um tenant.

Contact

Contatos/leads gerenciados no CRM. Podem ser originados de formulário, importação ou outras fontes.

Lead

Contato qualificado no pipeline de vendas com stage, probabilidade e valor estimado.

Agent

Agentes de IA (Nova, Atlas, Echo, Prime) com configurações de modelo, prompts e ferramentas específicas.

Automation

Automações criadas no Flow Builder com triggers, condições e ações definidas via nodes visuais.

Fluxo de Dados

O sistema segue um fluxo de dados previsível:

  1. Captura: Usuário interage via site, Landing Page ou API
  2. Processamento: Dados são validados, enrichment opcional via IA
  3. Qualificação: Lead passa por scoring automático
  4. Gestão: Entra no pipeline, recebe sequências de e-mail
  5. Conversão: Avança stages até fechamento
  6. Análise: Métricas são coletadas para analytics

Camadas do Sistema

Presentation

Pages, Componentes React, Hooks

Application

Server Actions, Handlers, Validação

Core

Entidades, Regras de Negócio, Services

Infrastructure

DevCod ORM, DevCod Data Lake, DevCod Mail, LLM APIs

Próximo: Arquitetura Técnica →