Arquitetura da plataforma

Um ambiente NEO típico combina aplicação web, banco de dados, cache, filas, serviço de realtime e uma camada de build de assets para o front-end.

Componentes principais

Camada	Papel
Web / WSGI	Processa requisições HTTP
Desk / Front-end	SPA administrativa no navegador
Banco	Persistência de documentos, metadados e configuração
Redis / cache	Cache, filas e suporte a pub-sub
Workers	Processam jobs em background
Scheduler	Executa tarefas periódicas
Realtime	Entrega eventos ao cliente
Proxy	TLS, roteamento e entrega de assets
Build de assets	Gera JS e CSS usados no Desk e website

Fluxo de alto nível

1. o navegador carrega o Desk;

2. os assets são servidos;

3. o usuário abre form, list, report ou page;

4. o cliente chama o backend;

5. o servidor valida e acessa o banco;

6. a resposta volta à UI;

7. eventos assíncronos podem chegar por realtime.

Arquitetura multi-site

Cada site possui seu próprio contexto, normalmente com:

• configuração local;

• banco ou schema associado;

• arquivos públicos e privados;

• apps instalados;

• dados e permissões próprios.

Isso permite isolamento lógico entre clientes, ambientes e domínios.

Estrutura macro do ambiente

ambiente/
├── apps/
├── sites/
├── logs/
├── config/
└── env/

apps/

Contém os apps e seu código versionado.

sites/

Contém configuração, arquivos e contexto dos sites.

logs/

Facilita observabilidade e troubleshooting.

Onde o front-end entra na arquitetura

O front-end aparece em quatro pontos principais:

• assets compilados;

• Desk;

• website / portal;

• realtime.

Ou seja, UX no NEO depende tanto do estado do backend quanto do estado do build de assets.

Realtime e experiência de usuário

O realtime é especialmente útil para:

• progresso de importação;

• conclusão de job;

• atualização de dashboard;

• feedback sem refresh completo.

Fronteiras recomendadas

Responsabilidade	Camada ideal
Validação crítica	Backend
Usabilidade	Front-end
Persistência	Backend
Layout padrão	Metadados
Rotina longa	Background job
Feedback de progresso	Realtime + front-end