# watwowmap/reactmap architecture

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

- Interactive diagram: https://gitdiagram.com/watwowmap/reactmap
- Repository: https://github.com/watwowmap/reactmap

## Overview

ReactMap is a Pokémon GO map frontend paired with a Node/GraphQL server. Users browse map overlays and filters; the frontend requests data from GraphQL, whose resolvers obtain records through multi-source database management and domain models. Separate branches cover authentication, scanner capabilities, geocoding, event-derived availability, and Poracle webhook management. The README documents broad overlay and backend support; several subsystem links are therefore omitted or marked unverified where sampled source does not establish the wiring.

Main entry points: [`server/src/graphql/resolvers.js`](https://github.com/watwowmap/reactmap/blob/main/server/src/graphql/resolvers.js) (Query resolvers), [`server/src/services/DbManager.js`](https://github.com/watwowmap/reactmap/blob/main/server/src/services/DbManager.js) (Source manager), [`src/pages/map/components/QueryData.jsx`](https://github.com/watwowmap/reactmap/blob/main/src/pages/map/components/QueryData.jsx) (Map data view), [`server/src/services/EventManager.js`](https://github.com/watwowmap/reactmap/blob/main/server/src/services/EventManager.js) (Availability and events)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_client["Map client"]
  node_app["React app<br/>[App.jsx]"]
  node_map["Map data view<br/>[QueryData.jsx]"]
  node_overlays["Map overlays"]
  node_filters["Overlay filters"]
  node_browserstate[("Browser preferences<br/>[useStorage.js]")]
  node_webhookui["Webhook management UI"]
  node_gqlclient["Apollo client<br/>[index.js]"]
end

subgraph group_api["GraphQL API"]
  node_graphql["GraphQL server<br/>[server.js]"]
  node_resolvers["Query resolvers<br/>[resolvers.js]"]
end

subgraph group_domain["Data and domain"]
  node_dbmanager["Source manager<br/>[DbManager.js]"]
  node_models["Map domain models"]
end

subgraph group_integrations["Integrations"]
  node_auth["Authentication strategies"]
  node_poracle["Poracle webhook service<br/>[Poracle.js]"]
  node_scanner["Scanner capabilities<br/>[scannerApi.js]"]
  node_geocoder["Geocoding service<br/>[geocoder.js]"]
end

subgraph group_operations["Runtime services"]
  node_events["Availability and events<br/>[EventManager.js]"]
  node_runtime["Shared runtime state<br/>[state.js]"]
  node_cache[("File cache<br/>[cache.js]")]
end

node_visitor(("Map user"))
node_scannerbackend{{"Scanner backends"}}
node_sql[("SQL databases")]
node_poracleexternal{{"Poracle service"}}

node_visitor -.->|"uses"| node_app
node_app -->|"loads"| node_map
node_map -.->|"renders"| node_overlays
node_filters -.->|"updates"| node_browserstate
node_map -.->|"reads"| node_browserstate
node_map -.->|"queries"| node_gqlclient
node_webhookui -.->|"queries"| node_gqlclient
node_webhookui -->|"updates"| node_browserstate
node_gqlclient -.->|"sends requests"| node_graphql
node_graphql -->|"registers"| node_resolvers
node_resolvers -->|"queries data"| node_dbmanager
node_resolvers -->|"uses"| node_poracle
node_resolvers -->|"uses"| node_geocoder
node_resolvers -->|"uses"| node_scanner
node_dbmanager -->|"binds models"| node_models
node_dbmanager -.->|"queries sources"| node_scannerbackend
node_models -.->|"reads records"| node_sql
node_runtime -->|"creates"| node_dbmanager
node_runtime -->|"creates"| node_events
node_runtime -->|"uses"| node_cache
node_events -->|"refreshes availability"| node_dbmanager
node_events -->|"uses"| node_poracle
node_events -->|"loads event cache"| node_cache
node_auth -->|"configured by"| node_runtime
node_poracle -->|"sends requests"| node_poracleexternal

click node_app "https://github.com/watwowmap/reactmap/blob/main/src/App.jsx"
click node_map "https://github.com/watwowmap/reactmap/blob/main/src/pages/map/components/QueryData.jsx"
click node_overlays "https://github.com/watwowmap/reactmap/tree/main/src/features"
click node_filters "https://github.com/watwowmap/reactmap/tree/main/src/features/drawer"
click node_browserstate "https://github.com/watwowmap/reactmap/blob/main/src/store/useStorage.js"
click node_webhookui "https://github.com/watwowmap/reactmap/blob/main/src/features/webhooks/hooks/useGetWebhookData.js"
click node_gqlclient "https://github.com/watwowmap/reactmap/blob/main/src/services/apollo/index.js"
click node_graphql "https://github.com/watwowmap/reactmap/blob/main/server/src/graphql/server.js"
click node_resolvers "https://github.com/watwowmap/reactmap/blob/main/server/src/graphql/resolvers.js"
click node_dbmanager "https://github.com/watwowmap/reactmap/blob/main/server/src/services/DbManager.js"
click node_models "https://github.com/watwowmap/reactmap/tree/main/server/src/models"
click node_events "https://github.com/watwowmap/reactmap/blob/main/server/src/services/EventManager.js"
click node_runtime "https://github.com/watwowmap/reactmap/blob/main/server/src/services/state.js"
click node_cache "https://github.com/watwowmap/reactmap/blob/main/server/src/services/cache.js"
click node_auth "https://github.com/watwowmap/reactmap/tree/main/server/src/strategies"
click node_poracle "https://github.com/watwowmap/reactmap/blob/main/server/src/services/Poracle.js"
click node_scanner "https://github.com/watwowmap/reactmap/blob/main/server/src/services/scannerApi.js"
click node_geocoder "https://github.com/watwowmap/reactmap/blob/main/server/src/services/geocoder.js"

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_app,node_map,node_overlays,node_filters,node_browserstate,node_webhookui,node_gqlclient,node_visitor toneBlue
class node_graphql,node_resolvers,node_sql toneAmber
class node_dbmanager,node_models toneMint
class node_auth,node_poracle,node_scanner,node_geocoder toneRose
class node_events,node_runtime,node_cache,node_scannerbackend,node_poracleexternal toneIndigo
```

## Components

### Map client

- [React app](https://github.com/watwowmap/reactmap/blob/main/src/App.jsx): `src/App.jsx`
- [Map data view](https://github.com/watwowmap/reactmap/blob/main/src/pages/map/components/QueryData.jsx): `src/pages/map/components/QueryData.jsx`
- [Map overlays](https://github.com/watwowmap/reactmap/tree/main/src/features): `src/features`
- [Overlay filters](https://github.com/watwowmap/reactmap/tree/main/src/features/drawer): `src/features/drawer`
- [Browser preferences](https://github.com/watwowmap/reactmap/blob/main/src/store/useStorage.js): `src/store/useStorage.js`
- [Webhook management UI](https://github.com/watwowmap/reactmap/blob/main/src/features/webhooks/hooks/useGetWebhookData.js): `src/features/webhooks/hooks/useGetWebhookData.js`
- [Apollo client](https://github.com/watwowmap/reactmap/blob/main/src/services/apollo/index.js): `src/services/apollo/index.js`

### GraphQL API

- [GraphQL server](https://github.com/watwowmap/reactmap/blob/main/server/src/graphql/server.js): `server/src/graphql/server.js`
- [Query resolvers](https://github.com/watwowmap/reactmap/blob/main/server/src/graphql/resolvers.js): `server/src/graphql/resolvers.js`

### Data and domain

- [Source manager](https://github.com/watwowmap/reactmap/blob/main/server/src/services/DbManager.js): `server/src/services/DbManager.js`
- [Map domain models](https://github.com/watwowmap/reactmap/tree/main/server/src/models): `server/src/models`

### Integrations

- [Authentication strategies](https://github.com/watwowmap/reactmap/tree/main/server/src/strategies): `server/src/strategies`
- [Poracle webhook service](https://github.com/watwowmap/reactmap/blob/main/server/src/services/Poracle.js): `server/src/services/Poracle.js`
- [Scanner capabilities](https://github.com/watwowmap/reactmap/blob/main/server/src/services/scannerApi.js): `server/src/services/scannerApi.js`
- [Geocoding service](https://github.com/watwowmap/reactmap/blob/main/server/src/services/geocoder.js): `server/src/services/geocoder.js`

### Runtime services

- [Availability and events](https://github.com/watwowmap/reactmap/blob/main/server/src/services/EventManager.js): `server/src/services/EventManager.js`
- [Shared runtime state](https://github.com/watwowmap/reactmap/blob/main/server/src/services/state.js): `server/src/services/state.js`
- [File cache](https://github.com/watwowmap/reactmap/blob/main/server/src/services/cache.js): `server/src/services/cache.js`

### Other components

- **Map user**
- **Scanner backends**
- **SQL databases**
- **Poracle service**

## Connections

- Map user → React app: uses (evidence: `README.md`)
- React app → Map data view: loads (evidence: `src/App.jsx`)
- Map data view → Map overlays: renders
- Overlay filters → Browser preferences: updates
- Map data view → Browser preferences: reads
- Map data view → Apollo client: queries
- Webhook management UI → Apollo client: queries
- Webhook management UI → Browser preferences: updates (evidence: `src/features/webhooks/hooks/useGetWebhookData.js`)
- Apollo client → GraphQL server: sends requests
- GraphQL server → Query resolvers: registers (evidence: `server/src/graphql/server.js`)
- Query resolvers → Source manager: queries data (evidence: `server/src/graphql/resolvers.js`)
- Query resolvers → Poracle webhook service: uses (evidence: `server/src/graphql/resolvers.js`)
- Query resolvers → Geocoding service: uses (evidence: `server/src/graphql/resolvers.js`)
- Query resolvers → Scanner capabilities: uses (evidence: `server/src/graphql/resolvers.js`)
- Source manager → Map domain models: binds models (evidence: `server/src/services/DbManager.js`)
- Source manager → Scanner backends: queries sources
- Map domain models → SQL databases: reads records
- Shared runtime state → Source manager: creates (evidence: `server/src/services/state.js`)
- Shared runtime state → Availability and events: creates (evidence: `server/src/services/state.js`)
- Shared runtime state → File cache: uses (evidence: `server/src/services/state.js`)
- Availability and events → Source manager: refreshes availability (evidence: `server/src/services/EventManager.js`)
- Availability and events → Poracle webhook service: uses (evidence: `server/src/services/EventManager.js`)
- Availability and events → File cache: loads event cache (evidence: `server/src/services/EventManager.js`)
- Authentication strategies → Shared runtime state: configured by (evidence: `server/src/services/state.js`)
- Poracle webhook service → Poracle service: sends requests (evidence: `server/src/services/Poracle.js`)
