CAPAG Funder Scan — Unlock the Money hackday

events/2026-06-11-unlock-the-money/apps/capag-funder-scan/.cursor/rules/citycatalyst-style.mdc

@@ -0,0 +1,52 @@
+---
+description: Match the CityCatalyst design system and stack in this app
+globs: "**"
+---
+
+# CityCatalyst conventions for capag-funder-scan
+
+This app mirrors the CityCatalyst frontend stack so it can graduate into a CC feature.
+
+## Stack (same as CityCatalyst `app/`)
+- **Chakra UI v3** (`@chakra-ui/react` + `@emotion/react`) — no Tailwind, no other UI libs
+- Chakra v3 composite API: `Table.Root/Header/Row/Cell`, `NativeSelect.Root/Field`, `ChakraProvider value={system}`
+- Fonts: **Poppins** (headings) + **Open Sans** (body), wired as CSS vars `--font-poppins` / `--font-opensans` via `next/font`
+
+## Theme
+`src/lib/theme.ts` is a trimmed copy of CityCatalyst's blue_theme tokens
+(source of truth: `CityCatalyst/app/src/lib/theme/recipes/app-theme.ts`):
+
+- `content.alternative` #001EA7 (headings), `content.link` #2351DC, `content.primary` #00001F,
+  `content.secondary` #232640, `content.tertiary` #7A7B9A
+- `background.default` #FFFFFF, `background.neutral` #E8EAFB (page bg), `background.overlay` #C5CBF5
+- `border.neutral` #D7D8FA
+- `rating.*` — CAPAG tier colors, derived from CC sector palette
+
+Always reference tokens (`color="content.tertiary"`), never raw hex in components.
+
+## Data
+- CAPAG: `data/capag.json` + `data/crosswalk.json` (regenerate with `scripts/*.py`, see README)
+- CityCatalyst Global API patterns: see `research/data-access.md` — locodes are URL-encoded with
+  the space (`BR%20POA`); CCRA needs the scenario segment (`/current`)
+
+## i18n (EN / PT-BR)
+Mirrors CityCatalyst's i18next + react-i18next setup (`src/i18n/settings.ts`, `client.ts`,
+`locales/{en,pt}/translation.json`). Two deliberate deviations for this single-route app:
+static `resources` instead of `resourcesToBackend` lazy import, and no `LanguageDetector` at
+init — server + first paint render `en`, then `LanguageToggle` applies the stored language in a
+mount effect (avoids hydration mismatch; same idea as next-themes).
+
+Rules:
+- All user-facing strings go through `t("key")`; never hardcode copy in components.
+- Keys are flat dotted strings, so init sets `keySeparator: false` / `nsSeparator: false`.
+- Numbers: use `{{count, number}}` (i18next built-in Intl formatter, locale-aware: pt-BR `5.566`).
+- The recommendation engine (`lib/recommend.ts`) returns i18n keys + vars, not prose, so EN/PT
+  both render from the same logic. Hazard-name vars are themselves `hazard.*` keys, resolved in
+  `CityPanel.renderLine` before interpolation.
+- Audience is Brazilian funders — keep PT-BR fiscal terminology exact (Endividamento, Poupança
+  Corrente, Liquidez Relativa, garantia federal).
+
+## If you add components
+Check CityCatalyst `app/src/components/` first and copy/adapt rather than inventing new patterns
+(e.g. tables, cards, tags). Local checkout lives at `work/oef/citycatalyst/repo` on Joaquin's machine;
+otherwise https://github.com/Open-Earth-Foundation/CityCatalyst/tree/develop/app

events/2026-06-11-unlock-the-money/apps/capag-funder-scan/.gitignore

@@ -0,0 +1,4 @@
+node_modules/
+.next/
+data/capag-latest.xlsx
+data/risks.jsonl

events/2026-06-11-unlock-the-money/apps/capag-funder-scan/README.md

