14 KiB
Impl: C94 — Agenda: filtro combobox único, header compacto (ícones) e ações no FAB mobile
Status: em execução (aprovado pelo humano em 2026-08-09) Atualizado em: 2026-08-09 Issue: #438 Intenção: docs/plans/c94-agenda-combobox-header-acoes-rapidas.md Appetite restante: ~1–1,5 dia eng (herdado); sem ajuste
Leitura da intenção
- Outcome: toolbar da agenda consolidada em um combobox único (chips removíveis + sugestões agrupadas), entrada de criação por viewport com um caminho só: desktop =
[combobox][carrinho giro][+ nova]+ "Link de import" como ícone agenda-contextual no header do app; mobile = sem botões de criação no corpo, tudo no drawer do FAB ("Nova atividade", "Link de import", "Planejar giro"). - O que NÃO negociar: filtros hoje = Município (único) + Tag + Deputado presente (chip bool), sem busca textual nem multi-seleção; estado do filtro segue na URL (reload/share consistentes); "Link de import" desktop mora no header do app, não na toolbar; mobile abre o mesmo diálogo como sheet; sem regressão de criação inline (C91), giros, revogação de feeds, leader lockdown.
- O que reavaliar (hipóteses da intenção):
- A intenção sugere "ActivityAgendaFilters.tsx vira o adaptador do combobox" — confirmado, mas ele vira a toolbar inteira (combobox + ícones trailing), não apenas o adaptador.
- A intenção sugere "slot no header vs renderizar no shell pela rota — executor decide". Decidir: slot via contexto de chrome (reusável por C95), não render por rota no shell.
- A intenção não decide o que fazer com "Link de import" no FAB quando não há filtros (hoje o botão fica desabilitado). Decidir: abrir o sheet e explicar dentro (em vez de tile morta).
Abordagem recomendada
flowchart LR
subgraph AgendaPage[AGENDA PAGE · server]
S[searchParams] --> P[CalendarFeedDialogProvider<br/>feeds · createFeed(state) · revokeFeed · canGenerate]
end
P -->|registra| H[SetCampaignHeaderAction id=calendar-feed]
H -->|lê| DH[CampaignDesktopHeader · agenda-contextual]
P -->|setContext openCalendarFeed| QK[CampaignQuickActionContext]
QK --> resolveActivityQuickActions['list' + import-calendar onAction]
QK --> FAB[FAB drawer · mobile]
AF[ActivityAgendaFilters → tool bar omnibox] -->|trailing desktop| ICON[ícone carrinho giro + ícone + nova]
AF --> URN[useCampaignListFilterNavigation → buildActivityAgendaHref]
Opções consideradas (combobox): A) omnibox chassis existente (CampaignListOmnibox B127) | B) StrictCombobox/combobox mobile avulso | C) manter selects nativos.
Recomendação: A — reusa o chassis já estabelecido nas listas; o adaptador segue o padrão activityOmnibox.ts (chips/sugestões puros + tests B128).
Rejeitadas: B (chassis não tem chips/teclado do omnibox — duplicaria); C (é exatamente a duplicação que a Issue quer eliminar).
Opções consideradas (header "Link de import"): A) slot por contexto de chrome (extender CampaignPageChromeContext com registro de ações de header) | B) renderizar no shell pela rota (usePathname no header + self-fetch de feeds/state via useSearchParams) | C) link simples para o dialog roteado.
Recomendação: A — "edit the owner": o contexto de chrome JÁ é o mecanismo por-página do shell; vira registro chaveado de ReactNode (reusável por C95 que precisa do mesmo header/slot). Mantém o conhecimento de domínio (feeds/state/action) na vertical de atividade.
Rejeitadas: B (acopla o shell compartilhado à URL/schema da agenda e exige useSearchParams no layout → Suspense; é o "renderizar na rota" que a intenção flagrou como risco); C (o diálogo não é rota; precisa de state).
Opções consideradas (FAB "Link de import" mobile): A) estender CampaignQuickAction com onAction + openCalendarFeed no contexto de quick actions | B) ação href para uma rota de wizzard | C) overlay próprio da agenda.
Recomendação: A — CampaignHomeActionButton JÁ suporta onClick; falta só o fio pelo overlay; o contexto de quick actions já é a ponte página→shell (precedente CampaignQuickActionContextSync/Bridge).
Rejeitadas: B (diálogo não é rota); C (duplica o drawer).
Componentes / mudanças
src/utilities/activityAgendaOmnibox.ts(novo): adaptador puro do omnibox paraActivityAgendaState—buildActivityAgendaOmniboxChips,buildActivityAgendaOmniboxSuggestionSeeds(grupos Município / Tag / "Deputado presente" chip bool),applyActivityAgendaOmniboxSuggestion,removeActivityAgendaOmniboxChip,clearActivityAgendaOmnibox. Mesmo shape deactivityOmnibox.ts(não é twin — outroStatecom 3 dimensões e sem busca/Janela).ActivityAgendaFilters.tsx(reescrita): vira a toolbar —<CampaignListOmnibox>com chips/sugestões/Limpar(chassis tem clear built-in) +trailingcom[ícone carrinho: Planejar giro][ícone "+" : Nova atividade]hidden md:inline-flex(mobile: zero botões no corpo).id="agenda-omnibox",label="Filtrar agenda",placeholdertipo "Filtrar por município, tag, deputado…". Navegação viauseCampaignListFilterNavigation+buildActivityAgendaHref.agenda/page.tsx: remove o bloco de botões "Planejar giro"/"Nova atividade" (movem para a toolbar); envolve o conteúdo em<CalendarFeedDialogProvider>(comfeeds,createFeed(label)= closure comstate,revokeFeed,canGenerate = hasFilters); mantémrestrictActivityAgendaState/redirects intocados.CalendarFeedDialog.tsx(extraído deCalendarFeedButton.tsx): diálogo nomear→copiar→revogar, responsivo (Dialog desktop / Drawer-sheet mobile viauseIsMobile, igual aoCampaignQuickActionsOverlay); expõeCalendarFeedDialogProvider+useCalendarFeedDialog()({ open, canGenerate }); quando!canGenerate, abre com aviso "Aplique filtros para gerar um link de import" e desabilita "Gerar link". O provider também injetaopenCalendarFeednoCampaignQuickActionContext(merge funcional + cleanup).CampaignPageChromeContext.tsx(extender): adicionaheaderActions: Record<string, ReactNode>+setHeaderAction(key, node|null); novo componenteSetCampaignHeaderAction({ id, children }): null(padrãoSetCampaignPageChrome).CampaignDesktopHeader.tsx: renderizaObject.values(headerActions)no cluster à direita, ANTES do sino e do AI (ordem do gate:[título …][Semana ▾ C95][Link de import][Notificações][IA]).AgendaFeedHeaderButton.tsx(novo, client): botão-íconeCalendarIcon,title/tooltip,disabled={!canGenerate},onClick={open}— registrado viaSetCampaignHeaderAction id="calendar-feed"na página (desktop-only porque oCampaignDesktopHeaderémd:flex).- Quick actions:
CampaignQuickActionganhaonAction?: () => void;CampaignQuickActionsOverlayrepassaonClick: action.onActionpara oCampaignHomeActionStrip(o botão já suporta);CampaignQuickActionContextganhaopenCalendarFeed?: () => void;resolveActivityQuickActions(surfacelist) devolve[new-activity, import-calendar(onAction), plan-tour]— ordem da intenção. - Migration: sem migration (nenhuma mudança de schema).
- Access / Consent: nenhuma mudança — agenda segue
gate: 'staff'; nenhum opt-in novo (o feed é dado de staff, sem Consent). - UI: Impeccable C/B — consolidar a toolbar seguindo o padrão de
ActivityFilters/listas; shape → craft → critique → polish leve; tokensdata-theme='campaign'.
Dados → forma (se aplicável)
- Forma: chips + sugestões agrupadas (padrão omnibox do repo) — "não apresento dados novos, filtro = navegação/URL". Decidido pela intenção (pergunta 3: forma adiada para o padrão existente).
Fases verificáveis
- Combobox (traço dominante) —
activityAgendaOmnibox.ts+ unit tests (espelho delistOmniboxB128); reescreverActivityAgendaFilters(omnibox + trailing desktop); página: remover botões avulsos. Verificar: URL canonical inalterada; e2e da agenda reescrito nos seletores (hojegetByLabel('Município'|'Tag'|'Deputado presente')). - Feed dialog + header slot + FAB — extrair
CalendarFeedDialog(Dialog/sheet); provider +useCalendarFeedDialog; extender chrome context (headerActions+SetCampaignHeaderAction);AgendaFeedHeaderButton+ header renderiza registrados; quick actionsonAction+openCalendarFeed+import-calendar. - Gates —
pnpm gate:fastna iteração; rebase emorigin/main; e2e agenda (atualizar + rodar);pnpm pushno fechamento.
Rabbit holes / Não escopo (engenharia)
- Omnibox de busca global da agenda (texto livre, multi-município, presets de janela) — fora; só as 3 dimensões de hoje, sem
onCommitQuery. - Refatorar
CampaignHomeActionStrip/CampaignHomeActionButtonalém do fio mínimo doonAction— não. - Migrar as outras listas para o omnibox (municípios etc. já usam) — não.
- Header vira barra de navegação — mantém batch pequeno: só
headerActionsregistrados + sino + IA. - C92/C93: o ícone reflete apenas o estado habilitado/desabilitado; "gerar feed sem filtros" é a C93 (fora).
- Não mudar o compose de giro nem o overlay inline (C91).
Divergências executadas (vs. hipótese da intenção)
AgendaFeedChrome(client, montado na página) é o ponte único: registra o botão do header (SetCampaignHeaderAction id="calendar-feed"), injetaopenCalendarFeednoCampaignQuickActionContexte dona do único<CalendarFeedDialog>(Dialog/sheet responsivo) — o botão do header e a ação do FAB chamam o mesmoopen()(sem contexto novo de diálogo no layout).- O overlay do FAB fecha ao disparar uma ação dialog (
onActionClicknoCampaignQuickActionsOverlay) — senão o sheet da agenda abriria por cima do drawer aberto. playwright.config.tsganhouwebServer.timeout = 240slocal-only (CI ? undefined) — a máquina compartilhada (load 60+ de worktrees paralelos) estourava o boot de 60s empnpm dev.
Pós-/simplify (reviewers paralelos)
- P1 corrigido:
ActivityAgendaFiltersmantém espelhodraftdo estado (padrão do filtro antigo) para picks consecutivos dentro da janela pending do RSC aplicarem cumulativos — derivar do propstatesolto dropava a primeira seleção (regressão desta entrega, achada pelo reviewer de correção). - P2 corrigido: no overlay,
onActionvencehrefdeterministicamente (o botão ignoraonClickna branch Link — combo latente). - Botão do header memoizado (
useMemo) noAgendaFeedChrome— registra só quandocanGenerate/openmuda. - Chaves nos nós de
headerActions(C95 terá 2+). handleRevokesem wrapper async inútil;ActivityAgendaFilterOptionnão exportado.- Deferido (DRY <3 call sites): extrair
chipLabel/seeds de município/tag compartilhados paralib/campaignListOmnibox. - E2E: os testes de slot do calendário (
cria inline,Mais detalhes) ganharam waits de visibilidade ([data-time="14:00:00"]:visible+dayCell) antes de medir — o FullCalendar renderiza o eixo de tempo lazy e re-layout no mount; osboundingBoxantigos corriam a renderização (flake que também existe no commit base; agora estabilizado).
Débitos deferidos (capture-review-debts)
| Débito | Gatilho de revisitação |
|---|---|
Query textual sem match fica presa no omnibox da agenda (sem onCommitQuery; q: é filtrado de propósito) |
Se um usuário relatar confusão, ou quando um omnibox sem busca textual voltar a aparecer em outra lista |
CampaignQuickAction permite href+onAction juntos (mitigado: onAction vence no overlay; tipo união discriminada seria refactor amplo) |
Na próxima Issue que tocar CampaignQuickActionTypes/overlay |
| Closure de filtro pode ficar stale dentro do diálogo de feed aberto (comportamento herdado do C92) | C93 (gerar sem filtros) ao mexer no diálogo |
| Feeds listados no diálogo só atualizam em re-render da página (herdado do C92) | Idem |
SetCampaignHeaderAction re-registra quando o host re-renderiza (agora memoizado; C95 deve revisitar o shape do slot) |
C95 (seletor de semana no header) |
Riscos e mitigação (executados)
- Header
[actions][sino][IA]conforme o gate; semuseSearchParamsno layout. - E2E agenda: a interação omnibox usa
fill(reabre o popover) em vez declicknum input já focado; assert final de URL com wait do chip +timeout: 20s. codebaseConventions—activityAgendaOmnibox.tsregistrado no pin desrc/utilities.- Os testes de slot do calendário (
cria inline,Mais detalhes) são frágeis de timing degridcell.nth(1)e flakam sob load alto também no commit base (verificado via worktree descartável dee3f6d3f5) — ambientais, não desta entrega; em load ~30 a suíte agenda passou 3/3.
Aceite de engenharia
- Aceite de produto da intenção ainda coberto (3 pontos + anti-goals)
- Invariantes AGENTS/engineering-standards (staff gate, URL canonical, sem Consent novo)
- Testes de domínio: unit do adaptador de agenda (espelho B128); e2e agenda reescrito e verde; int/serviço de feed intocados
pnpm gate:fast, tsc, lint, prettier, knip, check:cycles verdes