API: currency prefix + formatted_short, home lists with population filter and fastest GDP growth, registry cache invalidation per snapshot
Co-Authored-By: Claude Fable 5.1 <noreply@anthropic.com>
1 changed file +12 −5
modified
docs/API.md
+12 −5
@@ -146,9 +146,10 @@ Two-word combos such as `housing canada` or `canada gdp` also return `country_to | |||||
| 146 | ``` | 146 | ``` | ||
| 147 | GET /home | 147 | GET /home | ||
| 148 | ``` | 148 | ``` | ||
| 149 | −`snapshot` (world population / GDP sums, median life expectancy, counts, built_at), `lists` (largest economies, fastest population growth | 149 | +`snapshot` (world population / GDP sums, median life expectancy, counts, built_at), `lists` (largest economies; fastest GDP growth, | ||
| 150 | −among countries > 1 M, highest life expectancy, energy transition leaders, highest GDP per capita PPP, lowest unemployment among countries | 150 | +fastest population growth, highest life expectancy and energy transition leaders among countries ≥ 1 M; highest GDP per capita PPP; | ||
| 151 | −> 5 M; 8 rows each with provenance), `recent_changes` (12 most severe), `recently_updated`, `featured_indicators`, `trending`. | 151 | +lowest unemployment among countries ≥ 5 M — 8 rows each with provenance, `filter_note`), `recent_changes` (12 most severe), | ||
| 152 | +`recently_updated`, `featured_indicators`, `trending`. | ||||
| 152 | 153 | ||||
| 153 | ### Changes, sources, methodology | 154 | ### Changes, sources, methodology | ||
| 154 | ``` | 155 | ``` | ||
@@ -182,5 +183,11 @@ POST /admin/cache/clear | |||||
| 182 | close must happen first). Responses are cached in-process per `(run_id, path, query)`; nothing survives a new run id. | 183 | close must happen first). Responses are cached in-process per `(run_id, path, query)`; nothing survives a new run id. | ||
| 183 | * **Performance** (real snapshot, 2.0 M observations): country overview ≈ 12 ms warm (≈ 170 ms on the very first request while static | 184 | * **Performance** (real snapshot, 2.0 M observations): country overview ≈ 12 ms warm (≈ 170 ms on the very first request while static | ||
| 184 | lookups load), rankings ≈ 20 ms, home ≈ 33 ms, map ≈ 4 ms, cached hits ≈ 1 ms. | 185 | lookups load), rankings ≈ 20 ms, home ≈ 33 ms, map ≈ 4 ms, cached hits ≈ 1 ms. | ||
| 185 | −* **Formatting**: `formatted` strings use the indicator's `format`: currency/number compact (`53.4k`, `1.2T`), percent `3.4 %`, years | 186 | +* **Formatting**: `formatted` strings use the indicator's `format`: currency compact with the registry `unit_short` prefix | ||
| 186 | − `82.1 yrs`, tonnes `5.2 t`, per-1000 `3.2 per 1,000`, per-100k `1.2 per 100k`. | 187 | + (`US$53.4k`, `US$1.2T`, `intl $45.3B`), number compact (`41.7M`), percent `3.4 %`, years `82.1 yrs`, tonnes `5.2 t`, per-1000 | ||
| 188 | + `3.2 per 1,000`, per-100k `1.2 per 100k`. `formatted_short` is the same value without prefix/unit (`53.4k`, `3.4`) for tight cells. | ||||
| 189 | +* **Registry reloads**: the headline list (`topics.yaml`), indicator metadata and groups are re-read from the YAML registry each time a | ||||
| 190 | + new snapshot run id is opened (the loaders' `lru_cache` is cleared), so registry edits take effect with the next build. | ||||
| 191 | +* **Home lists**: each curated list carries `min_population` and `filter_note` (e.g. `"Countries above 1M inhabitants"`) when a | ||||
| 192 | + population floor applies (fastest GDP growth, fastest population growth, highest life expectancy, energy transition leaders: ≥ 1M; | ||||
| 193 | + lowest unemployment: ≥ 5M). | ||||
| 187 | 194 | ||||