Conceitos Fundamentais

Hierarquia da plataforma

O OutDo organiza tudo numa hierarquia clara. Compreender esta estrutura é essencial para trabalhar de forma eficaz com a plataforma.

Organization
└── Workspace
    └── Module
        └── Rail
            └── View → Feature (data)
                        ├── Columns (field definitions)
                        └── Rows (records)

Nível	O que é	Exemplo
Organização	O tenant de nível superior. Representa uma empresa ou entidade.	"Acme Corp"
Workspace	Um ambiente de aplicação isolado dentro de uma organização.	"Vendas", "Armazém", "RH"
Módulo	Uma secção dentro de um workspace, apresentada como um ícone no rail lateral.	"Inventário", "Encomendas", "Relatórios"
Rail	Uma entrada de navegação dentro de um módulo, que liga a uma view.	"Todos os Produtos", "Stock Baixo", "Relatório Diário"
View	Uma apresentação visual dos dados de uma feature.	Table view, Kanban board, Dashboard
Feature	Uma estrutura de dados (como uma tabela) que contém colunas e registos.	"Produtos", "Encomendas", "Clientes"
Coluna	Uma definição de campo dentro de uma feature, com tipo e configuração.	"Nome" (texto), "Preço" (numérico), "Estado" (select)
Registo	Um único registo de dados dentro de uma feature.	Um produto, uma encomenda, um cliente

Como tudo se relaciona

A chave para compreender o OutDo é que os dados e a apresentação estão separados.

Uma Feature define o que existe em termos de dados — as suas colunas, tipos e regras. Uma View define como esses dados são apresentados — como tabela, formulário, quadro kanban, ou qualquer outra visualização.

Esta separação significa que:

• Uma feature pode ter várias views. A mesma feature "Tarefas" pode ser apresentada como uma tabela para os gestores, um quadro kanban para a equipa e um calendário para o planeamento.
• As views são totalmente configuráveis. Cada view tem os seus próprios filtros, ordenação, agrupamento, colunas ocultas e definições de layout — sem alterar os dados subjacentes.
• Os módulos e os rails organizam a navegação. Não contêm dados por si próprios; apontam para views que apresentam dados de features.

Relações entre features

As features podem referenciar-se umas às outras através dos componentes Ligação a tabela e Vista ligada:

• Uma feature "Encomendas" pode ter uma coluna Ligação a tabela a apontar para "Clientes", criando uma relação entre encomendas e clientes.
• Um formulário de "Cliente" pode incorporar uma Vista ligada que mostra todas as encomendas desse cliente.

Variáveis

Tanto as organizações como os workspaces suportam variáveis personalizadas: pares chave-valor que podem ser referenciados com sintaxe de template como {{org.apiKey}} ou {{ws.storeId}}. Isto permite que a mesma configuração funcione de forma diferente em cada workspace.

Visão geral do modelo de dados

Todos os dados no OutDo são guardados como JSON. Cada registo de uma feature guarda os valores dos seus campos num objeto data flexível, com chaves que correspondem aos nomes das colunas. Esta abordagem permite reconfigurar features sem migrações de base de dados — adiciona ou remove colunas a qualquer momento, e os dados existentes adaptam-se.

Componentes determinam como os dados de cada coluna são introduzidos e apresentados. O tipo de componente de uma coluna (text field, select, date picker, formula, etc.) controla a interface de introdução, as regras de validação e o formato de apresentação. Mudar o tipo de componente de uma coluna muda a forma como os utilizadores interagem com esse campo em todas as views.

Permissões operam ao nível do objeto. Cada utilizador tem um role por workspace ou em toda a organização (Dono, Administrador, Editor, Utilizador, Leitura). Os perfis de acesso afinam o que o Utilizador e a Leitura veem e podem fazer, e o papel mais alto entre a organização e o workspace é o que vale.

Workflows acrescentam automação. Os triggers disparam por alterações a dados, ações do utilizador ou agendamentos. As ações executam-se em sequência — criando registos, chamando APIs, mapeando dados ou mostrando notificações.

Ligações dão às automações acesso a serviços externos. Nas Automações guardas ligações reutilizáveis (HTTP, MCP, SMTP, fornecedor de IA) e os passos referem-nas por nome; os segredos ficam encriptados. Para acesso de fora do OutDo, as chaves de API e o servidor MCP expõem os dados do workspace.