# yetanothertravelmap/yatm architecture

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

- Interactive diagram: https://gitdiagram.com/yetanothertravelmap/yatm
- Repository: https://github.com/yetanothertravelmap/yatm

## Overview

YATM is a travel-map web application: users sign in, manage map pins and categories, and view travel statistics; they can also import or export maps in JSON, KML, and XML. The frontend routes users to map, account, and authentication screens, while the Spring backend exposes corresponding API areas and separates request handling, domain services, and persistence. Import/export service relationships and several frontend route/auth links are visible in the supplied excerpts or source index; other backend feature links are documented capabilities or remain unverified because their source was not sampled.

Main entry points: [`backend/YATM/src/main/java/com/yetanothertravelmap/yatm/service/PinService.java`](https://github.com/yetanothertravelmap/yatm/blob/main/backend/YATM/src/main/java/com/yetanothertravelmap/yatm/service/PinService.java) (Pin service), [`backend/YATM/src/main/java/com/yetanothertravelmap/yatm/controller/ExportController.java`](https://github.com/yetanothertravelmap/yatm/blob/main/backend/YATM/src/main/java/com/yetanothertravelmap/yatm/controller/ExportController.java) (Export API), [`backend/YATM/src/main/java/com/yetanothertravelmap/yatm/service/JsonService.java`](https://github.com/yetanothertravelmap/yatm/blob/main/backend/YATM/src/main/java/com/yetanothertravelmap/yatm/service/JsonService.java) (JSON conversion), [`backend/YATM/src/main/java/com/yetanothertravelmap/yatm/service/KmlService.java`](https://github.com/yetanothertravelmap/yatm/blob/main/backend/YATM/src/main/java/com/yetanothertravelmap/yatm/service/KmlService.java) (KML conversion)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_frontend["Web frontend"]
  node_app["App routes<br/>[App.jsx]"]
  node_auth["Auth state<br/>[UseAuth.jsx]"]
  node_mapui["Map workspace<br/>[Map.jsx]"]
  node_accountui["Account screens<br/>[Profile.jsx]"]
  node_authui["Login and register<br/>[LogIn.jsx]"]
end

subgraph group_api["Backend API"]
  node_mapapi["Map API<br/>[MapController.java]"]
  node_accountapi["Account API"]
  node_authapi["Authentication API"]
  node_importapi["Import API"]
  node_exportapi["Export API"]
  node_statsapi["Statistics API"]
end

subgraph group_domain["Travel domain services"]
  node_mapservice["Map service<br/>[MapService.java]"]
  node_pinservice["Pin service<br/>[PinService.java]"]
  node_geocoding["Geocoding"]
  node_statsservice["Travel statistics<br/>[StatsService.java]"]
  node_pinrequest["Pin request model<br/>[PinRequest.java]"]
end

subgraph group_formats["Import and export"]
  node_jsonservice["JSON conversion<br/>[JsonService.java]"]
  node_kmlservice["KML conversion<br/>[KmlService.java]"]
  node_xmlservice["XML conversion<br/>[XmlService.java]"]
  node_jsondto["JSON feature model<br/>[Feature.java]"]
  node_kmldto["KML model<br/>[Kml.java]"]
  node_xmldto["XML travel-map model<br/>[XmlTravelMap.java]"]
end

subgraph group_persistence["Persistence"]
  node_pinmodel["Pin entity<br/>[Pin.java]"]
  node_categorymodel["Category entity<br/>[Category.java]"]
  node_mapmodel["Map entity<br/>[Map.java]"]
  node_userentity["User entity<br/>[User.java]"]
  node_maprepo[("Map repository<br/>[MapRepository.java]")]
  node_pinrepo[("Pin repository<br/>[PinRepository.java]")]
end

node_traveler(("Traveler"))

node_traveler -->|"uses"| node_app
node_app -->|"routes to"| node_authui
node_app -->|"routes to"| node_mapui
node_app -->|"routes to"| node_accountui
node_authui -.->|"authenticates via"| node_auth
node_mapui -.->|"requests map data"| node_mapapi
node_accountui -.->|"manages account"| node_accountapi
node_auth -->|"requests token"| node_authapi
node_mapapi -->|"delegates"| node_mapservice
node_mapapi -->|"delegates"| node_pinservice
node_accountapi -.->|"manages maps"| node_mapservice
node_statsapi -.->|"requests statistics"| node_statsservice
node_importapi -->|"converts JSON"| node_jsonservice
node_importapi -->|"converts KML"| node_kmlservice
node_importapi -->|"converts XML"| node_xmlservice
node_importapi -->|"creates pins"| node_pinservice
node_exportapi -->|"loads map"| node_mapservice
node_exportapi -->|"loads pins"| node_pinservice
node_exportapi -->|"converts JSON"| node_jsonservice
node_exportapi -->|"converts KML"| node_kmlservice
node_exportapi -->|"converts XML"| node_xmlservice
node_jsonservice -->|"maps features"| node_jsondto
node_kmlservice -->|"maps placemarks"| node_kmldto
node_xmlservice -->|"maps pins"| node_xmldto
node_jsonservice -->|"parses pins"| node_pinrequest
node_kmlservice -->|"parses pins"| node_pinrequest
node_xmlservice -->|"parses pins"| node_pinrequest
node_jsonservice -->|"reverse geocodes"| node_geocoding
node_kmlservice -->|"reverse geocodes"| node_geocoding
node_xmlservice -->|"reverse geocodes"| node_geocoding
node_pinservice -->|"persists pins"| node_pinrepo
node_pinservice -->|"loads map"| node_maprepo
node_mapservice -.->|"persists maps"| node_maprepo
node_pinservice -->|"assigns categories"| node_categorymodel
node_pinservice -->|"builds pins"| node_pinmodel
node_maprepo -->|"stores"| node_mapmodel
node_pinrepo -.->|"stores"| node_pinmodel
node_mapmodel -->|"belongs to"| node_userentity

click node_app "https://github.com/yetanothertravelmap/yatm/blob/main/frontend/src/App.jsx"
click node_auth "https://github.com/yetanothertravelmap/yatm/blob/main/frontend/src/hooks/UseAuth.jsx"
click node_mapui "https://github.com/yetanothertravelmap/yatm/blob/main/frontend/src/pages/Map/Map.jsx"
click node_accountui "https://github.com/yetanothertravelmap/yatm/blob/main/frontend/src/pages/Profile/Profile.jsx"
click node_authui "https://github.com/yetanothertravelmap/yatm/blob/main/frontend/src/pages/Login/LogIn.jsx"
click node_mapapi "https://github.com/yetanothertravelmap/yatm/blob/main/backend/YATM/src/main/java/com/yetanothertravelmap/yatm/controller/MapController.java"
click node_accountapi "https://github.com/yetanothertravelmap/yatm/blob/main/backend/YATM/src/main/java/com/yetanothertravelmap/yatm/controller/AccountController.java"
click node_authapi "https://github.com/yetanothertravelmap/yatm/blob/main/backend/YATM/src/main/java/com/yetanothertravelmap/yatm/controller/AuthController.java"
click node_importapi "https://github.com/yetanothertravelmap/yatm/blob/main/backend/YATM/src/main/java/com/yetanothertravelmap/yatm/controller/ImportController.java"
click node_exportapi "https://github.com/yetanothertravelmap/yatm/blob/main/backend/YATM/src/main/java/com/yetanothertravelmap/yatm/controller/ExportController.java"
click node_statsapi "https://github.com/yetanothertravelmap/yatm/blob/main/backend/YATM/src/main/java/com/yetanothertravelmap/yatm/controller/StatsController.java"
click node_mapservice "https://github.com/yetanothertravelmap/yatm/blob/main/backend/YATM/src/main/java/com/yetanothertravelmap/yatm/service/MapService.java"
click node_pinservice "https://github.com/yetanothertravelmap/yatm/blob/main/backend/YATM/src/main/java/com/yetanothertravelmap/yatm/service/PinService.java"
click node_geocoding "https://github.com/yetanothertravelmap/yatm/blob/main/backend/YATM/src/main/java/com/yetanothertravelmap/yatm/service/GeocodingService.java"
click node_statsservice "https://github.com/yetanothertravelmap/yatm/blob/main/backend/YATM/src/main/java/com/yetanothertravelmap/yatm/service/StatsService.java"
click node_jsonservice "https://github.com/yetanothertravelmap/yatm/blob/main/backend/YATM/src/main/java/com/yetanothertravelmap/yatm/service/JsonService.java"
click node_kmlservice "https://github.com/yetanothertravelmap/yatm/blob/main/backend/YATM/src/main/java/com/yetanothertravelmap/yatm/service/KmlService.java"
click node_xmlservice "https://github.com/yetanothertravelmap/yatm/blob/main/backend/YATM/src/main/java/com/yetanothertravelmap/yatm/service/XmlService.java"
click node_jsondto "https://github.com/yetanothertravelmap/yatm/blob/main/backend/YATM/src/main/java/com/yetanothertravelmap/yatm/dto/json/Feature.java"
click node_kmldto "https://github.com/yetanothertravelmap/yatm/blob/main/backend/YATM/src/main/java/com/yetanothertravelmap/yatm/dto/kml/Kml.java"
click node_xmldto "https://github.com/yetanothertravelmap/yatm/blob/main/backend/YATM/src/main/java/com/yetanothertravelmap/yatm/dto/xml/XmlTravelMap.java"
click node_pinrequest "https://github.com/yetanothertravelmap/yatm/blob/main/backend/YATM/src/main/java/com/yetanothertravelmap/yatm/dto/PinRequest.java"
click node_pinmodel "https://github.com/yetanothertravelmap/yatm/blob/main/backend/YATM/src/main/java/com/yetanothertravelmap/yatm/model/Pin.java"
click node_categorymodel "https://github.com/yetanothertravelmap/yatm/blob/main/backend/YATM/src/main/java/com/yetanothertravelmap/yatm/model/Category.java"
click node_mapmodel "https://github.com/yetanothertravelmap/yatm/blob/main/backend/YATM/src/main/java/com/yetanothertravelmap/yatm/model/Map.java"
click node_userentity "https://github.com/yetanothertravelmap/yatm/blob/main/backend/YATM/src/main/java/com/yetanothertravelmap/yatm/model/User.java"
click node_maprepo "https://github.com/yetanothertravelmap/yatm/blob/main/backend/YATM/src/main/java/com/yetanothertravelmap/yatm/repository/MapRepository.java"
click node_pinrepo "https://github.com/yetanothertravelmap/yatm/blob/main/backend/YATM/src/main/java/com/yetanothertravelmap/yatm/repository/PinRepository.java"

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_auth,node_mapui,node_accountui,node_authui toneBlue
class node_mapapi,node_accountapi,node_authapi,node_importapi,node_exportapi,node_statsapi toneAmber
class node_mapservice,node_pinservice,node_geocoding,node_statsservice,node_pinrequest toneMint
class node_jsonservice,node_kmlservice,node_xmlservice,node_jsondto,node_kmldto,node_xmldto toneRose
class node_pinmodel,node_categorymodel,node_mapmodel,node_userentity,node_maprepo,node_pinrepo,node_traveler toneIndigo
```

## Components

### Web frontend

- [App routes](https://github.com/yetanothertravelmap/yatm/blob/main/frontend/src/App.jsx): `frontend/src/App.jsx`
- [Auth state](https://github.com/yetanothertravelmap/yatm/blob/main/frontend/src/hooks/UseAuth.jsx): `frontend/src/hooks/UseAuth.jsx`
- [Map workspace](https://github.com/yetanothertravelmap/yatm/blob/main/frontend/src/pages/Map/Map.jsx): `frontend/src/pages/Map/Map.jsx`
- [Account screens](https://github.com/yetanothertravelmap/yatm/blob/main/frontend/src/pages/Profile/Profile.jsx): `frontend/src/pages/Profile/Profile.jsx`
- [Login and register](https://github.com/yetanothertravelmap/yatm/blob/main/frontend/src/pages/Login/LogIn.jsx): `frontend/src/pages/Login/LogIn.jsx`

### Backend API

- [Map API](https://github.com/yetanothertravelmap/yatm/blob/main/backend/YATM/src/main/java/com/yetanothertravelmap/yatm/controller/MapController.java): `backend/YATM/src/main/java/com/yetanothertravelmap/yatm/controller/MapController.java`
- [Account API](https://github.com/yetanothertravelmap/yatm/blob/main/backend/YATM/src/main/java/com/yetanothertravelmap/yatm/controller/AccountController.java): `backend/YATM/src/main/java/com/yetanothertravelmap/yatm/controller/AccountController.java`
- [Authentication API](https://github.com/yetanothertravelmap/yatm/blob/main/backend/YATM/src/main/java/com/yetanothertravelmap/yatm/controller/AuthController.java): `backend/YATM/src/main/java/com/yetanothertravelmap/yatm/controller/AuthController.java`
- [Import API](https://github.com/yetanothertravelmap/yatm/blob/main/backend/YATM/src/main/java/com/yetanothertravelmap/yatm/controller/ImportController.java): `backend/YATM/src/main/java/com/yetanothertravelmap/yatm/controller/ImportController.java`
- [Export API](https://github.com/yetanothertravelmap/yatm/blob/main/backend/YATM/src/main/java/com/yetanothertravelmap/yatm/controller/ExportController.java): `backend/YATM/src/main/java/com/yetanothertravelmap/yatm/controller/ExportController.java`
- [Statistics API](https://github.com/yetanothertravelmap/yatm/blob/main/backend/YATM/src/main/java/com/yetanothertravelmap/yatm/controller/StatsController.java): `backend/YATM/src/main/java/com/yetanothertravelmap/yatm/controller/StatsController.java`

### Travel domain services

- [Map service](https://github.com/yetanothertravelmap/yatm/blob/main/backend/YATM/src/main/java/com/yetanothertravelmap/yatm/service/MapService.java): `backend/YATM/src/main/java/com/yetanothertravelmap/yatm/service/MapService.java`
- [Pin service](https://github.com/yetanothertravelmap/yatm/blob/main/backend/YATM/src/main/java/com/yetanothertravelmap/yatm/service/PinService.java): `backend/YATM/src/main/java/com/yetanothertravelmap/yatm/service/PinService.java`
- [Geocoding](https://github.com/yetanothertravelmap/yatm/blob/main/backend/YATM/src/main/java/com/yetanothertravelmap/yatm/service/GeocodingService.java): `backend/YATM/src/main/java/com/yetanothertravelmap/yatm/service/GeocodingService.java`
- [Travel statistics](https://github.com/yetanothertravelmap/yatm/blob/main/backend/YATM/src/main/java/com/yetanothertravelmap/yatm/service/StatsService.java): `backend/YATM/src/main/java/com/yetanothertravelmap/yatm/service/StatsService.java`
- [Pin request model](https://github.com/yetanothertravelmap/yatm/blob/main/backend/YATM/src/main/java/com/yetanothertravelmap/yatm/dto/PinRequest.java): `backend/YATM/src/main/java/com/yetanothertravelmap/yatm/dto/PinRequest.java`

### Import and export

- [JSON conversion](https://github.com/yetanothertravelmap/yatm/blob/main/backend/YATM/src/main/java/com/yetanothertravelmap/yatm/service/JsonService.java): `backend/YATM/src/main/java/com/yetanothertravelmap/yatm/service/JsonService.java`
- [KML conversion](https://github.com/yetanothertravelmap/yatm/blob/main/backend/YATM/src/main/java/com/yetanothertravelmap/yatm/service/KmlService.java): `backend/YATM/src/main/java/com/yetanothertravelmap/yatm/service/KmlService.java`
- [XML conversion](https://github.com/yetanothertravelmap/yatm/blob/main/backend/YATM/src/main/java/com/yetanothertravelmap/yatm/service/XmlService.java): `backend/YATM/src/main/java/com/yetanothertravelmap/yatm/service/XmlService.java`
- [JSON feature model](https://github.com/yetanothertravelmap/yatm/blob/main/backend/YATM/src/main/java/com/yetanothertravelmap/yatm/dto/json/Feature.java): `backend/YATM/src/main/java/com/yetanothertravelmap/yatm/dto/json/Feature.java`
- [KML model](https://github.com/yetanothertravelmap/yatm/blob/main/backend/YATM/src/main/java/com/yetanothertravelmap/yatm/dto/kml/Kml.java): `backend/YATM/src/main/java/com/yetanothertravelmap/yatm/dto/kml/Kml.java`
- [XML travel-map model](https://github.com/yetanothertravelmap/yatm/blob/main/backend/YATM/src/main/java/com/yetanothertravelmap/yatm/dto/xml/XmlTravelMap.java): `backend/YATM/src/main/java/com/yetanothertravelmap/yatm/dto/xml/XmlTravelMap.java`

### Persistence

- [Pin entity](https://github.com/yetanothertravelmap/yatm/blob/main/backend/YATM/src/main/java/com/yetanothertravelmap/yatm/model/Pin.java): `backend/YATM/src/main/java/com/yetanothertravelmap/yatm/model/Pin.java`
- [Category entity](https://github.com/yetanothertravelmap/yatm/blob/main/backend/YATM/src/main/java/com/yetanothertravelmap/yatm/model/Category.java): `backend/YATM/src/main/java/com/yetanothertravelmap/yatm/model/Category.java`
- [Map entity](https://github.com/yetanothertravelmap/yatm/blob/main/backend/YATM/src/main/java/com/yetanothertravelmap/yatm/model/Map.java): `backend/YATM/src/main/java/com/yetanothertravelmap/yatm/model/Map.java`
- [User entity](https://github.com/yetanothertravelmap/yatm/blob/main/backend/YATM/src/main/java/com/yetanothertravelmap/yatm/model/User.java): `backend/YATM/src/main/java/com/yetanothertravelmap/yatm/model/User.java`
- [Map repository](https://github.com/yetanothertravelmap/yatm/blob/main/backend/YATM/src/main/java/com/yetanothertravelmap/yatm/repository/MapRepository.java): `backend/YATM/src/main/java/com/yetanothertravelmap/yatm/repository/MapRepository.java`
- [Pin repository](https://github.com/yetanothertravelmap/yatm/blob/main/backend/YATM/src/main/java/com/yetanothertravelmap/yatm/repository/PinRepository.java): `backend/YATM/src/main/java/com/yetanothertravelmap/yatm/repository/PinRepository.java`

### Other components

- **Traveler**

## Connections

- Traveler → App routes: uses
- App routes → Login and register: routes to (evidence: `frontend/src/App.jsx`)
- App routes → Map workspace: routes to (evidence: `frontend/src/App.jsx`)
- App routes → Account screens: routes to (evidence: `frontend/src/App.jsx`)
- Login and register → Auth state: authenticates via
- Map workspace → Map API: requests map data
- Account screens → Account API: manages account
- Auth state → Authentication API: requests token (evidence: `frontend/src/hooks/UseAuth.jsx`)
- Map API → Map service: delegates (evidence: `backend/YATM/src/main/java/com/yetanothertravelmap/yatm/controller/MapController.java`)
- Map API → Pin service: delegates (evidence: `backend/YATM/src/main/java/com/yetanothertravelmap/yatm/controller/MapController.java`)
- Account API → Map service: manages maps
- Statistics API → Travel statistics: requests statistics
- Import API → JSON conversion: converts JSON (evidence: `backend/YATM/src/main/java/com/yetanothertravelmap/yatm/controller/ImportController.java`)
- Import API → KML conversion: converts KML (evidence: `backend/YATM/src/main/java/com/yetanothertravelmap/yatm/controller/ImportController.java`)
- Import API → XML conversion: converts XML (evidence: `backend/YATM/src/main/java/com/yetanothertravelmap/yatm/controller/ImportController.java`)
- Import API → Pin service: creates pins (evidence: `backend/YATM/src/main/java/com/yetanothertravelmap/yatm/controller/ImportController.java`)
- Export API → Map service: loads map (evidence: `backend/YATM/src/main/java/com/yetanothertravelmap/yatm/controller/ExportController.java`)
- Export API → Pin service: loads pins (evidence: `backend/YATM/src/main/java/com/yetanothertravelmap/yatm/controller/ExportController.java`)
- Export API → JSON conversion: converts JSON (evidence: `backend/YATM/src/main/java/com/yetanothertravelmap/yatm/controller/ExportController.java`)
- Export API → KML conversion: converts KML (evidence: `backend/YATM/src/main/java/com/yetanothertravelmap/yatm/controller/ExportController.java`)
- Export API → XML conversion: converts XML (evidence: `backend/YATM/src/main/java/com/yetanothertravelmap/yatm/controller/ExportController.java`)
- JSON conversion → JSON feature model: maps features (evidence: `backend/YATM/src/main/java/com/yetanothertravelmap/yatm/service/JsonService.java`)
- KML conversion → KML model: maps placemarks (evidence: `backend/YATM/src/main/java/com/yetanothertravelmap/yatm/service/KmlService.java`)
- XML conversion → XML travel-map model: maps pins (evidence: `backend/YATM/src/main/java/com/yetanothertravelmap/yatm/service/XmlService.java`)
- JSON conversion → Pin request model: parses pins (evidence: `backend/YATM/src/main/java/com/yetanothertravelmap/yatm/service/JsonService.java`)
- KML conversion → Pin request model: parses pins (evidence: `backend/YATM/src/main/java/com/yetanothertravelmap/yatm/service/KmlService.java`)
- XML conversion → Pin request model: parses pins (evidence: `backend/YATM/src/main/java/com/yetanothertravelmap/yatm/service/XmlService.java`)
- JSON conversion → Geocoding: reverse geocodes (evidence: `backend/YATM/src/main/java/com/yetanothertravelmap/yatm/service/JsonService.java`)
- KML conversion → Geocoding: reverse geocodes (evidence: `backend/YATM/src/main/java/com/yetanothertravelmap/yatm/service/KmlService.java`)
- XML conversion → Geocoding: reverse geocodes (evidence: `backend/YATM/src/main/java/com/yetanothertravelmap/yatm/service/XmlService.java`)
- Pin service → Pin repository: persists pins (evidence: `backend/YATM/src/main/java/com/yetanothertravelmap/yatm/service/PinService.java`)
- Pin service → Map repository: loads map (evidence: `backend/YATM/src/main/java/com/yetanothertravelmap/yatm/service/PinService.java`)
- Map service → Map repository: persists maps (evidence: `backend/YATM/src/main/java/com/yetanothertravelmap/yatm/service/MapService.java`)
- Pin service → Category entity: assigns categories (evidence: `backend/YATM/src/main/java/com/yetanothertravelmap/yatm/service/PinService.java`)
- Pin service → Pin entity: builds pins (evidence: `backend/YATM/src/main/java/com/yetanothertravelmap/yatm/service/PinService.java`)
- Map repository → Map entity: stores (evidence: `backend/YATM/src/main/java/com/yetanothertravelmap/yatm/repository/MapRepository.java`)
- Pin repository → Pin entity: stores (evidence: `backend/YATM/src/main/java/com/yetanothertravelmap/yatm/repository/PinRepository.java`)
- Map entity → User entity: belongs to (evidence: `backend/YATM/src/main/java/com/yetanothertravelmap/yatm/model/Map.java`)
