# estopacema/mvp-global architecture

> Architecture diagram of the GitHub repository estopacema/mvp-global, generated by GitDiagram from its file tree, README and a sample of source files (last updated 2026-10-02). It is an AI-made overview: check details against the source.

- Interactive diagram: https://gitdiagram.com/estopacema/mvp-global
- Repository: https://github.com/estopacema/mvp-global

## Overview

MVP Global is a snapshot-backed atlas and accessible directory of Microsoft MVPs. Visitors explore the globe or directory, refine results with URL-backed search and filters, and open shareable country or profile pages; profile links also provide generated social previews. The runtime uses bundled catalog/profile data rather than a database or live directory API. A separate refresh branch scrapes and imports updated snapshot data. Edges follow shown imports or README descriptions; scraper internals and some route wiring were not sampled, so those links are documented rather than inferred.

Main entry points: [`src/lib/server-directory.ts`](https://github.com/estopacema/mvp-global/blob/main/src/lib/server-directory.ts) (Server directory), [`src/components/directory-view.tsx`](https://github.com/estopacema/mvp-global/blob/main/src/components/directory-view.tsx) (Directory view), [`src/components/explorer.tsx`](https://github.com/estopacema/mvp-global/blob/main/src/components/explorer.tsx) (Globe explorer), [`src/app/mvps/[id]/page.tsx`](https://github.com/estopacema/mvp-global/blob/main/src/app/mvps/%5Bid%5D/page.tsx) (Profile page)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_experience["Visitor experience"]
  node_home["Globe home<br/>[page.tsx]"]
  node_directory_route["Directory route<br/>[page.tsx]"]
  node_country_route["Country pages<br/>[page.tsx]"]
  node_about["About page<br/>[page.tsx]"]
end

subgraph group_discovery["Search and globe"]
  node_directory_view["Directory view<br/>[directory-view.tsx]"]
  node_explorer["Globe explorer<br/>[explorer.tsx]"]
  node_globe_client["Globe capability<br/>[globe-client.tsx]"]
  node_globe_view["Globe rendering<br/>[globe-view.tsx]"]
  node_globe_geometry["Globe geometry<br/>[globe-geometry.ts]"]
  node_globe_palette["Globe palette<br/>[globe-palette.ts]"]
  node_filter_bar["Search filters<br/>[filter-bar.tsx]"]
  node_filter_state["URL filter state<br/>[use-filters.ts]"]
  node_directory_logic["Directory querying<br/>[directory.ts]"]
  node_result_hook["Result selection"]
  node_results["Profile results<br/>[results.tsx]"]
  node_catalog["Snapshot catalog<br/>[catalog.ts]"]
  node_server_directory["Server directory"]
end

subgraph group_profiles["Profiles and sharing"]
  node_profile_route["Profile page<br/>[page.tsx]"]
  node_profile_card["Profile details<br/>[mvp-id-card.tsx]"]
  node_preview_route["Preview route<br/>[route.ts]"]
  node_preview_image["Preview rendering"]
  node_share["Profile sharing<br/>[profile-share.tsx]"]
end

subgraph group_refresh["Snapshot refresh"]
  node_scraper["MVP scraper<br/>[scrape-mvps.ts]"]
  node_importer["Snapshot importer<br/>[import-data.ts]"]
  node_snapshot["Committed snapshot"]
end

node_visitor(("Visitor"))
node_microsoft["Microsoft directory"]

node_visitor -->|"opens"| node_home
node_visitor -->|"opens"| node_directory_route
node_visitor -->|"opens"| node_country_route
node_visitor -->|"opens"| node_profile_route
node_home -->|"renders"| node_explorer
node_directory_route -->|"renders"| node_directory_view
node_country_route -->|"renders"| node_directory_view
node_directory_view -->|"renders"| node_filter_bar
node_directory_view -->|"renders"| node_results
node_directory_view -->|"uses"| node_result_hook
node_explorer -->|"renders"| node_globe_client
node_explorer -->|"renders"| node_filter_bar
node_explorer -->|"renders"| node_results
node_globe_client -->|"loads"| node_globe_view
node_globe_view -->|"uses"| node_globe_geometry
node_globe_view -->|"uses"| node_globe_palette
node_filter_bar -->|"updates"| node_filter_state
node_filter_state -->|"parses"| node_directory_logic
node_result_hook -->|"queries"| node_directory_logic
node_result_hook -->|"reads"| node_catalog
node_results -->|"uses"| node_directory_logic
node_server_directory -->|"reads"| node_catalog
node_server_directory -->|"queries"| node_directory_logic
node_directory_route -->|"loads results"| node_server_directory
node_country_route -->|"loads results"| node_server_directory
node_profile_route -->|"loads profile"| node_server_directory
node_profile_route -->|"renders"| node_profile_card
node_profile_route -->|"renders"| node_share
node_preview_route -->|"loads profile"| node_server_directory
node_preview_route -->|"generates"| node_preview_image
node_visitor -->|"opens"| node_about
node_microsoft -.->|"provides directory data"| node_scraper
node_scraper -->|"exports data for"| node_importer
node_importer -->|"updates"| node_snapshot

click node_home "https://github.com/estopacema/mvp-global/blob/main/src/app/page.tsx"
click node_directory_route "https://github.com/estopacema/mvp-global/blob/main/src/app/mvps/page.tsx"
click node_country_route "https://github.com/estopacema/mvp-global/blob/main/src/app/countries/%5Bcountry%5D/page.tsx"
click node_about "https://github.com/estopacema/mvp-global/blob/main/src/app/about/page.tsx"
click node_directory_view "https://github.com/estopacema/mvp-global/blob/main/src/components/directory-view.tsx"
click node_explorer "https://github.com/estopacema/mvp-global/blob/main/src/components/explorer.tsx"
click node_globe_client "https://github.com/estopacema/mvp-global/blob/main/src/components/globe/globe-client.tsx"
click node_globe_view "https://github.com/estopacema/mvp-global/blob/main/src/components/globe/globe-view.tsx"
click node_globe_geometry "https://github.com/estopacema/mvp-global/blob/main/src/lib/globe-geometry.ts"
click node_globe_palette "https://github.com/estopacema/mvp-global/blob/main/src/lib/globe-palette.ts"
click node_filter_bar "https://github.com/estopacema/mvp-global/blob/main/src/components/filter-bar.tsx"
click node_filter_state "https://github.com/estopacema/mvp-global/blob/main/src/hooks/use-filters.ts"
click node_directory_logic "https://github.com/estopacema/mvp-global/blob/main/src/lib/directory.ts"
click node_result_hook "https://github.com/estopacema/mvp-global/blob/main/src/hooks/use-directory-result.ts"
click node_results "https://github.com/estopacema/mvp-global/blob/main/src/components/results.tsx"
click node_catalog "https://github.com/estopacema/mvp-global/blob/main/src/lib/catalog.ts"
click node_server_directory "https://github.com/estopacema/mvp-global/blob/main/src/lib/server-directory.ts"
click node_profile_route "https://github.com/estopacema/mvp-global/blob/main/src/app/mvps/%5Bid%5D/page.tsx"
click node_profile_card "https://github.com/estopacema/mvp-global/blob/main/src/components/mvp-id-card.tsx"
click node_preview_route "https://github.com/estopacema/mvp-global/blob/main/src/app/mvps/%5Bid%5D/preview/route.ts"
click node_preview_image "https://github.com/estopacema/mvp-global/blob/main/src/lib/profile-preview-image.tsx"
click node_share "https://github.com/estopacema/mvp-global/blob/main/src/components/profile-share.tsx"
click node_scraper "https://github.com/estopacema/mvp-global/blob/main/mvp-scraper/scripts/scrape-mvps.ts"
click node_importer "https://github.com/estopacema/mvp-global/blob/main/scripts/import-data.ts"
click node_snapshot "https://github.com/estopacema/mvp-global/blob/main/src/lib/server-directory.ts"

classDef toneNeutral fill:#f8fafc,stroke:#334155,stroke-width:1.5px,color:#0f172a
classDef toneBlue fill:#dbeafe,stroke:#2563eb,stroke-width:1.5px,color:#172554
classDef toneAmber fill:#fef3c7,stroke:#d97706,stroke-width:1.5px,color:#78350f
classDef toneMint fill:#dcfce7,stroke:#16a34a,stroke-width:1.5px,color:#14532d
classDef toneRose fill:#ffe4e6,stroke:#e11d48,stroke-width:1.5px,color:#881337
classDef toneIndigo fill:#e0e7ff,stroke:#4f46e5,stroke-width:1.5px,color:#312e81
classDef toneTeal fill:#ccfbf1,stroke:#0f766e,stroke-width:1.5px,color:#134e4a
class node_home,node_directory_route,node_country_route,node_about toneBlue
class node_directory_view,node_explorer,node_globe_client,node_globe_view,node_globe_geometry,node_globe_palette,node_filter_bar,node_filter_state,node_directory_logic,node_result_hook,node_results,node_catalog,node_server_directory toneAmber
class node_profile_route,node_profile_card,node_preview_route,node_preview_image,node_share toneMint
class node_scraper,node_importer,node_snapshot toneRose
class node_visitor,node_microsoft toneIndigo
```

## Components

### Visitor experience

- [Globe home](https://github.com/estopacema/mvp-global/blob/main/src/app/page.tsx): `src/app/page.tsx`
- [Directory route](https://github.com/estopacema/mvp-global/blob/main/src/app/mvps/page.tsx): `src/app/mvps/page.tsx`
- [Country pages](https://github.com/estopacema/mvp-global/blob/main/src/app/countries/%5Bcountry%5D/page.tsx): `src/app/countries/[country]/page.tsx`
- [About page](https://github.com/estopacema/mvp-global/blob/main/src/app/about/page.tsx): `src/app/about/page.tsx`

### Search and globe

- [Directory view](https://github.com/estopacema/mvp-global/blob/main/src/components/directory-view.tsx): `src/components/directory-view.tsx`
- [Globe explorer](https://github.com/estopacema/mvp-global/blob/main/src/components/explorer.tsx): `src/components/explorer.tsx`
- [Globe capability](https://github.com/estopacema/mvp-global/blob/main/src/components/globe/globe-client.tsx): `src/components/globe/globe-client.tsx`
- [Globe rendering](https://github.com/estopacema/mvp-global/blob/main/src/components/globe/globe-view.tsx): `src/components/globe/globe-view.tsx`
- [Globe geometry](https://github.com/estopacema/mvp-global/blob/main/src/lib/globe-geometry.ts): `src/lib/globe-geometry.ts`
- [Globe palette](https://github.com/estopacema/mvp-global/blob/main/src/lib/globe-palette.ts): `src/lib/globe-palette.ts`
- [Search filters](https://github.com/estopacema/mvp-global/blob/main/src/components/filter-bar.tsx): `src/components/filter-bar.tsx`
- [URL filter state](https://github.com/estopacema/mvp-global/blob/main/src/hooks/use-filters.ts): `src/hooks/use-filters.ts`
- [Directory querying](https://github.com/estopacema/mvp-global/blob/main/src/lib/directory.ts): `src/lib/directory.ts`
- [Result selection](https://github.com/estopacema/mvp-global/blob/main/src/hooks/use-directory-result.ts): `src/hooks/use-directory-result.ts`
- [Profile results](https://github.com/estopacema/mvp-global/blob/main/src/components/results.tsx): `src/components/results.tsx`
- [Snapshot catalog](https://github.com/estopacema/mvp-global/blob/main/src/lib/catalog.ts): `src/lib/catalog.ts`
- [Server directory](https://github.com/estopacema/mvp-global/blob/main/src/lib/server-directory.ts): `src/lib/server-directory.ts`

### Profiles and sharing

- [Profile page](https://github.com/estopacema/mvp-global/blob/main/src/app/mvps/%5Bid%5D/page.tsx): `src/app/mvps/[id]/page.tsx`
- [Profile details](https://github.com/estopacema/mvp-global/blob/main/src/components/mvp-id-card.tsx): `src/components/mvp-id-card.tsx`
- [Preview route](https://github.com/estopacema/mvp-global/blob/main/src/app/mvps/%5Bid%5D/preview/route.ts): `src/app/mvps/[id]/preview/route.ts`
- [Preview rendering](https://github.com/estopacema/mvp-global/blob/main/src/lib/profile-preview-image.tsx): `src/lib/profile-preview-image.tsx`
- [Profile sharing](https://github.com/estopacema/mvp-global/blob/main/src/components/profile-share.tsx): `src/components/profile-share.tsx`

### Snapshot refresh

- [MVP scraper](https://github.com/estopacema/mvp-global/blob/main/mvp-scraper/scripts/scrape-mvps.ts): `mvp-scraper/scripts/scrape-mvps.ts`
- [Snapshot importer](https://github.com/estopacema/mvp-global/blob/main/scripts/import-data.ts): `scripts/import-data.ts`
- [Committed snapshot](https://github.com/estopacema/mvp-global/blob/main/src/lib/server-directory.ts): `src/lib/server-directory.ts`

### Other components

- **Visitor**
- **Microsoft directory**

## Connections

- Visitor → Globe home: opens (evidence: `README.md`)
- Visitor → Directory route: opens (evidence: `README.md`)
- Visitor → Country pages: opens (evidence: `README.md`)
- Visitor → Profile page: opens (evidence: `README.md`)
- Globe home → Globe explorer: renders (evidence: `src/app/page.tsx`)
- Directory route → Directory view: renders (evidence: `src/app/mvps/page.tsx`)
- Country pages → Directory view: renders (evidence: `src/app/countries/[country]/page.tsx`)
- Directory view → Search filters: renders (evidence: `src/components/directory-view.tsx`)
- Directory view → Profile results: renders (evidence: `src/components/directory-view.tsx`)
- Directory view → Result selection: uses (evidence: `src/components/directory-view.tsx`)
- Globe explorer → Globe capability: renders (evidence: `src/components/explorer.tsx`)
- Globe explorer → Search filters: renders (evidence: `src/components/explorer.tsx`)
- Globe explorer → Profile results: renders (evidence: `src/components/explorer.tsx`)
- Globe capability → Globe rendering: loads (evidence: `src/components/globe/globe-client.tsx`)
- Globe rendering → Globe geometry: uses (evidence: `src/components/globe/globe-view.tsx`)
- Globe rendering → Globe palette: uses (evidence: `src/components/globe/globe-view.tsx`)
- Search filters → URL filter state: updates (evidence: `src/components/filter-bar.tsx`)
- URL filter state → Directory querying: parses (evidence: `src/hooks/use-filters.ts`)
- Result selection → Directory querying: queries (evidence: `src/hooks/use-directory-result.ts`)
- Result selection → Snapshot catalog: reads (evidence: `src/hooks/use-directory-result.ts`)
- Profile results → Directory querying: uses (evidence: `src/components/results.tsx`)
- Server directory → Snapshot catalog: reads (evidence: `src/lib/server-directory.ts`)
- Server directory → Directory querying: queries (evidence: `src/lib/server-directory.ts`)
- Directory route → Server directory: loads results (evidence: `src/app/mvps/page.tsx`)
- Country pages → Server directory: loads results (evidence: `src/app/countries/[country]/page.tsx`)
- Profile page → Server directory: loads profile (evidence: `src/app/mvps/[id]/page.tsx`)
- Profile page → Profile details: renders (evidence: `src/app/mvps/[id]/page.tsx`)
- Profile page → Profile sharing: renders (evidence: `src/app/mvps/[id]/page.tsx`)
- Preview route → Server directory: loads profile (evidence: `src/app/mvps/[id]/preview/route.ts`)
- Preview route → Preview rendering: generates (evidence: `src/app/mvps/[id]/preview/route.ts`)
- Visitor → About page: opens (evidence: `README.md`)
- Microsoft directory → MVP scraper: provides directory data (evidence: `README.md`)
- MVP scraper → Snapshot importer: exports data for (evidence: `README.md`)
- Snapshot importer → Committed snapshot: updates (evidence: `README.md`)
