Organizações & Workspaces

Organizações

Uma Organização é o contentor de nível superior no OutDo. Representa uma empresa, equipa ou entidade, e garante isolamento completo de dados em relação a outras organizações.

O que uma organização contém

• Workspaces — Um ou mais ambientes de aplicação isolados
• Membros — Utilizadores adicionados à organização, que partilham o plano da organização
• Variáveis — Pares chave-valor personalizados, acessíveis em todos os workspaces (ex.: chaves de API, configuração partilhada)
• Quotas de seats — Seats que suportam o plano pago da organização: comprados via Stripe, ou atribuídos manualmente pela equipa OutDo a partir da consola da plataforma

Propriedades da organização

Propriedade	Descrição
Nome	Nome de apresentação mostrado em toda a plataforma (ex.: "Acme Corp")
Nome interno	Gerado automaticamente a partir do nome de apresentação, usado internamente (ex.: "acme_corp")
Owner	Acesso total a tudo na organização. Atribuído automaticamente a quem a criou, mas transferível para outro membro posteriormente — ver Permissões
Variáveis	Pares chave-valor personalizados, referenciados em integrações como {{org.variableName}}

Gerir organizações

A página de Organização lista todas as organizações a que pertences como uma lista de uma coluna, com linhas de largura total (não é uma grelha). Cada linha mostra o nome da organização, o número de workspaces e o número de membros.

Editar uma organização requer, no mínimo, o role de workspace Dev ou superior (Dev, Admin, Owner) — quer atribuído a nível de toda a organização, quer detido em pelo menos um workspace dessa organização. Os utilizadores que cumprem este requisito têm uma ação Configurar no menu de opções (⋮) da linha, que abre a caixa de diálogo de gestão da organização com estes separadores:

Separador	O que faz
Geral	Resumo só de leitura: contagens de membros, workspaces e subusers ativos, mais data de criação e criador
Configurações	Nome de apresentação e cor da organização
Variáveis	Adiciona, edita ou elimina variáveis da organização ({{org.variableName}}); uma variável pode ser marcada como secret, o que oculta o seu valor exceto para superadmins da plataforma
Subusers	Gere os subusers da organização
Utilizadores	Lista, adiciona ou remove membros da organização
Workspaces	Lista os workspaces da organização e permite escolher qual abre por predefinição
Uso de AI	Saldo de créditos de IA e detalhe de utilização por modo e modelo

Esta caixa de diálogo não é o Admin panel do workspace. Atribuir roles ou configurar overlays de visibilidade/operações acontece antes na secção Admin panel → Permissions do workspace, que requer o role Admin ou superior — o role Dev não tem acesso. Consulta Administração e Permissões para o modelo completo.

Configuração inicial

Se ainda não pertences a nenhuma organização, a página de Organização mostra um ecrã de boas-vindas em vez da lista. Clica em Criar a minha organização para abrires o portal OutDo — as organizações são criadas lá, já que a faturação e os entitlements são geridos no portal. Depois de seres adicionado a uma organização, ela volta a aparecer nesta página.

Membros e faturação

O plano (tier) é atribuído à organização como um todo — todos os membros partilham o mesmo plano. O Owner da organização muda-o a partir da página de Subscription do portal (a faturação nunca é gerida dentro do próprio OutDo). Existem cinco planos:

Plano	Preço (por seat/mês)	Workspaces	Registos por workspace	Armazenamento
Free	€0	1 (apenas template)	2.000	5 GB
Basic	€12	1	25.000	20 GB
Pro	€32	5	100.000	50 GB
Scale	€55	Ilimitados	250.000	100 GB
Enterprise	Personalizado	Ilimitados	Ilimitados	Personalizado

Os seats são a capacidade que suporta um plano pago — comprados através do checkout da Stripe, ou atribuídos manualmente. Mudar para um plano pago sem seats suficientes para o número atual de membros abre o checkout da Stripe para cobrir a diferença; no caso do Enterprise, sem seats suficientes, é apresentada antes uma mensagem para contactar vendas.

A utilização de seats (usados vs. comprados), as datas do ciclo de faturação e o histórico de atribuições manuais com o respetivo audit trail são visíveis para superadmins da plataforma na consola de administração interna do OutDo — não para os Admins da organização dentro da aplicação.

Workspaces

Um Workspace é um ambiente de aplicação isolado dentro de uma organização. Cada workspace tem as suas próprias features, views, módulos, workflows, integrações e permissões.

Quando usar vários workspaces

• Separar departamentos — workspace de Vendas, workspace de RH, workspace de Operações
• Separar ambientes — workspace de Produção, workspace de Staging
• Separar localizações — workspace da Loja A, workspace da Loja B (usando variáveis de workspace para definições específicas de cada localização)
• Separar clientes — Cada cliente tem o seu próprio workspace dentro da tua organização

Propriedades do workspace

Propriedade	Descrição
Nome	Nome de apresentação (ex.: "Operações de Vendas")
Nome interno	Gerado automaticamente a partir do nome de apresentação
Módulo predefinido	O módulo que abre primeiro ao entrar no workspace (opcional)
Ordem dos módulos	Ordenação personalizada dos módulos no rail de navegação
Variáveis	Pares chave-valor específicos do workspace, referenciados como {{ws.variableName}}

Criar e editar workspaces

Para criares um workspace:

