# varun5041/scandine architecture

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

- Interactive diagram: https://gitdiagram.com/varun5041/scandine
- Repository: https://github.com/varun5041/scandine

## Overview

ScanDine is a restaurant QR-menu and table-ordering application. Customers access a restaurant menu, place table-linked orders, and participate in a table session; restaurant owners manage their restaurant, menu, tables, orders, and business views. The source index supports the controller-to-service and service-to-repository structure, while excerpts show order creation, table QR generation, and session/revenue handling. The README contains no capability details, and unsampled implementations limit certainty about some integrations and routes.

Main entry points: [`src/main/java/com/scandine/controller/OwnerController.java`](https://github.com/varun5041/scandine/blob/main/src/main/java/com/scandine/controller/OwnerController.java) (Owner dashboard routes), [`src/main/java/com/scandine/controller/CustomerMenuController.java`](https://github.com/varun5041/scandine/blob/main/src/main/java/com/scandine/controller/CustomerMenuController.java) (Customer menu routes), [`src/main/java/com/scandine/service/OrderService.java`](https://github.com/varun5041/scandine/blob/main/src/main/java/com/scandine/service/OrderService.java) (Orders and sessions), [`src/main/java/com/scandine/repository`](https://github.com/varun5041/scandine/tree/main/src/main/java/com/scandine/repository) (JPA repositories)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_entry["Application entry"]
  node_app["Spring application"]
end

subgraph group_customer["Customer ordering"]
  node_customer_ui["Customer menu routes"]
  node_api["Ordering API<br/>[ApiController.java]"]
  node_order_service["Orders and sessions<br/>[OrderService.java]"]
end

subgraph group_owner["Restaurant operations"]
  node_owner_ui["Owner dashboard routes"]
  node_auth["Authentication routes"]
  node_restaurant_service["Restaurant management"]
  node_menu_service["Menu management<br/>[MenuService.java]"]
  node_table_service["Table and QR management<br/>[TableService.java]"]
end

subgraph group_core["Domain and persistence"]
  node_domain["Restaurant and order entities"]
  node_repositories[("JPA repositories")]
end

subgraph group_platform["Platform services"]
  node_payment_service["Razorpay integration"]
  node_file_service["File storage"]
  node_email_service["Email delivery<br/>[EmailService.java]"]
  node_security["User authentication lookup"]
  node_websocket["Order notifications"]
end

node_customer_actor(("Customer"))
node_owner_actor(("Restaurant owner"))

node_customer_actor -->|"opens menu"| node_customer_ui
node_customer_ui -->|"loads restaurant"| node_restaurant_service
node_customer_ui -->|"loads menu"| node_menu_service
node_customer_ui -->|"resolves table"| node_table_service
node_customer_ui -->|"starts ordering"| node_order_service
node_customer_actor -.->|"submits order"| node_api
node_api -->|"manages orders"| node_order_service
node_api -->|"loads restaurant"| node_restaurant_service
node_api -->|"handles payment"| node_payment_service
node_owner_actor -->|"manages restaurant"| node_owner_ui
node_owner_ui -->|"manages details"| node_restaurant_service
node_owner_ui -->|"manages menu"| node_menu_service
node_owner_ui -->|"manages tables"| node_table_service
node_owner_ui -->|"views orders"| node_order_service
node_owner_ui -->|"stores uploads"| node_file_service
node_restaurant_service -->|"reads and writes"| node_repositories
node_menu_service -->|"reads and writes"| node_repositories
node_table_service -->|"reads and writes"| node_repositories
node_order_service -->|"reads and writes"| node_repositories
node_order_service -->|"creates order items"| node_domain
node_repositories -->|"persists entities"| node_domain
node_order_service -->|"publishes updates"| node_websocket
node_auth -.->|"authenticates users"| node_security
node_security -->|"looks up users"| node_repositories
node_app -.->|"serves routes"| node_customer_ui

click node_app "https://github.com/varun5041/scandine/blob/main/src/main/java/com/scandine/ScanDineApplication.java"
click node_customer_ui "https://github.com/varun5041/scandine/blob/main/src/main/java/com/scandine/controller/CustomerMenuController.java"
click node_api "https://github.com/varun5041/scandine/blob/main/src/main/java/com/scandine/controller/ApiController.java"
click node_owner_ui "https://github.com/varun5041/scandine/blob/main/src/main/java/com/scandine/controller/OwnerController.java"
click node_auth "https://github.com/varun5041/scandine/blob/main/src/main/java/com/scandine/controller/AuthController.java"
click node_restaurant_service "https://github.com/varun5041/scandine/blob/main/src/main/java/com/scandine/service/RestaurantService.java"
click node_menu_service "https://github.com/varun5041/scandine/blob/main/src/main/java/com/scandine/service/MenuService.java"
click node_table_service "https://github.com/varun5041/scandine/blob/main/src/main/java/com/scandine/service/TableService.java"
click node_order_service "https://github.com/varun5041/scandine/blob/main/src/main/java/com/scandine/service/OrderService.java"
click node_payment_service "https://github.com/varun5041/scandine/blob/main/src/main/java/com/scandine/service/RazorpayService.java"
click node_file_service "https://github.com/varun5041/scandine/blob/main/src/main/java/com/scandine/service/FileStorageService.java"
click node_email_service "https://github.com/varun5041/scandine/blob/main/src/main/java/com/scandine/service/EmailService.java"
click node_domain "https://github.com/varun5041/scandine/tree/main/src/main/java/com/scandine/model"
click node_repositories "https://github.com/varun5041/scandine/tree/main/src/main/java/com/scandine/repository"
click node_security "https://github.com/varun5041/scandine/blob/main/src/main/java/com/scandine/security/CustomUserDetailsService.java"
click node_websocket "https://github.com/varun5041/scandine/blob/main/src/main/java/com/scandine/config/WebSocketConfig.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_app toneBlue
class node_customer_ui,node_api,node_order_service toneAmber
class node_owner_ui,node_auth,node_restaurant_service,node_menu_service,node_table_service toneMint
class node_domain,node_repositories toneRose
class node_payment_service,node_file_service,node_email_service,node_security,node_websocket,node_customer_actor,node_owner_actor toneIndigo
```

## Components

### Application entry

- [Spring application](https://github.com/varun5041/scandine/blob/main/src/main/java/com/scandine/ScanDineApplication.java): `src/main/java/com/scandine/ScanDineApplication.java`

### Customer ordering

- [Customer menu routes](https://github.com/varun5041/scandine/blob/main/src/main/java/com/scandine/controller/CustomerMenuController.java): `src/main/java/com/scandine/controller/CustomerMenuController.java`
- [Ordering API](https://github.com/varun5041/scandine/blob/main/src/main/java/com/scandine/controller/ApiController.java): `src/main/java/com/scandine/controller/ApiController.java`
- [Orders and sessions](https://github.com/varun5041/scandine/blob/main/src/main/java/com/scandine/service/OrderService.java): `src/main/java/com/scandine/service/OrderService.java`

### Restaurant operations

- [Owner dashboard routes](https://github.com/varun5041/scandine/blob/main/src/main/java/com/scandine/controller/OwnerController.java): `src/main/java/com/scandine/controller/OwnerController.java`
- [Authentication routes](https://github.com/varun5041/scandine/blob/main/src/main/java/com/scandine/controller/AuthController.java): `src/main/java/com/scandine/controller/AuthController.java`
- [Restaurant management](https://github.com/varun5041/scandine/blob/main/src/main/java/com/scandine/service/RestaurantService.java): `src/main/java/com/scandine/service/RestaurantService.java`
- [Menu management](https://github.com/varun5041/scandine/blob/main/src/main/java/com/scandine/service/MenuService.java): `src/main/java/com/scandine/service/MenuService.java`
- [Table and QR management](https://github.com/varun5041/scandine/blob/main/src/main/java/com/scandine/service/TableService.java): `src/main/java/com/scandine/service/TableService.java`

### Domain and persistence

- [Restaurant and order entities](https://github.com/varun5041/scandine/tree/main/src/main/java/com/scandine/model): `src/main/java/com/scandine/model`
- [JPA repositories](https://github.com/varun5041/scandine/tree/main/src/main/java/com/scandine/repository): `src/main/java/com/scandine/repository`

### Platform services

- [Razorpay integration](https://github.com/varun5041/scandine/blob/main/src/main/java/com/scandine/service/RazorpayService.java): `src/main/java/com/scandine/service/RazorpayService.java`
- [File storage](https://github.com/varun5041/scandine/blob/main/src/main/java/com/scandine/service/FileStorageService.java): `src/main/java/com/scandine/service/FileStorageService.java`
- [Email delivery](https://github.com/varun5041/scandine/blob/main/src/main/java/com/scandine/service/EmailService.java): `src/main/java/com/scandine/service/EmailService.java`
- [User authentication lookup](https://github.com/varun5041/scandine/blob/main/src/main/java/com/scandine/security/CustomUserDetailsService.java): `src/main/java/com/scandine/security/CustomUserDetailsService.java`
- [Order notifications](https://github.com/varun5041/scandine/blob/main/src/main/java/com/scandine/config/WebSocketConfig.java): `src/main/java/com/scandine/config/WebSocketConfig.java`

### Other components

- **Customer**
- **Restaurant owner**

## Connections

- Customer → Customer menu routes: opens menu (evidence: `src/main/java/com/scandine/controller/CustomerMenuController.java`)
- Customer menu routes → Restaurant management: loads restaurant (evidence: `src/main/java/com/scandine/controller/CustomerMenuController.java`)
- Customer menu routes → Menu management: loads menu (evidence: `src/main/java/com/scandine/controller/CustomerMenuController.java`)
- Customer menu routes → Table and QR management: resolves table (evidence: `src/main/java/com/scandine/controller/CustomerMenuController.java`)
- Customer menu routes → Orders and sessions: starts ordering (evidence: `src/main/java/com/scandine/controller/CustomerMenuController.java`)
- Customer → Ordering API: submits order (evidence: `src/main/java/com/scandine/controller/ApiController.java`)
- Ordering API → Orders and sessions: manages orders (evidence: `src/main/java/com/scandine/controller/ApiController.java`)
- Ordering API → Restaurant management: loads restaurant (evidence: `src/main/java/com/scandine/controller/ApiController.java`)
- Ordering API → Razorpay integration: handles payment (evidence: `src/main/java/com/scandine/controller/ApiController.java`)
- Restaurant owner → Owner dashboard routes: manages restaurant (evidence: `src/main/java/com/scandine/controller/OwnerController.java`)
- Owner dashboard routes → Restaurant management: manages details (evidence: `src/main/java/com/scandine/controller/OwnerController.java`)
- Owner dashboard routes → Menu management: manages menu (evidence: `src/main/java/com/scandine/controller/OwnerController.java`)
- Owner dashboard routes → Table and QR management: manages tables (evidence: `src/main/java/com/scandine/controller/OwnerController.java`)
- Owner dashboard routes → Orders and sessions: views orders (evidence: `src/main/java/com/scandine/controller/OwnerController.java`)
- Owner dashboard routes → File storage: stores uploads (evidence: `src/main/java/com/scandine/controller/OwnerController.java`)
- Restaurant management → JPA repositories: reads and writes (evidence: `src/main/java/com/scandine/service/RestaurantService.java`)
- Menu management → JPA repositories: reads and writes (evidence: `src/main/java/com/scandine/service/MenuService.java`)
- Table and QR management → JPA repositories: reads and writes (evidence: `src/main/java/com/scandine/service/TableService.java`)
- Orders and sessions → JPA repositories: reads and writes (evidence: `src/main/java/com/scandine/service/OrderService.java`)
- Orders and sessions → Restaurant and order entities: creates order items (evidence: `src/main/java/com/scandine/service/OrderService.java`)
- JPA repositories → Restaurant and order entities: persists entities (evidence: `src/main/java/com/scandine/repository/TableSessionRepository.java`)
- Orders and sessions → Order notifications: publishes updates (evidence: `src/main/java/com/scandine/service/OrderService.java`)
- Authentication routes → User authentication lookup: authenticates users
- User authentication lookup → JPA repositories: looks up users (evidence: `src/main/java/com/scandine/security/CustomUserDetailsService.java`)
- Spring application → Customer menu routes: serves routes
