Manual do Alt+Tasks

Alt+Tasks é um sistema de gestão de trabalho hierárquica. Ele junta duas experiências que normalmente vivem em ferramentas separadas:

Tarefas — a sua lista pessoal, no estilo GTD / Things 3, onde você realmente trabalha no dia a dia (capturar, priorizar, reagendar, concluir).
Espaços — os quadros (kanban) onde os projetos são organizados em cards hierárquicos (épicos, histórias, bugs, problemas, chamados…).

O pulo do gato: tarefa e card são a mesma coisa. Uma tarefa é apenas um card do tipo folha (tarefa). Isso significa que concluir uma tarefa na sua lista também faz a barra de progresso do projeto avançar — uma entidade, duas superfícies.

Estado do projeto. Esta é uma versão de protótipo com dados de demonstração em memória (sem backend). Tudo o que este manual descreve já está navegável no app. O seed traz duas organizações de exemplo — Acme Inc. (com os espaços Desenvolvimento e Suporte) e Globex (uma org enxuta) — e você troca entre elas pelo seletor no topo do menu.

1. Organizações — o nível mais alto

Tudo no Alt+Tasks vive dentro de uma organização (o "tenant"). Um mesmo usuário pode ser membro de várias organizações e trocar entre elas pelo seletor no topo do menu (acima das tarefas). Cada organização tem seus próprios espaços, cards, tipos de card e membros — completamente isolados das outras.

Isolamento total. Nomes e códigos não colidem entre organizações: a Acme e a Globex podem ter, cada uma, um espaço "Desenvolvimento" com prefixo DEV e um card DEV-1 — são itens distintos, que nunca se misturam. A contagem de códigos recomeça em cada organização.
Membros. Cada pessoa é membro de uma ou mais organizações (com um papel — admin ou membro). O seletor de responsável e as @menções só enxergam os membros da organização ativa.
Trocar de organização recarrega tudo no contexto dela: as visões GTD, o quadro, o backlog, as notificações e os espaços disponíveis.

No seed, Acme Inc. é a demonstração rica (espaços Desenvolvimento + Suporte, descritos em §6 e §7) e Globex é uma organização enxuta que existe para mostrar, na prática, que um DEV-1 da Globex não tem nada a ver com o DEV-1 da Acme.

2. Os dois mundos

	Tarefas (GTD)	Espaços (kanban)
Para quê	Seu trabalho do dia	Gerir projetos / fluxos
Organiza por	Data (quando fazer)	Coluna (em que etapa)
O que mostra	Só as suas tarefas (`tipo = tarefa`)	Todos os cards do espaço
Navegação	Inbox · Hoje · Programados · Concluídas	Quadro · Backlog · Todos
Atalho	teclas `1`–`4`	tecla `5`

Ambas as superfícies leem a mesma base de cards. Uma tarefa pode nascer solta na sua Inbox e depois ser puxada para dentro de um projeto; um card de projeto pode ter tarefas-folha que aparecem na sua lista pessoal. Você transita entre os dois mundos sem duplicar nada.

3. Tarefas — onde você trabalha

A área de tarefas é um app GTD enxuto e rápido de teclado. A "alma" é capturar sem tirar a mão do teclado e o gesto de "mudou a data → o item some da lista".

As quatro visões

Visão	Atalho	O que aparece
Inbox	`1`	Tarefas sem data (capturadas, ainda não planejadas).
Hoje	`2`	Tarefas com data ≤ hoje. As atrasadas sobem ao topo, em vermelho.
Programados	`3`	Tarefas com data futura, agrupadas por dia.
Concluídas	`4`	Histórico do que você terminou, mais recentes primeiro.

As visões são apenas consultas sobre a base: mostram só os cards do tipo tarefa que são seus (você é o responsável). Trocar a data de uma tarefa a move de visão automaticamente.

Capturar e operar pelo teclado

Tecla	Ação
`N`	Captura uma nova tarefa (sem sair do teclado).
`j` / `k` ou `↑` / `↓`	Navega entre as linhas.
`Enter`	Abre o detalhe da tarefa (drawer).
`Espaço` ou `x`	Conclui / reabre a tarefa selecionada.
`t` / `a` / `w`	Reagenda para hoje / amanhã / próxima semana.
`r`	Abre o seletor de data.
`0`	Remove a data (volta para a Inbox).
`1`–`5`	Troca de visão (`5` = Espaço).
`⌘K` ou `/`	Paleta de comandos.
`?`	Mostra a ajuda dos atalhos.

Concluir e reagendar animam a saída da linha e oferecem Desfazer no toast. Tudo respeita prefers-reduced-motion.

Anatomia de uma tarefa

Toda tarefa tem: título, nota (opcional), data, prioridade (baixa / média / alta / urgente, exibida como ícone) e responsável (pode ficar sem responsável). Uma tarefa está aberta enquanto está ativa e sem data de conclusão; ao concluí-la, grava-se essa data e ela vai para Concluídas. Tarefas avulsas recebem o código TASK-1, TASK-2, … Quando uma tarefa passa a viver dentro de um espaço (porque tem um card-pai), ela herda o prefixo daquele espaço.

