mirror of
https://github.com/fsolla/teqo.git
synced 2026-11-14 08:53:11 +00:00
9443a4e1f6
Nova rota staff-only /campanha/conceitos (glossário curado em src/lib/campaignIntelligenceConcepts.ts, revisado junto das fórmulas que descreve em municipalityPotential.ts/goalCoverage.ts) com descoberta por "Saiba mais" nos tooltips do card "Conta da cadeira" e entrada fixa no rodapé da sidebar (staffSecondaryNav). Corrige defeito E8 de formatElectionNumber (meta fracionária lida como cem mil em pt-BR). Ajustes pós-/simplify: MetricExplanation.conceptID obrigatório, href da sidebar desacoplado do módulo de conteúdo (client bundle).
103 lines
4.3 KiB
TypeScript
103 lines
4.3 KiB
TypeScript
import { describe, expect, it } from 'vitest'
|
||
|
||
import {
|
||
aggregateGoalCoverage,
|
||
computeGoalCoverage,
|
||
computeGoalCoverageByScenario,
|
||
formatGoalCoverageDeficitLabel,
|
||
} from '@/utilities/goalCoverage'
|
||
import { createEmptyMunicipalityPledgeAggregate } from '@/utilities/votePledgeData'
|
||
|
||
/**
|
||
* Fixes the meta×comprometido semantics locked in the E8 plan audit: a
|
||
* municipality can have `expectedVotes` filled by the E4R projection-sheet
|
||
* import with ZERO pledges behind it — coverage must report that gap, not
|
||
* 100% (which is what `resolveMunicipalityStaffVoteTotal`'s override
|
||
* behavior would give if reused here).
|
||
*/
|
||
describe('computeGoalCoverage', () => {
|
||
it('meta = expectedVotes[cenário] when set; comprometido = pledge aggregate only (never the override)', () => {
|
||
// Feira de Santana-style case: mesa expects 3000 (E4R sheet, cenário média),
|
||
// but only 1200 is backed by declared/estimated pledges.
|
||
const aggregate = createEmptyMunicipalityPledgeAggregate()
|
||
aggregate.effectiveByScenario.central = 1200
|
||
|
||
const coverage = computeGoalCoverage({ central: 3000 }, 5000, aggregate, 'central')
|
||
|
||
expect(coverage.goal).toBe(3000) // NOT 100% — expectedVotes wins over suggestedGoal, not over pledges
|
||
expect(coverage.committed).toBe(1200)
|
||
expect(coverage.coverageRatio).toBeCloseTo(0.4, 6)
|
||
expect(coverage.deficit).toBe(1800)
|
||
})
|
||
|
||
it('falls back to suggestedGoal when expectedVotes is unset for that scenario', () => {
|
||
const aggregate = createEmptyMunicipalityPledgeAggregate()
|
||
aggregate.effectiveByScenario.central = 400
|
||
|
||
const coverage = computeGoalCoverage(null, 1000, aggregate, 'central')
|
||
expect(coverage.goal).toBe(1000)
|
||
expect(coverage.committed).toBe(400)
|
||
expect(coverage.coverageRatio).toBeCloseTo(0.4, 6)
|
||
})
|
||
|
||
it('coverageRatio is null (not Infinity/NaN) when goal is zero', () => {
|
||
const aggregate = createEmptyMunicipalityPledgeAggregate()
|
||
const coverage = computeGoalCoverage(null, 0, aggregate, 'central')
|
||
expect(coverage.coverageRatio).toBeNull()
|
||
expect(coverage.deficit).toBe(0)
|
||
})
|
||
|
||
it('deficit is negative when the municipality is over-committed relative to its goal', () => {
|
||
const aggregate = createEmptyMunicipalityPledgeAggregate()
|
||
aggregate.effectiveByScenario.central = 1500
|
||
const coverage = computeGoalCoverage(null, 1000, aggregate, 'central')
|
||
expect(coverage.deficit).toBe(-500)
|
||
expect(coverage.coverageRatio).toBeCloseTo(1.5, 6)
|
||
})
|
||
|
||
it('reads each scenario independently (mirrors staffVoteTotalByScenario)', () => {
|
||
const aggregate = createEmptyMunicipalityPledgeAggregate()
|
||
aggregate.effectiveByScenario.pessimistic = 100
|
||
aggregate.effectiveByScenario.central = 200
|
||
aggregate.effectiveByScenario.optimistic = 300
|
||
|
||
const byScenario = computeGoalCoverageByScenario(
|
||
{ pessimistic: 500, optimistic: 900 },
|
||
600, // suggestedGoal fallback used only for 'central' (unset in expectedVotes)
|
||
aggregate,
|
||
)
|
||
|
||
expect(byScenario.pessimistic.goal).toBe(500)
|
||
expect(byScenario.pessimistic.committed).toBe(100)
|
||
expect(byScenario.central.goal).toBe(600) // falls back to suggestedGoal
|
||
expect(byScenario.central.committed).toBe(200)
|
||
expect(byScenario.optimistic.goal).toBe(900)
|
||
expect(byScenario.optimistic.committed).toBe(300)
|
||
})
|
||
})
|
||
|
||
describe('goal coverage labels', () => {
|
||
it('renders a fractional decomposed goal as whole votes', () => {
|
||
// A suggested goal of 100.968 votes must not read as "100,968" in pt-BR.
|
||
const aggregate = createEmptyMunicipalityPledgeAggregate()
|
||
const coverage = computeGoalCoverage(null, 100.968, aggregate, 'central')
|
||
expect(formatGoalCoverageDeficitLabel(coverage)).toBe('Faltam 101 votos para a meta')
|
||
})
|
||
})
|
||
|
||
describe('aggregateGoalCoverage', () => {
|
||
it('sums goal and committed across municipalities and recomputes the ratio', () => {
|
||
const aggregate = aggregateGoalCoverage([
|
||
{ goal: 3000, committed: 1200, coverageRatio: 0.4, deficit: 1800 },
|
||
{ goal: 1000, committed: 1000, coverageRatio: 1, deficit: 0 },
|
||
])
|
||
expect(aggregate.goal).toBe(4000)
|
||
expect(aggregate.committed).toBe(2200)
|
||
expect(aggregate.coverageRatio).toBeCloseTo(0.55, 6)
|
||
expect(aggregate.deficit).toBe(1800)
|
||
})
|
||
|
||
it('returns coverageRatio null for an empty list (zero goal)', () => {
|
||
expect(aggregateGoalCoverage([]).coverageRatio).toBeNull()
|
||
})
|
||
})
|