CoreFlow Platform¶
Status: Visão de Longo Prazo — Não Implementada
Este documento descreve a arquitetura de plataforma planejada, concebida em 01/07/2026 antes de qualquer produto existir. Não reflete o ambiente hauxtech real. Hoje (23/09/2026) cada produto listado em Produtos é uma aplicação Django standalone — banco PostgreSQL isolado, autenticação/RBAC próprios, deploy independente. Não existe nenhum serviço "Shared" (Auth/RBAC/Notificações/Arquivos/IA) centralizado consumido por mais de um produto.
Objetivo¶
A CoreFlow Platform é a marca corporativa da HauxTech Soluções que identifica um conjunto de produtos empresariais construídos com padrões de engenharia comuns (ver Standards) — não, hoje, uma plataforma tecnicamente unificada.
A visão de longo prazo é evoluir para uma base tecnológica única, compartilhando arquitetura, componentes, infraestrutura, autenticação, segurança e integrações entre produtos.
Visão¶
Construir um ecossistema empresarial integrado, onde os produtos compartilhem a mesma arquitetura, reduzindo duplicidade de código, aumentando a produtividade e facilitando a manutenção. Aspiracional — os produtos reais evoluíram de forma independente.
Missão¶
Disponibilizar uma plataforma robusta, moderna, segura e escalável para acelerar o desenvolvimento de soluções corporativas.
Produtos Reais (ambiente hauxtech, 23/09/2026)¶
| Produto | Domínio | % | Status |
|---|---|---|---|
| CoreFlow CRM | Relacionamento com clientes | 100% | Em Produção |
| CoreFlow ERP | Gestão corporativa (varejo/moda) | 100% | Em Produção |
| CoreFlow Time | Produtividade/projetos | 100% | Em Produção |
| CoreFlow Infra | Monitoramento de VPS | 100% | Em Produção |
| CoreFlow Stock | Estoque/WMS | 100% | Em Produção |
| CoreFlow People | RH/recrutamento | 90% | Em Produção |
| CoreFlow Planner AI | Tarefas/agenda com IA | 100% | Em Produção |
| CoreFlow Assets | Ativos/patrimônio | 100% | Em Produção |
Ver Produtos para a documentação de cada um.
A lista de produtos "ideais" originalmente prevista neste documento (CoreFlow Finance, RH, WMS, BI, Service, AI, RPA) não corresponde 1:1 aos produtos reais — ver nota em Roadmap.
Arquitetura Real (hoje)¶
Ambiente HauxTech (VPS Contabo)
│
┌─────────────────┼─────────────────┐
│ │ │
Nginx Proxy Docker Compose PostgreSQL
Manager (por produto) (1 banco isolado
por produto)
│ │ │
▼ ▼ ▼
Subdomínio App Django Dados do
próprio standalone produto
(*.hauxtech (accounts,
.com.br) RBAC e deploy
próprios)
Cada produto tem seu próprio módulo accounts, grupos de permissão, banco e ciclo de deploy — não há camada "Shared" real hoje.
Arquitetura Planejada (visão, não implementada)¶
CoreFlow Platform
│
┌──────────────────┼──────────────────┐
│ │ │
Shared Products Infrastructure
│ │ │
▼ ▼ ▼
Authentication CRM PostgreSQL
Authorization ERP Redis
Audit Finance Celery
Files RH Docker
Notifications WMS Nginx
AI BI CI/CD
Integrations Service Monitoring
Princípios¶
Toda a plataforma seguirá obrigatoriamente, na visão de longo prazo:
- Clean Architecture
- Domain Driven Design
- API First
- SOLID
- DRY
- KISS
- Security by Design
- Privacy by Design
- Multiempresa
- Escalabilidade Horizontal
Na prática hoje, cada produto segue Standards pragmáticos (Django MTV, CRUD com Log Duplo, testes por app) — não necessariamente Clean Architecture/DDD em camadas (ver ADR-0002, ADR-0003).
Stack Tecnológica¶
Real (maioria dos produtos)¶
- Python 3.12+, Django 5+
- Django Templates server-rendered, Bootstrap 5 + tema Dracula at Night / Novo Padrão Visual (
.holo-*) - Celery + Redis
- PostgreSQL (isolado por produto)
- Docker + Docker Compose v2 + Nginx Proxy Manager
DRF (Django REST Framework) é adicionado depois do MVP, como camada de API REST opcional (skill hx-implementar-api), não como base arquitetural — hoje presente em CoreFlow Time, Stock, People, ERP, Planner AI e CRM.
Exceção: CoreFlow ERP¶
Tentou stack fullstack Next.js/React/TypeScript no início (SP-1), mas essa camada foi removida por decisão registrada em ADR próprio do projeto (ADR-H001) para simplificar o MVP. Hoje é Django Templates como os demais.
Visão de longo prazo (não adotada)¶
React, Next.js, TypeScript como frontend desacoplado — ver ADR-0005.
Objetivos Estratégicos¶
A plataforma deverá permitir, na visão de longo prazo:
- Desenvolvimento rápido de novos produtos
- Compartilhamento de componentes
- Escalabilidade
- Padronização
- Alta disponibilidade
- Observabilidade
- Segurança
- Evolução contínua
Governança Real¶
Hoje, cada produto segue seu próprio ciclo via skills (hx-gerar-planejamento → hx-iniciar-projeto → hx-configurar-app → hx-deploy-app → com-auditoria-final → hx-finalizar-projeto), documentado em Score Implantacao.md (repositório central hauxtech-documentacao).