1. Na página de Workspace, clica em Novo workspace — ou em A partir de template para partires de um em vez disso. Ambos estão visíveis para quem tiver, no mínimo, o role de workspace Dev, quer a nível de toda a organização, quer num workspace existente da organização.
2. Introduz um nome de apresentação.
3. Clica em Guardar.

Para editares um workspace, abre o seu menu de opções (⋮) — o mesmo requisito mínimo de Dev que na criação:

• Configurar abre a caixa de diálogo de edição: o separador Geral contém o nome e o módulo predefinido, o separador Variáveis contém as variáveis específicas do workspace.
• Design abre o Admin panel do workspace — mas esse painel em si requer o role Admin ou superior. Um utilizador apenas com Dev vê a entrada Design no menu, mas é redirecionado de volta para o workspace se a abrir sem acesso de Admin.

Configuração inicial

Quando uma organização ainda não tem workspaces, a página de Workspace mostra um ecrã de onboarding em vez da lista, e o que vês depende do teu role e do plano da tua organização:

• As organizações Free não veem uma galeria de templates nesta fase. O OutDo cria automaticamente um workspace Free permanente a partir do template combinado Essencial (Tarefas e Projetos), enquanto mostra um breve ecrã "A preparar o teu workspace…". Continuar sem modelo é uma via de escape que te leva para a galeria caso a criação automática seja lenta ou falhe.
• As organizações não-Free veem, em vez disso, a galeria de templates: escolhem um template pronto para criar o workspace já com a sua estrutura, views e dados de exemplo aplicados, ou clicam em Começar do zero para criar um workspace vazio. (Uma organização Free tem acesso à mesma galeria mais tarde, para o seu workspace de trial — ver O workspace de trial abaixo.)
• Os membros sem permissão para criar workspaces (abaixo de Dev) veem uma mensagem a pedir que contactem alguém com acesso Dev ou superior para criar o primeiro.

Este onboarding só aparece antes de existir o primeiro workspace da organização. Depois de um workspace ser criado, a lista normal assume o controlo, com as ações Novo workspace e A partir de template disponíveis para membros com role Dev ou superior, como descrito acima.

O workspace de trial

Depois de existir o workspace permanente de uma organização Free, a página de Workspace mostra uma faixa: Experimentar o plano completo — 14 dias grátis. Esta abre a mesma galeria de templates; escolher um template cria um segundo workspace, marcado como trial pelo servidor. Ao fim de 14 dias, o trial passa a ser só de leitura — não é apagado nenhum dado — e a faixa desaparece assim que existe um trial. O trial é concedido uma vez por organização: recriá-lo não reinicia a contagem decrescente de 14 dias. Eliminar o workspace de trial consome o trial definitivamente — a organização não pode obter um novo, e a faixa do trial deixa de aparecer.

Os cartões de workspace têm um badge para estes dois casos: Free no workspace free permanente, e Trial · N dias (ou Trial · expirado depois de expirar) no workspace de trial.

Limites do plano Free: uma organização Free por utilizador, um workspace Free mais um trial por organização, 2.000 registos por workspace e um terminal kiosk. Quando um limite é atingido, o OutDo mostra um aviso Fazer upgrade.

Workspaces bloqueados

Quando uma organização tem mais workspaces do que o seu plano permite, só os criados mais recentemente (até ao limite do plano) continuam utilizáveis — os restantes ficam congelados, só de leitura. O workspace Free do plano free nunca é congelado, independentemente da sua idade; só workspaces extra, que não sejam de trial, podem ser bloqueados. Um cartão bloqueado mostra um badge Bloqueado, com um tooltip a explicar que o workspace excede o limite do plano, e ao abri-lo aparece uma faixa: as alterações feitas aí não serão guardadas. A partir daí, podes Fazer upgrade para desbloquear todos os workspaces de imediato, ou eliminar um workspace que já não uses — eliminar um reativa o workspace mais antigo a seguir, no seu lugar. Este congelamento nunca apaga dados; apenas impede escritas até a contagem voltar a estar dentro do limite do plano.

Variáveis de workspace

As variáveis são pares chave-valor que tornam a configuração do teu workspace dinâmica. São referenciadas em integrações usando a sintaxe {{ws.variableName}}.

Exemplos de utilização:

• storeId: "store-001" — Identifica qual a loja que este workspace representa
• region: "EU" — Define a configuração regional
• apiEndpoint: "https://api.example.com/v2" — Endpoint de API específico do workspace

Combinadas com as variáveis da organização ({{org.variableName}}), isto permite que o mesmo template de integração se comporte de forma diferente por workspace e por organização.

Navegação no workspace

Quando clicas num cartão de workspace:

1. O OutDo verifica se existe um módulo predefinido. Se estiver definido e for válido, navega diretamente para esse módulo.
2. Se não houver predefinição, recorre ao primeiro módulo na ordem configurada no admin panel.
3. Dentro do módulo, verifica se existe um Rail Padrão e navega para ele.
4. A view configurada nesse rail carrega na área de conteúdo principal.

Os workspaces sem módulos têm um badge Sem módulos no cartão e mostram um aviso se clicares neles — não aparecem visualmente esbatidos.

Modo kiosk

Os utilizadores marcados com a flag de conta kiosk saltam por completo a seleção de organização e workspace — kiosk é uma flag na conta do utilizador, não um role de workspace (ver Permissões). A sua conta está pré-configurada com uma organização, workspace, módulo e rail específicos. No login, são redirecionados automaticamente para a view designada — ideal para terminais de self-service, postos de ponto de venda ou estações de trabalho dedicadas.