How nikookinn/servemenu-platform works
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: TableService.java Table Management · MediaService.java Media Operations · apigateway API Gateway · controller Business Controllers
Components 24
Ingress and Platform
- API Gateway
api-gateway/src/main/java/com/servemenu/apigateway - Config Server
config-server/src/main/java/com/servemenu/configserver/ConfigServerApplication.java - Service Discovery
discovery-service/src/main/java/com/servemenu/discoveryservice/DiscoveryServiceApplication.java
Business Management
- Business Controllers
business-service/src/main/java/com/servemenu/businessservice/presentation/controller - Store Management
business-service/src/main/java/com/servemenu/businessservice/application/service/StoreService.java - Table Management
business-service/src/main/java/com/servemenu/businessservice/application/service/TableService.java - QR Customization
business-service/src/main/java/com/servemenu/businessservice/application/service/QRCustomizationService.java - Business Domain
business-service/src/main/java/com/servemenu/businessservice/domain/model/Business.java - Business Store Repositories
business-service/src/main/java/com/servemenu/businessservice/domain/repository/StoreRepository.java - Domain Event Publisher
business-service/src/main/java/com/servemenu/businessservice/infrastructure/kafka/producer/DomainEventPublisher.java
Identity and Users
- User Controllers
user-service/src/main/java/com/servemenu/userservice/presentation/controller - Store User Management
user-service/src/main/java/com/servemenu/userservice/application/service/StoreUserService.java - Customer Management
user-service/src/main/java/com/servemenu/userservice/application/service/CustomerService.java - User Domain
user-service/src/main/java/com/servemenu/userservice/domain/model/User.java - Keycloak Adapter
user-service/src/main/java/com/servemenu/userservice/infrastructure/keycloak/KeycloakUserManagementService.java
Media and QR
- Media API
media-service/src/main/java/com/servemenu/mediaservice/presentation/controller/MediaController.java - Media Operations
media-service/src/main/java/com/servemenu/mediaservice/application/service/MediaService.java - Media Asset Repository
media-service/src/main/java/com/servemenu/mediaservice/domain/repository/MediaAssetRepository.java - S3 Storage Adapter
media-service/src/main/java/com/servemenu/mediaservice/infrastructure/storage/S3StorageService.java - QR Generation Service
qr-service/src/services/qr-generator-canvas.service.ts - Media gRPC Service
media-service/src/main/java/com/servemenu/mediaservice/infrastructure/grpc/MediaGrpcServiceImpl.java
Other components
- Platform User
- Keycloak
- S3 Object Storage
Connections 22
- 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
business-service/src/main/java/com/servemenu/businessservice/application/service/StoreService.java - Store Management → Domain Event Publisher: publishes events
business-service/src/main/java/com/servemenu/businessservice/application/service/StoreService.java - Table Management → Business Store Repositories: reads and writes
business-service/src/main/java/com/servemenu/businessservice/application/service/TableService.java - Table Management → Domain Event Publisher: publishes events
business-service/src/main/java/com/servemenu/businessservice/application/service/TableService.java - Table Management → QR Customization: requests QR settings
business-service/src/main/java/com/servemenu/businessservice/application/service/TableService.java - QR Customization → Business Store Repositories: reads and writes
business-service/src/main/java/com/servemenu/businessservice/application/service/QRCustomizationService.java - User Controllers → Store User Management: delegates to
user-service/src/main/java/com/servemenu/userservice/presentation/controller/StoreUserController.java - Store User Management → User Domain: persists users
user-service/src/main/java/com/servemenu/userservice/application/service/StoreUserService.java - Store User Management → Keycloak Adapter: provisions accounts
user-service/src/main/java/com/servemenu/userservice/application/service/StoreUserService.java - Customer Management → Keycloak Adapter: provisions accounts
user-service/src/main/java/com/servemenu/userservice/application/service/CustomerService.java - Keycloak Adapter → Keycloak: manages accounts
user-service/src/main/java/com/servemenu/userservice/infrastructure/keycloak/KeycloakUserManagementService.java - Media API → Media Operations: delegates to
media-service/src/main/java/com/servemenu/mediaservice/presentation/controller/MediaController.java - Media Operations → Media Asset Repository: reads and writes
media-service/src/main/java/com/servemenu/mediaservice/application/service/MediaService.java - Media Operations → S3 Storage Adapter: stores assets
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