# armaan-94/food-delivery-system architecture

> Architecture diagram of the GitHub repository armaan-94/food-delivery-system, generated by GitDiagram from its file tree, README and a sample of source files (last updated 2026-09-30). It is an AI-made overview: check details against the source.

- Interactive diagram: https://gitdiagram.com/armaan-94/food-delivery-system
- Repository: https://github.com/armaan-94/food-delivery-system

## Overview

This is a Spring Cloud food-delivery platform: clients enter through the API Gateway, authenticate through the dedicated auth service, and use separate services for customer profiles, order placement/history, and delivery logistics. Each business service owns its data; Eureka supports discovery and the Config Server supplies centralized configuration. The sampled code shows the auth and user service layers directly, plus the order service’s repository call. Delivery internals and most runtime infrastructure wiring were not sampled, so those documented relationships are identified as documentation-based rather than source-verified.

Main entry points: [`apigateway/src/main/java/com/fooddelivery/apigateway/config/GatewayConfig.java`](https://github.com/armaan-94/food-delivery-system/blob/main/apigateway/src/main/java/com/fooddelivery/apigateway/config/GatewayConfig.java) (API Gateway), [`configurationserver/src/main/java/com/fooddelivery/configurationserver/ConfigurationserverApplication.java`](https://github.com/armaan-94/food-delivery-system/blob/main/configurationserver/src/main/java/com/fooddelivery/configurationserver/ConfigurationserverApplication.java) (Config Server), [`user-service/src/main/java/com/fooddelivery/controller/UserController.java`](https://github.com/armaan-94/food-delivery-system/blob/main/user-service/src/main/java/com/fooddelivery/controller/UserController.java) (User API), [`orderservice/src/main/java/com/fooddelivery/orderservice/controller/OrderController.java`](https://github.com/armaan-94/food-delivery-system/blob/main/orderservice/src/main/java/com/fooddelivery/orderservice/controller/OrderController.java) (Order API)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_edge["Platform Edge"]
  node_gateway["API Gateway<br/>[GatewayConfig.java]"]
end

subgraph group_identity["Identity"]
  node_auth_controller["Auth API"]
  node_auth_service["Auth Service<br/>[AuthService.java]"]
  node_auth_repo["Auth Repository"]
  node_auth_db[("Auth Database")]
end

subgraph group_customers["Customer Data"]
  node_user_controller["User API"]
  node_user_service["User Service<br/>[UserService.java]"]
  node_user_repo["User Repository"]
  node_user_db[("User Database")]
end

subgraph group_commerce["Orders"]
  node_order_controller["Order API"]
  node_order_service["Order Service<br/>[OrderService.java]"]
  node_order_repo["Order Repository"]
  node_order_db[("Order Database")]
end

subgraph group_logistics["Delivery Logistics"]
  node_delivery_controller["Delivery API"]
  node_partner_controller["Partner API"]
  node_delivery_service["Delivery Service"]
  node_partner_service["Partner Service"]
  node_delivery_db[("Delivery Database")]
end

subgraph group_platform["Platform Services"]
  node_registry["Eureka Registry"]
  node_config_server["Config Server"]
end

node_client(("Client"))

node_client -->|"sends requests"| node_gateway
node_gateway -.->|"routes requests"| node_auth_controller
node_gateway -.->|"routes requests"| node_user_controller
node_gateway -.->|"routes requests"| node_order_controller
node_gateway -.->|"routes requests"| node_delivery_controller
node_auth_controller -->|"delegates auth"| node_auth_service
node_auth_service -->|"checks credentials"| node_auth_repo
node_auth_repo -->|"reads and writes"| node_auth_db
node_user_controller -->|"delegates requests"| node_user_service
node_user_service -->|"manages profiles"| node_user_repo
node_user_repo -->|"reads and writes"| node_user_db
node_order_controller -->|"delegates queries"| node_order_service
node_order_service -->|"loads orders"| node_order_repo
node_order_repo -.->|"stores orders"| node_order_db
node_delivery_controller -->|"delegates logistics"| node_delivery_service
node_partner_controller -->|"delegates partner tasks"| node_partner_service
node_delivery_service -.->|"manages delivery data"| node_delivery_db
node_partner_service -.->|"manages partner data"| node_delivery_db
node_gateway -.->|"uses discovery"| node_registry
node_user_controller -.->|"registers service"| node_registry
node_order_controller -.->|"registers service"| node_registry
node_delivery_controller -.->|"registers service"| node_registry
node_gateway -.->|"loads configuration"| node_config_server
node_auth_controller -.->|"loads configuration"| node_config_server
node_user_controller -.->|"loads configuration"| node_config_server
node_order_controller -.->|"loads configuration"| node_config_server
node_delivery_controller -.->|"loads configuration"| node_config_server

click node_gateway "https://github.com/armaan-94/food-delivery-system/blob/main/apigateway/src/main/java/com/fooddelivery/apigateway/config/GatewayConfig.java"
click node_auth_controller "https://github.com/armaan-94/food-delivery-system/blob/main/authservice/src/main/java/com/fooddelivery/authservice/controller/AuthController.java"
click node_auth_service "https://github.com/armaan-94/food-delivery-system/blob/main/authservice/src/main/java/com/fooddelivery/authservice/service/AuthService.java"
click node_auth_repo "https://github.com/armaan-94/food-delivery-system/blob/main/authservice/src/main/java/com/fooddelivery/authservice/repository/AuthRepository.java"
click node_user_controller "https://github.com/armaan-94/food-delivery-system/blob/main/user-service/src/main/java/com/fooddelivery/controller/UserController.java"
click node_user_service "https://github.com/armaan-94/food-delivery-system/blob/main/user-service/src/main/java/com/fooddelivery/service/UserService.java"
click node_user_repo "https://github.com/armaan-94/food-delivery-system/blob/main/user-service/src/main/java/com/fooddelivery/repository/UserRepository.java"
click node_order_controller "https://github.com/armaan-94/food-delivery-system/blob/main/orderservice/src/main/java/com/fooddelivery/orderservice/controller/OrderController.java"
click node_order_service "https://github.com/armaan-94/food-delivery-system/blob/main/orderservice/src/main/java/com/fooddelivery/orderservice/service/OrderService.java"
click node_order_repo "https://github.com/armaan-94/food-delivery-system/blob/main/orderservice/src/main/java/com/fooddelivery/orderservice/repository/FoodOrderRepository.java"
click node_delivery_controller "https://github.com/armaan-94/food-delivery-system/blob/main/delivery-service/src/main/java/com/fooddelivery/controller/DeliveryController.java"
click node_partner_controller "https://github.com/armaan-94/food-delivery-system/blob/main/delivery-service/src/main/java/com/fooddelivery/controller/PartnerController.java"
click node_delivery_service "https://github.com/armaan-94/food-delivery-system/blob/main/delivery-service/src/main/java/com/fooddelivery/service/DeliveryServiceImpl.java"
click node_partner_service "https://github.com/armaan-94/food-delivery-system/blob/main/delivery-service/src/main/java/com/fooddelivery/service/PartnerServiceImpl.java"
click node_registry "https://github.com/armaan-94/food-delivery-system/blob/main/servicediscovery/src/main/java/com/fooddelivery/servicediscovery/ServicediscoveryApplication.java"
click node_config_server "https://github.com/armaan-94/food-delivery-system/blob/main/configurationserver/src/main/java/com/fooddelivery/configurationserver/ConfigurationserverApplication.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_client toneBlue
class node_auth_controller,node_auth_service,node_auth_repo,node_auth_db toneAmber
class node_user_controller,node_user_service,node_user_repo,node_user_db toneMint
class node_order_controller,node_order_service,node_order_repo,node_order_db toneRose
class node_delivery_controller,node_partner_controller,node_delivery_service,node_partner_service,node_delivery_db toneIndigo
class node_registry,node_config_server toneTeal
```

## Components

### Platform Edge

- [API Gateway](https://github.com/armaan-94/food-delivery-system/blob/main/apigateway/src/main/java/com/fooddelivery/apigateway/config/GatewayConfig.java): `apigateway/src/main/java/com/fooddelivery/apigateway/config/GatewayConfig.java`

### Identity

- [Auth API](https://github.com/armaan-94/food-delivery-system/blob/main/authservice/src/main/java/com/fooddelivery/authservice/controller/AuthController.java): `authservice/src/main/java/com/fooddelivery/authservice/controller/AuthController.java`
- [Auth Service](https://github.com/armaan-94/food-delivery-system/blob/main/authservice/src/main/java/com/fooddelivery/authservice/service/AuthService.java): `authservice/src/main/java/com/fooddelivery/authservice/service/AuthService.java`
- [Auth Repository](https://github.com/armaan-94/food-delivery-system/blob/main/authservice/src/main/java/com/fooddelivery/authservice/repository/AuthRepository.java): `authservice/src/main/java/com/fooddelivery/authservice/repository/AuthRepository.java`
- **Auth Database**

### Customer Data

- [User API](https://github.com/armaan-94/food-delivery-system/blob/main/user-service/src/main/java/com/fooddelivery/controller/UserController.java): `user-service/src/main/java/com/fooddelivery/controller/UserController.java`
- [User Service](https://github.com/armaan-94/food-delivery-system/blob/main/user-service/src/main/java/com/fooddelivery/service/UserService.java): `user-service/src/main/java/com/fooddelivery/service/UserService.java`
- [User Repository](https://github.com/armaan-94/food-delivery-system/blob/main/user-service/src/main/java/com/fooddelivery/repository/UserRepository.java): `user-service/src/main/java/com/fooddelivery/repository/UserRepository.java`
- **User Database**

### Orders

- [Order API](https://github.com/armaan-94/food-delivery-system/blob/main/orderservice/src/main/java/com/fooddelivery/orderservice/controller/OrderController.java): `orderservice/src/main/java/com/fooddelivery/orderservice/controller/OrderController.java`
- [Order Service](https://github.com/armaan-94/food-delivery-system/blob/main/orderservice/src/main/java/com/fooddelivery/orderservice/service/OrderService.java): `orderservice/src/main/java/com/fooddelivery/orderservice/service/OrderService.java`
- [Order Repository](https://github.com/armaan-94/food-delivery-system/blob/main/orderservice/src/main/java/com/fooddelivery/orderservice/repository/FoodOrderRepository.java): `orderservice/src/main/java/com/fooddelivery/orderservice/repository/FoodOrderRepository.java`
- **Order Database**

### Delivery Logistics

- [Delivery API](https://github.com/armaan-94/food-delivery-system/blob/main/delivery-service/src/main/java/com/fooddelivery/controller/DeliveryController.java): `delivery-service/src/main/java/com/fooddelivery/controller/DeliveryController.java`
- [Partner API](https://github.com/armaan-94/food-delivery-system/blob/main/delivery-service/src/main/java/com/fooddelivery/controller/PartnerController.java): `delivery-service/src/main/java/com/fooddelivery/controller/PartnerController.java`
- [Delivery Service](https://github.com/armaan-94/food-delivery-system/blob/main/delivery-service/src/main/java/com/fooddelivery/service/DeliveryServiceImpl.java): `delivery-service/src/main/java/com/fooddelivery/service/DeliveryServiceImpl.java`
- [Partner Service](https://github.com/armaan-94/food-delivery-system/blob/main/delivery-service/src/main/java/com/fooddelivery/service/PartnerServiceImpl.java): `delivery-service/src/main/java/com/fooddelivery/service/PartnerServiceImpl.java`
- **Delivery Database**

### Platform Services

- [Eureka Registry](https://github.com/armaan-94/food-delivery-system/blob/main/servicediscovery/src/main/java/com/fooddelivery/servicediscovery/ServicediscoveryApplication.java): `servicediscovery/src/main/java/com/fooddelivery/servicediscovery/ServicediscoveryApplication.java`
- [Config Server](https://github.com/armaan-94/food-delivery-system/blob/main/configurationserver/src/main/java/com/fooddelivery/configurationserver/ConfigurationserverApplication.java): `configurationserver/src/main/java/com/fooddelivery/configurationserver/ConfigurationserverApplication.java`

### Other components

- **Client**

## Connections

- Client → API Gateway: sends requests
- API Gateway → Auth API: routes requests
- API Gateway → User API: routes requests
- API Gateway → Order API: routes requests
- API Gateway → Delivery API: routes requests
- Auth API → Auth Service: delegates auth (evidence: `authservice/src/main/java/com/fooddelivery/authservice/controller/AuthController.java`)
- Auth Service → Auth Repository: checks credentials (evidence: `authservice/src/main/java/com/fooddelivery/authservice/service/AuthService.java`)
- Auth Repository → Auth Database: reads and writes (evidence: `authservice/src/main/java/com/fooddelivery/authservice/repository/AuthRepository.java`)
- User API → User Service: delegates requests (evidence: `user-service/src/main/java/com/fooddelivery/controller/UserController.java`)
- User Service → User Repository: manages profiles (evidence: `user-service/src/main/java/com/fooddelivery/service/UserService.java`)
- User Repository → User Database: reads and writes (evidence: `user-service/src/main/java/com/fooddelivery/repository/UserRepository.java`)
- Order API → Order Service: delegates queries (evidence: `orderservice/src/main/java/com/fooddelivery/orderservice/controller/OrderController.java`)
- Order Service → Order Repository: loads orders (evidence: `orderservice/src/main/java/com/fooddelivery/orderservice/service/OrderService.java`)
- Order Repository → Order Database: stores orders
- Delivery API → Delivery Service: delegates logistics (evidence: `delivery-service/src/main/java/com/fooddelivery/controller/DeliveryController.java`)
- Partner API → Partner Service: delegates partner tasks (evidence: `delivery-service/src/main/java/com/fooddelivery/controller/PartnerController.java`)
- Delivery Service → Delivery Database: manages delivery data
- Partner Service → Delivery Database: manages partner data
- API Gateway → Eureka Registry: uses discovery
- User API → Eureka Registry: registers service
- Order API → Eureka Registry: registers service
- Delivery API → Eureka Registry: registers service
- API Gateway → Config Server: loads configuration
- Auth API → Config Server: loads configuration
- User API → Config Server: loads configuration
- Order API → Config Server: loads configuration
- Delivery API → Config Server: loads configuration
