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 Linked Select e Linked View:

• Uma feature "Encomendas" pode ter uma coluna Linked Select a apontar para "Clientes", criando uma relação entre encomendas e clientes.
• Um formulário de "Cliente" pode incorporar uma Linked View 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 em integrações usando sintaxe de template como {{org.apiKey}} ou {{ws.storeId}}. Isto permite que a mesma configuração de integraçã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 pode receber um role (admin, editor, viewer, restricted) em workspaces, módulos, rails, views ou features específicos. Templates e grupos de permissões permitem padrões de acesso consistentes entre utilizadores.

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.

Integrações trazem dados externos para dentro do sistema. As integrações HTTP obtêm dados de APIs REST com mapeamento de campos. As integrações Excel importam dados de folhas de cálculo com correspondência de colunas. As integrações AI Struct usam inteligência artificial para extrair dados estruturados de documentos.