mirror of
https://github.com/fsolla/teqo.git
synced 2026-11-16 20:13:04 +00:00
- Catálogo v2 de ações rápidas: dossiê, eleições, nova liderança, giro - Integra no chassis B126 via registry + context sync na rota v2 - Omitido registrar sinal (já na faixa de status B147) Co-authored-by: Francisco Solla <fsolla@users.noreply.github.com>
4.2 KiB
4.2 KiB
Impl: Município v2 — ações secundárias no FAB
Status: aprovado Atualizado em: 2026-08-03 Issue: #334 Intenção: docs/plans/municipio-v2-fab-secundario.md Appetite restante: ~0,5 dia eng (herdado)
Leitura da intenção
- Outcome: na rota v2, secundárias (dossiê, eleições, nova liderança, compositor de giros) alcançáveis via FAB B126, sem tab nav de 6 itens; papel respeitado; dobra de operação intacta; print/dossiê sem FAB.
- O que NÃO negociar: leader lockdown; não replicar wizard de operação no FAB v2; não omitir
print:hiddendo chassis; não duplicar segundo FAB; registrar sinal omitido (assunção A — select na faixa B147). - O que reavaliar: hipótese de “integrar no chassis global” — confirmado: estender
resolveQuickActionsForPathcom superfície v2, não componente paralelo.
Abordagem recomendada
flowchart LR
V2Page["municipio/[slug]/v2/page.tsx"]
Sync["CampaignQuickActionContextSync"]
Registry["resolveQuickActionsForPath"]
V2QA["resolveMunicipalityV2QuickActions"]
Host["CampaignQuickActionsHost"]
V2Page --> Sync
Host --> Registry --> V2QA
Sync --> Host
Opções consideradas:
A — Reusar resolveMunicipalityDetailQuickActions (wizard) |
B — Catálogo v2 dedicado de navegação secundária | C — Segundo FAB só na v2 | |
|---|---|---|---|
| Já existe | Alinha com aceite (secundárias ≠ operação) | Viola anti-goal |
Recomendação: B — because v2 operational edits live in the status strip / future dobra; the old detail FAB ships wizard actions that would compete with B147–B150. A dedicated client-safe resolver returns navigation hrefs to existing surfaces.
Rejeitadas: A (wizard noise on v2). C (twin FAB).
Componentes / mudanças
campaignMunicipalityV2QuickActions.ts(src/lib/):parseMunicipalityV2Slug,resolveMunicipalityV2QuickActions,resolveMunicipalityV2QuickActionsForPath; links viabuildMunicipalityDetailTabHref,buildTourComposerHref+ catalogregion,/campanha/liderancas/nova?municipality=.campaignQuickActionRegistry.ts: early branch for v2 path before pluralmunicipiosresolver.municipio/[slug]/v2/page.tsx:CampaignQuickActionContextSyncwithmunicipalitySlug+municipalityIdfrom loader context.- Migration: nenhuma.
- Access / Consent: staff-only via page gate
noLeader; same as v2 shell. - UI: Impeccable B — reuse B126 host; no new chrome. Print: existing
print:hiddenon FAB suffices when user opens dossier on old tab route.
Catálogo FAB v2 (staff)
| id | label | destino |
|---|---|---|
municipality-dossier |
Preparar visita | /campanha/municipios/{slug}?tab=dossie |
municipality-elections |
Ver eleições | /campanha/municipios/{slug}?tab=elections |
new-leadership |
Nova liderança | /campanha/liderancas/nova?municipality={id} |
plan-tour |
Planejar giro | /campanha/atividades/giros?region={TI} |
Omitido: register-signal (assunção A).
Fases verificáveis
- Lib + registry — resolver + unit tests.
- Page wire — context sync on v2 RSC.
- Gates —
pnpm gate:fast; entrega viapnpm push.
Rabbit holes / Não escopo (engenharia)
- Cutover URLs (B152).
- Reescrever dossiê/eleições.
- Atualizações/demandas no FAB (rede/agora nas fatias B149–B150).
returnPathde volta à v2 nos links do detalhe antigo.
Riscos e mitigação
- Slug singular vs plural: parser dedicado
^/campanha/municipio/([^/]+)/v2$— não colide communicipios. - Giros sem TI:
buildTourComposerHref({ region: null })se catalog miss (defensivo).
Aceite de engenharia
- Aceite de produto da intenção ainda coberto
- Invariantes AGENTS/engineering-standards
- Testes unitários do resolver v2
Self-score decision-quality: 4/5