mirror of https://github.com/fsolla/teqo.git synced 2026-11-13 23:53:05 +00:00

feat(nav): add Organizações to staff sidebar (B144, #313 )

Insert Organizações after Lideranças in staffNav so staff can discover
the existing /campanha/organizacoes list from the structural nav.
Leaders remain on leaderNav; isCampaignNavActive already covers list,
detail, and /nova paths.

Co-authored-by: Francisco Solla <fsolla@users.noreply.github.com>

2026-08-02 23:13:34 +00:00

2.9 KiB

Raw Permalink Blame History

Impl: Sidebar — entrada para Organizações

Status: aprovado Atualizado em: 2026-08-02 Issue: #313 Intenção: docs/plans/sidebar-organizacoes.md Appetite restante: ~0,25 dia eng (um item de nav; sem migration)

Leitura da intenção

Outcome: Staff (coordenador, assessor, candidato) descobre /campanha/organizacoes pela sidebar desktop e Sheet mobile; liderança não vê o item; destino ativo em lista, detalhe e /nova.
O que NÃO negociar: lockdown de leader; não redesenhar sidebar; não duplicar lista; href canônico /campanha/organizacoes.
O que reavaliar: hipótese de importar ORGANIZATIONS_LIST_PATH — nav.ts usa literais (precedente Conceitos) para não puxar módulos ao client bundle; manter literal.

Abordagem recomendada

flowchart LR
  staffNav["staffNav + Organizações"] --> getCampaignNav
  getCampaignNav --> CampaignSidebar
  getCampaignNav --> MobileSheet["Sheet mobile"]
  isCampaignNavActive --> Active["lista / slug / nova"]

Opções consideradas: A) item após Lideranças | B) após Dobradinhas | C) antes de Apoiadores
Recomendação: A — afinidade domínio orgs ↔ lideranças; alinhado à recomendação da intenção.
Rejeitadas: B/C — sem ganho de descoberta; A é o modelo mental acordado.

Componentes / mudanças

staffNav (src/components/campaign/shell/nav.ts): inserir { title: 'Organizações', href: '/campanha/organizacoes', icon: LandmarkIcon } logo após Lideranças; import LandmarkIcon de lucide-react (instituições — distinto de HandshakeIcon e Building2 usado em município no dashboard).
Migration: sem migration
Access / Consent: nenhum — getCampaignNav já exclui leader; staff vê por default (mesmo que Lideranças/Demandas)
UI: Impeccable B — encaixe no shell existente; CampaignSidebar e Sheet já consomem getCampaignNav; isCampaignNavActive já cobre paths aninhados (/nova, [slug])

Dados → forma

N/A — só navegação.

Fases verificáveis

Nav — uma linha em staffNav + ícone
Testes — unit: href presente para staff, ausente para leader; isCampaignNavActive em lista/detalhe/nova
Gates — pnpm gate:fast; entrega pnpm push

Rabbit holes / Não escopo (engenharia)

Reordenar demais itens além do encaixe após Lideranças
Exportar constante de href (só MUNICIPALITY_NAV_HREF tem consumidor especial B18)
staffSecondaryNav — destino de trabalho, não referência

Riscos e mitigação

Leader vê link: mitigado — getCampaignNav('leader') retorna leaderNav separado
Active state em /nova: mitigado — isCampaignNavActive usa pathname.startsWith(\${href}/`)`

Aceite de engenharia

Aceite de produto da intenção ainda coberto
Invariantes AGENTS/engineering-standards
Testes de domínio previstos (unit) para nav + active state

2.9 KiB Raw Permalink Blame History