How yoavamar132/global-city-map works
This is a JavaFX client/server application for browsing and managing city maps, with user authentication, role-specific workflows, purchases and subscriptions, map viewing, and content administration. The main user path runs from connection setup through login or guest browsing, then into catalogs, purchase or owned-map workflows, and map display. Requests and responses use shared serializable message types; server services mediate database repositories. Several server routing and UI subsystems are present in the tree but unsampled, so their links are marked unverified rather than inferred as confirmed calls.
Main entry points: GcmClient.java Client transport · RequestHandler.java Server request handler · menu Role menus · BuyMapCatalogController.java Purchase catalog
Components 28
Client experience
- Client application
client/src/main/java/gcm/client/utill/ClientApp.java - Connection setup
client/src/main/java/gcm/client/controllers/ui/ClientConnectionController.java - Scene navigation
client/src/main/java/gcm/client/utill/SceneNavigator.java - Login and registration
client/src/main/java/gcm/client/controllers/LoginController.java - Role menus
client/src/main/java/gcm/client/controllers/menu
Map workflows
- Guest city catalog
client/src/main/java/gcm/client/controllers/catalogPublic/GuestCatalogController.java - Guest city maps
client/src/main/java/gcm/client/controllers/catalogPublic/GuestCityMapsController.java - Purchase catalog
client/src/main/java/gcm/client/controllers/catalog/BuyMapCatalogController.java - Map purchase flow
client/src/main/java/gcm/client/controllers/user_util/BuyMapScreenController.java - Purchase session
client/src/main/java/gcm/client/controllers/user_util/PurchaseSession.java - Owned maps
client/src/main/java/gcm/client/controllers/user_util/MyMapsController.java - Subscriptions
client/src/main/java/gcm/client/controllers/user_util/UserSubscriptionsController.java - Map viewer
client/src/main/java/gcm/client/controllers/map/MapViewerController.java - Map base layer
client/src/main/java/gcm/client/controllers/map/MapBaseLayerController.java - Map overlays
client/src/main/java/gcm/client/controllers/map/MapOverlayLayerController.java - Content administration
client/src/main/java/gcm/client/controllers/menu/ContentWorkerMenuController.java
Shared protocol
- Client transport
client/src/main/java/gcm/client/network/GcmClient.java - Request types
common/src/main/java/common/messages/GcmRequest.java - Response envelope
common/src/main/java/common/messages/GcmResponse.java - Map and user data
common/src/main/java/common/model/MapSheet.java
Server services
- Server request handler
server/src/main/java/gcm/server/controllers/RequestHandler.java - Authentication service
server/src/main/java/gcm/server/service/AuthService.java - Catalog service
server/src/main/java/gcm/server/service/CatalogService.java - City service
server/src/main/java/gcm/server/service/CityService.java - Map service
server/src/main/java/gcm/server/service/MapService.java
Data access
- Database repositories
server/src/main/java/gcm/server/data - Database manager
server/src/main/java/gcm/server/data/DbManager.java
Other components
- Visitor or user
Connections 34
- Visitor or user → Connection setup: starts client
- Connection setup → Client application: sets client
client/src/main/java/gcm/client/controllers/ui/ClientConnectionController.java - Client application → Scene navigation: starts navigation
client/src/main/java/gcm/client/utill/ClientApp.java - Client application → Login and registration: shows welcome
client/src/main/java/gcm/client/utill/ClientApp.java - Visitor or user → Login and registration: submits credentials
- Login and registration → Client transport: sends login
client/src/main/java/gcm/client/controllers/LoginController.java - Login and registration → Scene navigation: routes by role
client/src/main/java/gcm/client/controllers/LoginController.java - Scene navigation → Role menus: loads menu
client/src/main/java/gcm/client/utill/SceneNavigator.java - Role menus → Guest city catalog: opens catalog
client/src/main/java/gcm/client/controllers/menu/UserMenuController.java - Guest city catalog → Client transport: requests cities
client/src/main/java/gcm/client/controllers/catalogPublic/GuestCatalogController.java - Guest city catalog → Guest city maps: passes map list
client/src/main/java/gcm/client/controllers/catalogPublic/GuestCatalogController.java - Role menus → Purchase catalog: opens purchase catalog
client/src/main/java/gcm/client/controllers/menu/UserMenuController.java - Purchase catalog → Client transport: loads cities
client/src/main/java/gcm/client/controllers/catalog/BuyMapCatalogController.java - Purchase catalog → Purchase session: sets selection
client/src/main/java/gcm/client/controllers/catalog/BuyMapCatalogController.java - Purchase catalog → Map purchase flow: opens purchase
client/src/main/java/gcm/client/controllers/catalog/BuyMapCatalogController.java - Role menus → Owned maps: opens owned maps
client/src/main/java/gcm/client/controllers/menu/UserMenuController.java - Owned maps → Client transport: requests maps
client/src/main/java/gcm/client/controllers/user_util/MyMapsController.java - Owned maps → Map viewer: passes selected map
client/src/main/java/gcm/client/controllers/user_util/MyMapsController.java - Owned maps → Subscriptions: opens subscriptions
client/src/main/java/gcm/client/controllers/user_util/MyMapsController.java - Map viewer → Map base layer: uses base layer
client/src/main/java/gcm/client/controllers/map/MapViewerController.java - Map viewer → Map overlays: uses overlays
client/src/main/java/gcm/client/controllers/map/MapViewerController.java - Role menus → Content administration: opens admin options
client/src/main/java/gcm/client/controllers/menu/ContentWorkerMenuController.java - Content administration → Server request handler: requests admin actions
- Client transport → Request types: transmits request
client/src/main/java/gcm/client/network/GcmClient.java - Client transport → Response envelope: receives response
client/src/main/java/gcm/client/network/GcmClient.java - Client transport → Server request handler: sends over connection
- Server request handler → Authentication service: dispatches auth
server/src/main/java/gcm/server/controllers/RequestHandler.java - Server request handler → Catalog service: dispatches catalog
server/src/main/java/gcm/server/controllers/RequestHandler.java - Server request handler → City service: dispatches city requests
server/src/main/java/gcm/server/controllers/RequestHandler.java - Server request handler → Map service: dispatches map requests
server/src/main/java/gcm/server/controllers/RequestHandler.java - Authentication service → Database repositories: uses user repository
server/src/main/java/gcm/server/service/AuthService.java - Catalog service → Database repositories: uses catalog repository
server/src/main/java/gcm/server/service/CatalogService.java - City service → Database repositories: uses city repository
server/src/main/java/gcm/server/service/CityService.java - Map service → Database repositories: uses map repositories
server/src/main/java/gcm/server/service/MapService.java