Change to 2024 Gatineau Actuals

Author: jclarkin

data/gatineau/README.md

@@ -1,6 +1,6 @@
-# Gatineau Budget Data
+# Gatineau Financial Actuals Data
 
-Scripts and data for extracting and processing Gatineau's municipal budget data.
+Extract and process Gatineau's municipal financial actuals (consolidated accounting actuals, not budgeted projections).
 
 ## Setup
 
@@ -12,54 +12,44 @@ pip install -r data/gatineau/scripts/requirements.txt
 
 ## Usage
 
-### Full Workflow
+**Full workflow:**
 
 ```bash
 export OPENAI_API_KEY='your-key-here'
-python3 data/gatineau/scripts/processor.py \
-  --year 2025 \
-  --pdf-url "https://www.gatineau.ca/..." \
-  --extract
+python3 data/gatineau/scripts/processor.py --year 2024 --pdf-url "https://..." --extract
 ```
 
-### Step-by-Step
-
-**Download PDF:**
+**Extract only (PDF already downloaded):**
 
 ```bash
-python3 data/gatineau/scripts/processor.py --year 2025 --pdf-url "https://..."
+export OPENAI_API_KEY='your-key-here'
+python3 data/gatineau/scripts/processor.py --year 2024 --extract
 ```
 
-**Extract Data (requires API key):**
+**Convert only (markdown already exists):**
 
 ```bash
-export OPENAI_API_KEY='your-key-here'
-python3 data/gatineau/scripts/processor.py --year 2025 --extract
+python3 data/gatineau/scripts/processor.py --year 2024
 ```
 
-**Or Extract Manually:**
+**Manual extraction:**
 
-1. Open `raw/Gatineau Budget <year>.pdf`
+1. Open `raw/Gatineau Consolidated Financial Report <year>.pdf`
 2. Use prompt from `llm_prompt.txt` with your LLM
 3. Save output to `extracted/<year>/llm_extracted.md`
-
-**Convert to JSON:**
-
-```bash
-python3 data/gatineau/scripts/processor.py --year 2025
-```
+4. Run converter: `python3 data/gatineau/scripts/processor.py --year 2024`
 
 ## Output
 
-- `sankey.json` - Hierarchical budget data for visualization
+- `sankey.json` - Hierarchical financial data for visualization
 - `summary.json` - Metadata, metrics, and ministry breakdowns
 
 ## Data Format
 
-Extracted markdown must include:
+Markdown must include:
 
-- `## Key Metrics – <year>` section (population, employees, debt, property tax)
-- `## Revenues – <year>` section with nested bullets
-- `## Expenses – <year>` section with nested bullets
+- `## Key Metrics – <year>` (population, employees, debt, property tax)
+- `## Revenues – <year>` (nested bullets with amounts)
+- `## Expenses – <year>` (nested bullets with amounts)
 
-All amounts in thousands of dollars (`k$`). See `llm_prompt.txt` for full specification.
+All amounts must be in full dollars (e.g., `$123,456,789`), not thousands. See `llm_prompt.txt` for full specification.

data/gatineau/extracted/2024/llm_extracted.md

