HWHeat Waves
    DashboardUtforsk
    Analyse
    Data Kilder
      • Explore Slice
      • Read Path
      • Routes
      • Atlas Route
      • Charts Correlation
      • Chart Libraries
      • Dashboard Route
    • Design Rationale
    • Doc Map
    DocsSettings
    DashboardAtlasUtforsk
    Analyse
    Data Kilder
    1. Documentation
    3. Application Architecture
    5. Atlas route — scrollytelling EU fire characteristics over fire_data

    Atlas route — scrollytelling EU fire characteristics over fire_data

    `/atlas` chapter rail, URL filters, and read-only charts over materialised `fire_data` rows. Pair with read-path doc for RPC semantics.

    Atlas route (/atlas)

    This page owns the /atlas surface: URL → console stripe → chapter rail (capabilities, fire characteristics, categories, sources, boundary blur, time, slice). It does not duplicate ETL contracts or full DDL — use the links below.

    TopicOwner
    get_fire_data / catalogread-path-get-fire-data-and-catalog-caching.md
    Route inventory (nav)app-routes.md
    Taxonomy / dim codes../semantics-and-sources/taxonomy-and-eu-firestat-alignment.md

    Flow

    1. app/(main)/atlas/page.tsx — server page; searchParams read inside a Suspense child (compatible with cacheComponents).
    2. fireDataQueryFromSearchParams (lib/data-model/fire-data-query-url.ts) — Tier-2 URL ↔ FireDataQuery via dim_code / dim_codes (same codec as /dashboard); page defaults from atlasDefaultQuery (_lib/default-query.ts).
    3. ConsoleShell — client URL wiring (url="tier2") + shared Console (route="atlas" preset in console-config.ts; dimension allowlist from FIRE_CHARACTERISTIC_DIM_CODES in eu-firestat-variable-numbers.ts).
    4. getCatalog() — same catalog entry as other Tier 2 routes.
    5. Chapters fetch via fetchAtlas* using resolveFireDataRequest → getCachedFireData (same pipeline as /simple). Circle-pack adds fire_type to p_breakdown_axes on that one fetch only.
    6. Charts: shared components/fire-data/charts/echarts/ (treemap, sankey, theme river, radar, heatmap, force graph, circle pack). Chapters pivot rows via lib/data-model/chart-pivot.ts then render product charts.
    7. Slice chapter CTA — fireDataQueryToHref('/dashboard', query) opens /dashboard with the same Tier-2 FireDataQuery (multi-source preserved). Do not link Atlas handoffs to /explore.

    Post-RPC row filters (row-filters.ts, atlasRowMatchesFilters) were removed — encoding is handled in FireDataQuery + resolveFireDataRequest.

    Navigation

    • Mobile bottom nav links to /atlas (components/dashboard/mobile-bottom-nav.tsx). When already on /atlas, tapping Atlas again toggles the console drawer (same pattern as Utforsk on /explore) via ConsoleSheetProvider.
    • Desktop sidebar does not list Atlas today — deep-link or mobile only.

    Code map

    AreaPath
    Pageapp/(main)/atlas/page.tsx
    ConsoleConsoleShell (route="atlas") — see console-config.ts
    Defaultsapp/(main)/atlas/_lib/default-query.ts
    URL codeclib/data-model/fire-data-query-url.ts
    Queriesapp/(main)/atlas/_lib/atlas-queries.ts
    Chaptersapp/(main)/atlas/chapters/*.tsx

    Maintenance

    When adding a chapter or changing filter semantics, update this file and app-routes.md. If reads switch RPCs or grains, sync read-path-get-fire-data-and-catalog-caching.md and run npm run types:gen:fire-data when the Postgres contract changes.