teqo-backup/scripts/lib/dossieBulletin.mjs

/**
 * Boletim model (owner: C186; unit seam C187): one A4 page, voter-facing. It
 * reads ONLY the `bulletinFacts` ledger produced by `buildDossierReport` — every
 * fact there already carries a source, so the boletim cannot introduce a new
 * fact. No sources are printed (they live in the dossiê).
 */

import { formatDateTimeBr } from './cityReportFormat.mjs'
import { dossierPhaseLabel, dossierSphereLabel } from './dossieBlocks.mjs'
import { BULLETIN_TIMELINE_STEPS } from './dossieCareer.mjs'
import { resolveDossierUnit } from './dossieUnit.mjs'

export const BULLETIN_HIGHLIGHT_LIMIT = 6
const BULLETIN_MORE_LIMIT = 14

const eraRank = { C: 0, B: 1, A: 2 }

const rankFacts = (facts, unit) => {
  const sphereRank = resolveDossierUnit(unit).breadthRank ?? {}
  return [...facts].sort((left, right) => {
    const sphere = (sphereRank[left.sphere] ?? 9) - (sphereRank[right.sphere] ?? 9)
    if (sphere !== 0) return sphere
    const hasValue = (left.value ? 0 : 1) - (right.value ? 0 : 1)
    if (hasValue !== 0) return hasValue
    const era = (eraRank[left.era] ?? 9) - (eraRank[right.era] ?? 9)
    if (era !== 0) return era
    return String(left.id).localeCompare(String(right.id))
  })
}

/**
 * @param {{
 *   facts?: Array<{ id: string, era: string, sphere: string, area: string, headline: string, detail: string|null, value: string|null, year: string|null, phase: string|null, sourceUrl: string, sourceDate: string }>,
 *   municipality?: string,
 *   region?: string | null,
 *   identity?: { name: string, badges?: string[] } | null,
 *   unit?: any,
 *   generatedAt?: Date,
 * }} params
 */
export const buildBulletin = ({
  facts = [],
  municipality = null,
  region = null,
  identity = null,
  unit,
  generatedAt = new Date(),
}) => {
  const resolvedUnit = resolveDossierUnit(unit)
  const ordered = rankFacts(facts, resolvedUnit)
  const subjectName = municipality ?? identity?.name ?? '—'
  const highlights = ordered.slice(0, BULLETIN_HIGHLIGHT_LIMIT).map((fact) => {
    // Theme-only fallback: a fact without money value shows its year; without
    // either, the card is textual and prints no number slot at all (never zero).
    const number = resolvedUnit.bulletinNumberFallback
      ? (fact.value ?? fact.year ?? null)
      : fact.value
    return {
      eyebrow: `${fact.area ?? 'Atuação'} · ${dossierSphereLabel(fact.sphere, resolvedUnit)}`,
      number,
      ...(resolvedUnit.bulletinNumberFallback && !number ? { textual: true } : {}),
      title: fact.brief?.title ?? fact.headline,
      note: fact.brief?.note ?? fact.detail ?? null,
      phase: fact.value ? (fact.phase ?? null) : null,
      phaseLabel: fact.value ? dossierPhaseLabel(fact.phase) : null,
    }
  })
  const moreItems = ordered
    .slice(
      BULLETIN_HIGHLIGHT_LIMIT,
      BULLETIN_HIGHLIGHT_LIMIT + (resolvedUnit.bulletinMoreLimit ?? BULLETIN_MORE_LIMIT),
    )
    .map((fact) => ({
      label: fact.brief?.title ?? fact.headline,
      detail: fact.brief?.note ?? fact.detail ?? fact.value ?? fact.area,
    }))
  const shown = highlights.length + moreItems.length

  return {
    unit: resolvedUnit,
    sparse: ordered.length < 3,
    meta: {
      title: resolvedUnit.bulletinTitle,
      kicker: resolvedUnit.bulletinKicker ?? 'Boletim informativo · atuação pública',
      subjectName,
      municipality: subjectName,
      region,
      identity,
      identityBadges: identity?.badges ?? [],
      identityPills:
        resolvedUnit.bulletinPills && identity ? resolvedUnit.bulletinPills(identity) : null,
      generatedAt,
      generatedAtLabel: formatDateTimeBr(generatedAt),
      modelLabel: 'Modelo — insumo interno',
    },
    highlights,
    moreItems,
    // Never a silent drop (C188): the facts beyond the two caps are counted so
    // the one-page boletim states how much of the sourced set it left out.
    factsTotal: ordered.length,
    factsRemaining: ordered.length - shown,
    timeline: BULLETIN_TIMELINE_STEPS,
  }
}