@@ -0,0 +1,74 @@
+# CAPAG Funder Scan
+
+> Brazil's Treasury rates every municipality's creditworthiness. CityCatalyst knows every municipality's emissions, climate risks, and priority actions. Nobody has ever joined the two — until now.
+
+## Team
+
+| Name | Role |
+|------|------|
+| Joaquin van Peborgh | Dev / Data |
+| Carole Viaene | Research / Funder angle |
+
+## What We're Building
+
+A funder-facing scan of all 5,570 Brazilian municipalities that overlays **CAPAG fiscal capacity ratings** (Tesouro Nacional) with **CityCatalyst climate data** (emissions, climate risk, prioritized actions) — so climate funders like BNDES/CCFLA can segment the market and design the right instrument per city:
+
+- **CAPAG A/B** (2,236 cities) → bankable: traditional credit lines + federal guarantees
+- **CAPAG C** (2,316 cities) → locked out of federal credit → grant-first / blended finance
+- **n.d.** (841 cities) → not even rated (broken accounting) → technical assistance first
+
+## Revenue Connection
+
+Funders' hardest question — "can this city actually absorb and repay climate finance?" — answered at a glance, powered by CityCatalyst data. OEF becomes the trust layer in the deal flow: screening for BNDES/CCFLA, premium scan + per-city investment briefs as a CityCatalyst feature.
+
+## Status
+
+- ✅ Deep research on CAPAG (see `research/` — reusable by other teams)
+- ✅ ETL: latest Treasury XLSX → `data/capag.json` (5,568 municipalities, ratings + sub-indicators + ICF)
+- ✅ Crosswalk: CAPAG (IBGE) ↔ CityCatalyst (LOCODE) via CCRA BR city list — **99.96% match** (5,566/5,568)
+- ✅ Coverage probe: SEEG emissions + CCRA risk verified live for sampled cities in **every** CAPAG tier (32/32)
+- ⏳ Product build
+
+## How to Run
+
+```bash
+cd events/2026-06-11-unlock-the-money/apps/capag-funder-scan
+
+# data pipeline
+python3 scripts/fetch_capag.py          # Treasury XLSX → data/capag.json
+python3 scripts/probe_citycatalyst.py   # crosswalk + coverage report
+python3 scripts/fetch_risks.py          # national CCRA snapshot → data/risks.json
+python3 scripts/fetch_centroids.py      # IBGE centroids → data/centroids.json
+python3 scripts/fetch_projects.py       # funded LatAm projects → data/projects.json
+
+# app
+npm install
+npm run dev
+# Open http://localhost:3000
+```
+
+## Demo Script (5 min)
+
+1. [Problem: funders can't tell which Brazilian cities can absorb climate capital]
+2. [The scan: 5,570 municipalities, CAPAG tier × climate signal]
+3. [The "aha": 2,316 creditless C-cities with high climate need = the blended-finance market nobody can see]
+4. [Revenue: screening service for BNDES/CCFLA, premium CityCatalyst feature]
+5. [Next: per-city investment briefs, Siconfi live recomputation]
+
+## Built With
+
+- Cursor + Claude
+- Next.js / React
+- Tesouro Transparente CKAN (CAPAG, ODbL) · CityCatalyst Global API (SEEG + SINIR + SNIS + EPE merged inventory, CCRA risk)
+- Chakra UI v3 with CityCatalyst design tokens (see `.cursor/rules/citycatalyst-style.mdc`)
+- i18next (EN / PT-BR), CityCatalyst's i18n stack — toggle in the nav, full Portuguese for the Brazilian funder audience
+
+## What We Learned
+
+See `research/` — full verified findings on CAPAG methodology, data access, and gotchas.
+
+## If This Survives the Hackday
+
+- [ ] Per-city investment brief generator (CCFLA direct ask)
+- [ ] HIAP prioritized actions in the overlay
+- [ ] Live CAPAG recomputation from Siconfi API (TCE-ES-style, national)