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

# Pastas

> O primitivo organizacional do Apollo Space — contém boards, documentos, pipelines e outras pastas.

Um cliente novo fecha numa segunda. Antes do café esfriar, já existe uma
pasta pra ele — pipeline CRM, board de execução, o doc da proposta — e o
time inteiro sabe exatamente onde olhar. Nada caiu numa pilha plana de
boards e docs.

É isso que pastas fazem: guardam o formato da sua empresa pra que ninguém —
nenhuma pessoa, nenhum agente lendo seu workspace — precise caçar nada.

## Pra que servem

**Pastas** são o jeito de organizar tudo dentro da sua org. Cada
board, documento, pipeline CRM ou rotina mora **dentro de uma
pasta**. Você pode ter pastas dentro de pastas (hierarquia) e a
estrutura aparece na sidebar — assim você acha qualquer recurso
sem busca.

Sem pastas, sua org vira uma lista plana de boards e docs. Com
pastas, você modela o jeito do seu time pensar — por cliente, por
projeto, por trimestre, por equipe.

## Anatomia

<CardGroup cols={2}>
  <Card title="Nome + descrição" icon="folder">
    Identifica a pasta. Pode incluir emoji no nome pra reconhecimento
    visual rápido (ex.: 🚀 Lançamento Q3).
  </Card>

  <Card title="Conteúdo" icon="layer-group">
    Boards, documentos, pipelines CRM, subpastas, rotinas. Cada item
    aparece como linha dentro da pasta.
  </Card>

  <Card title="Permissões" icon="user-lock">
    Por default, herda permissões da pasta pai. Override por pasta
    (futuro): pasta sensível visível só pra subset do time.
  </Card>

  <Card title="Ordem custom" icon="grip-vertical">
    Você arrasta itens pra reordenar dentro da pasta. A ordem
    persiste por usuário (cada um vê seu jeito) ou por org
    (compartilhada).
  </Card>
</CardGroup>

## Pasta pessoal vs pasta da org

Cada membro tem **uma pasta pessoal** + acesso às **pastas da org**:

| Tipo                    | Visível pra                            | Caso de uso                                                 |
| ----------------------- | -------------------------------------- | ----------------------------------------------------------- |
| **Pessoal**             | Só você (+ seu Digital Twin se houver) | Notas privadas, scratchpad, rascunhos antes de compartilhar |
| **Org (compartilhada)** | Todo membro com permissão              | Operação do time — clientes, projetos, processos            |

O isolamento é **fenced no banco** — outro membro da org nunca vê
sua pasta pessoal mesmo se procurar manualmente. Veja
[Multi-tenant](/pt/trust/multi-tenant).

## Como organizar — padrões que funcionam

<AccordionGroup>
  <Accordion title="Por cliente (agências, consultorias)" icon="briefcase">
    ```
    Clientes
    ├── Empresa A
    │   ├── Pipeline CRM
    │   ├── Board de execução
    │   └── Docs (proposta, contrato, briefing)
    ├── Empresa B
    │   └── ...
    └── Templates (pra clonar quando entra cliente novo)
    ```

    **Vantagem:** isolar contexto por cliente; nenhuma mistura.
    **Limitação:** se um colaborador trabalha pra 3 clientes,
    precisa entrar em 3 pastas.
  </Accordion>

  <Accordion title="Por função (times maiores)" icon="users">
    ```
    Vendas
    ├── Pipeline outbound
    ├── Board de propostas em revisão
    └── Voice + templates de e-mail
    Marketing
    ├── Calendário editorial
    ├── Board de campanhas
    └── Docs (briefings, persona, ICP)
    Produto
    └── ...
    ```

    **Vantagem:** alinhado à estrutura do time.
    **Limitação:** projetos cross-funcional ficam ambíguos.
  </Accordion>

  <Accordion title="Por fase do ciclo (operações repetíveis)" icon="rotate">
    ```
    Lead → Conversa → Proposta → Negociação → Fechamento → Pós
    ```

    Pasta por fase, cada uma com o board + doc específico daquela
    etapa.

    **Vantagem:** lead "passa" de pasta em pasta — atalho visual.
    **Limitação:** cross-pasta search vira essencial.
  </Accordion>

  <Accordion title="Por trimestre (foco em metas)" icon="calendar">
    ```
    2026
    ├── Q1
    │   ├── OKRs Q1
    │   ├── Board de iniciativas
    │   └── Retro
    ├── Q2
    │   └── ...
    ```

    **Vantagem:** revisão histórica fica natural.
    **Limitação:** projetos longos atravessam várias pastas.
  </Accordion>
