Blueprint¶

Status real

O blueprint abaixo é a especificação original do CRM. O produto está 100% e em produção, mas opera como aplicação Django independente; os serviços compartilhados representados no diagrama ainda não foram implementados.

Objetivo¶

Apresentar a visão macro da arquitetura funcional, técnica e operacional do CoreFlow CRM.

Este documento representa o mapa de referência para implementação, evolução e integração do produto dentro da CoreFlow Platform.

Visão Geral¶

O CoreFlow CRM é composto por apps Django independentes dentro do mesmo monólito. A integração através de serviços compartilhados da CoreFlow Platform permanece como visão futura.

Cada módulo possui autonomia funcional, compartilhando autenticação local, auditoria, mixins e utilitários do app core.

Arquitetura Geral¶

flowchart TD CoreFlowPlatform CoreFlowPlatform --> Authentication CoreFlowPlatform --> RBAC CoreFlowPlatform --> Files CoreFlowPlatform --> Notifications CoreFlowPlatform --> Audit CoreFlowPlatform --> AI CRM CRM --> Leads CRM --> Contacts CRM --> Accounts CRM --> Opportunities CRM --> Activities CRM --> Pipeline CRM --> Tasks CRM --> Notes

Estrutura Funcional¶

O CRM é dividido em:

Leads
Contacts
Accounts
Opportunities
Activities
Pipeline
Tarefas
Anotações e Timeline
Dashboards
Auditoria

Fluxo Comercial¶

flowchart LR Lead --> Contact --> Account --> Opportunity --> Proposal --> Sale --> Customer --> CustomerSuccess

Integração¶

O CRM integra-se com:

CoreFlow Platform¶

Authentication
Users
Companies
RBAC
Files
Notifications
Audit
AI Gateway

Produtos¶

Visão futura

Produtos, concorrentes e propostas não são entidades do MVP atual; permanecem apenas como conceitos de evolução.

ERP
Finance
RH
BI
WMS

Sistemas Externos¶

WhatsApp
SMTP
Google
Microsoft
APIs REST
Webhooks

Tecnologias¶

Backend

Python
Django
Django REST Framework

Frontend

React
Next.js
TypeScript

Banco

PostgreSQL

Cache

Redis

Infraestrutura

Docker
Nginx

Arquitetura de Camadas¶

Presentation

↓

API

↓

Application

↓

Domain

↓

Infrastructure

↓

Database

Comunicação¶

Todos os módulos comunicam-se através de:

REST
Domain Events
Webhooks
Filas

É proibido acesso direto ao banco de outro módulo.

Segurança¶

Todos os módulos utilizam:

JWT
RBAC
Auditoria
LGPD
Multiusuário

Escalabilidade¶

O blueprint prevê:

Multiempresa (visão futura; não implementado no MVP)
Multiusuário
Balanceamento
Processamento Assíncrono
Cache Distribuído
Workers

Objetivos Arquiteturais¶

Baixo acoplamento
Alta coesão
Escalabilidade
Testabilidade
Modularidade
Integração nativa
Documentação AI-First

Artefatos Relacionados¶

Conceito
Estrutura Funcional
Arquitetura
Banco de Dados
APIs
Interface
DevOps
Implantação
Governança

Objetivo Final¶

Fornecer uma visão consolidada da arquitetura do CoreFlow CRM, servindo como referência para desenvolvimento, documentação, integração e implementação por agentes de Inteligência Artificial.