No detalhe da tarefa você também tem comentários (com @menção), histórico e a possibilidade de transformar a tarefa em um card de um espaço (ver §4 e §5).

4. Cards e Espaços — onde os projetos vivem

O card como entidade única

Tudo no Alt+Tasks é um Card auto-referente (cada card pode ter um card-pai via parentId). O que muda é o tipo:

Tipos "contêineres" (épico, história, bug, problema, chamado…) aparecem como tiles no quadro kanban.
O tipo tarefa é a folha: não aparece como tile no quadro; ela conta no progresso do card-pai e aparece na sua lista pessoal de tarefas.

Os tipos são configuráveis (em Tipos, no menu, ou na engrenagem do espaço): nome, ícone, cor, se entra no kanban e as regras de vínculo (quais tipos podem ser filhos de quais). O tipo tarefa é fixo e não pode ser excluído.

Cada espaço escolhe um subconjunto desses tipos globais, define suas colunas e tem um prefixo de código imutável (ex.: DEV, SUP).

Status × Coluna

São conceitos separados: status é o ciclo de vida do card; a coluna é onde ele está no quadro.

Status tem 3 valores: ativo (nasce assim, sem comportamento especial), arquivado (soft-delete — sai de toda contabilização) e fechado (encerrado, com a regra da semana civil). O status não posiciona o card no quadro.
Coluna é configuração do espaço e é o único posicionamento: o card guarda em qual coluna está (colunaId) e arrastar só troca de coluna. Você pode ter quantas colunas quiser, com os rótulos que quiser.

Backlog e Cancelado são colunas virtuais (ids reservados): um card pode estar nelas mesmo que o espaço não as exiba no quadro. Se você incluir a coluna Backlog/Cancelado na configuração do espaço, os cards passam a aparecer nela normalmente; caso contrário, eles ficam fora do quadro (mas seguem em Backlog / Todos).

As três telas de um espaço

Quadro (/espaco) — o kanban. Mostra os cards do espaço nas colunas. Cada card tem duas navegações: clicar no corpo abre o detalhe; o chip de filhos faz drill (o quadro passa a listar os filhos daquele card, com breadcrumb). Mover cards entre colunas é por arrastar-e-soltar (otimista, com Desfazer). Há um filtro (texto + tipo + responsável) e um botão de novo card por coluna (que respeita as regras de vínculo). Dá para alternar entre visão aninhada e planificada.
Backlog — os cards na coluna virtual backlog, agrupados por prioridade. É o funil de entrada do espaço, ainda fora do fluxo do quadro.
Todos — uma tabela com todos os cards do espaço (inclui os da coluna cancelado sob demanda); boa para busca e visão geral.

Progresso, vínculos e ciclo de vida

Progresso. Todo card mostra uma barra = tarefas concluídas ÷ total de tarefas em todo o subtree. Concluir uma tarefa-folha sobe a barra de todos os ancestrais de uma vez.
Vínculos. Cards podem ser vinculados entre si (relação simétrica), para conectar itens relacionados sem hierarquia (ex.: um bug vinculado à história que o originou).
Bloqueio. Qualquer card pode ser marcado como bloqueado; o motivo é registrado como um comentário.
Arquivar. É o "soft-delete" (status arquivado): um card arquivado sai de toda contabilização (quadro, backlog, todos, progresso), mas não é apagado.
Fechar. Qualquer card pode ser fechado (status fechado), pelo menu de ações. Ele continua na sua coluna apenas na semana civil em que foi fechado; depois some do quadro (mas permanece em Todos). Card fechado não recebe novos comentários. O inverso é Reabrir.
Histórico. Cada card guarda a linha do tempo de suas transições (criação, mudança de coluna, de status, de responsável, bloqueio), visível em uma aba no detalhe.
Comentários e @menção. Comentários são de primeira classe; uma @menção gera notificação (acende o sino no topo) mesmo que o card não seja seu.

5. Um fluxo de trabalho de ponta a ponta

Um caminho típico, conectando os dois mundos:

Capture (N) tudo que aparece na sua Inbox, sem se preocupar com organização. Ex.: "Ideia: atalho para mover card entre colunas".
Planeje: dê uma data (t/a/w/r) ao que vai fazer — o item migra para Hoje ou Programados.
Promova ao projeto: se uma tarefa é maior do que um item pessoal, transforme-a em um card dentro de um espaço (vira, por exemplo, uma história no Desenvolvimento). A tarefa original é arquivada e fica vinculada ao novo card.
Decomponha: dentro do espaço, quebre o card em filhos. Um épico ganha histórias e bugs; uma história ganha tarefas. Cada tarefa-folha pode ser atribuída a uma pessoa e volta a aparecer na lista pessoal dela.
Toque o quadro: arraste os cards pelas colunas conforme avançam (A fazer → Em desenvolvimento → Em revisão → Concluído). A barra de progresso dos pais sobe sozinha à medida que as tarefas são concluídas.
Feche o card quando entregue. Ele sai do quadro na virada da semana, mas o histórico e os números ficam preservados em Todos.

A seguir, os dois espaços que já vêm no app servem de modelo concreto.

