- loadMunicipalityV2ContaData + MunicipalityV2LocalAccountSection - Inline edit-in-place com cenário ativo local para cobertura - Extract MunicipalityTerritorialClassRow do card E8 - Integra com B149 rede e B150 agora na mesma página v2 - Impl plan docs/plans/municipio-v2-conta-local-impl.md
297 lines
12 KiB
TypeScript
297 lines
12 KiB
TypeScript
import Link from 'next/link'
|
||
import type { ReactNode } from 'react'
|
||
|
||
import { MunicipalityListExpectedVotesControl } from '@/components/campaign/municipality/MunicipalityListExpectedVotesControl'
|
||
import {
|
||
CampaignConceptMetricExplanation,
|
||
MunicipalityTerritorialClassRow,
|
||
} from '@/components/campaign/municipality/MunicipalityTerritorialClassRow'
|
||
import { CampaignHoverTooltip } from '@/components/campaign/shared/CampaignHoverTooltip'
|
||
import { CampaignInfoHint } from '@/components/campaign/shared/CampaignInfoHint'
|
||
import { Progress } from '@/components/ui/Progress'
|
||
import { campaignHoverExplanationClassName } from '@/lib/campaignHoverTooltip'
|
||
import { CAMPAIGN_CONCEPTS_PATH } from '@/lib/campaignIntelligenceConcepts'
|
||
import { formatElectionNumber } from '@/lib/electionFormat'
|
||
import { cn } from '@/lib/utils'
|
||
import type { VoteEstimateScenarioViewModel } from '@/lib/voteEstimate'
|
||
import {
|
||
formatGoalCoverageDeficitLabel,
|
||
formatGoalCoverageRatioLabel,
|
||
formatRatioAsPercentLabel,
|
||
goalCoverageProgressPercent,
|
||
type MunicipalityGoalCoverage,
|
||
} from '@/utilities/municipality/goalCoverage'
|
||
import type { MunicipalityPotential, RollOff } from '@/utilities/municipality/municipalityPotential'
|
||
import type { MunicipalityTerritorialClassification } from '@/utilities/municipality/municipalityTerritorialClass'
|
||
import type { MunicipalityIntraTerritoryCaptureBenchmark } from '@/utilities/territory/territoryIntraCaptureBenchmark'
|
||
import type { MunicipalityPledgeCoverageView } from '@/utilities/votePledgeViews'
|
||
|
||
/**
|
||
* One `dt`/`dd` pair in the diagnostic grid, with a hover/focus/tap tooltip
|
||
* explaining the metric — deliberately not the "?" icon button pattern used
|
||
* by `CampaignInfoHint` in the card title (that stays reserved for
|
||
* card-level context that persists open; this is a per-metric definition
|
||
* that dismisses on its own), per the E8 UI feedback: these are dense
|
||
* numbers that need an inline explanation, not a separate affordance to
|
||
* seek out. Reuses `CampaignHoverTooltip` (same shadcn Tooltip stack
|
||
* wired for baseline/sortable-header hints), which handles the tap-to-open
|
||
* itself.
|
||
*
|
||
* A real `<button>` (not a `div` with `tabIndex`) so the tap target is
|
||
* reliably focusable/clickable on touch, sized to the 44px target, and
|
||
* announced with its own accessible name — a screen-reader user tabbing in
|
||
* hears "mais informações" up front instead of discovering extra content
|
||
* only by opening it. `side="right"` keeps the bubble off the vertical axis
|
||
* this row shares with "Cobertura da meta" above, so a viewport-bottom
|
||
* collision flip never covers that figure (`/impeccable critique` finding).
|
||
*/
|
||
const GoalAccountMetric = ({
|
||
label,
|
||
value,
|
||
explanation,
|
||
}: {
|
||
label: string
|
||
value: string
|
||
explanation: ReactNode
|
||
}) => (
|
||
<CampaignHoverTooltip content={explanation} side="right" align="start" sideOffset={8}>
|
||
<button
|
||
type="button"
|
||
aria-label={`${label}: mais informações`}
|
||
className="flex min-h-11 w-fit flex-col items-start gap-0.5 rounded-md px-1.5 py-1 text-left outline-none hover:bg-muted/60 focus-visible:ring-2 focus-visible:ring-ring"
|
||
>
|
||
<dt className={cn('text-xs text-muted-foreground', campaignHoverExplanationClassName)}>
|
||
{label}
|
||
</dt>
|
||
<dd className="tabular-nums">{value}</dd>
|
||
</button>
|
||
</CampaignHoverTooltip>
|
||
)
|
||
|
||
const formatRollOff = (rollOff: RollOff | null): string => {
|
||
if (!rollOff) return 'Sem majoritária 2022 disponível'
|
||
const votesLabel = formatElectionNumber(rollOff.votes)
|
||
const percentLabel =
|
||
rollOff.percentOfTurnout != null
|
||
? ` (${formatRatioAsPercentLabel(rollOff.percentOfTurnout)} do comparecimento)`
|
||
: ''
|
||
return `${votesLabel}${percentLabel}`
|
||
}
|
||
|
||
/**
|
||
* E8 "conta da cadeira" — meta × comprometido para este município, com o
|
||
* bloco de diagnóstico (teto do campo, captura, share intracampo, roll-off).
|
||
* Cenário fixo `central`: o detalhe não tem seletor de cenário (a lista e o
|
||
* dashboard têm).
|
||
*/
|
||
export const MunicipalityGoalAccountCard = ({
|
||
municipalityID,
|
||
expectedVotes,
|
||
pledgeCoverage,
|
||
suggestedGoal,
|
||
goalCoverage,
|
||
potential,
|
||
territorialClass,
|
||
territoryCaptureBenchmark,
|
||
}: {
|
||
municipalityID: number
|
||
expectedVotes: VoteEstimateScenarioViewModel
|
||
pledgeCoverage: MunicipalityPledgeCoverageView | null
|
||
suggestedGoal: number
|
||
goalCoverage: MunicipalityGoalCoverage
|
||
potential: MunicipalityPotential
|
||
territorialClass: MunicipalityTerritorialClassification
|
||
territoryCaptureBenchmark: MunicipalityIntraTerritoryCaptureBenchmark
|
||
}) => {
|
||
const usesMesaEstimate = expectedVotes.central != null
|
||
const latestIntraFieldShareYear = Math.max(
|
||
...Object.keys(potential.intraFieldShareByYear).map(Number),
|
||
)
|
||
const latestIntraFieldShare = potential.intraFieldShareByYear[latestIntraFieldShareYear] ?? null
|
||
|
||
const benchmarkRatioLabel =
|
||
territoryCaptureBenchmark.ratioToMedian != null
|
||
? `${territoryCaptureBenchmark.ratioToMedian.toLocaleString('pt-BR', { maximumFractionDigits: 1 })}×`
|
||
: '—'
|
||
const benchmarkLead =
|
||
territoryCaptureBenchmark.medianCapture != null ? (
|
||
<>
|
||
Captura <strong>{benchmarkRatioLabel}</strong> a mediana do seu território (
|
||
{formatRatioAsPercentLabel(territoryCaptureBenchmark.medianCapture)}).
|
||
</>
|
||
) : (
|
||
<>Sem mediana de captura no território — faltam tetos de 2022 nos pares.</>
|
||
)
|
||
|
||
return (
|
||
<section
|
||
aria-labelledby="municipality-goal-account-title"
|
||
className="flex flex-col gap-4 rounded-xl border p-4"
|
||
>
|
||
<div className="flex items-center gap-1">
|
||
<h2 id="municipality-goal-account-title" className="text-base font-medium">
|
||
Conta da cadeira
|
||
</h2>
|
||
<CampaignInfoHint label="Sobre a conta da cadeira">
|
||
<div className="flex flex-col gap-2">
|
||
<p>
|
||
<strong>Meta</strong> é a estimativa da mesa; sem estimativa, usa a meta sugerida — a
|
||
votação do próprio Jorge Solla aqui em 2022 (cenário média).
|
||
</p>
|
||
<p>
|
||
<strong>Comprometido</strong> é só a soma das declarações de lideranças — nunca a
|
||
meta.
|
||
</p>
|
||
<p>
|
||
O roll-off e o teto do campo (abaixo) só usam 2022 — a majoritária de 2014/2018 já foi
|
||
importada, mas ainda não entra nessas contas.
|
||
</p>
|
||
{/*
|
||
Keyboard path into E18's documentation: Popover content is
|
||
tabbable, tooltip content is not, so this link (unlike the
|
||
per-metric ones) is reachable without a pointer.
|
||
*/}
|
||
<Link
|
||
href={CAMPAIGN_CONCEPTS_PATH}
|
||
className="font-medium text-primary underline underline-offset-4"
|
||
>
|
||
Como cada número é calculado
|
||
</Link>
|
||
</div>
|
||
</CampaignInfoHint>
|
||
</div>
|
||
|
||
<div className="rounded-lg bg-muted/40 px-3 py-2">
|
||
<p className="text-xs font-medium text-muted-foreground">Votos estimados</p>
|
||
<MunicipalityListExpectedVotesControl
|
||
municipalityID={municipalityID}
|
||
expectedVotes={expectedVotes}
|
||
pledgeCoverage={pledgeCoverage}
|
||
variant="popover"
|
||
/>
|
||
<p className="mt-1 text-xs text-muted-foreground">
|
||
Meta usada na conta: {formatElectionNumber(goalCoverage.goal)} (
|
||
{usesMesaEstimate ? 'estimativa da mesa' : 'meta sugerida: votação de 2022 aqui'})
|
||
</p>
|
||
</div>
|
||
|
||
<div className="flex flex-col gap-1.5">
|
||
<div className="flex items-baseline justify-between gap-2">
|
||
<span className="text-2xl font-semibold tabular-nums">
|
||
{formatGoalCoverageRatioLabel(goalCoverage)}
|
||
</span>
|
||
<span className="text-sm text-muted-foreground">Cobertura da meta</span>
|
||
</div>
|
||
{goalCoverage.coverageRatio != null ? (
|
||
// h-2 (vs. the shared default h-1): at 0% coverage — the most common
|
||
// early-campaign state — the empty track is the only visual signal,
|
||
// and a 4px hairline read as near-invisible in the E8
|
||
// `/impeccable critique`.
|
||
<Progress
|
||
value={goalCoverageProgressPercent(goalCoverage)}
|
||
aria-label={`Cobertura da meta: ${formatGoalCoverageRatioLabel(goalCoverage)}`}
|
||
className="h-2"
|
||
/>
|
||
) : null}
|
||
<p className="text-xs text-muted-foreground tabular-nums">
|
||
{formatGoalCoverageDeficitLabel(goalCoverage)}
|
||
</p>
|
||
</div>
|
||
|
||
<div className="flex flex-col gap-3 border-t pt-3">
|
||
<MunicipalityTerritorialClassRow territorialClass={territorialClass} />
|
||
<dl className="grid grid-cols-2 gap-3 text-sm sm:grid-cols-4">
|
||
<GoalAccountMetric
|
||
label="Teto do campo (proj.)"
|
||
value={formatElectionNumber(Math.round(potential.projectedFieldCeiling))}
|
||
explanation={
|
||
<CampaignConceptMetricExplanation
|
||
lead={
|
||
<>
|
||
<strong>Teto do campo</strong> projeta quantos votos válidos o campo pode
|
||
alcançar em 2026.
|
||
</>
|
||
}
|
||
formula="Fórmula: votos do presidencial do campo em 2022 (1º turno), ajustados pelo crescimento de comparecimento projetado para a disputa de deputado federal."
|
||
conceptID="teto-do-campo"
|
||
/>
|
||
}
|
||
/>
|
||
<GoalAccountMetric
|
||
label="Captura (2022)"
|
||
value={formatRatioAsPercentLabel(potential.captureRate2022)}
|
||
explanation={
|
||
<CampaignConceptMetricExplanation
|
||
lead={
|
||
<>
|
||
<strong>Captura</strong> mostra quanto do teto do campo Jorge Solla conquistou
|
||
em 2022.
|
||
</>
|
||
}
|
||
formula="Fórmula: votos de Solla (2022) ÷ teto do campo (presidencial 2022). Só diagnóstico — não entra na meta."
|
||
conceptID="captura"
|
||
/>
|
||
}
|
||
/>
|
||
</dl>
|
||
<p className="text-xs text-muted-foreground">
|
||
{benchmarkLead}
|
||
{territoryCaptureBenchmark.beacon ? (
|
||
<>
|
||
{' '}
|
||
Referência no território:{' '}
|
||
<Link
|
||
href={`/campanha/municipios/${territoryCaptureBenchmark.beacon.slug}`}
|
||
className="font-medium text-primary underline underline-offset-4"
|
||
>
|
||
{territoryCaptureBenchmark.beacon.name}
|
||
</Link>{' '}
|
||
({formatRatioAsPercentLabel(territoryCaptureBenchmark.beacon.captureRate)}). Leitura
|
||
para aprender mecanismo — não é nota.
|
||
</>
|
||
) : null}
|
||
</p>
|
||
<dl className="grid grid-cols-2 gap-3 text-sm sm:grid-cols-4">
|
||
<GoalAccountMetric
|
||
label={`Share intracampo (${latestIntraFieldShareYear})`}
|
||
value={formatRatioAsPercentLabel(latestIntraFieldShare)}
|
||
explanation={
|
||
<CampaignConceptMetricExplanation
|
||
lead={
|
||
<>
|
||
<strong>Share intracampo</strong> mostra a fração dos votos do campo, só na
|
||
disputa de deputado federal, que foi para Jorge Solla nesse ano.
|
||
</>
|
||
}
|
||
formula="O denominador é o próprio campo nessa disputa — não o teto presidencial de 2022, que é o denominador da Captura."
|
||
conceptID="share-intracampo"
|
||
/>
|
||
}
|
||
/>
|
||
<GoalAccountMetric
|
||
label="Roll-off (2022)"
|
||
value={formatRollOff(potential.rollOff2022)}
|
||
explanation={
|
||
<CampaignConceptMetricExplanation
|
||
lead={
|
||
<>
|
||
<strong>Roll-off</strong> mede quanto voto em branco/nulo a disputa de deputado
|
||
federal atrai a mais que a presidencial, no mesmo pleito.
|
||
</>
|
||
}
|
||
formula="Fórmula: (brancos + nulos, deputado federal 2022) − (brancos + nulos, presidencial 2022)."
|
||
conceptID="roll-off"
|
||
/>
|
||
}
|
||
/>
|
||
</dl>
|
||
</div>
|
||
{!usesMesaEstimate && suggestedGoal <= 0 ? (
|
||
<p className="text-xs text-muted-foreground">
|
||
Sem votação própria em 2022 aqui, então não há meta sugerida — é município de expansão:
|
||
cadastre a estimativa da mesa manualmente se decidir investir.
|
||
</p>
|
||
) : null}
|
||
</section>
|
||
)
|
||
}
|