# bhavika-007/restopss architecture

> Architecture diagram of the GitHub repository bhavika-007/restopss, 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/bhavika-007/restopss
- Repository: https://github.com/bhavika-007/restopss

## Overview

This is a restaurant operations and booking platform: customers discover restaurants, reserve tables or join a waitlist, while staff manage seating, orders, kitchen work, billing, and restaurant setup. The graph emphasizes reservation/allocation and floor-plan workflows; the tree also shows menu, staff, ordering, kitchen, and cashier capabilities. Source excerpts support the core reservation, allocation, floor-plan, and realtime links; unsampled feature paths are represented at their exact tree paths, with uncertain wiring omitted.

Main entry points: [`backend/server.js`](https://github.com/bhavika-007/restopss/blob/main/backend/server.js) (HTTP and socket server), [`backend/services/allocationService.js`](https://github.com/bhavika-007/restopss/blob/main/backend/services/allocationService.js) (Table allocation), [`backend/controllers/reservationController.js`](https://github.com/bhavika-007/restopss/blob/main/backend/controllers/reservationController.js) (Reservation handling), [`backend/services/reservationService.js`](https://github.com/bhavika-007/restopss/blob/main/backend/services/reservationService.js) (Reservation matching)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_client["Web application"]
  node_web["Role-based web app<br/>[App.jsx]"]
  node_booking_ui["Customer booking<br/>[Booking.jsx]"]
  node_host_ui["Host seating<br/>[HostFloor.jsx]"]
  node_manager_ui["Manager workspace"]
  node_floor_ui["Floor plan editor"]
  node_floor_grid["Floor grid<br/>[FloorPlanGrid.jsx]"]
  node_api_client["API client<br/>[api.js]"]
  node_socket_ui["Realtime client<br/>[SocketContext.jsx]"]
end

subgraph group_api["API and access"]
  node_server["HTTP and socket server<br/>[server.js]"]
  node_auth["Authentication and roles<br/>[auth.js]"]
  node_realtime["Socket events<br/>[socketService.js]"]
end

subgraph group_booking["Booking and seating"]
  node_reservation_api["Reservation handling"]
  node_reservation_rules["Reservation matching"]
  node_allocation_api["Waitlist handling"]
  node_allocation_rules["Table allocation"]
end

subgraph group_operations["Restaurant operations"]
  node_floor_api["Floor layout handling"]
  node_order_api["Order handling<br/>[orderController.js]"]
  node_customer_order_api["Customer orders"]
  node_menu_api["Menu management<br/>[menuController.js]"]
  node_kitchen_api["Kitchen operations<br/>[kitchenRoutes.js]"]
  node_billing_api["Billing<br/>[billingRoutes.js]"]
  node_restaurant_api["Restaurant management"]
  node_staff_api["Staff management<br/>[staffRoutes.js]"]
  node_table_api["Table management<br/>[tableController.js]"]
end

subgraph group_domain["Domain state"]
  node_reservation_data[("Reservations<br/>[Reservation.js]")]
  node_table_data[("Tables<br/>[Table.js]")]
  node_restaurant_data[("Restaurants<br/>[Restaurant.js]")]
  node_queue_data[("Waiting queue<br/>[WaitingQueue.js]")]
  node_order_data[("Orders<br/>[Order.js]")]
  node_menu_data[("Menu items<br/>[MenuItem.js]")]
  node_floor_data[("Floor elements<br/>[FloorElement.js]")]
end

node_customer(("Customer"))
node_staff(("Restaurant staff"))

node_customer -->|"uses"| node_web
node_staff -->|"uses"| node_web
node_web -->|"routes to"| node_booking_ui
node_booking_ui -.->|"requests"| node_api_client
node_host_ui -.->|"requests"| node_api_client
node_manager_ui -->|"opens"| node_floor_ui
node_floor_ui -->|"renders"| node_floor_grid
node_floor_ui -->|"requests layout"| node_api_client
node_api_client -.->|"HTTP requests"| node_server
node_server -->|"routes reservations"| node_reservation_api
node_server -->|"routes allocation"| node_allocation_api
node_server -->|"routes floor layout"| node_floor_api
node_server -->|"protects routes"| node_auth
node_reservation_api -->|"finds combinations"| node_reservation_rules
node_reservation_api -->|"rematches queue"| node_allocation_rules
node_allocation_api -->|"allocates tables"| node_allocation_rules
node_allocation_rules -->|"checks combinations"| node_reservation_rules
node_reservation_api -->|"reads and writes"| node_reservation_data
node_reservation_rules -->|"checks overlap"| node_reservation_data
node_reservation_rules -->|"reads tables"| node_table_data
node_reservation_rules -->|"reads capacity"| node_restaurant_data
node_allocation_rules -->|"reads and updates"| node_table_data
node_allocation_rules -->|"reads and updates"| node_queue_data
node_allocation_rules -->|"reads duration"| node_restaurant_data
node_reservation_api -->|"emits events"| node_realtime
node_allocation_api -->|"emits events"| node_realtime
node_server -->|"initializes"| node_realtime
node_socket_ui -.->|"joins rooms"| node_realtime
node_server -->|"routes orders"| node_order_api
node_server -->|"routes customer orders"| node_customer_order_api
node_order_api -.->|"reads and writes"| node_order_data
node_customer_order_api -.->|"reads and writes"| node_order_data
node_server -->|"routes menu"| node_menu_api
node_menu_api -.->|"manages items"| node_menu_data
node_server -->|"routes kitchen"| node_kitchen_api
node_server -->|"routes billing"| node_billing_api
node_server -->|"routes restaurants"| node_restaurant_api
node_restaurant_api -->|"manages records"| node_restaurant_data
node_server -->|"routes staff"| node_staff_api
node_server -->|"routes tables"| node_table_api
node_table_api -->|"manages tables"| node_table_data
node_floor_api -->|"manages layout tables"| node_table_data
node_floor_api -->|"manages elements"| node_floor_data

click node_web "https://github.com/bhavika-007/restopss/blob/main/frontend/src/App.jsx"
click node_booking_ui "https://github.com/bhavika-007/restopss/blob/main/frontend/src/pages/Booking.jsx"
click node_host_ui "https://github.com/bhavika-007/restopss/blob/main/frontend/src/pages/HostFloor.jsx"
click node_manager_ui "https://github.com/bhavika-007/restopss/blob/main/frontend/src/pages/ManagerDashboard.jsx"
click node_floor_ui "https://github.com/bhavika-007/restopss/blob/main/frontend/src/pages/ManagerFloorPlan.jsx"
click node_floor_grid "https://github.com/bhavika-007/restopss/blob/main/frontend/src/components/FloorPlanGrid/FloorPlanGrid.jsx"
click node_api_client "https://github.com/bhavika-007/restopss/blob/main/frontend/src/api.js"
click node_socket_ui "https://github.com/bhavika-007/restopss/blob/main/frontend/src/context/SocketContext.jsx"
click node_server "https://github.com/bhavika-007/restopss/blob/main/backend/server.js"
click node_auth "https://github.com/bhavika-007/restopss/blob/main/backend/middleware/auth.js"
click node_reservation_api "https://github.com/bhavika-007/restopss/blob/main/backend/controllers/reservationController.js"
click node_reservation_rules "https://github.com/bhavika-007/restopss/blob/main/backend/services/reservationService.js"
click node_allocation_api "https://github.com/bhavika-007/restopss/blob/main/backend/controllers/allocationController.js"
click node_allocation_rules "https://github.com/bhavika-007/restopss/blob/main/backend/services/allocationService.js"
click node_floor_api "https://github.com/bhavika-007/restopss/blob/main/backend/controllers/floorLayoutController.js"
click node_order_api "https://github.com/bhavika-007/restopss/blob/main/backend/controllers/orderController.js"
click node_customer_order_api "https://github.com/bhavika-007/restopss/blob/main/backend/controllers/customerOrderController.js"
click node_menu_api "https://github.com/bhavika-007/restopss/blob/main/backend/controllers/menuController.js"
click node_kitchen_api "https://github.com/bhavika-007/restopss/blob/main/backend/routes/kitchenRoutes.js"
click node_billing_api "https://github.com/bhavika-007/restopss/blob/main/backend/routes/billingRoutes.js"
click node_restaurant_api "https://github.com/bhavika-007/restopss/blob/main/backend/controllers/restaurantController.js"
click node_staff_api "https://github.com/bhavika-007/restopss/blob/main/backend/routes/staffRoutes.js"
click node_table_api "https://github.com/bhavika-007/restopss/blob/main/backend/controllers/tableController.js"
click node_reservation_data "https://github.com/bhavika-007/restopss/blob/main/backend/models/Reservation.js"
click node_table_data "https://github.com/bhavika-007/restopss/blob/main/backend/models/Table.js"
click node_restaurant_data "https://github.com/bhavika-007/restopss/blob/main/backend/models/Restaurant.js"
click node_queue_data "https://github.com/bhavika-007/restopss/blob/main/backend/models/WaitingQueue.js"
click node_order_data "https://github.com/bhavika-007/restopss/blob/main/backend/models/Order.js"
click node_menu_data "https://github.com/bhavika-007/restopss/blob/main/backend/models/MenuItem.js"
click node_floor_data "https://github.com/bhavika-007/restopss/blob/main/backend/models/FloorElement.js"
click node_realtime "https://github.com/bhavika-007/restopss/blob/main/backend/services/socketService.js"

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_web,node_booking_ui,node_host_ui,node_manager_ui,node_floor_ui,node_floor_grid,node_api_client,node_socket_ui toneBlue
class node_server,node_auth,node_realtime toneAmber
class node_reservation_api,node_reservation_rules,node_allocation_api,node_allocation_rules toneMint
class node_floor_api,node_order_api,node_customer_order_api,node_menu_api,node_kitchen_api,node_billing_api,node_restaurant_api,node_staff_api,node_table_api toneRose
class node_reservation_data,node_table_data,node_restaurant_data,node_queue_data,node_order_data,node_menu_data,node_floor_data,node_customer,node_staff toneIndigo
```

## Components

### Web application

- [Role-based web app](https://github.com/bhavika-007/restopss/blob/main/frontend/src/App.jsx): `frontend/src/App.jsx`
- [Customer booking](https://github.com/bhavika-007/restopss/blob/main/frontend/src/pages/Booking.jsx): `frontend/src/pages/Booking.jsx`
- [Host seating](https://github.com/bhavika-007/restopss/blob/main/frontend/src/pages/HostFloor.jsx): `frontend/src/pages/HostFloor.jsx`
- [Manager workspace](https://github.com/bhavika-007/restopss/blob/main/frontend/src/pages/ManagerDashboard.jsx): `frontend/src/pages/ManagerDashboard.jsx`
- [Floor plan editor](https://github.com/bhavika-007/restopss/blob/main/frontend/src/pages/ManagerFloorPlan.jsx): `frontend/src/pages/ManagerFloorPlan.jsx`
- [Floor grid](https://github.com/bhavika-007/restopss/blob/main/frontend/src/components/FloorPlanGrid/FloorPlanGrid.jsx): `frontend/src/components/FloorPlanGrid/FloorPlanGrid.jsx`
- [API client](https://github.com/bhavika-007/restopss/blob/main/frontend/src/api.js): `frontend/src/api.js`
- [Realtime client](https://github.com/bhavika-007/restopss/blob/main/frontend/src/context/SocketContext.jsx): `frontend/src/context/SocketContext.jsx`

### API and access

- [HTTP and socket server](https://github.com/bhavika-007/restopss/blob/main/backend/server.js): `backend/server.js`
- [Authentication and roles](https://github.com/bhavika-007/restopss/blob/main/backend/middleware/auth.js): `backend/middleware/auth.js`
- [Socket events](https://github.com/bhavika-007/restopss/blob/main/backend/services/socketService.js): `backend/services/socketService.js`

### Booking and seating

- [Reservation handling](https://github.com/bhavika-007/restopss/blob/main/backend/controllers/reservationController.js): `backend/controllers/reservationController.js`
- [Reservation matching](https://github.com/bhavika-007/restopss/blob/main/backend/services/reservationService.js): `backend/services/reservationService.js`
- [Waitlist handling](https://github.com/bhavika-007/restopss/blob/main/backend/controllers/allocationController.js): `backend/controllers/allocationController.js`
- [Table allocation](https://github.com/bhavika-007/restopss/blob/main/backend/services/allocationService.js): `backend/services/allocationService.js`

### Restaurant operations

- [Floor layout handling](https://github.com/bhavika-007/restopss/blob/main/backend/controllers/floorLayoutController.js): `backend/controllers/floorLayoutController.js`
- [Order handling](https://github.com/bhavika-007/restopss/blob/main/backend/controllers/orderController.js): `backend/controllers/orderController.js`
- [Customer orders](https://github.com/bhavika-007/restopss/blob/main/backend/controllers/customerOrderController.js): `backend/controllers/customerOrderController.js`
- [Menu management](https://github.com/bhavika-007/restopss/blob/main/backend/controllers/menuController.js): `backend/controllers/menuController.js`
- [Kitchen operations](https://github.com/bhavika-007/restopss/blob/main/backend/routes/kitchenRoutes.js): `backend/routes/kitchenRoutes.js`
- [Billing](https://github.com/bhavika-007/restopss/blob/main/backend/routes/billingRoutes.js): `backend/routes/billingRoutes.js`
- [Restaurant management](https://github.com/bhavika-007/restopss/blob/main/backend/controllers/restaurantController.js): `backend/controllers/restaurantController.js`
- [Staff management](https://github.com/bhavika-007/restopss/blob/main/backend/routes/staffRoutes.js): `backend/routes/staffRoutes.js`
- [Table management](https://github.com/bhavika-007/restopss/blob/main/backend/controllers/tableController.js): `backend/controllers/tableController.js`

### Domain state

- [Reservations](https://github.com/bhavika-007/restopss/blob/main/backend/models/Reservation.js): `backend/models/Reservation.js`
- [Tables](https://github.com/bhavika-007/restopss/blob/main/backend/models/Table.js): `backend/models/Table.js`
- [Restaurants](https://github.com/bhavika-007/restopss/blob/main/backend/models/Restaurant.js): `backend/models/Restaurant.js`
- [Waiting queue](https://github.com/bhavika-007/restopss/blob/main/backend/models/WaitingQueue.js): `backend/models/WaitingQueue.js`
- [Orders](https://github.com/bhavika-007/restopss/blob/main/backend/models/Order.js): `backend/models/Order.js`
- [Menu items](https://github.com/bhavika-007/restopss/blob/main/backend/models/MenuItem.js): `backend/models/MenuItem.js`
- [Floor elements](https://github.com/bhavika-007/restopss/blob/main/backend/models/FloorElement.js): `backend/models/FloorElement.js`

### Other components

- **Customer**
- **Restaurant staff**

## Connections

- Customer → Role-based web app: uses
- Restaurant staff → Role-based web app: uses
- Role-based web app → Customer booking: routes to (evidence: `frontend/src/App.jsx`)
- Customer booking → API client: requests
- Host seating → API client: requests
- Manager workspace → Floor plan editor: opens (evidence: `frontend/src/App.jsx`)
- Floor plan editor → Floor grid: renders (evidence: `frontend/src/pages/ManagerFloorPlan.jsx`)
- Floor plan editor → API client: requests layout
- API client → HTTP and socket server: HTTP requests
- HTTP and socket server → Reservation handling: routes reservations (evidence: `backend/server.js`)
- HTTP and socket server → Waitlist handling: routes allocation (evidence: `backend/server.js`)
- HTTP and socket server → Floor layout handling: routes floor layout (evidence: `backend/server.js`)
- HTTP and socket server → Authentication and roles: protects routes
- Reservation handling → Reservation matching: finds combinations (evidence: `backend/controllers/reservationController.js`)
- Reservation handling → Table allocation: rematches queue (evidence: `backend/controllers/reservationController.js`)
- Waitlist handling → Table allocation: allocates tables (evidence: `backend/controllers/allocationController.js`)
- Table allocation → Reservation matching: checks combinations (evidence: `backend/services/allocationService.js`)
- Reservation handling → Reservations: reads and writes (evidence: `backend/controllers/reservationController.js`)
- Reservation matching → Reservations: checks overlap (evidence: `backend/services/reservationService.js`)
- Reservation matching → Tables: reads tables (evidence: `backend/services/reservationService.js`)
- Reservation matching → Restaurants: reads capacity (evidence: `backend/services/reservationService.js`)
- Table allocation → Tables: reads and updates (evidence: `backend/services/allocationService.js`)
- Table allocation → Waiting queue: reads and updates (evidence: `backend/services/allocationService.js`)
- Table allocation → Restaurants: reads duration (evidence: `backend/services/allocationService.js`)
- Reservation handling → Socket events: emits events (evidence: `backend/controllers/reservationController.js`)
- Waitlist handling → Socket events: emits events (evidence: `backend/controllers/allocationController.js`)
- HTTP and socket server → Socket events: initializes (evidence: `backend/server.js`)
- Realtime client → Socket events: joins rooms
- HTTP and socket server → Order handling: routes orders (evidence: `backend/server.js`)
- HTTP and socket server → Customer orders: routes customer orders (evidence: `backend/server.js`)
- Order handling → Orders: reads and writes (evidence: `backend/controllers/orderController.js`)
- Customer orders → Orders: reads and writes (evidence: `backend/controllers/customerOrderController.js`)
- HTTP and socket server → Menu management: routes menu (evidence: `backend/server.js`)
- Menu management → Menu items: manages items
- HTTP and socket server → Kitchen operations: routes kitchen (evidence: `backend/server.js`)
- HTTP and socket server → Billing: routes billing (evidence: `backend/server.js`)
- HTTP and socket server → Restaurant management: routes restaurants (evidence: `backend/server.js`)
- Restaurant management → Restaurants: manages records (evidence: `backend/controllers/restaurantController.js`)
- HTTP and socket server → Staff management: routes staff (evidence: `backend/server.js`)
- HTTP and socket server → Table management: routes tables (evidence: `backend/server.js`)
- Table management → Tables: manages tables (evidence: `backend/controllers/tableController.js`)
- Floor layout handling → Tables: manages layout tables (evidence: `backend/controllers/floorLayoutController.js`)
- Floor layout handling → Floor elements: manages elements (evidence: `backend/controllers/floorLayoutController.js`)
