2. O Shell: navegação, busca (⌘K), notificações e tema

Onde: a moldura fixa em volta de toda tela

Visão geral

Depois de logar, tudo acontece dentro do Shell: um menu lateral (esquerda) e uma barra superior (topo) que permanecem enquanto a tela central muda. Este capítulo é o mapa da navegação — onde fica cada coisa e como se movimentar rápido.

Quando usar

• Sempre. É a sua bússola: todo capítulo deste guia é aberto a partir daqui.

Pré-requisitos

• Estar logado (Cap. 1).

Passo a passo (por região)

Menu lateral (Sidebar)

Organizado em duas seções + rodapé, nesta ordem:

Seção	Item	Abre
Treino	Dashboard	Cap. 3
	Atletas	Cap. 4
	Programação	Cap. 8
	Construtor	Cap. 7
	Biblioteca	Cap. 6
Acompanhamento	Resultados	Cap. 9
	Analytics	Cap. 10
	Mensageria	Cap. 11
(rodapé)	Configurações	Cap. 13

Nota

não há troca de box/empresa aqui (modelo de head coach único) — a marca é um contexto fixo, somente leitura.

Barra superior (Topbar)

Da esquerda para a direita:

1. Título da tela atual (ex.: “Dashboard”, “Construtor de Treino”).
2. Busca / command palette — campo “Buscar atletas, treinos, movimentos…” + botão ⌘K.
3. Sino de notificações — com um badge de não-lidas; abre o painel de notificações.
4. Alternar tema (☀️/🌙).
5. Avatar / iniciais do coach.

Command palette (⌘K)

Abra com ⌘K (ou clicando na busca). É a forma mais rápida de navegar: digite, use as setas e Enter. As ações vêm agrupadas — navegar (Dashboard, Atletas, Programação…) e criar (Novo WOD, Novo programa, Adicionar atleta, Publicar treino de hoje).

Cuidado

as ações de criar no palette são atalhos — elas te levam à tela certa (ou pré-preenchem), mas o palette não cria dados sozinho. A criação de verdade acontece na tela correspondente (ex.: Construtor).

Sino de notificações (painel)

Abre a lista de não-lidas, cada uma com o tempo relativo (“agora”, “há 5 min”, “há 2 h”, “há 3 d”). Clicar marca como lida; há “marcar todas”. Notificações de mensagem levam direto à Mensageria. Detalhes no Cap. 12.

Tema

Alterna claro/escuro (☀️/🌙). A escolha é salva no navegador e mantida entre sessões.

Navegação & histórico

Cada tela tem uma URL própria (/dashboard, /athletes, /athletes/:id, /schedule, /builder, /library, /results, /analytics, /messages, /settings). Os botões voltar/avançar do navegador funcionam, e você pode compartilhar/favoritar o link de uma tela (ex.: o perfil de um atleta).

Estados

• Cada tela central carrega com skeleton próprio; o Shell (menu + barra) fica sempre visível depois de autenticado.

Dicas

Dica

⌘K é o atalho universal — de qualquer tela, é o caminho mais curto para navegar ou pular para a autoria.

Erros comuns / troubleshooting

• “O badge do sino não zera.” → Abra o painel e use marcar como lida / marcar todas; o contador reflete as não-lidas.
• “Voltar no navegador me tirou do sistema.” → Voltar navega o histórico de telas; se você voltar antes do login, cai na tela de acesso — é esperado.

Como o atleta vê

Não se aplica — o Shell é a moldura do app do coach.