> ## Documentation Index
> Fetch the complete documentation index at: https://docs.alana.shopping/llms.txt
> Use this file to discover all available pages before exploring further.

# Workspaces

> Entenda isolamento de workspace, configurações e arquitetura multi-tenant.

## Visão geral

Um **workspace** é a unidade organizacional de nível superior no Alana Shopping B2B. Todo recurso — marcas, catálogos, produtos, membros e cobrança — pertence a exatamente um workspace.

Workspaces fornecem isolamento completo de dados. Políticas de row-level security garantem que um membro do Workspace A nunca possa acessar dados do Workspace B, mesmo no nível do banco de dados.

## Propriedades do workspace

| Propriedade             | Descrição                                                               |
| ----------------------- | ----------------------------------------------------------------------- |
| `name`                  | Nome de exibição do workspace                                           |
| `slug`                  | Identificador seguro para URL, gerado automaticamente do nome           |
| `plan`                  | Plano de cobrança atual: `standard`, `pro`, `business`, ou `enterprise` |
| `industry`              | Vertical da indústria para recomendações de IA personalizadas           |
| `company_size`          | Faixa de tamanho para limites de plano e onboarding                     |
| `allowed_email_domains` | Restringir convites a domínios de email específicos                     |
| `ai_training_opt_out`   | Se os dados do workspace são excluídos do treinamento do modelo de IA   |

## Ciclo de vida do workspace

<Steps>
  <Step title="Criação">
    Um workspace é criado durante o fluxo de configuração pós-autenticação. O usuário criador torna-se o **owner**.
  </Step>

  <Step title="Onboarding">
    O assistente de onboarding guia o owner através da seleção de indústria, criação de marca e opcionalmente carregamento de dados de exemplo.
  </Step>

  <Step title="Uso ativo">
    Membros são convidados, marcas e catálogos são criados, e o workspace opera normalmente.
  </Step>

  <Step title="Exportação / Exclusão">
    Owners podem exportar todos os dados do workspace (compatível com GDPR) ou deletar permanentemente o workspace.
  </Step>
</Steps>

## Configurações de segurança

Cada workspace tem políticas de segurança configuráveis:

* **Timeout de sessão** — logout automático após inatividade
* **Exigir 2FA** — exigir autenticação de dois fatores para todos os membros
* **Lista de permissão de IP** — restringir acesso de API a faixas de IP específicas
* **Forçar logout** — encerrar imediatamente todas as sessões ativas em todo o workspace

<Info>
  Configurações de segurança só podem ser modificadas pelo **owner** ou **admin** do workspace.
</Info>