Architecture Overview

flowchart TB
    Browser(["Browser"])
    Browser -->|"GET /dashboard/[market]?..."| page

    subgraph App["Next.js 16 · App Router"]
        page["page.tsx — async RSC\n~130 lines · generateMetadata · layout composition"]

        subgraph CC["Client components"]
            refine["refine-bar.tsx\nuseSearchParams · router.push\nexports REFINE_BAR_ID"]
            nav["section-nav.tsx\nIntersectionObserver + ResizeObserver\nimports TOPBAR_ID · REFINE_BAR_ID"]
        end

        subgraph Sec["sections/ — RSC wrappers"]
            s01["s01-market-intelligence.tsx  async RSC\nawaits getConvergenceSnapshot + getDemandSnapshot"]
            s03["s03-moat-coverage.tsx  async RSC\nawaits getMoatDimensions → passes moats prop"]
            sc["supply-concepts.tsx  use client\nTerrainMap · SupplyBanner · SupplyDensitySection"]
            spp["supply-parcel-panel.tsx  use client\nMiniCard · RightPanel · MoatGridA/B/C"]
            mc["moat-concepts.tsx  use client\nMoatCoverageSection (receives moats prop)"]
            s4x["s04 → s08  RSC stubs"]
        end

        subgraph Q["lib/queries/ — stubs → Prisma"]
            qi["intelligence.ts · moats.ts\nmarket.ts · supply.ts"]
        end

        subgraph CD["components/dashboard/ — shared primitives"]
            ui["Topbar (exports TOPBAR_ID) · LogoMark\nSectionHead · Card · SectionBanner"]
        end

        subgraph Lib["lib/ — in-memory constants · zero DB calls"]
            moat["moat-data.ts\nMOATS · SAT_COLOR · SAT_COLOR_HEX · SAT_LABEL"]
            mkt["market-data.ts\nCATCHMENT_STATS · RING_COLORS · RING_COLORS_HEX"]
            sd["supply-data.ts\nPARCELS constant"]
        end
    end

    page --> refine
    page --> nav
    page --> Sec
    Sec --> Q
    Q --> Lib
    Sec --> CD
    sc --> sd
    spp --> sd
    s01 --> qi
    s03 --> qi
    

flowchart TB
    Browser(["Browser"])
    Browser -->|"GET /dashboard/[market]?..."| page

    subgraph App["Next.js 16 · App Router"]
        page["page.tsx — async RSC\nawait params · await searchParams"]

        subgraph CC["Client components — unchanged"]
            refine["refine-bar.tsx"]
            nav["section-nav.tsx"]
        end

        subgraph Q["lib/queries/"]
            qf["market.ts · supply.ts\nmoats.ts · intelligence.ts"]
        end

        subgraph Sec["sections/ — 8 RSC wrappers"]
            sc["supply-concepts.tsx\nuse client · react-map-gl\ndrive rings + parcel polygons"]
            sO["s01 · s03 → s08  RSC"]
        end

        subgraph CD["components/dashboard/ — shared primitives"]
            ui["Topbar · LogoMark\nSectionHead · Card · SectionBanner"]
        end
    end

    subgraph DL["Data layer"]
        prisma["Prisma Client\n@prisma/adapter-neon"]
        neon[("Neon PostgreSQL\nPostGIS · 25 tables")]
    end

    page --> refine
    page --> nav
    page --> Q
    Q --> prisma
    prisma --> neon
    page --> Sec
    Sec --> CD
    

%%{init: {'theme': 'default'}}%%
sequenceDiagram
    actor User
    participant RB as RefineBar (use client)
    participant Browser
    participant Page as page.tsx (async RSC)
    participant Q as lib/queries/ stubs
    participant Lib as lib/ constants

    User->>RB: select catchment = 90
    RB->>Browser: router.push(?catchment=90)
    Browser->>Page: GET /dashboard/[market]?catchment=90
    Page->>Page: await params / searchParams
    Page->>Q: getMarketStats(slug, "90")
    Q->>Lib: CATCHMENT_STATS["90"] (~0ms)
    Lib-->>Q: in-memory
    Q-->>Page: market stats
    Page-->>Browser: HTML
    Browser-->>RB: hydrate
    RB-->>User: render

    Note over Q,Lib: No I/O — stubs read in-memory constants
    

%%{init: {'theme': 'default'}}%%
sequenceDiagram
    actor User
    participant RB as RefineBar (use client)
    participant Browser
    participant Page as page.tsx (async RSC)
    participant Q as lib/queries/
    participant DB as Neon PostgreSQL

    User->>RB: select catchment = 90
    RB->>Browser: router.push(?catchment=90)
    Browser->>Page: GET /dashboard/[market]?catchment=90
    Page->>Page: await params / searchParams
    Page->>Q: getMarketStats(slug, "90")
    Q->>DB: SELECT WHERE isochrone = 90
    DB-->>Q: rows
    Q-->>Page: market stats
    Page->>Q: getParcels(catchment=90, acres=10-19, budget=1.5-6)
    Q->>DB: ST_Within + WHERE filters
    DB-->>Q: rows
    Q-->>Page: parcels
    Page-->>Browser: HTML
    Browser-->>RB: hydrate
    RB-->>User: render

    Note over Q,DB: 2 Neon queries · ~15–40ms