# gizachewb/order-delivery-system-microservices-architecture architecture

> Architecture diagram of the GitHub repository gizachewb/order-delivery-system-microservices-architecture, generated by GitDiagram from its file tree, README and a sample of source files (last updated 2026-11-21). It is an AI-made overview: check details against the source.

- Interactive diagram: https://gitdiagram.com/gizachewb/order-delivery-system-microservices-architecture
- Repository: https://github.com/gizachewb/order-delivery-system-microservices-architecture

## Overview

This repository presents a food-ordering and door-to-door delivery platform, but the available source is chiefly two Spring services for Keycloak integration and role-protected endpoints. The visible user workflow covers credential token requests and user registration; the README also describes restaurant/menu discovery, ordering, payment, status notifications and driver pickup. Those food-delivery stages are documented capabilities, not demonstrated implementations in the supplied excerpts, so they are shown as unverified concepts rather than wired runtime components.

Main entry points: [`keycloak-springboot/src/main/java/com/geekcolab/development/services/KeyCloakService.java`](https://github.com/gizachewb/order-delivery-system-microservices-architecture/blob/main/keycloak-springboot/src/main/java/com/geekcolab/development/services/KeyCloakService.java) (Keycloak service), [`keycloak-springboot/src/main/java/com/geekcolab/development/controller/KeycloakController.java`](https://github.com/gizachewb/order-delivery-system-microservices-architecture/blob/main/keycloak-springboot/src/main/java/com/geekcolab/development/controller/KeycloakController.java) (Identity endpoints), [`keycloak-springboot/src/main/java/com/geekcolab/development/controller/UserController.java`](https://github.com/gizachewb/order-delivery-system-microservices-architecture/blob/main/keycloak-springboot/src/main/java/com/geekcolab/development/controller/UserController.java) (User endpoints), [`keycloak-springboot/src/main/java/com/geekcolab/development/model/UserDTO.java`](https://github.com/gizachewb/order-delivery-system-microservices-architecture/blob/main/keycloak-springboot/src/main/java/com/geekcolab/development/model/UserDTO.java) (User profile data)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_identity["Identity service"]
  node_identity_api["Identity endpoints"]
  node_user_api["User endpoints"]
  node_user_service["Keycloak service"]
  node_user_data["User profile data<br/>[UserDTO.java]"]
  node_address_data["Address data<br/>[AddressDTO.java]"]
  node_payment_data["Payment data<br/>[PaymentDTO.java]"]
  node_credentials["Login credentials"]
end

subgraph group_access["Role access"]
  node_role_api["Role endpoints"]
  node_security_config["Resource security"]
end

subgraph group_delivery["Delivery capabilities"]
  node_restaurant["Restaurant onboarding"]
  node_discovery["Restaurant and menu search"]
  node_ordering["Order placement"]
  node_payment["Order payment"]
  node_status["Order status updates"]
  node_notifications["Status notifications"]
  node_driver["Driver pickup"]
end

node_client(("Platform users"))
node_keycloak["Keycloak identity"]
node_kafka["Kafka broker"]

node_client -->|"requests tokens"| node_identity_api
node_identity_api -->|"delegates token work"| node_user_service
node_identity_api -->|"accepts credentials"| node_credentials
node_user_service -->|"requests identity operations"| node_keycloak
node_client -->|"requests profile actions"| node_user_api
node_user_api -->|"delegates user actions"| node_user_service
node_user_api -->|"accepts profile"| node_user_data
node_user_data -->|"includes address"| node_address_data
node_user_data -->|"includes payment details"| node_payment_data
node_user_service -->|"publishes user creation"| node_kafka
node_client -.->|"calls role endpoints"| node_role_api
node_security_config -.->|"protects endpoints"| node_role_api
node_client -.->|"searches restaurants"| node_discovery
node_client -.->|"places orders"| node_ordering
node_restaurant -.->|"updates order status"| node_ordering
node_ordering -.->|"requires payment"| node_payment
node_ordering -.->|"triggers status notices"| node_notifications
node_notifications -.->|"notifies customer"| node_client
node_ordering -.->|"offers pickup"| node_driver

click node_identity_api "https://github.com/gizachewb/order-delivery-system-microservices-architecture/blob/main/keycloak-springboot/src/main/java/com/geekcolab/development/controller/KeycloakController.java"
click node_user_api "https://github.com/gizachewb/order-delivery-system-microservices-architecture/blob/main/keycloak-springboot/src/main/java/com/geekcolab/development/controller/UserController.java"
click node_user_service "https://github.com/gizachewb/order-delivery-system-microservices-architecture/blob/main/keycloak-springboot/src/main/java/com/geekcolab/development/services/KeyCloakService.java"
click node_user_data "https://github.com/gizachewb/order-delivery-system-microservices-architecture/blob/main/keycloak-springboot/src/main/java/com/geekcolab/development/model/UserDTO.java"
click node_address_data "https://github.com/gizachewb/order-delivery-system-microservices-architecture/blob/main/keycloak-springboot/src/main/java/com/geekcolab/development/model/AddressDTO.java"
click node_payment_data "https://github.com/gizachewb/order-delivery-system-microservices-architecture/blob/main/keycloak-springboot/src/main/java/com/geekcolab/development/model/PaymentDTO.java"
click node_credentials "https://github.com/gizachewb/order-delivery-system-microservices-architecture/blob/main/keycloak-springboot/src/main/java/com/geekcolab/development/model/UserCredentials.java"
click node_role_api "https://github.com/gizachewb/order-delivery-system-microservices-architecture/tree/main/keycloak-springboot-resourceserver/src/main/java/com/geekcolab/development/controller"
click node_security_config "https://github.com/gizachewb/order-delivery-system-microservices-architecture/blob/main/keycloak-springboot-resourceserver/src/main/java/com/geekcolab/development/config/security/SecurityConfig.java"
click node_restaurant "https://github.com/gizachewb/order-delivery-system-microservices-architecture/tree/main/restaurant"
click node_payment "https://github.com/gizachewb/order-delivery-system-microservices-architecture/tree/main/payment"
click node_driver "https://github.com/gizachewb/order-delivery-system-microservices-architecture/tree/main/dasher"

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_identity_api,node_user_api,node_user_service,node_user_data,node_address_data,node_payment_data,node_credentials,node_client toneBlue
class node_role_api,node_security_config toneAmber
class node_restaurant,node_discovery,node_ordering,node_payment,node_status,node_notifications,node_driver toneMint
class node_keycloak,node_kafka toneIndigo
```

## Components

### Identity service

- [Identity endpoints](https://github.com/gizachewb/order-delivery-system-microservices-architecture/blob/main/keycloak-springboot/src/main/java/com/geekcolab/development/controller/KeycloakController.java): `keycloak-springboot/src/main/java/com/geekcolab/development/controller/KeycloakController.java`
- [User endpoints](https://github.com/gizachewb/order-delivery-system-microservices-architecture/blob/main/keycloak-springboot/src/main/java/com/geekcolab/development/controller/UserController.java): `keycloak-springboot/src/main/java/com/geekcolab/development/controller/UserController.java`
- [Keycloak service](https://github.com/gizachewb/order-delivery-system-microservices-architecture/blob/main/keycloak-springboot/src/main/java/com/geekcolab/development/services/KeyCloakService.java): `keycloak-springboot/src/main/java/com/geekcolab/development/services/KeyCloakService.java`
- [User profile data](https://github.com/gizachewb/order-delivery-system-microservices-architecture/blob/main/keycloak-springboot/src/main/java/com/geekcolab/development/model/UserDTO.java): `keycloak-springboot/src/main/java/com/geekcolab/development/model/UserDTO.java`
- [Address data](https://github.com/gizachewb/order-delivery-system-microservices-architecture/blob/main/keycloak-springboot/src/main/java/com/geekcolab/development/model/AddressDTO.java): `keycloak-springboot/src/main/java/com/geekcolab/development/model/AddressDTO.java`
- [Payment data](https://github.com/gizachewb/order-delivery-system-microservices-architecture/blob/main/keycloak-springboot/src/main/java/com/geekcolab/development/model/PaymentDTO.java): `keycloak-springboot/src/main/java/com/geekcolab/development/model/PaymentDTO.java`
- [Login credentials](https://github.com/gizachewb/order-delivery-system-microservices-architecture/blob/main/keycloak-springboot/src/main/java/com/geekcolab/development/model/UserCredentials.java): `keycloak-springboot/src/main/java/com/geekcolab/development/model/UserCredentials.java`

### Role access

- [Role endpoints](https://github.com/gizachewb/order-delivery-system-microservices-architecture/tree/main/keycloak-springboot-resourceserver/src/main/java/com/geekcolab/development/controller): `keycloak-springboot-resourceserver/src/main/java/com/geekcolab/development/controller`
- [Resource security](https://github.com/gizachewb/order-delivery-system-microservices-architecture/blob/main/keycloak-springboot-resourceserver/src/main/java/com/geekcolab/development/config/security/SecurityConfig.java): `keycloak-springboot-resourceserver/src/main/java/com/geekcolab/development/config/security/SecurityConfig.java`

### Delivery capabilities

- [Restaurant onboarding](https://github.com/gizachewb/order-delivery-system-microservices-architecture/tree/main/restaurant): `restaurant`
- **Restaurant and menu search**
- **Order placement**
- [Order payment](https://github.com/gizachewb/order-delivery-system-microservices-architecture/tree/main/payment): `payment`
- **Order status updates**
- **Status notifications**
- [Driver pickup](https://github.com/gizachewb/order-delivery-system-microservices-architecture/tree/main/dasher): `dasher`

### Other components

- **Platform users**
- **Keycloak identity**
- **Kafka broker**

## Connections

- Platform users → Identity endpoints: requests tokens (evidence: `keycloak-springboot/src/main/java/com/geekcolab/development/controller/KeycloakController.java`)
- Identity endpoints → Keycloak service: delegates token work (evidence: `keycloak-springboot/src/main/java/com/geekcolab/development/controller/KeycloakController.java`)
- Identity endpoints → Login credentials: accepts credentials (evidence: `keycloak-springboot/src/main/java/com/geekcolab/development/controller/KeycloakController.java`)
- Keycloak service → Keycloak identity: requests identity operations (evidence: `keycloak-springboot/src/main/java/com/geekcolab/development/services/KeyCloakService.java`)
- Platform users → User endpoints: requests profile actions (evidence: `keycloak-springboot/src/main/java/com/geekcolab/development/controller/UserController.java`)
- User endpoints → Keycloak service: delegates user actions (evidence: `keycloak-springboot/src/main/java/com/geekcolab/development/controller/UserController.java`)
- User endpoints → User profile data: accepts profile (evidence: `keycloak-springboot/src/main/java/com/geekcolab/development/controller/UserController.java`)
- User profile data → Address data: includes address (evidence: `keycloak-springboot/src/main/java/com/geekcolab/development/model/UserDTO.java`)
- User profile data → Payment data: includes payment details (evidence: `keycloak-springboot/src/main/java/com/geekcolab/development/model/UserDTO.java`)
- Keycloak service → Kafka broker: publishes user creation (evidence: `keycloak-springboot/src/main/java/com/geekcolab/development/services/KeyCloakService.java`)
- Platform users → Role endpoints: calls role endpoints
- Resource security → Role endpoints: protects endpoints
- Platform users → Restaurant and menu search: searches restaurants (evidence: `README.md`)
- Platform users → Order placement: places orders (evidence: `README.md`)
- Restaurant onboarding → Order placement: updates order status (evidence: `README.md`)
- Order placement → Order payment: requires payment (evidence: `README.md`)
- Order placement → Status notifications: triggers status notices (evidence: `README.md`)
- Status notifications → Platform users: notifies customer (evidence: `README.md`)
- Order placement → Driver pickup: offers pickup (evidence: `README.md`)
