# nikookinn/servemenu-platform architecture

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

- Interactive diagram: https://gitdiagram.com/nikookinn/servemenu-platform
- Repository: https://github.com/nikookinn/servemenu-platform

## Overview

ServeMenu is a microservices platform for managing businesses, stores, users, media, and QR codes. A visible workflow is store/table management: a request reaches business-service, whose table logic validates and persists tables, publishes table events, and requests QR generation. User management also provisions accounts in Keycloak; media-service handles asset operations and S3 storage. The tree documents gateway, configuration, discovery, and QR-service components, but the README is empty and most wiring was not sampled, so uncertain service-to-service links are omitted or marked unverified.

Main entry points: [`business-service/src/main/java/com/servemenu/businessservice/application/service/TableService.java`](https://github.com/nikookinn/servemenu-platform/blob/main/business-service/src/main/java/com/servemenu/businessservice/application/service/TableService.java) (Table Management), [`media-service/src/main/java/com/servemenu/mediaservice/application/service/MediaService.java`](https://github.com/nikookinn/servemenu-platform/blob/main/media-service/src/main/java/com/servemenu/mediaservice/application/service/MediaService.java) (Media Operations), [`api-gateway/src/main/java/com/servemenu/apigateway`](https://github.com/nikookinn/servemenu-platform/tree/main/api-gateway/src/main/java/com/servemenu/apigateway) (API Gateway), [`business-service/src/main/java/com/servemenu/businessservice/presentation/controller`](https://github.com/nikookinn/servemenu-platform/tree/main/business-service/src/main/java/com/servemenu/businessservice/presentation/controller) (Business Controllers)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_edge["Ingress and Platform"]
  node_gateway["API Gateway"]
  node_config["Config Server"]
  node_discovery["Service Discovery"]
end

subgraph group_business["Business Management"]
  node_business_api["Business Controllers"]
  node_store_service["Store Management<br/>[StoreService.java]"]
  node_table_service["Table Management<br/>[TableService.java]"]
  node_qr_custom["QR Customization"]
  node_business_data["Business Domain<br/>[Business.java]"]
  node_business_store_repo["Business Store Repositories"]
  node_domain_events["Domain Event Publisher"]
end

subgraph group_identity["Identity and Users"]
  node_user_api["User Controllers"]
  node_store_user["Store User Management"]
  node_customer["Customer Management"]
  node_user_data["User Domain<br/>[User.java]"]
  node_keycloak_adapter["Keycloak Adapter"]
end

subgraph group_media["Media and QR"]
  node_media_api["Media API"]
  node_media_service["Media Operations<br/>[MediaService.java]"]
  node_media_repo[("Media Asset Repository")]
  node_s3_storage["S3 Storage Adapter"]
  node_qr_worker["QR Generation Service"]
  node_grpc_media["Media gRPC Service"]
end

node_operator(("Platform User"))
node_keycloak["Keycloak"]
node_s3[("S3 Object Storage")]

node_operator -.->|"sends requests"| node_gateway
node_gateway -.->|"routes requests"| node_business_api
node_gateway -.->|"routes requests"| node_user_api
node_business_api -.->|"delegates to"| node_store_service
node_business_api -.->|"delegates to"| node_table_service
node_store_service -->|"reads and writes"| node_business_store_repo
node_store_service -->|"publishes events"| node_domain_events
node_table_service -->|"reads and writes"| node_business_store_repo
node_table_service -->|"publishes events"| node_domain_events
node_table_service -->|"requests QR settings"| node_qr_custom
node_qr_custom -.->|"reads and writes"| node_business_store_repo
node_user_api -.->|"delegates to"| node_store_user
node_store_user -->|"persists users"| node_user_data
node_store_user -->|"provisions accounts"| node_keycloak_adapter
node_customer -.->|"provisions accounts"| node_keycloak_adapter
node_keycloak_adapter -->|"manages accounts"| node_keycloak
node_media_api -.->|"delegates to"| node_media_service
node_media_service -->|"reads and writes"| node_media_repo
node_media_service -->|"stores assets"| node_s3_storage
node_s3_storage -.->|"uploads and deletes"| node_s3
node_qr_worker -.->|"uploads QR assets"| node_media_api
node_grpc_media -.->|"handles media calls"| node_media_service

click node_gateway "https://github.com/nikookinn/servemenu-platform/tree/main/api-gateway/src/main/java/com/servemenu/apigateway"
click node_config "https://github.com/nikookinn/servemenu-platform/blob/main/config-server/src/main/java/com/servemenu/configserver/ConfigServerApplication.java"
click node_discovery "https://github.com/nikookinn/servemenu-platform/blob/main/discovery-service/src/main/java/com/servemenu/discoveryservice/DiscoveryServiceApplication.java"
click node_business_api "https://github.com/nikookinn/servemenu-platform/tree/main/business-service/src/main/java/com/servemenu/businessservice/presentation/controller"
click node_store_service "https://github.com/nikookinn/servemenu-platform/blob/main/business-service/src/main/java/com/servemenu/businessservice/application/service/StoreService.java"
click node_table_service "https://github.com/nikookinn/servemenu-platform/blob/main/business-service/src/main/java/com/servemenu/businessservice/application/service/TableService.java"
click node_qr_custom "https://github.com/nikookinn/servemenu-platform/blob/main/business-service/src/main/java/com/servemenu/businessservice/application/service/QRCustomizationService.java"
click node_business_data "https://github.com/nikookinn/servemenu-platform/blob/main/business-service/src/main/java/com/servemenu/businessservice/domain/model/Business.java"
click node_business_store_repo "https://github.com/nikookinn/servemenu-platform/blob/main/business-service/src/main/java/com/servemenu/businessservice/domain/repository/StoreRepository.java"
click node_domain_events "https://github.com/nikookinn/servemenu-platform/blob/main/business-service/src/main/java/com/servemenu/businessservice/infrastructure/kafka/producer/DomainEventPublisher.java"
click node_user_api "https://github.com/nikookinn/servemenu-platform/tree/main/user-service/src/main/java/com/servemenu/userservice/presentation/controller"
click node_store_user "https://github.com/nikookinn/servemenu-platform/blob/main/user-service/src/main/java/com/servemenu/userservice/application/service/StoreUserService.java"
click node_customer "https://github.com/nikookinn/servemenu-platform/blob/main/user-service/src/main/java/com/servemenu/userservice/application/service/CustomerService.java"
click node_user_data "https://github.com/nikookinn/servemenu-platform/blob/main/user-service/src/main/java/com/servemenu/userservice/domain/model/User.java"
click node_keycloak_adapter "https://github.com/nikookinn/servemenu-platform/blob/main/user-service/src/main/java/com/servemenu/userservice/infrastructure/keycloak/KeycloakUserManagementService.java"
click node_media_api "https://github.com/nikookinn/servemenu-platform/blob/main/media-service/src/main/java/com/servemenu/mediaservice/presentation/controller/MediaController.java"
click node_media_service "https://github.com/nikookinn/servemenu-platform/blob/main/media-service/src/main/java/com/servemenu/mediaservice/application/service/MediaService.java"
click node_media_repo "https://github.com/nikookinn/servemenu-platform/blob/main/media-service/src/main/java/com/servemenu/mediaservice/domain/repository/MediaAssetRepository.java"
click node_s3_storage "https://github.com/nikookinn/servemenu-platform/blob/main/media-service/src/main/java/com/servemenu/mediaservice/infrastructure/storage/S3StorageService.java"
click node_qr_worker "https://github.com/nikookinn/servemenu-platform/blob/main/qr-service/src/services/qr-generator-canvas.service.ts"
click node_grpc_media "https://github.com/nikookinn/servemenu-platform/blob/main/media-service/src/main/java/com/servemenu/mediaservice/infrastructure/grpc/MediaGrpcServiceImpl.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_config,node_discovery,node_operator toneBlue
class node_business_api,node_store_service,node_table_service,node_qr_custom,node_business_data,node_business_store_repo,node_domain_events,node_s3 toneAmber
class node_user_api,node_store_user,node_customer,node_user_data,node_keycloak_adapter toneMint
class node_media_api,node_media_service,node_media_repo,node_s3_storage,node_qr_worker,node_grpc_media toneRose
class node_keycloak toneIndigo
```

## Components

### Ingress and Platform

- [API Gateway](https://github.com/nikookinn/servemenu-platform/tree/main/api-gateway/src/main/java/com/servemenu/apigateway): `api-gateway/src/main/java/com/servemenu/apigateway`
- [Config Server](https://github.com/nikookinn/servemenu-platform/blob/main/config-server/src/main/java/com/servemenu/configserver/ConfigServerApplication.java): `config-server/src/main/java/com/servemenu/configserver/ConfigServerApplication.java`
- [Service Discovery](https://github.com/nikookinn/servemenu-platform/blob/main/discovery-service/src/main/java/com/servemenu/discoveryservice/DiscoveryServiceApplication.java): `discovery-service/src/main/java/com/servemenu/discoveryservice/DiscoveryServiceApplication.java`

### Business Management

- [Business Controllers](https://github.com/nikookinn/servemenu-platform/tree/main/business-service/src/main/java/com/servemenu/businessservice/presentation/controller): `business-service/src/main/java/com/servemenu/businessservice/presentation/controller`
- [Store Management](https://github.com/nikookinn/servemenu-platform/blob/main/business-service/src/main/java/com/servemenu/businessservice/application/service/StoreService.java): `business-service/src/main/java/com/servemenu/businessservice/application/service/StoreService.java`
- [Table Management](https://github.com/nikookinn/servemenu-platform/blob/main/business-service/src/main/java/com/servemenu/businessservice/application/service/TableService.java): `business-service/src/main/java/com/servemenu/businessservice/application/service/TableService.java`
- [QR Customization](https://github.com/nikookinn/servemenu-platform/blob/main/business-service/src/main/java/com/servemenu/businessservice/application/service/QRCustomizationService.java): `business-service/src/main/java/com/servemenu/businessservice/application/service/QRCustomizationService.java`
- [Business Domain](https://github.com/nikookinn/servemenu-platform/blob/main/business-service/src/main/java/com/servemenu/businessservice/domain/model/Business.java): `business-service/src/main/java/com/servemenu/businessservice/domain/model/Business.java`
- [Business Store Repositories](https://github.com/nikookinn/servemenu-platform/blob/main/business-service/src/main/java/com/servemenu/businessservice/domain/repository/StoreRepository.java): `business-service/src/main/java/com/servemenu/businessservice/domain/repository/StoreRepository.java`
- [Domain Event Publisher](https://github.com/nikookinn/servemenu-platform/blob/main/business-service/src/main/java/com/servemenu/businessservice/infrastructure/kafka/producer/DomainEventPublisher.java): `business-service/src/main/java/com/servemenu/businessservice/infrastructure/kafka/producer/DomainEventPublisher.java`

### Identity and Users

- [User Controllers](https://github.com/nikookinn/servemenu-platform/tree/main/user-service/src/main/java/com/servemenu/userservice/presentation/controller): `user-service/src/main/java/com/servemenu/userservice/presentation/controller`
- [Store User Management](https://github.com/nikookinn/servemenu-platform/blob/main/user-service/src/main/java/com/servemenu/userservice/application/service/StoreUserService.java): `user-service/src/main/java/com/servemenu/userservice/application/service/StoreUserService.java`
- [Customer Management](https://github.com/nikookinn/servemenu-platform/blob/main/user-service/src/main/java/com/servemenu/userservice/application/service/CustomerService.java): `user-service/src/main/java/com/servemenu/userservice/application/service/CustomerService.java`
- [User Domain](https://github.com/nikookinn/servemenu-platform/blob/main/user-service/src/main/java/com/servemenu/userservice/domain/model/User.java): `user-service/src/main/java/com/servemenu/userservice/domain/model/User.java`
- [Keycloak Adapter](https://github.com/nikookinn/servemenu-platform/blob/main/user-service/src/main/java/com/servemenu/userservice/infrastructure/keycloak/KeycloakUserManagementService.java): `user-service/src/main/java/com/servemenu/userservice/infrastructure/keycloak/KeycloakUserManagementService.java`

### Media and QR

- [Media API](https://github.com/nikookinn/servemenu-platform/blob/main/media-service/src/main/java/com/servemenu/mediaservice/presentation/controller/MediaController.java): `media-service/src/main/java/com/servemenu/mediaservice/presentation/controller/MediaController.java`
- [Media Operations](https://github.com/nikookinn/servemenu-platform/blob/main/media-service/src/main/java/com/servemenu/mediaservice/application/service/MediaService.java): `media-service/src/main/java/com/servemenu/mediaservice/application/service/MediaService.java`
- [Media Asset Repository](https://github.com/nikookinn/servemenu-platform/blob/main/media-service/src/main/java/com/servemenu/mediaservice/domain/repository/MediaAssetRepository.java): `media-service/src/main/java/com/servemenu/mediaservice/domain/repository/MediaAssetRepository.java`
- [S3 Storage Adapter](https://github.com/nikookinn/servemenu-platform/blob/main/media-service/src/main/java/com/servemenu/mediaservice/infrastructure/storage/S3StorageService.java): `media-service/src/main/java/com/servemenu/mediaservice/infrastructure/storage/S3StorageService.java`
- [QR Generation Service](https://github.com/nikookinn/servemenu-platform/blob/main/qr-service/src/services/qr-generator-canvas.service.ts): `qr-service/src/services/qr-generator-canvas.service.ts`
- [Media gRPC Service](https://github.com/nikookinn/servemenu-platform/blob/main/media-service/src/main/java/com/servemenu/mediaservice/infrastructure/grpc/MediaGrpcServiceImpl.java): `media-service/src/main/java/com/servemenu/mediaservice/infrastructure/grpc/MediaGrpcServiceImpl.java`

### Other components

- **Platform User**
- **Keycloak**
- **S3 Object Storage**

## Connections

- Platform User → API Gateway: sends requests
- API Gateway → Business Controllers: routes requests
- API Gateway → User Controllers: routes requests
- Business Controllers → Store Management: delegates to
- Business Controllers → Table Management: delegates to
- Store Management → Business Store Repositories: reads and writes (evidence: `business-service/src/main/java/com/servemenu/businessservice/application/service/StoreService.java`)
- Store Management → Domain Event Publisher: publishes events (evidence: `business-service/src/main/java/com/servemenu/businessservice/application/service/StoreService.java`)
- Table Management → Business Store Repositories: reads and writes (evidence: `business-service/src/main/java/com/servemenu/businessservice/application/service/TableService.java`)
- Table Management → Domain Event Publisher: publishes events (evidence: `business-service/src/main/java/com/servemenu/businessservice/application/service/TableService.java`)
- Table Management → QR Customization: requests QR settings (evidence: `business-service/src/main/java/com/servemenu/businessservice/application/service/TableService.java`)
- QR Customization → Business Store Repositories: reads and writes (evidence: `business-service/src/main/java/com/servemenu/businessservice/application/service/QRCustomizationService.java`)
- User Controllers → Store User Management: delegates to (evidence: `user-service/src/main/java/com/servemenu/userservice/presentation/controller/StoreUserController.java`)
- Store User Management → User Domain: persists users (evidence: `user-service/src/main/java/com/servemenu/userservice/application/service/StoreUserService.java`)
- Store User Management → Keycloak Adapter: provisions accounts (evidence: `user-service/src/main/java/com/servemenu/userservice/application/service/StoreUserService.java`)
- Customer Management → Keycloak Adapter: provisions accounts (evidence: `user-service/src/main/java/com/servemenu/userservice/application/service/CustomerService.java`)
- Keycloak Adapter → Keycloak: manages accounts (evidence: `user-service/src/main/java/com/servemenu/userservice/infrastructure/keycloak/KeycloakUserManagementService.java`)
- Media API → Media Operations: delegates to (evidence: `media-service/src/main/java/com/servemenu/mediaservice/presentation/controller/MediaController.java`)
- Media Operations → Media Asset Repository: reads and writes (evidence: `media-service/src/main/java/com/servemenu/mediaservice/application/service/MediaService.java`)
- Media Operations → S3 Storage Adapter: stores assets (evidence: `media-service/src/main/java/com/servemenu/mediaservice/application/service/MediaService.java`)
- S3 Storage Adapter → S3 Object Storage: uploads and deletes
- QR Generation Service → Media API: uploads QR assets
- Media gRPC Service → Media Operations: handles media calls