</AccordionGroup>

<Tip>
  **Misture sem dó.** Você não precisa escolher UMA estrutura. Tenha
  pastas por cliente E pastas por função E pastas por trimestre.
  O que **não** funciona é deixar tudo na raiz — vira lista plana.
</Tip>

## Operações comuns

<Steps>
  <Step title="Criar pasta">
    `⌘N` em qualquer tela, ou click no `+` ao lado de **Pastas** na
    sidebar.

    **Resultado esperado:** pasta nova aparece em itálico até você
    nomear; some o itálico quando confirma.
  </Step>

  <Step title="Mover item entre pastas">
    Arrasta o item (board, doc, pipeline) entre pastas na sidebar.
    Atalho: botão direito → **Mover para...** → escolhe destino.

    **Resultado esperado:** item some da pasta origem, aparece na
    destino. Histórico preservado.
  </Step>

  <Step title="Arquivar pasta">
    Botão direito → **Arquivar**. A pasta some da sidebar mas vai
    pra **Arquivados** (não é deletada).

    **Resultado esperado:** pasta e tudo dentro fica em modo
    read-only até você restaurar.
  </Step>

  <Step title="Restaurar do Arquivados">
    Sidebar → **Arquivados** → click na pasta → botão
    **Restaurar**. Volta pra estrutura original (ou pra raiz se a
    pasta pai foi deletada).
  </Step>
</Steps>

## Pasta raiz (a "Home" da hierarquia)

Cada org tem **uma pasta raiz** invisível que contém todo o resto. Você
não cria nem deleta — ela existe pra ancorar a hierarquia.

Mover algo "pra fora de qualquer pasta" significa, na real, mover pra
**pasta raiz**. Ela aparece na sidebar como o nível mais alto, embaixo
do header com seletor de organização.

## Audit

Toda operação em pasta gera entrada no histórico da org:

| Evento            | Inclui                          |
| ----------------- | ------------------------------- |
| `folder_created`  | Quem criou + nome + pasta pai   |
| `folder_renamed`  | Nome antigo + novo + quem mudou |
| `folder_moved`    | Origem + destino + quem mudou   |
| `item_moved_into` | Que item + de onde              |
| `folder_archived` | Quem arquivou + quando          |
| `folder_restored` | Quem restaurou + quando         |

Owner + Admin podem inspecionar — útil em retro quando o time não
acha um doc ("ah, foi movido pra pasta X há 2 semanas").

## Limites

| Limite                         | Valor                                                 |
| ------------------------------ | ----------------------------------------------------- |
| **Profundidade da hierarquia** | 10 níveis (mais que isso é sinal de over-engineering) |
| **Pastas por nível**           | Ilimitado (sidebar scrolla)                           |
| **Itens por pasta**            | Ilimitado                                             |
| **Tamanho do nome**            | 80 caracteres                                         |

## Próximos passos

<CardGroup cols={2}>
  <Card title="Boards" icon="square-kanban" href="/pt/features/boards">
    O kanban que mora dentro das pastas.
  </Card>

  <Card title="Documentos" icon="file-lines" href="/pt/features/documentos">
    Os docs que moram dentro das pastas.
  </Card>

  <Card title="CRM" icon="users" href="/pt/features/crm">
    Pipelines (que também moram em pastas).
  </Card>
</CardGroup>