The AI FAB (Sollinha) sits at bottom-20 (80px) with z-40 in a different stacking context. Moving the Quick Actions FAB from bottom-4 to bottom-[calc(4rem)] for the bottom nav caused overlap at the shared z-40, so the AI button intercepted clicks. Raised to 7rem (112px) to clear both the bottom nav (4rem) and the AI FAB button (ending at 7rem).
8 KiB
Impl: B164 — Barra de navegação inferior no mobile (+ drawer Mais)
Status: aprovado Atualizado em: 2026-08-08 Issue: #400 Intenção: docs/plans/barra-navegacao-inferior-mobile.md Appetite restante: ~1 dia eng (dentro do estimado)
Leitura da intenção
- Outcome: Staff no mobile troca entre os 4 destinos primários (Início, Municípios, Atualizações, Agenda) e o overflow (Mais) em um toque; barra fixa inferior só em mobile (<
md), staff-only (leader lockdown intacto). - O que NÃO negociar: leader não vê a barra de 5 destinos; desktop/tablet continua sidebar-only;
SidebarTriggermobile permanece; FAB continua; paginação/semântica do scroll global não quebra. - O que reavaliar: altura real da bottom nav vs
pbdo scroll (CampaignContentScroll); z-index da barra vs FAB vs Drawer (overlay do wizard).
Abordagem recomendada
flowchart TD
layout["(app)/layout.tsx"] --> topbar["CampaignMobileTopBar md:hidden"]
layout --> header["CampaignDesktopHeader md:flex hidden"]
layout --> scroll["CampaignContentScroll pb-[calc(4rem+env(safe-area-inset-bottom))] md:pb-6"]
layout --> fab["CampaignQuickActionsFab — bottom ajustado via className"]
layout --> bottom["CampaignBottomNav staff fixed bottom-0 md:hidden"]
bottom --> drawer["Drawer overflow: Quadro … Perfil / Sair"]
bottom --> atualizacoes["/campanha/atualizacoes — âncora C89 (placeholder)"]
nav["nav.ts"] --> bottomnav["getCampaignBottomNav(role)"]
nav --> overflow["getCampaignOverflowNav(role)"]
nav --> bottomnav5["5 primários (Início, Municípios, Atualizações, Agenda, Mais)"]
Opções consideradas: A (drawer) | B (página separada) | C (reaproveitar B73)
Recomendação: A — Drawer para o overflow "Mais". — @base-ui/react Drawer já está no codebase (CampaignQuickActionsOverlay usa o mesmo padrão); consistente com swipe-down do wizard; FAB overlay já foi testado com Drawer. Nada de rota /campanha/mais → não precisa de página server, access gate, ou CAMPAIGN_OVERFLOW_HREF.
Rejeitadas:
- B) Página
/campanha/mais: navegação full-reload, menos nativo; duplicaria Perfil/Sair do sidebar. O drawer fecha em 1 toque e reusalogoutCampaign. - C) Reaproveitar
CampaignBottomNavapagado do B73: foi deletado deliberadamente ("git history é o arquivo"). Recriar novo, sem código morto. - Bottom navigator genérico do shadcn: não existe nesse projeto (verificado
src/components/ui/). UsaButton+ CSS grid, como o original.
Componentes / mudanças
-
src/lib/campaignPaths.ts: adicionarCAMPAIGN_UPDATES_HREF = '/campanha/atualizacoes'. (SemCAMPAIGN_OVERFLOW_HREF— drawer, não rota.) -
src/components/campaign/shell/nav.ts:- Importar
BellIcon,EllipsisVerticaldelucide-react; importarCAMPAIGN_UPDATES_HREF. bottomNavPrimaryHrefs: Set<string>—{ '/campanha', '/campanha/municipios', CAMPAIGN_UPDATES_HREF, CAMPAIGN_AGENDA_HOME }(os 4 que NÃO são Mais).bottomNavStaff: CampaignNavItem[]— 5 itens: Início, Municípios, Atualizações, Agenda, Mais.getCampaignBottomNav(role): staff →bottomNavStaff; leader →[](lockdown).getCampaignOverflowNav(role): staff →getCampaignNav(role).filter(h => !bottomNavPrimaryHrefs.has(h.href))+getCampaignSecondaryNav(role)(Conceitos). Leader →[]. Perfil + Sair são tratados inline no drawer footer, não emnav.ts(como no sidebar footer).isCampaignNavActive: reconhecer/campanha/atualizacoespor prefixo (exatidão como/campanha).
- Importar
-
src/components/campaign/shell/CampaignBottomNav.tsx(new):use client,fixed inset-x-0 bottom-0,md:hidden print:hidden,z-30(abaixo do FABz-40, acima do scroll). Contém:- Barra: grid 5 colunas, 4 itens =
Link, item 5 "Mais" =button(abre drawer), ícone + rótulo pt-BR,aria-currentviaisCampaignNavActive,pb-[env(safe-area-inset-bottom)],border-t. - Drawer:
@base-uiDrawer (showSwipeHandle,swipeDirection="down"), overlay nav items degetCampaignOverflowNav(role)+ footer Perfil (CAMPAIGN_PROFILE_HOME) + Sair (logoutCampaign).
- Barra: grid 5 colunas, 4 itens =
-
src/app/(campaign)/campanha/(app)/atualizacoes/page.tsx(new): placeholder honesto —CampaignPageShell+ título "Atualizações" + texto "Em breve você verá o feed de atualizações da campanha aqui." Staff-only (redireciona leader para/campanha). -
src/app/(campaign)/campanha/(app)/layout.tsx: renderizar<CampaignBottomNav role={user.role} />quandoisStaffCampaignRole(user.role)— sibling deTooltipProvider > div, fora do flex flow (fixed). -
src/components/campaign/shell/CampaignQuickActionsHost.tsx:CampaignContentScroll:pb-[calc(4rem+env(safe-area-inset-bottom))] md:pb-6(mobile gap para a barra).- FAB:
className={showBottomNav ? 'bottom-[calc(7rem+env(safe-area-inset-bottom))] md:bottom-4' : undefined}— 7rem clears a 4rem bottom nav + the AI FAB (bottom-20, 2rem button → top at 7rem); sobe quando a barra existe.
-
Migration: sem migration — chrome de navegação.
-
Access / Consent:
isStaffCampaignRolereusado;canAccessSupporterArea/isUnrestrictedCampaignRolejá filtramApoiadores/AssessoresemgetCampaignNav→ herdados. Sem Consent. -
UI: Impeccable C — shell chrome, mobile-first,
data-theme='campaign', consistente comCampaignQuickActionsOverlayDrawer pattern.
Dados → forma
N/A — chrome de navegação, sem dados de domínio.
Fases verificáveis
- Nav (tracer) —
nav.tscomgetCampaignBottomNav+getCampaignOverflowNav;campaignPaths.tscomCAMPAIGN_UPDATES_HREF. Unit test (campaignNav.unit.spec.tsestendido) validando: staff tem 5 itens; leader tem 0; overflow exclui primários + inclui Conceitos;isCampaignNavActivematchaatualizacoespor prefixo. - UI —
CampaignBottomNav.tsx(barra + drawer overflow),/campanha/atualizacoesplaceholder; layout renderiza barra only staff mobile; FAB sobe; scroll não esconde conteúdo; drawer reabre Perfil/Sair com role filter. - Gates —
pnpm gate:fast; e2e smoke mobile (barra visível staff, invisível desktop/leader, navegação ativa reflete rota, FAB acima da barra, drawer overflow abre/fecha);pnpm push -u origin HEAD→gh pr create --base main.
Rabbit holes / Não escopo (engenharia)
- Drawer do wizard (
CampaignQuickActionsOverlaymobile) sobrepõe a barra: o Drawer é modal full-snap, z-index alto, não há conflito visual. - FAB no desktop: bottom nav é
md:hidden, entãomd:bottom-4no FAB mantém comportamento atual. - Leader lockdown:
getCampaignBottomNav('leader')retorna[];/campanha/atualizacoesredireciona leader para/campanha. - Atualizações: âncora honesta — não implementar feed/threads (→ C89). Placeholder com título + texto.
- Não reintroduzir Quadro/Territórios/Apoiadores/Assessores na barra (teto de 5, thumb zone).
- Não tocar no design-refs HTML legados.
Riscos e mitigação
- Risco: conteúdo fica escondido atrás da barra. Mitigação:
pb-[calc(4rem+env(safe-area-inset-bottom))]no scroll + teste de overflow. - Risco: FAB some atrás da barra. Mitigação: ajuste de
bottomvia conditional className emCampaignQuickActionsHost. - Risco: leader enxerga a barra. Mitigação:
isStaffCampaignRoleno layout +getCampaignBottomNav('leader') → []. - Risco: z-index da barra sobe sobre o Drawer. Mitigação:
z-30(Drawer usa z-50+).
Aceite de engenharia
- Aceite de produto da intenção ainda coberto (5 itens, staff only, Mais = drawer overflow, sidebar intacta desktop)
- Invariantes AGENTS/engineering-standards: identificadores inglês, copy pt-BR,
md:hidden, role filtering vianav.ts - Unit:
getCampaignBottomNav/getCampaignOverflowNav/isCampaignNavActiveestendidos (5 itens staff, 0 leader, overflow exclui primários, inclui Conceitos) - e2e smoke: barra visível mobile staff, invisível desktop/leader, navegação ativa reflete rota, FAB acima da barra, drawer overflow abre/fecha
pnpm gate:fastverde (tsc + lint + knip + test + build)