mirror of
https://github.com/fsolla/teqo.git
synced 2026-11-17 21:03:06 +00:00
77 lines
4.4 KiB
Markdown
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.
|