Pular para conteúdo

Arquitetura

Status real

O MVP é um monólito Django modular, com views, forms, models, services, templates e URLs separados por app. DDD, Clean Architecture, eventos de domínio e serviços compartilhados permanecem referências de evolução, não a estrutura executada hoje.

Composição real

flowchart TD Browser --> Django Django --> Apps Apps --> ORM ORM --> PostgreSQL Apps --> Templates Apps --> AuditLog

Camadas observadas no código

  • config/: settings, WSGI/ASGI e URL raiz;
  • apps/*/models.py: entidades Django e regras de validação;
  • apps/*/views.py: views baseadas em classe e funções protegidas;
  • apps/*/forms.py: validação e widgets server-side;
  • apps/*/services.py: transições com regra própria, como conversão, conclusão e reabertura;
  • apps/*/api/: viewsets DRF somente nos módulos com API;
  • templates/: apresentação server-rendered;
  • apps/core/: dashboard, mixins, timeline, utilitários e permissões;
  • apps/auditoria/: persistência dos logs append-only.

Comunicação entre módulos

As relações são feitas pelo ORM e por imports de serviços/mixins. A timeline consulta atividades, tarefas e notas; o dashboard consulta os modelos comerciais; a auditoria é chamada pelo LogService.

Limites do MVP

Não há frontend separado, filas de eventos de domínio, microserviços, webhooks, multi-tenant, integração externa ou camada compartilhada da CoreFlow Platform consumida em runtime.