teqo-backup/docs/plans/detalhe-entidade-titulo-no-header-impl.md
2026-08-03 00:29:48 +00:00

77 lines
4.4 KiB
Markdown

# Impl: Detalhe de entidade — título no header (sem hero espaçoso)
Status: aprovado
Atualizado em: 2026-08-02
Issue: #315
Intenção: docs/plans/detalhe-entidade-titulo-no-header.md
Appetite restante: ~0,5 dia eng (8 rotas de detalhe + catálogo + e2e)
## Leitura da intenção
- **Outcome:** Em cada detalhe de entidade em `/campanha`, a identidade do registro (título + subtítulo) vive no header da shell; o corpo começa direto em abas/seções/chips operacionais, sem hero nem “Voltar para…”.
- **O que NÃO negociar:** listas mantêm header de seção (B123/B133); edit routes inalteradas; chips operacionais no corpo; leader lockdown; aba do browser alinhada à entidade.
- **O que reavaliar:** hipótese de tocar só `campaignPageChrome` — insuficiente: títulos são dinâmicos por registro; precedente de `SetCampaignPageChrome` + `generateMetadata` nas rotas `/editar` é o dono.
## Abordagem recomendada
```mermaid
flowchart LR
RSC[Detail page RSC] --> MD[generateMetadata]
RSC --> SC[SetCampaignPageChrome]
SC --> Shell[CampaignPageChromeDisplay]
RSC --> Body[Corpo sem hero]
```
**Opções consideradas:**
- A) Estender `resolveCampaignPageChrome` com dados de entidade (impossível — catálogo é estático/client-safe)
- B) `SetCampaignPageChrome` + `generateMetadata` por rota (precedente edit routes)
- C) Novo provider server-side de chrome
**Recomendação:** B — reusa `SetCampaignPageChrome` e `campaignPageMetadata` já usados em `/editar` e `MunicipalityListPageChrome`; path rules de detalhe passam a `null` (como edit) para não flashar título de seção antes do override.
**Rejeitadas:** C (twin desnecessário); A (dados dinâmicos não cabem no catálogo).
### Componentes / mudanças
- **`campaignPageChrome.ts`:** regras de detalhe retornam `null`; teste unitário atualizado.
- **8 rotas de detalhe** (`municipios/[slug]`, `liderancas/[id]`, `atividades/[slug]`, `demandas/[slug]`, `dobradinhas/[slug]`, `organizacoes/[slug]`, `apoiadores/[id]`, `assessores/[id]`): `generateMetadata` + `SetCampaignPageChrome`; remover hero (`h1`, “Voltar…”, chips de identidade duplicados, linha Assessoria no município).
- **`campaignZoneMap.e2e.spec.ts`:** assert no chrome da shell (`data-slot=campaign-page-chrome-title`) em vez de `h1` no corpo.
- **Migration:** sem migration
- **Access / Consent:** inalterado
### Mapeamento chrome por rota
| Rota | title | subtitle |
| ------------------- | ----------------- | --------------------------------------- |
| municipios/[slug] | view.name | formatMunicipalityGeographyLabel(view) |
| liderancas/[id] | Liderança | leadership.name |
| atividades/[slug] | view.title | view.locationLabel ou municipality.name |
| demandas/[slug] | demand.title | `${kind} · ${municipalityName}` |
| dobradinhas/[slug] | stateDeputy.name | party (opcional) |
| organizacoes/[slug] | organization.name | organizationKindLabels[kind] |
| apoiadores/[id] | Apoiador | supporter.name |
| assessores/[id] | Assessor | advisor.name |
## Fases verificáveis
1. **Catálogo + testes** — path rules `null` para detalhes; unit spec
2. **UI — 8 páginas** — chrome override + remoção de hero; metadata dinâmica
3. **Gates** — `pnpm gate:fast`; push via `pnpm push`
## Rabbit holes / Não escopo (engenharia)
- Novo bloco UI para Assessoria no município
- Wizard, giros, perfil, contatos, rotas `/editar`, listas
- Refatorar `CampaignPageChromeText` (layout já suporta subtitle)
## Riscos e mitigação
- **Flash de título de seção:** path rule `null` + `useLayoutEffect` do override (mesmo que edit routes)
- **E2E que asserta `h1`:** atualizar para chrome slot
- **Atividade sem locationLabel:** fallback para `municipality?.name`
## Débitos deferidos (capture-review-debts autônomo)
- **Domain `*DetailPageChrome` builders** (score 4, defer_trigger): quando um 3º detalhe precisar de lógica de subtítulo compartilhada além do padrão SetCampaignPageChrome — extrair no módulo dono do view model, não HOF genérico.
- **`cache()` em loaders de detalhe** (score 3, defer_trigger): edit routes já duplicam fetch MD+página; otimizar loaders no dono quando houver evidência de custo em prod.