@@ -0,0 +1,302 @@
+## Key Metrics – 2024
+
+- Total employees – **2988**
+- Net debt – **$183,329,026**
+- Total debt – **$801,035,832**
+- Debt interest – **$28,845,149**
+- Property tax revenue – **$552,969,088**
+
+---
+
+## Revenues – 2024
+
+- **Taxes**
+  - Sur la valeur foncière (property taxes)
+    - Taxe foncière générale – **$430,477,805**
+    - Service de la dette – **$44,420,694**
+    - Activités de fonctionnement – **$77,307,949**
+    - Secteurs – Service de la dette – **$762,640**
+    - **Total Sur la valeur foncière – $552,969,088**
+
+  - Sur une autre base
+    - Eau – **$4,907,769**
+    - Matières résiduelles – **$22,981,335**
+    - Centres d'urgence 9-1-1 – **$1,759,931**
+    - Service de la dette – **$6,041,502**
+    - Pouvoir général de taxation – **$1,506,965**
+    - **Total Sur une autre base – $37,197,502**
+
+  - **Total Taxes – $590,166,590**
+
+- **Compensations tenant lieu de taxes**
+  - Gouvernement du Québec et ses entreprises
+    - Immeubles et établissements provinciaux – **$3,651,319**
+    - Immeubles de la SQI – **$86,037**
+    - Santé et services sociaux – **$6,234,414**
+    - Cégeps et universités – **$3,852,988**
+    - Écoles primaires et secondaires – **$10,218,115**
+    - **Total Gouvernement du Québec – $24,042,873**
+
+  - Gouvernement du Canada et ses entreprises
+    - Taxes sur la valeur foncière – **$52,863,770**
+    - **Total Gouvernement du Canada – $52,863,770**
+
+  - **Total Compensations tenant lieu de taxes – $76,906,643**
+
+- **Transferts**
+  - Transferts relatifs à des ententes de partage des frais et autres transferts – fonctionnement
+    - Sécurité publique
+      - Autres – **$2,011,705**
+    - Transport
+      - Réseau routier
+        - Voirie municipale – **$469,281**
+        - Enlèvement de la neige – **$96,622**
+      - Transport collectif
+        - Transport en commun – transport régulier – **$32,794,916**
+        - Transport en commun – transport adapté – **$3,614,299**
+    - Hygiène du milieu
+      - Eau et égout
+        - Approvisionnement et traitement de l'eau potable – **$1,050,408**
+        - Réseau de distribution de l'eau potable – **$308,282**
+        - Traitement des eaux usées – **$1,421,049**
+        - Réseaux d'égout – **$1,895,978**
+        - **Total Eau et égout – $4,675,717**
+      - Matières résiduelles
+        - Déchets domestiques et assimilés – **$5,030,565**
+        - Matières recyclables – Collecte sélective
+          - Collecte et transport – **$17,191,391**
+          - Tri et conditionnement – **$3,033,775**
+        - **Total Matières résiduelles – $25,255,731**
+    - Aménagement, urbanisme et développement
+      - Aménagement, urbanisme et zonage – **$125,550**
+      - Rénovation urbaine – **($1,732)**
+      - Promotion et développement économique – **$2,156,916**
+      - Autres – **$2,413,871**
+      - **Total Aménagement, urbanisme et développement – $4,694,605**
+    - Loisirs et culture
+      - Activités récréatives – **$1,390,394**
+      - Activités culturelles
+        - Bibliothèques – **$1,151,879**
+        - Autres – **$1,849,532**
+      - **Total Loisirs et culture – $4,391,805**
+    - **Total Transferts – fonctionnement – $78,004,681**
+
+  - Transferts – investissement (subsidies for capital projects)
+    - Sécurité publique
+      - Police – **$617,253**
+      - Sécurité civile – **$222,217**
+    - Transport
+      - Réseau routier
+        - Autres – **($692,293)**
+      - Transport collectif
+        - Transport en commun – transport régulier – **$30,894,166**
+    - Hygiène du milieu
+      - Eau et égout
+        - Approvisionnement et traitement de l'eau potable – **$16,354,902**
+        - Réseau de distribution de l'eau potable – **$6,585,695**
+        - Traitement des eaux usées – **$22,097,568**
+        - Réseaux d'égout – **$6,585,695**
+      - Matières résiduelles
+        - Déchets domestiques et assimilés – **$274,999**
+      - Protection de l'environnement – **$1,763,713**
+    - Loisirs et culture
+      - Activités récréatives – **$3,432,427**
+      - Activités culturelles
+        - Bibliothèques – **$2,094,935**
+        - Autres – **$4,122,008**
+    - **Total Transferts – investissement – $94,353,285**
+
+  - Transferts de droit
+    - Partage de la croissance d'un point de TVQ – **$14,939,620**
+    - **Total Transferts de droit – $14,939,620**
+
+  - **Total Transferts – $187,297,586**
+
+- **Services rendus**
+  - Services rendus aux organismes municipaux
+    - Transport – Voirie municipale – **$5,849**
+    - Hygiène du milieu – Déchets domestiques et assimilés – **$22,887**
+    - Loisirs et culture – Activités récréatives – **$523,755**
+    - Loisirs et culture – Autres – **$9,239,014**
+    - **Total Services rendus aux organismes municipaux – $9,791,505**
+
+  - Autres services rendus
+    - Administration générale – Autres – **$2,238,219**
+    - Sécurité publique
+      - Police – **$1,218,965**
+      - Sécurité incendie
+        - Autres – **$781,284**
+      - Sécurité civile – **$4,472,292**
+    - Transport
+      - Réseau routier
+        - Voirie municipale – **$1,797,023**
+        - Enlèvement de la neige – **$113,618**
+      - Transport collectif
+        - Transport régulier – **$33,987,254**
+        - Transport adapté – **$574,679**
+      - Autres – **$4,913,441**
+      - **Total Transport – $41,386,015**
+    - Hygiène du milieu
+      - Eau et égout
+        - Approvisionnement et traitement de l'eau potable – **$180,415**
+        - Réseau de distribution de l'eau potable – **$83,494**
+        - Traitement des eaux usées – **$347,818**
+        - **Total Eau et égout – $611,727**
+      - Matières résiduelles
+        - Déchets domestiques et assimilés – **$2,403,831**
+        - Matières recyclables – **$404,871**
+        - **Total Matières résiduelles – $2,808,702**
+      - Autres – **$397,497**
+      - **Total Hygiène du milieu – $3,817,926**
+    - Aménagement, urbanisme et développement
+      - Aménagement, urbanisme et zonage – **$442,432**
+      - Rénovation urbaine – **$302,577**
+      - Autres – **$7,239**
+      - **Total Aménagement, urbanisme et développement – $752,248**
+    - Loisirs et culture
+      - Activités récréatives – **$5,316,041**
+      - Activités culturelles
+        - Bibliothèques – **$163,788**
+        - Autres – **$583,167**
+      - **Total Loisirs et culture – $6,062,996**
+    - **Total Autres services rendus – $60,729,945**
+
+  - **Total Services rendus – $70,521,450**
+
+- **Imposition de droits**
+  - Licences et permis – **$8,613,791**
+  - Droits de mutation immobilière – **$63,338,747**
+  - **Total Imposition de droits – $71,952,538**
+
+- **Amendes et pénalités**
+  - Amendes et pénalités – **$10,626,320**
+
+- **Revenus de placements de portefeuille**
+  - Revenus de placements – **$23,007,327**
+
+- **Autres revenus d'intérêts**
+  - Autres revenus d'intérêts – **$4,823,683**
+
+- **Autres revenus**
+  - Gain sur cession d'immobilisations corporelles – **$4,608,973**
+  - Produit de cession de propriétés destinées à la revente – **$1,698,886**
+  - Contributions des promoteurs – **$13,017,800**
+  - Autres revenus divers – **$8,599,998**
+  - **Total Autres revenus – $27,925,657**
+
+- **Total Revenues – $1,063,227,794**
+
+---
+
+## Expenses – 2024
+
+- **Administration générale**
+  - Conseil – **$8,057,169**
+  - Greffe et application de la loi – **$16,908,701**
+  - Gestion financière et administrative – **$65,089,688**
+  - Évaluation – **$6,661,501**
+  - Gestion du personnel – **$18,311,972**
+  - Communications et autres – **$19,344,454**
+  - **Total Administration générale – $134,373,485**
+
+- **Sécurité publique**
+  - Police – **$98,188,014**
+  - Sécurité incendie
+    - Autres – **$55,562,994**
+  - Sécurité civile – **$1,015,893**
+  - Autres sécurité publique – **$13,687,505**
+  - **Total Sécurité publique – $168,454,406**
+
+- **Transport**
+  - Réseau routier
+    - Voirie municipale – **$53,079,471**
+    - Enlèvement de la neige – **$34,779,230**
+    - Éclairage des rues – **$4,481,225**
+    - Circulation et stationnement – **$6,088,164**
+    - **Total Réseau routier – $98,428,090**
+
+  - Transport collectif
+    - Transport en commun – **$151,150,246**
+    - Transport aérien – **$3,252,550**
+    - Autres transports – **$1,085,678**
+    - **Total Transport collectif – $155,488,474**
+
+  - **Total Transport – $253,916,564**
+
+- **Hygiène du milieu**
+  - Eau et égout
+    - Approvisionnement et traitement de l'eau potable – **$19,385,189**
+    - Réseau de distribution de l'eau potable – **$15,824,533**
+    - Traitement des eaux usées – **$11,225,344**
+    - Réseaux d'égout – **$26,398,196**
+    - **Total Eau et égout – $72,833,262**
+
+  - Matières résiduelles
+    - Déchets domestiques – collecte et transport – **$9,390,066**
+    - Élimination – **$7,092,924**
+    - Matières recyclables – collecte et transport – **$11,069,623**
+    - Matières organiques – collecte et transport – **$4,632,017**
+    - Matières organiques – traitement – **$2,753,448**
+    - Matériaux secs – **$5,522,560**
+    - Plan de gestion – **$9,651,882**
+    - Autres – **$8,354,850**
+    - **Total Matières résiduelles et organiques – $58,467,370**
+
+  - Protection de l'environnement et autres
+    - Protection de l'environnement – **$7,847,261**
+    - Autres hygiène du milieu – **$6,569,288**
+    - **Total Protection et autres – $14,416,549**
+
+  - **Total Hygiène du milieu – $145,717,181**
+
+- **Santé et bien-être**
+  - Habitation – Logement social – **$3,801,496**
+  - Autres programmes sociaux – **$3,998,047**
+  - **Total Santé et bien-être – $7,799,543**
+
+- **Aménagement, urbanisme et développement**
+  - Aménagement, urbanisme et zonage – **$19,994,601**
+  - Biens patrimoniaux – **$345,615**
+  - Autres biens – **$3,641,129**
+  - Promotion et développement économique
+    - Industries et commerces – **$5,273,541**
+    - Tourisme – **$651,137**
+    - **Total Promotion et développement économique – $5,924,678**
+  - Autres promotion/développement – **$4,323,556**
+  - Autres aménagement et urbanisme – **$3,364,422**
+  - **Total Aménagement, urbanisme et développement – $37,594,001**
+
+- **Loisirs et culture**
+  - Activités récréatives
+    - Centres communautaires – **$38,731,350**
+    - Patinoires – **$10,060,587**
+    - Piscines, plages et ports de plaisance – **$8,688,615**
+    - Parcs et terrains de jeux – **$24,550,264**
+    - Expositions et foires – **$7,008,790**
+    - **Total Activités récréatives – $89,039,606**
+
+  - Activités culturelles
+    - Centres communautaires – **$7,020,082**
+    - Bibliothèques – **$13,765,220**
+    - Musées et centres d'exposition – **$506,067**
+    - Autres ressources patrimoniales – **$401,221**
+    - Autres culture – **$12,156,928**
+    - **Total Activités culturelles – $33,849,518**
+
+  - **Total Loisirs et culture – $122,889,124**
+
+- **Frais de financement**
+  - Intérêts et autres frais sur la dette à long terme – organisme municipal – **$26,156,846**
+  - Autres frais – **$1,222,400**
+  - Avantages sociaux futurs – **($358,000)**
+  - Autres frais de financement – **$1,823,903**
+  - **Total Frais de financement – $28,845,149**
+
+- **Total Expenses – $899,589,453**
+
+---
+
+## Surplus/Deficit Calculation
+
+**Total Surplus = Total Revenues – Total Expenses**
+**Total Surplus = $1,063,227,794 – $899,589,453 = $163,638,341**