PolicyEngine / PolicyEngine/chronicle

Add Iriscare Brussels family-allowance facts

Open
#216 0 comments 0 reactions 0 assignees View on GitHub

Nobody has claimed this yet.

Dominant language
Python
Stars
0
Forks
1
Avg merge
11h 48m
Merged PRs (30d)
45

Description

Refs #69.

Source gap

Chronicle has no direct Iriscare or Famiris post-2019 Brussels child-benefit
package containing both caseload and expenditure. The official interactive
statistics are not safe to transcribe, and preliminary inspection of the
official annual report found more than one expenditure occurrence that must be
distinguished by publisher scope rather than silently reconciled.

Deterministic handoff

Retrieve the official Iriscare 2024 annual-report PDF through the Iriscare entry
in FETCH-MANIFEST-BELGIUM-PUBLIC-FACTS.json:

https://rapport.iriscare.brussels/wp-content/uploads/2025/09/Rapport-annuel-2024.pdf

The official statistics pages may be used only if a separate reviewed handoff
pins their native Fabric export bytes; screenshots and copied dashboard text
are not artifacts.

Acceptance criteria

  • Pin the unchanged official PDF with exact URL, SHA-256, size, publication
    vintage, table/page references, and content-addressed raw-storage pointer.
  • Parse the full PDF deterministically. If multiple publisher cells differ,
    emit separately labelled facts only when their accounting populations/scopes
    are explicit; otherwise document the ambiguity and omit the values.
  • Preserve exact Brussels administrative/geographic scope, reference period,
    recipient unit, currency, scale, and assertion. Do not combine funds, infer a
    regional total, reconcile values, or compute per-recipient amounts.
  • Run validate-package, source-cell preservation, fact-load,
    consumer-artifact, raw-facts-boundary, ruff, and git diff --check checks.

Contributor guide

Open the contributing guide

First steps

  1. Read the whole issue, then the project's contributing guide.
  2. Comment on the issue to say you are picking it up — it saves two people doing the same work.
  3. Fork the repository and make your change on a branch.
  4. Open a pull request that references the issue number.

Research direction

Start with the Iriscare entry in FETCH-MANIFEST-BELGIUM-PUBLIC-FACTS.json and retrieve the linked 2024 annual-report PDF. Parse the full PDF while preserving source cells and recording scope, periods, units, and page references; omit ambiguous values. Run validate-package, source-cell preservation, fact-load, consumer-artifact, raw-facts-boundary, ruff, and git diff --check; done means all checks pass and the unchanged PDF is pinned with its metadata and raw-storage pointer.

Written by the indexing model from the issue text.

Assessment

Tech stack
python
Domain
data
Issue type
Feature
Difficulty
4/5
Estimated time
3-5 days
Activity status
Active
Clarity
Mostly clear
Newbie friendliness
55/100

Get new issues in your inbox

A short digest of beginner-friendly GitHub issues.