# lasha-ilashvili/traveltogeorgia architecture

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

- Interactive diagram: https://gitdiagram.com/lasha-ilashvili/traveltogeorgia
- Repository: https://github.com/lasha-ilashvili/traveltogeorgia

## Overview

Travel to Georgia is a Spring web guide for discovering Georgian sightseeing locations, with account registration, login, profiles, and role-restricted user administration. Visitors browse, search, filter, and open location details; the location service retrieves and maps persisted records for the web layer. Authentication resolves users and roles, while account services support registration and profile/admin requests. The README documents these capabilities; controller-to-view wiring and database configuration were not excerpted, so those links are omitted or marked unverified.

Main entry points: [`src/main/java/com/capstone/traveltogeorgia/user/data/service/UserService.java`](https://github.com/lasha-ilashvili/traveltogeorgia/blob/main/src/main/java/com/capstone/traveltogeorgia/user/data/service/UserService.java) (Account service), [`src/main/java/com/capstone/traveltogeorgia/user/data/repository/UserRepository.java`](https://github.com/lasha-ilashvili/traveltogeorgia/blob/main/src/main/java/com/capstone/traveltogeorgia/user/data/repository/UserRepository.java) (User repository), [`src/main/java/com/capstone/traveltogeorgia/location/domain/controller/LocationsController.java`](https://github.com/lasha-ilashvili/traveltogeorgia/blob/main/src/main/java/com/capstone/traveltogeorgia/location/domain/controller/LocationsController.java) (Location requests), [`src/main/java/com/capstone/traveltogeorgia/location/data/service/LocationsService.java`](https://github.com/lasha-ilashvili/traveltogeorgia/blob/main/src/main/java/com/capstone/traveltogeorgia/location/data/service/LocationsService.java) (Location queries)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_locations["Location discovery"]
  node_location_controller["Location requests"]
  node_location_service["Location queries"]
  node_location_models["Location models"]
end

subgraph group_accounts["Accounts and access"]
  node_account_controller["Account requests"]
  node_user_controller["Profile and admin"]
  node_user_service["Account service<br/>[UserService.java]"]
  node_user_models["User and roles"]
  node_details_service["Login lookup"]
  node_security_config["Access rules"]
end

subgraph group_persistence["Persistence"]
  node_location_repository["Location repository"]
  node_location_entity["Location record"]
  node_database[("PostgreSQL")]
  node_user_repository["User repository"]
  node_user_entity["User record<br/>[UserEntity.java]"]
end

subgraph group_web["Web presentation"]
  node_views["HTML views"]
end

node_visitor(("Visitor"))

node_visitor -->|"browses"| node_location_controller
node_location_controller -->|"requests data"| node_location_service
node_location_service -->|"queries"| node_location_repository
node_location_service -->|"maps results"| node_location_models
node_location_repository -->|"returns records"| node_location_entity
node_location_entity -->|"uses enums"| node_location_models
node_location_repository -.->|"persists through JPA"| node_database
node_visitor -->|"registers"| node_account_controller
node_visitor -->|"views account"| node_user_controller
node_account_controller -->|"registers user"| node_user_service
node_user_controller -->|"requests users"| node_user_service
node_user_service -->|"reads and saves"| node_user_repository
node_user_service -->|"maps users"| node_user_models
node_user_repository -->|"returns records"| node_user_entity
node_user_entity -->|"uses role"| node_user_models
node_user_repository -.->|"persists through JPA"| node_database
node_details_service -->|"looks up user"| node_user_repository
node_security_config -->|"configures lookup"| node_details_service
node_security_config -->|"checks roles"| node_user_models
node_location_controller -.->|"renders pages"| node_views
node_account_controller -.->|"renders pages"| node_views
node_user_controller -.->|"renders pages"| node_views

click node_location_controller "https://github.com/lasha-ilashvili/traveltogeorgia/blob/main/src/main/java/com/capstone/traveltogeorgia/location/domain/controller/LocationsController.java"
click node_location_service "https://github.com/lasha-ilashvili/traveltogeorgia/blob/main/src/main/java/com/capstone/traveltogeorgia/location/data/service/LocationsService.java"
click node_location_models "https://github.com/lasha-ilashvili/traveltogeorgia/tree/main/src/main/java/com/capstone/traveltogeorgia/location/domain/model"
click node_location_repository "https://github.com/lasha-ilashvili/traveltogeorgia/blob/main/src/main/java/com/capstone/traveltogeorgia/location/data/Repository/LocationsRepository.java"
click node_location_entity "https://github.com/lasha-ilashvili/traveltogeorgia/blob/main/src/main/java/com/capstone/traveltogeorgia/location/data/model/LocationEntity.java"
click node_account_controller "https://github.com/lasha-ilashvili/traveltogeorgia/blob/main/src/main/java/com/capstone/traveltogeorgia/user/auth/domain/controller/AuthController.java"
click node_user_controller "https://github.com/lasha-ilashvili/traveltogeorgia/blob/main/src/main/java/com/capstone/traveltogeorgia/user/domain/controller/UserController.java"
click node_user_service "https://github.com/lasha-ilashvili/traveltogeorgia/blob/main/src/main/java/com/capstone/traveltogeorgia/user/data/service/UserService.java"
click node_user_models "https://github.com/lasha-ilashvili/traveltogeorgia/tree/main/src/main/java/com/capstone/traveltogeorgia/user/domain/model"
click node_user_repository "https://github.com/lasha-ilashvili/traveltogeorgia/blob/main/src/main/java/com/capstone/traveltogeorgia/user/data/repository/UserRepository.java"
click node_user_entity "https://github.com/lasha-ilashvili/traveltogeorgia/blob/main/src/main/java/com/capstone/traveltogeorgia/user/data/model/UserEntity.java"
click node_details_service "https://github.com/lasha-ilashvili/traveltogeorgia/blob/main/src/main/java/com/capstone/traveltogeorgia/user/auth/data/security/CustomUserDetailsService.java"
click node_security_config "https://github.com/lasha-ilashvili/traveltogeorgia/blob/main/src/main/java/com/capstone/traveltogeorgia/user/auth/data/security/SecurityConfig.java"
click node_views "https://github.com/lasha-ilashvili/traveltogeorgia/tree/main/src/main/resources/templates"

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_location_controller,node_location_service,node_location_models toneBlue
class node_account_controller,node_user_controller,node_user_service,node_user_models,node_details_service,node_security_config toneAmber
class node_location_repository,node_location_entity,node_database,node_user_repository,node_user_entity toneMint
class node_views toneRose
class node_visitor toneIndigo
```

## Components

### Location discovery

- [Location requests](https://github.com/lasha-ilashvili/traveltogeorgia/blob/main/src/main/java/com/capstone/traveltogeorgia/location/domain/controller/LocationsController.java): `src/main/java/com/capstone/traveltogeorgia/location/domain/controller/LocationsController.java`
- [Location queries](https://github.com/lasha-ilashvili/traveltogeorgia/blob/main/src/main/java/com/capstone/traveltogeorgia/location/data/service/LocationsService.java): `src/main/java/com/capstone/traveltogeorgia/location/data/service/LocationsService.java`
- [Location models](https://github.com/lasha-ilashvili/traveltogeorgia/tree/main/src/main/java/com/capstone/traveltogeorgia/location/domain/model): `src/main/java/com/capstone/traveltogeorgia/location/domain/model`

### Accounts and access

- [Account requests](https://github.com/lasha-ilashvili/traveltogeorgia/blob/main/src/main/java/com/capstone/traveltogeorgia/user/auth/domain/controller/AuthController.java): `src/main/java/com/capstone/traveltogeorgia/user/auth/domain/controller/AuthController.java`
- [Profile and admin](https://github.com/lasha-ilashvili/traveltogeorgia/blob/main/src/main/java/com/capstone/traveltogeorgia/user/domain/controller/UserController.java): `src/main/java/com/capstone/traveltogeorgia/user/domain/controller/UserController.java`
- [Account service](https://github.com/lasha-ilashvili/traveltogeorgia/blob/main/src/main/java/com/capstone/traveltogeorgia/user/data/service/UserService.java): `src/main/java/com/capstone/traveltogeorgia/user/data/service/UserService.java`
- [User and roles](https://github.com/lasha-ilashvili/traveltogeorgia/tree/main/src/main/java/com/capstone/traveltogeorgia/user/domain/model): `src/main/java/com/capstone/traveltogeorgia/user/domain/model`
- [Login lookup](https://github.com/lasha-ilashvili/traveltogeorgia/blob/main/src/main/java/com/capstone/traveltogeorgia/user/auth/data/security/CustomUserDetailsService.java): `src/main/java/com/capstone/traveltogeorgia/user/auth/data/security/CustomUserDetailsService.java`
- [Access rules](https://github.com/lasha-ilashvili/traveltogeorgia/blob/main/src/main/java/com/capstone/traveltogeorgia/user/auth/data/security/SecurityConfig.java): `src/main/java/com/capstone/traveltogeorgia/user/auth/data/security/SecurityConfig.java`

### Persistence

- [Location repository](https://github.com/lasha-ilashvili/traveltogeorgia/blob/main/src/main/java/com/capstone/traveltogeorgia/location/data/Repository/LocationsRepository.java): `src/main/java/com/capstone/traveltogeorgia/location/data/Repository/LocationsRepository.java`
- [Location record](https://github.com/lasha-ilashvili/traveltogeorgia/blob/main/src/main/java/com/capstone/traveltogeorgia/location/data/model/LocationEntity.java): `src/main/java/com/capstone/traveltogeorgia/location/data/model/LocationEntity.java`
- **PostgreSQL**
- [User repository](https://github.com/lasha-ilashvili/traveltogeorgia/blob/main/src/main/java/com/capstone/traveltogeorgia/user/data/repository/UserRepository.java): `src/main/java/com/capstone/traveltogeorgia/user/data/repository/UserRepository.java`
- [User record](https://github.com/lasha-ilashvili/traveltogeorgia/blob/main/src/main/java/com/capstone/traveltogeorgia/user/data/model/UserEntity.java): `src/main/java/com/capstone/traveltogeorgia/user/data/model/UserEntity.java`

### Web presentation

- [HTML views](https://github.com/lasha-ilashvili/traveltogeorgia/tree/main/src/main/resources/templates): `src/main/resources/templates`

### Other components

- **Visitor**

## Connections

- Visitor → Location requests: browses (evidence: `README.md`)
- Location requests → Location queries: requests data (evidence: `src/main/java/com/capstone/traveltogeorgia/location/domain/controller/LocationsController.java`)
- Location queries → Location repository: queries (evidence: `src/main/java/com/capstone/traveltogeorgia/location/data/service/LocationsService.java`)
- Location queries → Location models: maps results (evidence: `src/main/java/com/capstone/traveltogeorgia/location/data/service/LocationsService.java`)
- Location repository → Location record: returns records (evidence: `src/main/java/com/capstone/traveltogeorgia/location/data/Repository/LocationsRepository.java`)
- Location record → Location models: uses enums (evidence: `src/main/java/com/capstone/traveltogeorgia/location/data/model/LocationEntity.java`)
- Location repository → PostgreSQL: persists through JPA
- Visitor → Account requests: registers (evidence: `README.md`)
- Visitor → Profile and admin: views account (evidence: `README.md`)
- Account requests → Account service: registers user (evidence: `src/main/java/com/capstone/traveltogeorgia/user/auth/domain/controller/AuthController.java`)
- Profile and admin → Account service: requests users (evidence: `src/main/java/com/capstone/traveltogeorgia/user/domain/controller/UserController.java`)
- Account service → User repository: reads and saves (evidence: `src/main/java/com/capstone/traveltogeorgia/user/data/service/UserService.java`)
- Account service → User and roles: maps users (evidence: `src/main/java/com/capstone/traveltogeorgia/user/data/service/UserService.java`)
- User repository → User record: returns records (evidence: `src/main/java/com/capstone/traveltogeorgia/user/data/repository/UserRepository.java`)
- User record → User and roles: uses role (evidence: `src/main/java/com/capstone/traveltogeorgia/user/data/model/UserEntity.java`)
- User repository → PostgreSQL: persists through JPA
- Login lookup → User repository: looks up user (evidence: `src/main/java/com/capstone/traveltogeorgia/user/auth/data/security/CustomUserDetailsService.java`)
- Access rules → Login lookup: configures lookup (evidence: `src/main/java/com/capstone/traveltogeorgia/user/auth/data/security/SecurityConfig.java`)
- Access rules → User and roles: checks roles (evidence: `src/main/java/com/capstone/traveltogeorgia/user/auth/data/security/SecurityConfig.java`)
- Location requests → HTML views: renders pages
- Account requests → HTML views: renders pages
- Profile and admin → HTML views: renders pages
