# dryvo-company/dryvo-web-frontend architecture

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

- Interactive diagram: https://gitdiagram.com/dryvo-company/dryvo-web-frontend
- Repository: https://github.com/dryvo-company/dryvo-web-frontend

## Overview

Dryvo is a parking-map and community editing product with moderation and administrative reporting. The main user-facing domain is map-based discovery and editing: map data and geometry support drawing or selecting parking elements, which can be submitted or managed; moderators review pending submissions, while administrators have reporting and campaign capabilities. Source excerpts establish several data and delegation links, but the README is empty and many pages and components were not sampled, so uncertain page-to-component wiring is omitted.

Main entry points: [`dryvo/src/services/api/parking.ts`](https://github.com/dryvo-company/dryvo-web-frontend/blob/main/dryvo/src/services/api/parking.ts) (Parking API), [`dryvo/src/hooks/dashboard/useDashboardData.ts`](https://github.com/dryvo-company/dryvo-web-frontend/blob/main/dryvo/src/hooks/dashboard/useDashboardData.ts) (Dashboard data), [`dryvo/src/hooks/map/useMapDrawHandlers.ts`](https://github.com/dryvo-company/dryvo-web-frontend/blob/main/dryvo/src/hooks/map/useMapDrawHandlers.ts) (Draw handlers), [`dryvo/src/hooks/admin/usePendingQueue.ts`](https://github.com/dryvo-company/dryvo-web-frontend/blob/main/dryvo/src/hooks/admin/usePendingQueue.ts) (Pending submissions)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_map["Map experience"]
  node_map_editor["Map editor<br/>[MapEditor.jsx]"]
  node_map_engine["Google map engine"]
  node_map_sync["Map synchronization"]
end

subgraph group_edit["Editing and review"]
  node_draw_handlers["Draw handlers"]
  node_zone_resolution["Zone resolution"]
  node_geo_utils["Geometry utilities<br/>[geo.ts]"]
  node_map_helpers["Map geometry helpers<br/>[mapHelpers.ts]"]
  node_pending_queue["Pending submissions<br/>[usePendingQueue.ts]"]
  node_moderation_live["Live moderation"]
end

subgraph group_services["Data and realtime"]
  node_parking_api["Parking API<br/>[parking.ts]"]
  node_api_core["HTTP API core<br/>[core.ts]"]
  node_city_api["City coverage API<br/>[cities.ts]"]
  node_collab_socket["Collaboration socket<br/>[collabSocket.ts]"]
end

subgraph group_admin["Administration"]
  node_dashboard_data["Dashboard data"]
  node_admin_pages["Admin dashboards"]
  node_parking_admin["Parking management"]
  node_reports_campaigns["Reports and campaigns"]
end

node_visitor(("Map user"))
node_cities[("City coverage service")]
node_backend[("Dryvo backend")]

node_visitor -.->|"edits map"| node_map_editor
node_map_editor -.->|"renders map"| node_map_engine
node_map_engine -->|"delegates sync"| node_map_sync
node_draw_handlers -->|"converts geometry"| node_geo_utils
node_draw_handlers -->|"loads coverage"| node_city_api
node_draw_handlers -->|"fetches coverage"| node_cities
node_zone_resolution -->|"checks zones"| node_map_helpers
node_zone_resolution -->|"loads zone detail"| node_parking_api
node_parking_api -->|"sends requests"| node_api_core
node_city_api -->|"sends requests"| node_api_core
node_pending_queue -->|"loads submissions"| node_parking_api
node_pending_queue -->|"gets socket"| node_collab_socket
node_pending_queue -->|"subscribes updates"| node_moderation_live
node_moderation_live -->|"handles events"| node_collab_socket
node_moderation_live -->|"updates cached data"| node_dashboard_data
node_dashboard_data -->|"loads parking data"| node_parking_api
node_dashboard_data -->|"checks health"| node_backend
node_admin_pages -.->|"shows metrics"| node_dashboard_data
node_parking_admin -.->|"manages lots"| node_parking_api
node_reports_campaigns -.->|"serves admin APIs"| node_backend

click node_map_editor "https://github.com/dryvo-company/dryvo-web-frontend/blob/main/dryvo/src/components/map/MapEditor/MapEditor.jsx"
click node_map_engine "https://github.com/dryvo-company/dryvo-web-frontend/blob/main/dryvo/src/services/map/useGoogleMapEngine.ts"
click node_map_sync "https://github.com/dryvo-company/dryvo-web-frontend/blob/main/dryvo/src/services/map/useGoogleMapSync.ts"
click node_draw_handlers "https://github.com/dryvo-company/dryvo-web-frontend/blob/main/dryvo/src/hooks/map/useMapDrawHandlers.ts"
click node_zone_resolution "https://github.com/dryvo-company/dryvo-web-frontend/blob/main/dryvo/src/components/map/PropertiesPanel/useZoneResolution.ts"
click node_geo_utils "https://github.com/dryvo-company/dryvo-web-frontend/blob/main/dryvo/src/utils/map/geo.ts"
click node_map_helpers "https://github.com/dryvo-company/dryvo-web-frontend/blob/main/dryvo/src/utils/map/mapHelpers.ts"
click node_parking_api "https://github.com/dryvo-company/dryvo-web-frontend/blob/main/dryvo/src/services/api/parking.ts"
click node_api_core "https://github.com/dryvo-company/dryvo-web-frontend/blob/main/dryvo/src/services/api/core.ts"
click node_city_api "https://github.com/dryvo-company/dryvo-web-frontend/blob/main/dryvo/src/services/api/cities.ts"
click node_collab_socket "https://github.com/dryvo-company/dryvo-web-frontend/blob/main/dryvo/src/services/collabSocket.ts"
click node_pending_queue "https://github.com/dryvo-company/dryvo-web-frontend/blob/main/dryvo/src/hooks/admin/usePendingQueue.ts"
click node_moderation_live "https://github.com/dryvo-company/dryvo-web-frontend/blob/main/dryvo/src/hooks/realtime/useModerationLive.ts"
click node_dashboard_data "https://github.com/dryvo-company/dryvo-web-frontend/blob/main/dryvo/src/hooks/dashboard/useDashboardData.ts"
click node_admin_pages "https://github.com/dryvo-company/dryvo-web-frontend/tree/main/dryvo/src/app/admin"
click node_parking_admin "https://github.com/dryvo-company/dryvo-web-frontend/tree/main/dryvo/src/components/modals/ParkingManagement"
click node_reports_campaigns "https://github.com/dryvo-company/dryvo-web-frontend/tree/main/dryvo/src/services/api"

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_map_editor,node_map_engine,node_map_sync,node_visitor toneBlue
class node_draw_handlers,node_zone_resolution,node_geo_utils,node_map_helpers,node_pending_queue,node_moderation_live,node_cities,node_backend toneAmber
class node_parking_api,node_api_core,node_city_api,node_collab_socket toneMint
class node_dashboard_data,node_admin_pages,node_parking_admin,node_reports_campaigns toneRose
```

## Components

### Map experience

- [Map editor](https://github.com/dryvo-company/dryvo-web-frontend/blob/main/dryvo/src/components/map/MapEditor/MapEditor.jsx): `dryvo/src/components/map/MapEditor/MapEditor.jsx`
- [Google map engine](https://github.com/dryvo-company/dryvo-web-frontend/blob/main/dryvo/src/services/map/useGoogleMapEngine.ts): `dryvo/src/services/map/useGoogleMapEngine.ts`
- [Map synchronization](https://github.com/dryvo-company/dryvo-web-frontend/blob/main/dryvo/src/services/map/useGoogleMapSync.ts): `dryvo/src/services/map/useGoogleMapSync.ts`

### Editing and review

- [Draw handlers](https://github.com/dryvo-company/dryvo-web-frontend/blob/main/dryvo/src/hooks/map/useMapDrawHandlers.ts): `dryvo/src/hooks/map/useMapDrawHandlers.ts`
- [Zone resolution](https://github.com/dryvo-company/dryvo-web-frontend/blob/main/dryvo/src/components/map/PropertiesPanel/useZoneResolution.ts): `dryvo/src/components/map/PropertiesPanel/useZoneResolution.ts`
- [Geometry utilities](https://github.com/dryvo-company/dryvo-web-frontend/blob/main/dryvo/src/utils/map/geo.ts): `dryvo/src/utils/map/geo.ts`
- [Map geometry helpers](https://github.com/dryvo-company/dryvo-web-frontend/blob/main/dryvo/src/utils/map/mapHelpers.ts): `dryvo/src/utils/map/mapHelpers.ts`
- [Pending submissions](https://github.com/dryvo-company/dryvo-web-frontend/blob/main/dryvo/src/hooks/admin/usePendingQueue.ts): `dryvo/src/hooks/admin/usePendingQueue.ts`
- [Live moderation](https://github.com/dryvo-company/dryvo-web-frontend/blob/main/dryvo/src/hooks/realtime/useModerationLive.ts): `dryvo/src/hooks/realtime/useModerationLive.ts`

### Data and realtime

- [Parking API](https://github.com/dryvo-company/dryvo-web-frontend/blob/main/dryvo/src/services/api/parking.ts): `dryvo/src/services/api/parking.ts`
- [HTTP API core](https://github.com/dryvo-company/dryvo-web-frontend/blob/main/dryvo/src/services/api/core.ts): `dryvo/src/services/api/core.ts`
- [City coverage API](https://github.com/dryvo-company/dryvo-web-frontend/blob/main/dryvo/src/services/api/cities.ts): `dryvo/src/services/api/cities.ts`
- [Collaboration socket](https://github.com/dryvo-company/dryvo-web-frontend/blob/main/dryvo/src/services/collabSocket.ts): `dryvo/src/services/collabSocket.ts`

### Administration

- [Dashboard data](https://github.com/dryvo-company/dryvo-web-frontend/blob/main/dryvo/src/hooks/dashboard/useDashboardData.ts): `dryvo/src/hooks/dashboard/useDashboardData.ts`
- [Admin dashboards](https://github.com/dryvo-company/dryvo-web-frontend/tree/main/dryvo/src/app/admin): `dryvo/src/app/admin`
- [Parking management](https://github.com/dryvo-company/dryvo-web-frontend/tree/main/dryvo/src/components/modals/ParkingManagement): `dryvo/src/components/modals/ParkingManagement`
- [Reports and campaigns](https://github.com/dryvo-company/dryvo-web-frontend/tree/main/dryvo/src/services/api): `dryvo/src/services/api`

### Other components

- **Map user**
- **City coverage service**
- **Dryvo backend**

## Connections

- Map user → Map editor: edits map
- Map editor → Google map engine: renders map
- Google map engine → Map synchronization: delegates sync (evidence: `dryvo/src/services/map/useGoogleMapEngine.ts`)
- Draw handlers → Geometry utilities: converts geometry (evidence: `dryvo/src/hooks/map/useMapDrawHandlers.ts`)
- Draw handlers → City coverage API: loads coverage (evidence: `dryvo/src/hooks/map/useMapDrawHandlers.ts`)
- Draw handlers → City coverage service: fetches coverage (evidence: `dryvo/src/hooks/map/useMapDrawHandlers.ts`)
- Zone resolution → Map geometry helpers: checks zones (evidence: `dryvo/src/components/map/PropertiesPanel/useZoneResolution.ts`)
- Zone resolution → Parking API: loads zone detail (evidence: `dryvo/src/components/map/PropertiesPanel/useZoneResolution.ts`)
- Parking API → HTTP API core: sends requests (evidence: `dryvo/src/services/api/parking.ts`)
- City coverage API → HTTP API core: sends requests (evidence: `dryvo/src/services/api/cities.ts`)
- Pending submissions → Parking API: loads submissions (evidence: `dryvo/src/hooks/admin/usePendingQueue.ts`)
- Pending submissions → Collaboration socket: gets socket (evidence: `dryvo/src/hooks/admin/usePendingQueue.ts`)
- Pending submissions → Live moderation: subscribes updates (evidence: `dryvo/src/hooks/admin/usePendingQueue.ts`)
- Live moderation → Collaboration socket: handles events (evidence: `dryvo/src/hooks/realtime/useModerationLive.ts`)
- Live moderation → Dashboard data: updates cached data (evidence: `dryvo/src/hooks/realtime/useModerationLive.ts`)
- Dashboard data → Parking API: loads parking data (evidence: `dryvo/src/hooks/dashboard/useDashboardData.ts`)
- Dashboard data → Dryvo backend: checks health (evidence: `dryvo/src/hooks/dashboard/useDashboardData.ts`)
- Admin dashboards → Dashboard data: shows metrics
- Parking management → Parking API: manages lots
- Reports and campaigns → Dryvo backend: serves admin APIs
