# nithish0302/dinehub architecture

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

- Interactive diagram: https://gitdiagram.com/nithish0302/dinehub
- Repository: https://github.com/nithish0302/dinehub

## Overview

DineHub is a Spring Boot microservices application for user accounts and authentication, food catalog CRUD, and payments, with an API gateway and Eureka registry also present in the tree. The main user workflow is account creation or login, followed by authenticated account operations; food and payment APIs provide separate domain workflows. Service interfaces separate controllers from persistence-oriented implementations. The README describes session authentication, while the sampled implementation issues JWT access tokens and refresh tokens, so the graph reflects the source. Some service integrations and gateway routing are not established by the excerpts.

Main entry points: [`user-service/src/main/java/com/dinehub/user/service/impl/UserServiceImpl.java`](https://github.com/nithish0302/dinehub/blob/main/user-service/src/main/java/com/dinehub/user/service/impl/UserServiceImpl.java) (Account logic), [`user-service/src/main/java/com/dinehub/user/controller/UserController.java`](https://github.com/nithish0302/dinehub/blob/main/user-service/src/main/java/com/dinehub/user/controller/UserController.java) (User API), [`payment-service/src/main/java/com/dinehub/paymentservice/services/impl/PaymentServiceImpl.java`](https://github.com/nithish0302/dinehub/blob/main/payment-service/src/main/java/com/dinehub/paymentservice/services/impl/PaymentServiceImpl.java) (Payment logic), [`api-gateway/src/main/java/com/dinehub/apigateway/filter/JwtAuthenticationFilter.java`](https://github.com/nithish0302/dinehub/blob/main/api-gateway/src/main/java/com/dinehub/apigateway/filter/JwtAuthenticationFilter.java) (Gateway filters)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_edge["Gateway and registry"]
  node_gateway["Gateway filters"]
  node_gatewayjwt["JWT validation<br/>[JwtService.java]"]
  node_registry["Eureka registry"]
end

subgraph group_users["User accounts"]
  node_userapi["User API"]
  node_userservice["Account logic"]
  node_userrepo[("User persistence")]
  node_userentity["User model<br/>[User.java]"]
  node_userjwt["Access-token issuer<br/>[JwtService.java]"]
  node_refreshtoken["Refresh-token logic"]
  node_refreshentity["Refresh-token model<br/>[RefreshToken.java]"]
  node_usererrors["User error handling"]
end

subgraph group_catalog["Food catalog"]
  node_foodapi["Food API"]
  node_foodlogic["Catalog logic"]
  node_foodrepo[("Food persistence")]
  node_foodmodel["Food model<br/>[Food.java]"]
  node_fooderrors["Food error handling"]
end

subgraph group_payments["Payments"]
  node_paymentapi["Payment API"]
  node_paymentlogic["Payment logic"]
  node_paymentrepo[("Payment persistence")]
  node_paymentmodel["Payment model<br/>[Payment.java]"]
  node_userclient["User service client"]
end

node_customer(("API client"))

node_customer -.->|"sends requests"| node_gateway
node_gateway -->|"validates tokens"| node_gatewayjwt
node_customer -->|"calls account API"| node_userapi
node_userapi -->|"delegates account work"| node_userservice
node_userapi -->|"delegates token actions"| node_refreshtoken
node_userservice -->|"reads and writes"| node_userrepo
node_userservice -->|"issues access token"| node_userjwt
node_userservice -->|"creates refresh token"| node_refreshtoken
node_customer -->|"calls catalog API"| node_foodapi
node_foodapi -->|"delegates catalog work"| node_foodlogic
node_foodlogic -->|"reads and writes"| node_foodrepo
node_customer -.->|"calls payment API"| node_paymentapi
node_paymentapi -->|"delegates payment work"| node_paymentlogic
node_paymentlogic -->|"reads and writes"| node_paymentrepo
node_paymentlogic -->|"uses user client"| node_userclient
node_registry -->|"registers service"| node_userapi

click node_gateway "https://github.com/nithish0302/dinehub/blob/main/api-gateway/src/main/java/com/dinehub/apigateway/filter/JwtAuthenticationFilter.java"
click node_gatewayjwt "https://github.com/nithish0302/dinehub/blob/main/api-gateway/src/main/java/com/dinehub/apigateway/security/JwtService.java"
click node_registry "https://github.com/nithish0302/dinehub/blob/main/eureka-server/src/main/java/com/dinehub/eurekaserver/EurekaServerApplication.java"
click node_userapi "https://github.com/nithish0302/dinehub/blob/main/user-service/src/main/java/com/dinehub/user/controller/UserController.java"
click node_userservice "https://github.com/nithish0302/dinehub/blob/main/user-service/src/main/java/com/dinehub/user/service/impl/UserServiceImpl.java"
click node_userrepo "https://github.com/nithish0302/dinehub/blob/main/user-service/src/main/java/com/dinehub/user/repository/UserRepository.java"
click node_userentity "https://github.com/nithish0302/dinehub/blob/main/user-service/src/main/java/com/dinehub/user/entity/User.java"
click node_userjwt "https://github.com/nithish0302/dinehub/blob/main/user-service/src/main/java/com/dinehub/user/security/JwtService.java"
click node_refreshtoken "https://github.com/nithish0302/dinehub/blob/main/user-service/src/main/java/com/dinehub/user/service/impl/RefreshServiceTokenImpl.java"
click node_refreshentity "https://github.com/nithish0302/dinehub/blob/main/user-service/src/main/java/com/dinehub/user/entity/RefreshToken.java"
click node_usererrors "https://github.com/nithish0302/dinehub/blob/main/user-service/src/main/java/com/dinehub/user/exception/GlobalExceptionHandler.java"
click node_foodapi "https://github.com/nithish0302/dinehub/blob/main/food-service/src/main/java/com/dinehub/foodService/controller/FoodController.java"
click node_foodlogic "https://github.com/nithish0302/dinehub/blob/main/food-service/src/main/java/com/dinehub/foodService/service/seviceImpl/FoodServiceImpl.java"
click node_foodrepo "https://github.com/nithish0302/dinehub/blob/main/food-service/src/main/java/com/dinehub/foodService/repository/FoodRepository.java"
click node_foodmodel "https://github.com/nithish0302/dinehub/blob/main/food-service/src/main/java/com/dinehub/foodService/entity/Food.java"
click node_fooderrors "https://github.com/nithish0302/dinehub/blob/main/food-service/src/main/java/com/dinehub/foodService/exception/GlobalExceptionHandler.java"
click node_paymentapi "https://github.com/nithish0302/dinehub/blob/main/payment-service/src/main/java/com/dinehub/paymentservice/controller/PaymentController.java"
click node_paymentlogic "https://github.com/nithish0302/dinehub/blob/main/payment-service/src/main/java/com/dinehub/paymentservice/services/impl/PaymentServiceImpl.java"
click node_paymentrepo "https://github.com/nithish0302/dinehub/blob/main/payment-service/src/main/java/com/dinehub/paymentservice/repository/PaymentRepository.java"
click node_paymentmodel "https://github.com/nithish0302/dinehub/blob/main/payment-service/src/main/java/com/dinehub/paymentservice/entity/Payment.java"
click node_userclient "https://github.com/nithish0302/dinehub/blob/main/payment-service/src/main/java/com/dinehub/paymentservice/client/UserServiceClient.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_gateway,node_gatewayjwt,node_registry,node_customer toneBlue
class node_userapi,node_userservice,node_userrepo,node_userentity,node_userjwt,node_refreshtoken,node_refreshentity,node_usererrors toneAmber
class node_foodapi,node_foodlogic,node_foodrepo,node_foodmodel,node_fooderrors toneMint
class node_paymentapi,node_paymentlogic,node_paymentrepo,node_paymentmodel,node_userclient toneRose
```

## Components

### Gateway and registry

- [Gateway filters](https://github.com/nithish0302/dinehub/blob/main/api-gateway/src/main/java/com/dinehub/apigateway/filter/JwtAuthenticationFilter.java): `api-gateway/src/main/java/com/dinehub/apigateway/filter/JwtAuthenticationFilter.java`
- [JWT validation](https://github.com/nithish0302/dinehub/blob/main/api-gateway/src/main/java/com/dinehub/apigateway/security/JwtService.java): `api-gateway/src/main/java/com/dinehub/apigateway/security/JwtService.java`
- [Eureka registry](https://github.com/nithish0302/dinehub/blob/main/eureka-server/src/main/java/com/dinehub/eurekaserver/EurekaServerApplication.java): `eureka-server/src/main/java/com/dinehub/eurekaserver/EurekaServerApplication.java`

### User accounts

- [User API](https://github.com/nithish0302/dinehub/blob/main/user-service/src/main/java/com/dinehub/user/controller/UserController.java): `user-service/src/main/java/com/dinehub/user/controller/UserController.java`
- [Account logic](https://github.com/nithish0302/dinehub/blob/main/user-service/src/main/java/com/dinehub/user/service/impl/UserServiceImpl.java): `user-service/src/main/java/com/dinehub/user/service/impl/UserServiceImpl.java`
- [User persistence](https://github.com/nithish0302/dinehub/blob/main/user-service/src/main/java/com/dinehub/user/repository/UserRepository.java): `user-service/src/main/java/com/dinehub/user/repository/UserRepository.java`
- [User model](https://github.com/nithish0302/dinehub/blob/main/user-service/src/main/java/com/dinehub/user/entity/User.java): `user-service/src/main/java/com/dinehub/user/entity/User.java`
- [Access-token issuer](https://github.com/nithish0302/dinehub/blob/main/user-service/src/main/java/com/dinehub/user/security/JwtService.java): `user-service/src/main/java/com/dinehub/user/security/JwtService.java`
- [Refresh-token logic](https://github.com/nithish0302/dinehub/blob/main/user-service/src/main/java/com/dinehub/user/service/impl/RefreshServiceTokenImpl.java): `user-service/src/main/java/com/dinehub/user/service/impl/RefreshServiceTokenImpl.java`
- [Refresh-token model](https://github.com/nithish0302/dinehub/blob/main/user-service/src/main/java/com/dinehub/user/entity/RefreshToken.java): `user-service/src/main/java/com/dinehub/user/entity/RefreshToken.java`
- [User error handling](https://github.com/nithish0302/dinehub/blob/main/user-service/src/main/java/com/dinehub/user/exception/GlobalExceptionHandler.java): `user-service/src/main/java/com/dinehub/user/exception/GlobalExceptionHandler.java`

### Food catalog

- [Food API](https://github.com/nithish0302/dinehub/blob/main/food-service/src/main/java/com/dinehub/foodService/controller/FoodController.java): `food-service/src/main/java/com/dinehub/foodService/controller/FoodController.java`
- [Catalog logic](https://github.com/nithish0302/dinehub/blob/main/food-service/src/main/java/com/dinehub/foodService/service/seviceImpl/FoodServiceImpl.java): `food-service/src/main/java/com/dinehub/foodService/service/seviceImpl/FoodServiceImpl.java`
- [Food persistence](https://github.com/nithish0302/dinehub/blob/main/food-service/src/main/java/com/dinehub/foodService/repository/FoodRepository.java): `food-service/src/main/java/com/dinehub/foodService/repository/FoodRepository.java`
- [Food model](https://github.com/nithish0302/dinehub/blob/main/food-service/src/main/java/com/dinehub/foodService/entity/Food.java): `food-service/src/main/java/com/dinehub/foodService/entity/Food.java`
- [Food error handling](https://github.com/nithish0302/dinehub/blob/main/food-service/src/main/java/com/dinehub/foodService/exception/GlobalExceptionHandler.java): `food-service/src/main/java/com/dinehub/foodService/exception/GlobalExceptionHandler.java`

### Payments

- [Payment API](https://github.com/nithish0302/dinehub/blob/main/payment-service/src/main/java/com/dinehub/paymentservice/controller/PaymentController.java): `payment-service/src/main/java/com/dinehub/paymentservice/controller/PaymentController.java`
- [Payment logic](https://github.com/nithish0302/dinehub/blob/main/payment-service/src/main/java/com/dinehub/paymentservice/services/impl/PaymentServiceImpl.java): `payment-service/src/main/java/com/dinehub/paymentservice/services/impl/PaymentServiceImpl.java`
- [Payment persistence](https://github.com/nithish0302/dinehub/blob/main/payment-service/src/main/java/com/dinehub/paymentservice/repository/PaymentRepository.java): `payment-service/src/main/java/com/dinehub/paymentservice/repository/PaymentRepository.java`
- [Payment model](https://github.com/nithish0302/dinehub/blob/main/payment-service/src/main/java/com/dinehub/paymentservice/entity/Payment.java): `payment-service/src/main/java/com/dinehub/paymentservice/entity/Payment.java`
- [User service client](https://github.com/nithish0302/dinehub/blob/main/payment-service/src/main/java/com/dinehub/paymentservice/client/UserServiceClient.java): `payment-service/src/main/java/com/dinehub/paymentservice/client/UserServiceClient.java`

### Other components

- **API client**

## Connections

- API client → Gateway filters: sends requests
- Gateway filters → JWT validation: validates tokens (evidence: `api-gateway/src/main/java/com/dinehub/apigateway/filter/JwtAuthenticationFilter.java`)
- API client → User API: calls account API
- User API → Account logic: delegates account work (evidence: `user-service/src/main/java/com/dinehub/user/controller/UserController.java`)
- User API → Refresh-token logic: delegates token actions (evidence: `user-service/src/main/java/com/dinehub/user/controller/UserController.java`)
- Account logic → User persistence: reads and writes (evidence: `user-service/src/main/java/com/dinehub/user/service/impl/UserServiceImpl.java`)
- Account logic → Access-token issuer: issues access token (evidence: `user-service/src/main/java/com/dinehub/user/service/impl/UserServiceImpl.java`)
- Account logic → Refresh-token logic: creates refresh token (evidence: `user-service/src/main/java/com/dinehub/user/service/impl/UserServiceImpl.java`)
- API client → Food API: calls catalog API
- Food API → Catalog logic: delegates catalog work (evidence: `food-service/src/main/java/com/dinehub/foodService/controller/FoodController.java`)
- Catalog logic → Food persistence: reads and writes (evidence: `food-service/src/main/java/com/dinehub/foodService/service/seviceImpl/FoodServiceImpl.java`)
- API client → Payment API: calls payment API
- Payment API → Payment logic: delegates payment work (evidence: `payment-service/src/main/java/com/dinehub/paymentservice/controller/PaymentController.java`)
- Payment logic → Payment persistence: reads and writes (evidence: `payment-service/src/main/java/com/dinehub/paymentservice/services/impl/PaymentServiceImpl.java`)
- Payment logic → User service client: uses user client (evidence: `payment-service/src/main/java/com/dinehub/paymentservice/services/impl/PaymentServiceImpl.java`)
- Eureka registry → User API: registers service
