teqo/tests/unit/campaignIntelligenceConcepts.unit.spec.ts
Francisco Ignácio Fontoura Solla 9443a4e1f6 E18: documentação de conceitos de inteligência de campanha
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).
2026-07-25 01:37:37 -03:00

82 lines
2.9 KiB
TypeScript

// @vitest-environment node
import { describe, expect, it } from 'vitest'
import {
getCampaignBottomNav,
getCampaignNav,
getCampaignSecondaryNav,
} from '@/components/campaign/nav'
import {
CAMPAIGN_CONCEPT_CATEGORIES,
CAMPAIGN_CONCEPTS_PATH,
campaignConceptHref,
campaignConceptsByCategory,
campaignIntelligenceConcepts,
} from '@/lib/campaignIntelligenceConcepts'
/**
* The concept ids are URL anchors linked from tooltips across `/campanha`
* (`campaignConceptHref`), so a duplicate or anchor-unsafe id ships a dead
* "Saiba mais" link. Every concept must also belong to a rendered category —
* otherwise the page silently drops it.
*/
describe('campaignIntelligenceConcepts', () => {
it('has unique, anchor-safe ids', () => {
const ids = campaignIntelligenceConcepts.map((concept) => concept.id)
expect(new Set(ids).size).toBe(ids.length)
for (const id of ids) {
expect(id).toMatch(/^[a-z0-9-]+$/)
}
})
it('assigns every concept to a rendered category', () => {
const categoryIDs = new Set(CAMPAIGN_CONCEPT_CATEGORIES.map((category) => category.id))
for (const concept of campaignIntelligenceConcepts) {
expect(categoryIDs).toContain(concept.categoryID)
}
const grouped = CAMPAIGN_CONCEPT_CATEGORIES.flatMap((category) =>
campaignConceptsByCategory(category.id),
)
expect(grouped).toHaveLength(campaignIntelligenceConcepts.length)
})
it('documents what each number measures, how it is calculated, and where it shows up', () => {
for (const concept of campaignIntelligenceConcepts) {
expect(concept.title.length).toBeGreaterThan(0)
expect(concept.oneLiner.length).toBeGreaterThan(0)
expect(concept.formula.length).toBeGreaterThan(0)
expect(concept.whyItMatters.length).toBeGreaterThan(0)
expect(concept.whereItAppears.length).toBeGreaterThan(0)
}
})
it('builds anchor hrefs into the concepts page', () => {
expect(campaignConceptHref('cobertura-da-meta')).toBe('/campanha/conceitos#cobertura-da-meta')
})
})
/**
* The sidebar entry is the only always-visible way in, so it carries the same
* staff-only rule as the route itself — a `leader` offered the link would just
* be bounced back to `/campanha`.
*/
describe('concepts sidebar entry', () => {
it('is offered to staff and hidden from leaders', () => {
expect(getCampaignSecondaryNav('coordinator').map((item) => item.href)).toEqual([
CAMPAIGN_CONCEPTS_PATH,
])
expect(getCampaignSecondaryNav('advisor')).not.toHaveLength(0)
expect(getCampaignSecondaryNav('candidate')).not.toHaveLength(0)
expect(getCampaignSecondaryNav('leader')).toHaveLength(0)
})
it('stays out of the work destinations and the mobile bottom bar', () => {
const hrefs = [
...getCampaignNav('coordinator'),
...getCampaignBottomNav('coordinator'),
].map((item) => item.href)
expect(hrefs).not.toContain(CAMPAIGN_CONCEPTS_PATH)
})
})