Visão geral do neo e do neo framework

O NEO Framework é um framework full stack orientado a metadados. A plataforma usa a descrição declarativa da aplicação para gerar banco, formulários, listas, permissões, APIs e boa parte da experiência padrão do Desk.

Conceitos centrais

Conceito	Descrição
Site	Unidade de execução com banco, arquivos e configuração próprios
App	Pacote instalável com código, metadados, hooks e assets
Module	Agrupamento lógico de funcionalidades
DocType	Definição de dados, interface e comportamento
Document	Instância concreta de um DocType
Desk	Interface administrativa principal
Website / Portal	Camada web pública ou autenticada fora do Desk
Hook	Ponto declarativo de extensão

Como o NEO acelera desenvolvimento

Um DocType bem modelado já entrega automaticamente:

• persistência;

• formulário;

• lista;

• integração com permissões;

• endpoints padrão;

• suporte a relatórios e impressão;

• eventos de ciclo de vida.

Isso reduz código repetitivo e desloca o foco para regra de negócio e experiência.

Relação entre metadados, backend e front-end

Metadados

Definem campos, labels, opções, layout, naming, permissões e regras de renderização.

Backend

Executa validações, cálculos, integrações, transações e automações.

Front-end

Consome metadados, chama APIs e apresenta formulários, listas, pages, dialogs e website.

No NEO, essas camadas se alimentam mutuamente. Quando você altera um campo, o Desk muda. Quando cria um método whitelisted, o cliente pode consumi-lo. Quando injeta assets via hooks, a UX muda sem reescrever tudo.

Superfícies de interface

Desk

SPA administrativa com formulários, listas, reports, pages, workspaces e dashboards.

Website

Camada server-side para páginas públicas, blog, landing pages e rotas simples.

Portal

Área autenticada para usuários externos, normalmente com acesso restrito aos próprios dados.

Web Forms

Formulários publicados fora do Desk para captação de dados.

Fluxo mental de uma feature

Um recurso típico nasce assim:

1. modelagem do DocType;

2. regra de negócio no controller;

3. UX no Desk com script cliente ou page;

4. integração por RPC ou REST;

5. reports, jobs e automações;

6. versionamento e deploy.

Vantagens práticas

• menos código repetitivo;

• mais consistência entre banco, API e UI;

• evolução incremental;

• extensibilidade por hooks, pages, jobs e website.

O papel do front-end do NEO

O front-end do NEO inclui:

• neo.ui.form.on;

• neo.call;

• ListView e indicadores;

• Page API;

• Dialog API;

• portal e website;

• assets em public/.

Portanto, front-end no NEO não é um detalhe opcional: é a materialização navegável do seu modelo de dados.