# d7218/microservice_project architecture

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

- Interactive diagram: https://gitdiagram.com/d7218/microservice_project
- Repository: https://github.com/d7218/microservice_project

## Overview

This repository contains three HTTP microservices for users, hotels, and ratings, plus a service-registry application. The visible request workflow is controller → service contract/implementation → persistence repository, returning domain records to callers. User and hotel data use JPA repositories; ratings use MongoDB. The source excerpts do not establish cross-service calls or registry registration wiring, so those relationships are not asserted. Exception handling and application configuration exist, but their runtime connections are not mapped here.

Main entry points: [`UserService/UserService/src/main/java/com/lcwd/user/service/services/impl/UserServiceIMpl.java`](https://github.com/d7218/microservice_project/blob/main/UserService/UserService/src/main/java/com/lcwd/user/service/services/impl/UserServiceIMpl.java) (User operations), [`HotelService (1)/HotelService/src/main/java/com/lcwd/hotel/service/impl/HotelServiceImpl.java`](https://github.com/d7218/microservice_project/blob/main/HotelService%20(1)/HotelService/src/main/java/com/lcwd/hotel/service/impl/HotelServiceImpl.java) (Hotel operations), [`RaringServuice/RaringServuice/src/main/java/com/lcwd/rating/services/impl/RatingServiceImpl.java`](https://github.com/d7218/microservice_project/blob/main/RaringServuice/RaringServuice/src/main/java/com/lcwd/rating/services/impl/RatingServiceImpl.java) (Rating operations), [`UserService/UserService/src/main/java/com/lcwd/user/service/Controller/UserController.java`](https://github.com/d7218/microservice_project/blob/main/UserService/UserService/src/main/java/com/lcwd/user/service/Controller/UserController.java) (User API)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_user["User service"]
  node_user_controller["User API"]
  node_user_contract["User service contract<br/>[UserService.java]"]
  node_user_impl["User operations"]
  node_user_repo["User repository"]
  node_user_data["User records<br/>[User.java]"]
  node_user_db[("Relational database")]
end

subgraph group_hotel["Hotel service"]
  node_hotel_controller["Hotel API"]
  node_hotel_contract["Hotel service contract<br/>[HotelService.java]"]
  node_hotel_impl["Hotel operations"]
  node_hotel_repo["Hotel repository"]
  node_hotel_data["Hotel records<br/>[Hotel.java]"]
  node_hotel_db[("Relational database")]
end

subgraph group_rating["Rating service"]
  node_rating_controller["Rating API"]
  node_rating_contract["Rating service contract<br/>[RatingService.java]"]
  node_rating_impl["Rating operations"]
  node_rating_repo["Rating repository"]
  node_rating_data["Rating records<br/>[Rating.java]"]
  node_rating_db[("MongoDB")]
end

subgraph group_registry["Service registry"]
  node_registry_app["Registry application"]
end

node_client(("API client"))

node_client -->|"sends requests"| node_user_controller
node_user_controller -->|"calls"| node_user_contract
node_user_impl -->|"implements"| node_user_contract
node_user_impl -->|"uses"| node_user_repo
node_user_repo -->|"persists"| node_user_db
node_user_impl -->|"handles"| node_user_data
node_client -->|"sends requests"| node_hotel_controller
node_hotel_controller -->|"calls"| node_hotel_contract
node_hotel_impl -->|"implements"| node_hotel_contract
node_hotel_impl -->|"uses"| node_hotel_repo
node_hotel_repo -->|"persists"| node_hotel_db
node_hotel_impl -->|"handles"| node_hotel_data
node_client -->|"sends requests"| node_rating_controller
node_rating_controller -->|"calls"| node_rating_contract
node_rating_impl -->|"implements"| node_rating_contract
node_rating_impl -->|"uses"| node_rating_repo
node_rating_repo -->|"persists"| node_rating_db
node_rating_impl -->|"handles"| node_rating_data

click node_user_controller "https://github.com/d7218/microservice_project/blob/main/UserService/UserService/src/main/java/com/lcwd/user/service/Controller/UserController.java"
click node_user_contract "https://github.com/d7218/microservice_project/blob/main/UserService/UserService/src/main/java/com/lcwd/user/service/services/UserService.java"
click node_user_impl "https://github.com/d7218/microservice_project/blob/main/UserService/UserService/src/main/java/com/lcwd/user/service/services/impl/UserServiceIMpl.java"
click node_user_repo "https://github.com/d7218/microservice_project/blob/main/UserService/UserService/src/main/java/com/lcwd/user/service/repository/UserRepository.java"
click node_user_data "https://github.com/d7218/microservice_project/blob/main/UserService/UserService/src/main/java/com/lcwd/user/service/entites/User.java"
click node_hotel_controller "https://github.com/d7218/microservice_project/blob/main/HotelService%20(1)/HotelService/src/main/java/com/lcwd/hotel/controller/HotelController.java"
click node_hotel_contract "https://github.com/d7218/microservice_project/blob/main/HotelService%20(1)/HotelService/src/main/java/com/lcwd/hotel/service/HotelService.java"
click node_hotel_impl "https://github.com/d7218/microservice_project/blob/main/HotelService%20(1)/HotelService/src/main/java/com/lcwd/hotel/service/impl/HotelServiceImpl.java"
click node_hotel_repo "https://github.com/d7218/microservice_project/blob/main/HotelService%20(1)/HotelService/src/main/java/com/lcwd/hotel/repository/HotelRepository.java"
click node_hotel_data "https://github.com/d7218/microservice_project/blob/main/HotelService%20(1)/HotelService/src/main/java/com/lcwd/hotel/entity/Hotel.java"
click node_rating_controller "https://github.com/d7218/microservice_project/blob/main/RaringServuice/RaringServuice/src/main/java/com/lcwd/rating/controller/RatingController.java"
click node_rating_contract "https://github.com/d7218/microservice_project/blob/main/RaringServuice/RaringServuice/src/main/java/com/lcwd/rating/services/RatingService.java"
click node_rating_impl "https://github.com/d7218/microservice_project/blob/main/RaringServuice/RaringServuice/src/main/java/com/lcwd/rating/services/impl/RatingServiceImpl.java"
click node_rating_repo "https://github.com/d7218/microservice_project/blob/main/RaringServuice/RaringServuice/src/main/java/com/lcwd/rating/repository/RatingRepository.java"
click node_rating_data "https://github.com/d7218/microservice_project/blob/main/RaringServuice/RaringServuice/src/main/java/com/lcwd/rating/entity/Rating.java"
click node_registry_app "https://github.com/d7218/microservice_project/blob/main/ServiceRegistry/src/main/java/com/lcwd/ServiceRegistry/ServiceRegistryApplication.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_user_controller,node_user_contract,node_user_impl,node_user_repo,node_user_data,node_user_db,node_client toneBlue
class node_hotel_controller,node_hotel_contract,node_hotel_impl,node_hotel_repo,node_hotel_data,node_hotel_db toneAmber
class node_rating_controller,node_rating_contract,node_rating_impl,node_rating_repo,node_rating_data,node_rating_db toneMint
class node_registry_app toneRose
```

## Components

### User service

- [User API](https://github.com/d7218/microservice_project/blob/main/UserService/UserService/src/main/java/com/lcwd/user/service/Controller/UserController.java): `UserService/UserService/src/main/java/com/lcwd/user/service/Controller/UserController.java`
- [User service contract](https://github.com/d7218/microservice_project/blob/main/UserService/UserService/src/main/java/com/lcwd/user/service/services/UserService.java): `UserService/UserService/src/main/java/com/lcwd/user/service/services/UserService.java`
- [User operations](https://github.com/d7218/microservice_project/blob/main/UserService/UserService/src/main/java/com/lcwd/user/service/services/impl/UserServiceIMpl.java): `UserService/UserService/src/main/java/com/lcwd/user/service/services/impl/UserServiceIMpl.java`
- [User repository](https://github.com/d7218/microservice_project/blob/main/UserService/UserService/src/main/java/com/lcwd/user/service/repository/UserRepository.java): `UserService/UserService/src/main/java/com/lcwd/user/service/repository/UserRepository.java`
- [User records](https://github.com/d7218/microservice_project/blob/main/UserService/UserService/src/main/java/com/lcwd/user/service/entites/User.java): `UserService/UserService/src/main/java/com/lcwd/user/service/entites/User.java`
- **Relational database**

### Hotel service

- [Hotel API](https://github.com/d7218/microservice_project/blob/main/HotelService%20(1)/HotelService/src/main/java/com/lcwd/hotel/controller/HotelController.java): `HotelService (1)/HotelService/src/main/java/com/lcwd/hotel/controller/HotelController.java`
- [Hotel service contract](https://github.com/d7218/microservice_project/blob/main/HotelService%20(1)/HotelService/src/main/java/com/lcwd/hotel/service/HotelService.java): `HotelService (1)/HotelService/src/main/java/com/lcwd/hotel/service/HotelService.java`
- [Hotel operations](https://github.com/d7218/microservice_project/blob/main/HotelService%20(1)/HotelService/src/main/java/com/lcwd/hotel/service/impl/HotelServiceImpl.java): `HotelService (1)/HotelService/src/main/java/com/lcwd/hotel/service/impl/HotelServiceImpl.java`
- [Hotel repository](https://github.com/d7218/microservice_project/blob/main/HotelService%20(1)/HotelService/src/main/java/com/lcwd/hotel/repository/HotelRepository.java): `HotelService (1)/HotelService/src/main/java/com/lcwd/hotel/repository/HotelRepository.java`
- [Hotel records](https://github.com/d7218/microservice_project/blob/main/HotelService%20(1)/HotelService/src/main/java/com/lcwd/hotel/entity/Hotel.java): `HotelService (1)/HotelService/src/main/java/com/lcwd/hotel/entity/Hotel.java`
- **Relational database**

### Rating service

- [Rating API](https://github.com/d7218/microservice_project/blob/main/RaringServuice/RaringServuice/src/main/java/com/lcwd/rating/controller/RatingController.java): `RaringServuice/RaringServuice/src/main/java/com/lcwd/rating/controller/RatingController.java`
- [Rating service contract](https://github.com/d7218/microservice_project/blob/main/RaringServuice/RaringServuice/src/main/java/com/lcwd/rating/services/RatingService.java): `RaringServuice/RaringServuice/src/main/java/com/lcwd/rating/services/RatingService.java`
- [Rating operations](https://github.com/d7218/microservice_project/blob/main/RaringServuice/RaringServuice/src/main/java/com/lcwd/rating/services/impl/RatingServiceImpl.java): `RaringServuice/RaringServuice/src/main/java/com/lcwd/rating/services/impl/RatingServiceImpl.java`
- [Rating repository](https://github.com/d7218/microservice_project/blob/main/RaringServuice/RaringServuice/src/main/java/com/lcwd/rating/repository/RatingRepository.java): `RaringServuice/RaringServuice/src/main/java/com/lcwd/rating/repository/RatingRepository.java`
- [Rating records](https://github.com/d7218/microservice_project/blob/main/RaringServuice/RaringServuice/src/main/java/com/lcwd/rating/entity/Rating.java): `RaringServuice/RaringServuice/src/main/java/com/lcwd/rating/entity/Rating.java`
- **MongoDB**

### Service registry

- [Registry application](https://github.com/d7218/microservice_project/blob/main/ServiceRegistry/src/main/java/com/lcwd/ServiceRegistry/ServiceRegistryApplication.java): `ServiceRegistry/src/main/java/com/lcwd/ServiceRegistry/ServiceRegistryApplication.java`

### Other components

- **API client**

## Connections

- API client → User API: sends requests (evidence: `UserService/UserService/src/main/java/com/lcwd/user/service/Controller/UserController.java`)
- User API → User service contract: calls (evidence: `UserService/UserService/src/main/java/com/lcwd/user/service/Controller/UserController.java`)
- User operations → User service contract: implements (evidence: `UserService/UserService/src/main/java/com/lcwd/user/service/services/impl/UserServiceIMpl.java`)
- User operations → User repository: uses (evidence: `UserService/UserService/src/main/java/com/lcwd/user/service/services/impl/UserServiceIMpl.java`)
- User repository → Relational database: persists (evidence: `UserService/UserService/src/main/java/com/lcwd/user/service/repository/UserRepository.java`)
- User operations → User records: handles (evidence: `UserService/UserService/src/main/java/com/lcwd/user/service/services/impl/UserServiceIMpl.java`)
- API client → Hotel API: sends requests (evidence: `HotelService (1)/HotelService/src/main/java/com/lcwd/hotel/controller/HotelController.java`)
- Hotel API → Hotel service contract: calls (evidence: `HotelService (1)/HotelService/src/main/java/com/lcwd/hotel/controller/HotelController.java`)
- Hotel operations → Hotel service contract: implements (evidence: `HotelService (1)/HotelService/src/main/java/com/lcwd/hotel/service/impl/HotelServiceImpl.java`)
- Hotel operations → Hotel repository: uses (evidence: `HotelService (1)/HotelService/src/main/java/com/lcwd/hotel/service/impl/HotelServiceImpl.java`)
- Hotel repository → Relational database: persists (evidence: `HotelService (1)/HotelService/src/main/java/com/lcwd/hotel/repository/HotelRepository.java`)
- Hotel operations → Hotel records: handles (evidence: `HotelService (1)/HotelService/src/main/java/com/lcwd/hotel/service/impl/HotelServiceImpl.java`)
- API client → Rating API: sends requests (evidence: `RaringServuice/RaringServuice/src/main/java/com/lcwd/rating/controller/RatingController.java`)
- Rating API → Rating service contract: calls (evidence: `RaringServuice/RaringServuice/src/main/java/com/lcwd/rating/controller/RatingController.java`)
- Rating operations → Rating service contract: implements (evidence: `RaringServuice/RaringServuice/src/main/java/com/lcwd/rating/services/impl/RatingServiceImpl.java`)
- Rating operations → Rating repository: uses (evidence: `RaringServuice/RaringServuice/src/main/java/com/lcwd/rating/services/impl/RatingServiceImpl.java`)
- Rating repository → MongoDB: persists (evidence: `RaringServuice/RaringServuice/src/main/java/com/lcwd/rating/repository/RatingRepository.java`)
- Rating operations → Rating records: handles (evidence: `RaringServuice/RaringServuice/src/main/java/com/lcwd/rating/services/impl/RatingServiceImpl.java`)