6. Espaço de Desenvolvimento

Vive na organização Acme Inc. (a Globex tem o seu próprio espaço "Desenvolvimento", separado).

Modela o próprio alt-tasks: o time tratando o desenvolvimento do produto como um quadro ágil. É um Jira/Linear enxuto.

Prefixo dos códigos: DEV-1, DEV-2, …
Tipos disponíveis: Épico, História, Bug e Tarefa.
Regras de vínculo:
- Épico pode conter História, Bug e Tarefa.
- História pode conter Bug e Tarefa.
- Bug pode conter Tarefa.
Colunas do quadro: A fazer, Em desenvolvimento, Em revisão e Concluído. "Em desenvolvimento" e "Em revisão" são duas colunas próximas: o card transita entre elas só trocando de coluna, sem mexer no status.

Exemplo de hierarquia que já vem no seed:

Épico    Quadro kanban dos espaços
├─ História  Arrastar-e-soltar entre colunas        (em revisão)
│  ├─ Tarefa  Implementar as drop zones             ✓
│  ├─ Tarefa  Animar a reordenação dos cards
│  └─ Tarefa  Revisar o PR do arrastar-e-soltar     ← sua tarefa (Programados)
├─ História  Duas colunas próximas no quadro        (concluído)
│  └─ Tarefa  Gravar colunaId no card               ✓
└─ Bug       Card some ao mudar de coluna no Safari

Épico    Visões GTD (tarefas)                        (em revisão)
└─ História  Reagendar com os atalhos t / a / w
   └─ Tarefa  Respeitar prefers-reduced-motion

Além disso, há um bug solto no topo ("Drawer não fecha com a tecla ESC"), itens no Backlog ("Busca full-text dentro do quadro") e cards já concluídos/fechados para demonstrar a regra da semana.

7. Espaço de Suporte

Modela uma operação de atendimento no espírito de um ITSM: separa a causa raiz (problema) dos atendimentos individuais (chamados).

Prefixo dos códigos: SUP-1, SUP-2, …
Tipos disponíveis: Problema, Chamado e Tarefa.
Regras de vínculo:
- Problema (causa recorrente) pode conter Chamado e Tarefa.
- Chamado (incidente / solicitação) pode conter Tarefa.
Colunas do quadro: Aberto, Em atendimento e Resolvido.

Exemplo de hierarquia que já vem no seed:

Problema  Lentidão recorrente ao abrir o quadro
├─ Chamado  Cliente A: quadro trava com 200+ cards   (aberto)
│  └─ Tarefa  Coletar os logs de performance do cliente
└─ Chamado  Cliente B: filtro de busca lento         (resolvido)
   └─ Tarefa  Adicionar índice na busca por título    ✓

Chamado   Dúvida: como exportar um relatório?         (aberto)

E ainda: um chamado no Backlog ("Integração com o Slack"), um cancelado (improcedente) e um resolvido/fechado na semana ("Erro 500 ao salvar comentário").

Como os dois espaços se conectam ao seu dia. Note que algumas tarefas da sua lista pessoal (Hoje/Programados) referem-se a esses cards — por exemplo, "Revisar o PR do arrastar-e-soltar" vive dentro de uma história do Desenvolvimento, e "Responder a dúvida sobre o SLA" nasce do contexto de Suporte. É o mesmo trabalho, visto de dois ângulos.

8. Referência rápida

Status do card (ciclo de vida): ativo · arquivado · fechado. A coluna do quadro (colunaId) é separada do status e define onde o card aparece; backlog e cancelado são colunas virtuais.

Tarefa (GTD): está aberta enquanto ativo e sem data de conclusão; ao concluir, recebe a data e vai para Concluídas. (Descartar uma tarefa hoje significa arquivá-la.)

Códigos: TASK-n para tarefas avulsas; {PREFIXO}-n para cards de um espaço (ex.: DEV-12, SUP-3). O contador é por espaço, independente do tipo, e o prefixo é definido na criação do espaço (imutável). A contagem é por organização — DEV-1 da Acme e DEV-1 da Globex são cards distintos.

Glossário:

Organização — o tenant: o nível mais alto, que contém espaços, cards, tipos e membros. Um usuário pode ser membro de várias e troca entre elas; os dados de uma organização são isolados das demais (nomes/códigos não colidem).
Espaço — um quadro/projeto, com seu conjunto de tipos, colunas e prefixo.
Card — qualquer item de trabalho (a unidade do sistema).
Tarefa — o card-folha; é o que aparece na sua lista pessoal GTD.
Coluna — onde um card aparece no quadro; pertence ao espaço e é o único posicionamento (colunaId). backlog/cancelado são colunas virtuais.
Status — o ciclo de vida do card: ativo · arquivado · fechado.
Drill — entrar num card para ver seus filhos como um quadro próprio.
Progresso — tarefas concluídas ÷ total de tarefas no subtree do card.
Fechar — encerrar um card (status fechado): sai do quadro após a semana, fica em Todos; não recebe comentários. O inverso é Reabrir.
Arquivar — soft-delete (status arquivado): o card some de toda contabilização.