- Marcelo Areco reviewers: [] created: 2026-07-02 updated: 2026-07-02 tags:
- crm
- architecture
- ddd
- clean-architecture
Arquitetura¶
Objetivo¶
Definir a arquitetura oficial do CoreFlow CRM.
Este documento estabelece os princípios arquiteturais, responsabilidades das camadas, integração com a CoreFlow Platform e diretrizes para implementação.
Visão Geral¶
O CoreFlow CRM é um produto da CoreFlow Platform construído seguindo:
- Domain-Driven Design (DDD)
- Clean Architecture
- API First
- Event Driven Architecture
- Multi-Tenant
- Multiempresa
- Segurança por RBAC
Arquitetura Geral¶
flowchart TD
UI
API
Application
Domain
Infrastructure
Database
UI --> API
API --> Application
Application --> Domain
Application --> Infrastructure
Infrastructure --> Database
Camadas¶
Presentation¶
Responsável pela interação com o usuário.
Inclui:
- Web
- Mobile
- APIs REST
- Webhooks
Application¶
Responsável pelos casos de uso.
Contém:
- Commands
- Queries
- DTOs
- Application Services
Domain¶
Contém as regras de negócio.
Inclui:
- Entities
- Aggregates
- Value Objects
- Domain Services
- Domain Events
- Repositories
Infrastructure¶
Responsável por:
- Django ORM
- PostgreSQL
- Redis
- Storage
- Cache
- APIs Externas
- Filas
- Mensageria
Bounded Contexts¶
O CRM é composto pelos seguintes contextos:
- Leads
- Contacts
- Accounts
- Opportunities
- Activities
- Proposals
- Campaigns
- Customer Success
Cada contexto possui autonomia funcional.
Integração com o Core¶
O CRM utiliza os seguintes serviços compartilhados:
- Authentication
- Users
- Companies
- RBAC
- Files
- Notifications
- Audit
- AI Gateway
Não replica funcionalidades do Core.
Comunicação¶
São permitidos:
- REST
- Eventos
- Webhooks
- Filas
É proibido:
- acesso direto ao banco de outro contexto;
- compartilhamento de entidades;
- regras duplicadas.
Persistência¶
Banco oficial:
- PostgreSQL
ORM oficial:
- Django ORM
Princípios:
- Soft Delete
- UUID
- Auditoria
- Multiempresa
- Migrações versionadas
Eventos¶
Principais eventos publicados:
- LeadCreated
- LeadQualified
- LeadConverted
- ContactCreated
- OpportunityCreated
- OpportunityWon
- ProposalGenerated
Segurança¶
Todos os módulos utilizam:
- JWT
- OAuth2
- RBAC
- Auditoria
- LGPD
- Controle por Empresa
APIs¶
Arquitetura API First.
Todas as funcionalidades deverão possuir APIs REST documentadas.
Versionamento:
Integrações¶
Integrações nativas:
- ERP
- Finance
- RH
- BI
- AI
- Serviços do Core
Integrações externas:
- Microsoft
- APIs REST
- Webhooks
Escalabilidade¶
Preparado para:
- Horizontal Scaling
- Cache Distribuído
- Workers
- Processamento Assíncrono
- Mensageria
Observabilidade¶
- Logs
- Auditoria
- Métricas
- Tracing
- Health Check
Tecnologias¶
- Python
- Django
- PostgreSQL
- Redis
- Docker
- Nginx
- MkDocs
- OpenAPI
Princípios¶
- Alta Coesão
- Baixo Acoplamento
- Responsabilidade Única
- API First
- Domain First
- AI First Documentation
Objetivo Final¶
Disponibilizar uma arquitetura robusta, escalável e consistente para o CoreFlow CRM, garantindo evolução contínua, integração com a CoreFlow Platform e implementação orientada por documentação AI-First.