Estrutura Funcional¶

Esta página descreve o MVP real do CoreFlow CRM. A fonte de verdade é o repositório coreflow-crm, especialmente apps/, templates/ e config/urls.py.

Escopo real

O CRM é uma aplicação Django independente com templates server-side e banco próprio. Não há, no MVP, módulos de campanhas, propostas, customer success, relatórios, automações, anexos ou integração compartilhada com a CoreFlow Platform.

Fluxo comercial implementado¶

flowchart LR Lead --> Conta Lead --> Contato Lead --> Oportunidade Conta --> Contato Conta --> Oportunidade Oportunidade --> Pipeline Conta --> Timeline Contato --> Timeline Lead --> Timeline Oportunidade --> Timeline

Módulos¶

Módulo	App Django	Escopo implementado
Contas	`apps.contas`	Empresas, prospects, parceiros e fornecedores
Contatos	`apps.contatos`	Pessoas vinculadas ou independentes
Leads	`apps.leads`	Cadastro, qualificação, perda, conversão e Kanban
Oportunidades	`apps.oportunidades`	Negócios, etapas, Kanban, ganho, perda e reabertura
Pipeline	`apps.oportunidades`	Pipelines e etapas comerciais mantidos pelo Admin
Atividades	`apps.atividades`	Interações e agenda
Tarefas	`apps.tarefas`	Ações pendentes, prazos, conclusão e reabertura
Anotações	`apps.anotacoes`	Notas internas públicas ou privadas por entidade
Dashboards	`apps.core`	Indicadores comerciais e operacionais
Auditoria	`apps.auditoria`	Logs append-only e consulta autorizada
Contas de acesso	`apps.accounts`	Usuários, roles, login e recuperação de senha

Capacidades transversais¶

autenticação por sessão e proteção CSRF;
autorização por role (Administrador, Gestor, Comercial, Atendimento e Consulta);
logging duplo em operações de negócio;
UUID nas entidades que herdam BaseModel;
created_at, updated_at e is_active em BaseModel;
exclusão lógica onde definida pelo módulo;
timeline unificada de atividades, tarefas e notas;
API REST parcial somente para contas, oportunidades e atividades, documentada em APIs.

Fora do escopo atual¶

Campanhas, propostas, customer success, automações, relatórios independentes, anexos de arquivos, multiempresa/tenant, integrações externas, envio de WhatsApp e frontend React/Next.js não estão implementados no MVP.