Core Platform¶

Status: Visão de Longo Prazo — Não Implementada

Nenhum serviço compartilhado descrito nesta página existe hoje. Cada produto (ver Produtos) implementa seu próprio módulo accounts, RBAC (grupos Django) e auditoria (LogService/admin_logger) de forma independente — padrão real documentado em Standards. Os documentos individuais em core/*.md desta seção são especificações prospectivas, não implementações.

Objetivo¶

O Core representaria o núcleo compartilhado da CoreFlow Platform, caso viesse a ser implementado.

A visão é que produtos futuros dependessem dos serviços desta camada, eliminando duplicação de código e padronizando comportamentos entre eles.

Visão Geral¶

Na visão de longo prazo, nenhum produto implementaria novamente funcionalidades pertencentes ao Core — todo comportamento comum seria implementado uma única vez e reutilizado.

Hoje, cada produto reimplementa autenticação, RBAC e auditoria de forma independente (decisão implícita, não uma exceção documentada — é assim que todos os 8 produtos reais foram construídos até aqui).

Responsabilidades¶

O Core é responsável por disponibilizar:

Autenticação
Usuários
Empresas
Controle de Acesso (RBAC)
Auditoria
Notificações
Arquivos
Inteligência Artificial
Integrações
Configurações Globais

Arquitetura (visão, não implementada)¶

                    Core Platform

                           │

 ┌───────┬───────┬─────────┼─────────┬────────┬────────┐

 │       │       │         │         │        │        │

CRM     ERP    Time     Infra     Stock    People   Planner AI

 │       │       │         │         │        │        │

 └───────┴───────┴─────────┴─────────┴────────┴────────┘

                Serviços Compartilhados (não existem hoje)

Na visão de longo prazo, todos os produtos consumiriam os mesmos serviços do Core. Hoje cada produto tem sua própria implementação isolada.

Módulos¶

Authentication¶

Responsável pela autenticação da plataforma.

Principais responsabilidades:

Login
Logout
Refresh Token
MFA
Sessões
Recuperação de Senha

Users¶

Gerenciamento de usuários.

Responsabilidades:

Cadastro
Perfil
Preferências
Status
Associações

Companies¶

Gerenciamento de empresas (Tenants).

Responsabilidades:

Cadastro
Configurações
Licenciamento
Filiais
Multiempresa

RBAC¶

Controle de acesso baseado em papéis.

Responsabilidades:

Papéis
Permissões
Grupos
Perfis
Restrições

Audit¶

Auditoria corporativa.

Responsabilidades:

Logs
Histórico
Alterações
Rastreabilidade

Notifications¶

Sistema centralizado de notificações.

Suportes previstos:

E-mail
Push
SMS
WhatsApp
WebSocket
Notificações internas

Files¶

Gerenciamento corporativo de arquivos.

Responsabilidades:

Upload
Download
Versionamento
Armazenamento
Assinatura

AI¶

Serviços compartilhados de Inteligência Artificial.

Responsabilidades:

Agentes
Prompts
Contexto
Automações
Classificações
Recomendações

Integrations¶

Centralização das integrações externas.

Exemplos:

APIs
Webhooks
ERPs
Marketplaces
Gateways
Serviços de terceiros

Princípios¶

Todo módulo do Core deverá ser:

Independente
Reutilizável
Testável
Escalável
Documentado
Versionado

Dependências¶

Os módulos do Core poderão depender entre si apenas quando estritamente necessário.

Dependências circulares são proibidas.

Fluxo de Desenvolvimento¶

flowchart LR A[Planejamento] B[Documentação] C[Arquitetura] D[Implementação] E[Testes] F[Revisão] G[Disponibilização] A --> B --> C --> D --> E --> F --> G

Governança¶

Toda evolução do Core deverá priorizar:

Compatibilidade
Reutilização
Segurança
Performance
Simplicidade

Mudanças incompatíveis deverão ser documentadas através de ADR.

Objetivo Final¶

O Core constitui a fundação tecnológica da CoreFlow Platform.

Todos os produtos deverão reutilizar seus serviços, garantindo consistência arquitetural, redução de retrabalho e facilidade de evolução da plataforma.