How yetanothertravelmap/yatm works
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: PinService.java Pin service · ExportController.java Export API · JsonService.java JSON conversion · KmlService.java KML conversion
Components 29
Web frontend
- App routes
frontend/src/App.jsx - Auth state
frontend/src/hooks/UseAuth.jsx - Map workspace
frontend/src/pages/Map/Map.jsx - Account screens
frontend/src/pages/Profile/Profile.jsx - Login and register
frontend/src/pages/Login/LogIn.jsx
Backend API
- Map API
backend/YATM/src/main/java/com/yetanothertravelmap/yatm/controller/MapController.java - Account API
backend/YATM/src/main/java/com/yetanothertravelmap/yatm/controller/AccountController.java - Authentication API
backend/YATM/src/main/java/com/yetanothertravelmap/yatm/controller/AuthController.java - Import API
backend/YATM/src/main/java/com/yetanothertravelmap/yatm/controller/ImportController.java - Export API
backend/YATM/src/main/java/com/yetanothertravelmap/yatm/controller/ExportController.java - Statistics API
backend/YATM/src/main/java/com/yetanothertravelmap/yatm/controller/StatsController.java
Travel domain services
- Map service
backend/YATM/src/main/java/com/yetanothertravelmap/yatm/service/MapService.java - Pin service
backend/YATM/src/main/java/com/yetanothertravelmap/yatm/service/PinService.java - Geocoding
backend/YATM/src/main/java/com/yetanothertravelmap/yatm/service/GeocodingService.java - Travel statistics
backend/YATM/src/main/java/com/yetanothertravelmap/yatm/service/StatsService.java - Pin request model
backend/YATM/src/main/java/com/yetanothertravelmap/yatm/dto/PinRequest.java
Import and export
- JSON conversion
backend/YATM/src/main/java/com/yetanothertravelmap/yatm/service/JsonService.java - KML conversion
backend/YATM/src/main/java/com/yetanothertravelmap/yatm/service/KmlService.java - XML conversion
backend/YATM/src/main/java/com/yetanothertravelmap/yatm/service/XmlService.java - JSON feature model
backend/YATM/src/main/java/com/yetanothertravelmap/yatm/dto/json/Feature.java - KML model
backend/YATM/src/main/java/com/yetanothertravelmap/yatm/dto/kml/Kml.java - XML travel-map model
backend/YATM/src/main/java/com/yetanothertravelmap/yatm/dto/xml/XmlTravelMap.java
Persistence
- Pin entity
backend/YATM/src/main/java/com/yetanothertravelmap/yatm/model/Pin.java - Category entity
backend/YATM/src/main/java/com/yetanothertravelmap/yatm/model/Category.java - Map entity
backend/YATM/src/main/java/com/yetanothertravelmap/yatm/model/Map.java - User entity
backend/YATM/src/main/java/com/yetanothertravelmap/yatm/model/User.java - Map repository
backend/YATM/src/main/java/com/yetanothertravelmap/yatm/repository/MapRepository.java - Pin repository
backend/YATM/src/main/java/com/yetanothertravelmap/yatm/repository/PinRepository.java
Other components
- Traveler
Connections 38
- Traveler → App routes: uses
- App routes → Login and register: routes to
frontend/src/App.jsx - App routes → Map workspace: routes to
frontend/src/App.jsx - App routes → Account screens: routes to
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
frontend/src/hooks/UseAuth.jsx - Map API → Map service: delegates
backend/YATM/src/main/java/com/yetanothertravelmap/yatm/controller/MapController.java - Map API → Pin service: delegates
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
backend/YATM/src/main/java/com/yetanothertravelmap/yatm/controller/ImportController.java - Import API → KML conversion: converts KML
backend/YATM/src/main/java/com/yetanothertravelmap/yatm/controller/ImportController.java - Import API → XML conversion: converts XML
backend/YATM/src/main/java/com/yetanothertravelmap/yatm/controller/ImportController.java - Import API → Pin service: creates pins
backend/YATM/src/main/java/com/yetanothertravelmap/yatm/controller/ImportController.java - Export API → Map service: loads map
backend/YATM/src/main/java/com/yetanothertravelmap/yatm/controller/ExportController.java - Export API → Pin service: loads pins
backend/YATM/src/main/java/com/yetanothertravelmap/yatm/controller/ExportController.java - Export API → JSON conversion: converts JSON
backend/YATM/src/main/java/com/yetanothertravelmap/yatm/controller/ExportController.java - Export API → KML conversion: converts KML
backend/YATM/src/main/java/com/yetanothertravelmap/yatm/controller/ExportController.java - Export API → XML conversion: converts XML
backend/YATM/src/main/java/com/yetanothertravelmap/yatm/controller/ExportController.java - JSON conversion → JSON feature model: maps features
backend/YATM/src/main/java/com/yetanothertravelmap/yatm/service/JsonService.java - KML conversion → KML model: maps placemarks
backend/YATM/src/main/java/com/yetanothertravelmap/yatm/service/KmlService.java - XML conversion → XML travel-map model: maps pins
backend/YATM/src/main/java/com/yetanothertravelmap/yatm/service/XmlService.java - JSON conversion → Pin request model: parses pins
backend/YATM/src/main/java/com/yetanothertravelmap/yatm/service/JsonService.java - KML conversion → Pin request model: parses pins
backend/YATM/src/main/java/com/yetanothertravelmap/yatm/service/KmlService.java - XML conversion → Pin request model: parses pins
backend/YATM/src/main/java/com/yetanothertravelmap/yatm/service/XmlService.java - JSON conversion → Geocoding: reverse geocodes
backend/YATM/src/main/java/com/yetanothertravelmap/yatm/service/JsonService.java - KML conversion → Geocoding: reverse geocodes
backend/YATM/src/main/java/com/yetanothertravelmap/yatm/service/KmlService.java - XML conversion → Geocoding: reverse geocodes
backend/YATM/src/main/java/com/yetanothertravelmap/yatm/service/XmlService.java - Pin service → Pin repository: persists pins
backend/YATM/src/main/java/com/yetanothertravelmap/yatm/service/PinService.java - Pin service → Map repository: loads map
backend/YATM/src/main/java/com/yetanothertravelmap/yatm/service/PinService.java - Map service → Map repository: persists maps
backend/YATM/src/main/java/com/yetanothertravelmap/yatm/service/MapService.java - Pin service → Category entity: assigns categories
backend/YATM/src/main/java/com/yetanothertravelmap/yatm/service/PinService.java - Pin service → Pin entity: builds pins
backend/YATM/src/main/java/com/yetanothertravelmap/yatm/service/PinService.java - Map repository → Map entity: stores
backend/YATM/src/main/java/com/yetanothertravelmap/yatm/repository/MapRepository.java - Pin repository → Pin entity: stores
backend/YATM/src/main/java/com/yetanothertravelmap/yatm/repository/PinRepository.java - Map entity → User entity: belongs to
backend/YATM/src/main/java/com/yetanothertravelmap/yatm/model/Map.java