> ## 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.

# Boards

> Kanban nativo do Apollo Space — colunas customizáveis, cards com responsável, prazo e anexos.

## Pra que servem

Segunda de manhã. Alguém arrasta "Lançar a landing page" de Backlog
pra Em curso, o owner recebe a notificação, e quem bater o olho no
board já sabe o que está andando e o que travou — sem reunião de
status. É esse o ponto: um board transforma *"em que pé está isso?"*
em algo que se vê num relance. E como o owner pode ser uma pessoa ou
um dos seus agentes, o trabalho não para no momento em que um humano
sai de cena.

**Boards** são quadros kanban — colunas verticais com cards que
representam tarefas, e você arrasta entre colunas conforme progride.
Diferente do CRM (que tem stages pré-modelados de funil), um board
é **livre**: você cria as colunas que fazem sentido pro fluxo do
trabalho.

Casos de uso típicos:

* **Backlog → Em curso → Em revisão → Feito** (gestão de projeto)
* **Ideias → Aprovadas → Em produção → Publicadas** (calendário editorial)
* **Reportado → Investigando → Em fix → Corrigido** (bug tracking)
* **Aguardando → Em curso → Aguarda revisão → Feito** (fluxo de suporte)

## Anatomia de um board

<CardGroup cols={2}>
  <Card title="Colunas" icon="table-columns">
    Cada coluna é um **estado** do trabalho. Você cria, renomeia,
    reordena, arquiva. Sem limite de quantidade — mas mais de 7-8
    colunas vira ilegível.
  </Card>

  <Card title="Cards" icon="address-card">
    Cada card é uma **task**. Tem título, descrição rica, owner,
    prazo, prioridade, anexos, checklist, comentários, atividades.
  </Card>

  <Card title="WIP limit (opcional)" icon="gauge-high">
    Você pode definir um teto de cards por coluna. Quando estourar,
    o board avisa em vermelho — sinal de que tem gargalo.
  </Card>

  <Card title="Atividade do card" icon="clock-rotate-left">
    Cada movimento (mudança de coluna, edição de campo, comentário)
    fica registrado no card. Histórico append-only.
  </Card>
</CardGroup>

## Card — anatomia completa

<AccordionGroup>
  <Accordion title="Título + descrição" icon="text">
    Título curto (vira o que aparece na coluna). Descrição rica
    (markdown + WYSIWYG) suporta listas, código, imagens, mentions
    de leads/agentes/membros.
  </Accordion>

  <Accordion title="Owner + colaboradores" icon="users">
    **Owner** é responsável principal — recebe notificações + cobra
    progresso. **Colaboradores** acompanham mas não respondem por
    delivery. Pode ser humano ou agente.
  </Accordion>

  <Accordion title="Prazo + prioridade" icon="calendar">
    Prazo é data (não datetime — manter UX simples). Prioridade:
    Baixa / Média / Alta / Urgente. Cards atrasados ganham badge
    vermelho na coluna.
  </Accordion>

  <Accordion title="Checklist" icon="list-check">
    Sub-tarefas dentro do card. Cada item pode ser marcado
    independentemente. Útil pra desmembrar "build feature X" em
    sub-passos sem criar 10 cards separados.
  </Accordion>

  <Accordion title="Anexos" icon="paperclip">
    Arquivos (PDF, imagens, docs) ou links externos. Anexos pesam
    pro storage da org — veja Settings → Storage.
  </Accordion>

  <Accordion title="Comentários" icon="comment">
    Thread no card. Mention `@usuário` notifica direto;
    `@nome-agente` envolve agente na conversa (ex.: pedir pro Scout
    pesquisar contexto).
  </Accordion>

  <Accordion title="Custom fields (no nível do board)" icon="table-cells">
    Campos próprios do board (ex.: "Estimativa em horas", "Sprint",
    "Cliente associado"). Aplicáveis em todos os cards daquele board.
  </Accordion>
</AccordionGroup>

## Visualizações

