# cunvoas/opendata-tools architecture

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

- Interactive diagram: https://gitdiagram.com/cunvoas/opendata-tools
- Repository: https://github.com/cunvoas/opendata-tools
- Video tour (about a minute): https://gitdiagram.com/cunvoas/opendata-tools/video

## Overview

This repository combines a Spring backend and Vue/Leaflet public map for nationwide park-access analysis, plus small data-conversion utilities. The main user journey is map search, then viewing park and geographic data; the backend also supports scheduled accessibility calculations, OMS indicators, community data management, project proposals, NDVI, and GeoJSON publication. The README documents these capabilities, but sampled backend excerpts do not establish most controller-to-service wiring, so those links are documented at a high level; the separate DBF and GeoPackage utilities are omitted from the main product flow.

Main entry points: [`geoservice-isochrone-v2/src/main/java/com/github/cunvoas/geoserviceisochrone/controller`](https://github.com/cunvoas/opendata-tools/tree/main/geoservice-isochrone-v2/src/main/java/com/github/cunvoas/geoserviceisochrone/controller) (Web and REST API), [`geoservice-isochrone-v2/src/main/java/com/github/cunvoas/geoserviceisochrone/service/park`](https://github.com/cunvoas/opendata-tools/tree/main/geoservice-isochrone-v2/src/main/java/com/github/cunvoas/geoserviceisochrone/service/park) (Park management), [`geoservice-isochrone-v2/src/main/java/com/github/cunvoas/geoserviceisochrone/repo`](https://github.com/cunvoas/opendata-tools/tree/main/geoservice-isochrone-v2/src/main/java/com/github/cunvoas/geoserviceisochrone/repo) (PostGIS data), [`geoservice-isochrone-v2/src/main/java/com/github/cunvoas/geoserviceisochrone/service/export/PublishService.java`](https://github.com/cunvoas/opendata-tools/blob/main/geoservice-isochrone-v2/src/main/java/com/github/cunvoas/geoserviceisochrone/service/export/PublishService.java) (GeoJSON publication)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_frontend["Public map"]
  node_vueapp["Vue app<br/>[App.vue]"]
  node_search["Location search<br/>[SearchLocation.vue]"]
  node_autocomplete["Autocomplete<br/>[Autocomplete.vue]"]
  node_mapview["Interactive map<br/>[AppCarte.vue]"]
  node_ndviview["NDVI view<br/>[AppNdvi.vue]"]
end

subgraph group_api["Geo service"]
  node_controllers["Web and REST API"]
  node_parks["Park management"]
end

subgraph group_analysis["Analysis and data"]
  node_batch["Compute queue"]
  node_stats["OMS indicators"]
  node_proposals["Proposal evaluation"]
  node_ndvi["NDVI batches"]
  node_publish["GeoJSON publication"]
  node_store[("PostGIS data")]
end

subgraph group_integrations["External data"]
  node_ign["IGN isochrone API"]
  node_copernicus["Copernicus"]
  node_osm["OpenStreetMap"]
end

node_visitor(("Map visitor"))
node_apiuser(("API clients"))
node_staticdata["Published map data"]

node_visitor -->|"uses"| node_vueapp
node_vueapp -->|"renders"| node_search
node_search -->|"uses"| node_autocomplete
node_visitor -->|"views"| node_mapview
node_visitor -->|"views"| node_ndviview
node_apiuser -->|"requests"| node_controllers
node_controllers -.->|"manages parks"| node_parks
node_controllers -.->|"requests jobs"| node_batch
node_batch -->|"reads and writes"| node_store
node_batch -.->|"computes access"| node_stats
node_controllers -.->|"serves indicators"| node_stats
node_controllers -.->|"evaluates proposals"| node_proposals
node_ndvi -->|"stores results"| node_store
node_ndvi -.->|"requests imagery"| node_copernicus
node_parks -->|"reads and updates"| node_store
node_parks -.->|"matches park data"| node_osm
node_parks -.->|"uses geographic data"| node_ign
node_publish -.->|"reads data"| node_store
node_publish -->|"writes statistics"| node_stats
node_publish -->|"produces GeoJSON"| node_staticdata

click node_vueapp "https://github.com/cunvoas/opendata-tools/blob/main/geoservice-map-vue3/src/App.vue"
click node_search "https://github.com/cunvoas/opendata-tools/blob/main/geoservice-map-vue3/src/components/SearchLocation.vue"
click node_autocomplete "https://github.com/cunvoas/opendata-tools/blob/main/geoservice-map-vue3/src/components/Autocomplete.vue"
click node_mapview "https://github.com/cunvoas/opendata-tools/blob/main/geoservice-map-vue3/src/views/AppCarte.vue"
click node_ndviview "https://github.com/cunvoas/opendata-tools/blob/main/geoservice-map-vue3/src/views/AppNdvi.vue"
click node_controllers "https://github.com/cunvoas/opendata-tools/tree/main/geoservice-isochrone-v2/src/main/java/com/github/cunvoas/geoserviceisochrone/controller"
click node_parks "https://github.com/cunvoas/opendata-tools/tree/main/geoservice-isochrone-v2/src/main/java/com/github/cunvoas/geoserviceisochrone/service/park"
click node_batch "https://github.com/cunvoas/opendata-tools/blob/main/geoservice-isochrone-v2/src/main/java/com/github/cunvoas/geoserviceisochrone/service/compute/BatchJobService.java"
click node_stats "https://github.com/cunvoas/opendata-tools/blob/main/geoservice-isochrone-v2/src/main/java/com/github/cunvoas/geoserviceisochrone/service/analytics/StatsSurfaceService.java"
click node_proposals "https://github.com/cunvoas/opendata-tools/blob/main/geoservice-isochrone-v2/src/main/java/com/github/cunvoas/geoserviceisochrone/service/proposal/ManualProposalEvaluationService.java"
click node_ndvi "https://github.com/cunvoas/opendata-tools/blob/main/geoservice-isochrone-v2/src/main/java/com/github/cunvoas/geoserviceisochrone/extern/ndvi/NdviBatchJobService.java"
click node_publish "https://github.com/cunvoas/opendata-tools/blob/main/geoservice-isochrone-v2/src/main/java/com/github/cunvoas/geoserviceisochrone/service/export/PublishService.java"
click node_store "https://github.com/cunvoas/opendata-tools/tree/main/geoservice-isochrone-v2/src/main/java/com/github/cunvoas/geoserviceisochrone/repo"

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_vueapp,node_search,node_autocomplete,node_mapview,node_ndviview,node_apiuser toneBlue
class node_controllers,node_parks toneAmber
class node_batch,node_stats,node_proposals,node_ndvi,node_publish,node_store toneMint
class node_ign,node_copernicus,node_osm toneRose
class node_visitor,node_staticdata toneIndigo
```

## Components

### Public map

- [Vue app](https://github.com/cunvoas/opendata-tools/blob/main/geoservice-map-vue3/src/App.vue): `geoservice-map-vue3/src/App.vue`
- [Location search](https://github.com/cunvoas/opendata-tools/blob/main/geoservice-map-vue3/src/components/SearchLocation.vue): `geoservice-map-vue3/src/components/SearchLocation.vue`
- [Autocomplete](https://github.com/cunvoas/opendata-tools/blob/main/geoservice-map-vue3/src/components/Autocomplete.vue): `geoservice-map-vue3/src/components/Autocomplete.vue`
- [Interactive map](https://github.com/cunvoas/opendata-tools/blob/main/geoservice-map-vue3/src/views/AppCarte.vue): `geoservice-map-vue3/src/views/AppCarte.vue`
- [NDVI view](https://github.com/cunvoas/opendata-tools/blob/main/geoservice-map-vue3/src/views/AppNdvi.vue): `geoservice-map-vue3/src/views/AppNdvi.vue`

### Geo service

- [Web and REST API](https://github.com/cunvoas/opendata-tools/tree/main/geoservice-isochrone-v2/src/main/java/com/github/cunvoas/geoserviceisochrone/controller): `geoservice-isochrone-v2/src/main/java/com/github/cunvoas/geoserviceisochrone/controller`
- [Park management](https://github.com/cunvoas/opendata-tools/tree/main/geoservice-isochrone-v2/src/main/java/com/github/cunvoas/geoserviceisochrone/service/park): `geoservice-isochrone-v2/src/main/java/com/github/cunvoas/geoserviceisochrone/service/park`

### Analysis and data

- [Compute queue](https://github.com/cunvoas/opendata-tools/blob/main/geoservice-isochrone-v2/src/main/java/com/github/cunvoas/geoserviceisochrone/service/compute/BatchJobService.java): `geoservice-isochrone-v2/src/main/java/com/github/cunvoas/geoserviceisochrone/service/compute/BatchJobService.java`
- [OMS indicators](https://github.com/cunvoas/opendata-tools/blob/main/geoservice-isochrone-v2/src/main/java/com/github/cunvoas/geoserviceisochrone/service/analytics/StatsSurfaceService.java): `geoservice-isochrone-v2/src/main/java/com/github/cunvoas/geoserviceisochrone/service/analytics/StatsSurfaceService.java`
- [Proposal evaluation](https://github.com/cunvoas/opendata-tools/blob/main/geoservice-isochrone-v2/src/main/java/com/github/cunvoas/geoserviceisochrone/service/proposal/ManualProposalEvaluationService.java): `geoservice-isochrone-v2/src/main/java/com/github/cunvoas/geoserviceisochrone/service/proposal/ManualProposalEvaluationService.java`
- [NDVI batches](https://github.com/cunvoas/opendata-tools/blob/main/geoservice-isochrone-v2/src/main/java/com/github/cunvoas/geoserviceisochrone/extern/ndvi/NdviBatchJobService.java): `geoservice-isochrone-v2/src/main/java/com/github/cunvoas/geoserviceisochrone/extern/ndvi/NdviBatchJobService.java`
- [GeoJSON publication](https://github.com/cunvoas/opendata-tools/blob/main/geoservice-isochrone-v2/src/main/java/com/github/cunvoas/geoserviceisochrone/service/export/PublishService.java): `geoservice-isochrone-v2/src/main/java/com/github/cunvoas/geoserviceisochrone/service/export/PublishService.java`
- [PostGIS data](https://github.com/cunvoas/opendata-tools/tree/main/geoservice-isochrone-v2/src/main/java/com/github/cunvoas/geoserviceisochrone/repo): `geoservice-isochrone-v2/src/main/java/com/github/cunvoas/geoserviceisochrone/repo`

### External data

- **IGN isochrone API**
- **Copernicus**
- **OpenStreetMap**

### Other components

- **Map visitor**
- **API clients**
- **Published map data**

## Connections

- Map visitor → Vue app: uses (evidence: `README.md`)
- Vue app → Location search: renders (evidence: `geoservice-map-vue3/src/App.vue`)
- Location search → Autocomplete: uses (evidence: `geoservice-map-vue3/src/components/SearchLocation.vue`)
- Map visitor → Interactive map: views (evidence: `README.md`)
- Map visitor → NDVI view: views (evidence: `README.md`)
- API clients → Web and REST API: requests (evidence: `README.md`)
- Web and REST API → Park management: manages parks
- Web and REST API → Compute queue: requests jobs
- Compute queue → PostGIS data: reads and writes (evidence: `geoservice-isochrone-v2/src/main/java/com/github/cunvoas/geoserviceisochrone/service/compute/BatchJobService.java`)
- Compute queue → OMS indicators: computes access
- Web and REST API → OMS indicators: serves indicators (evidence: `geoservice-isochrone-v2/src/main/java/com/github/cunvoas/geoserviceisochrone/service/analytics/StatsSurfaceService.java`)
- Web and REST API → Proposal evaluation: evaluates proposals (evidence: `geoservice-isochrone-v2/src/main/java/com/github/cunvoas/geoserviceisochrone/service/proposal/ManualProposalEvaluationService.java`)
- NDVI batches → PostGIS data: stores results (evidence: `geoservice-isochrone-v2/src/main/java/com/github/cunvoas/geoserviceisochrone/extern/ndvi/NdviBatchJobService.java`)
- NDVI batches → Copernicus: requests imagery
- Park management → PostGIS data: reads and updates (evidence: `geoservice-isochrone-v2/src/main/java/com/github/cunvoas/geoserviceisochrone/service/park/ParkOverpassCadastreService.java`)
- Park management → OpenStreetMap: matches park data
- Park management → IGN isochrone API: uses geographic data
- GeoJSON publication → PostGIS data: reads data (evidence: `geoservice-isochrone-v2/src/main/java/com/github/cunvoas/geoserviceisochrone/service/export/PublishService.java`)
- GeoJSON publication → OMS indicators: writes statistics (evidence: `geoservice-isochrone-v2/src/main/java/com/github/cunvoas/geoserviceisochrone/service/export/PublishService.java`)
- GeoJSON publication → Published map data: produces GeoJSON (evidence: `README.md`)