<CardGroup cols={2}>
  <Card title="Kanban" icon="square-kanban">
    Default. Colunas + cards. Drag-drop entre colunas.
  </Card>

  <Card title="Lista" icon="table-list">
    Tabela densa com colunas configuráveis. Bom pra análise + bulk
    actions.
  </Card>

  <Card title="Timeline" icon="chart-gantt">
    Cards em linha do tempo (gantt-style). Útil quando prazo +
    sequência importam (lançamento, projeto com marcos).
  </Card>

  <Card title="Calendário" icon="calendar">
    Cards posicionados na data do prazo. Útil pra calendário
    editorial / planejamento por dia.
  </Card>
</CardGroup>

## Filtros + busca

Em cima do board:

* **Filtro por owner** — só cards meus / só de fulano
* **Filtro por prazo** — atrasados / esta semana / sem prazo
* **Filtro por tag / prioridade** — combina vários
* **Busca textual** — substring no título + descrição

Filtros podem ser **salvos por usuário** — você cria "Meus
atrasados" uma vez, fica disponível pra você no menu.

## Diferença board vs CRM pipeline

| Aspecto     | Board                       | CRM Pipeline                                                       |
| ----------- | --------------------------- | ------------------------------------------------------------------ |
| Colunas     | Livres (você define)        | Stages (com semântica — Novo / Qualificado / Fechado-Ganho / etc.) |
| Cards       | Tasks genéricas             | Leads (pessoa/empresa)                                             |
| Métricas    | Velocidade, WIP, lead time  | Conversion rate, ciclo, valor pipeline                             |
| Quando usar | Qualquer trabalho com fluxo | Especificamente: vendas / aquisição                                |

Você pode ter ambos na mesma org — Board pra projetos internos,
Pipeline CRM pra comercial.

## Como criar

<Steps>
  <Step title="+ Criar → Board">
    Atalho no Home, ou click direito numa pasta → **Novo board**.

    **Resultado esperado:** modal pedindo nome + template inicial.
  </Step>

  <Step title="Escolha o template (ou começa em branco)">
    Templates default: Sprint, Calendário editorial, Bug tracker,
    Suporte, Lançamento. Cada um vem com colunas + campos
    pré-configurados.

    **Resultado esperado:** board criado com as colunas do template,
    sem cards ainda.
  </Step>

  <Step title="Adicione cards">
    Click no `+` no fim da coluna, ou atalho `⌘Enter` quando hover
    na coluna.
  </Step>

  <Step title="Configure (opcional)">
    Settings do board → custom fields, WIP limits, automações,
    permissões.
  </Step>
</Steps>

## Automações

O board pode mover o trabalho por você. Defina a regra uma vez e ela
roda em todo card que se encaixa — exemplos:

* *"Quando card move pra 'Em revisão', notificar @reviewer"*
* *"Quando prazo expirar e card ainda não está em 'Feito', marcar urgente"*
* *"Quando card é criado, atribuir owner default = quem criou"*
* *"Quando card move pra 'Feito', arquivar após 30 dias"*

Configurado em **Board → Settings → Automações**. Sem código —
condição → ação no estilo IFTTT.

## Audit

Toda mudança em card / coluna fica no histórico:

* `card_created` / `card_moved` / `card_archived`
* `column_created` / `column_renamed` / `column_reordered`
* `field_updated` (qual campo, valor antes/depois)
* `comment_added` / `attachment_uploaded`

Quem fez + quando + payload da mudança. Audit append-only.

## Próximos passos

<CardGroup cols={2}>
  <Card title="Pastas" icon="folder" href="/pt/features/pastas">
    Onde os boards moram.
  </Card>

  <Card title="Tarefas (minhas)" icon="list-check" href="/pt/dashboard/overview">
    Visão consolidada de cards atribuídos a você, cruzando boards.
  </Card>

  <Card title="CRM (pipelines)" icon="users" href="/pt/features/crm">
    O outro tipo de "board" — pipelines de leads.
  </Card>

  <Card title="Rotinas" icon="rotate" href="/pt/features/rotinas">
    Pra criar cards automaticamente em cadência.
  </Card>
</CardGroup>