# svamseekar/masova-platform architecture

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

- Interactive diagram: https://gitdiagram.com/svamseekar/masova-platform
- Repository: https://github.com/svamseekar/masova-platform

## Overview

MaSoVa is a multi-store restaurant operating system spanning customer ordering, restaurant operations, payments, delivery, and management analytics. The principal documented flow is customer app → API gateway → commerce order handling, with payment, kitchen, and delivery capabilities around the order lifecycle. Separate product branches cover menu/allergen compliance, fiscal signing, inventory, reviews, staff operations, and intelligence. Some subsystem links rely on README-level architecture statements; unsampled implementation details are not inferred.

Main entry points: [`api-gateway/src/main/java/com/MaSoVa/gateway/ApiGatewayApplication.java`](https://github.com/svamseekar/masova-platform/blob/main/api-gateway/src/main/java/com/MaSoVa/gateway/ApiGatewayApplication.java) (API Gateway), [`commerce-service/src/main/java/com/MaSoVa/commerce/order/service/OrderService.java`](https://github.com/svamseekar/masova-platform/blob/main/commerce-service/src/main/java/com/MaSoVa/commerce/order/service/OrderService.java) (Orders and Kitchen), [`frontend/src/pages/manager/ManagerShell.tsx`](https://github.com/svamseekar/masova-platform/blob/main/frontend/src/pages/manager/ManagerShell.tsx) (Manager Dashboard), [`frontend/src/apps/DriverApp/DriverDashboard.tsx`](https://github.com/svamseekar/masova-platform/blob/main/frontend/src/apps/DriverApp/DriverDashboard.tsx) (Driver App)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_experience["User Experience"]
  node_customer_app["Customer App<br/>[App.tsx]"]
  node_driver_app["Driver App"]
  node_manager_ui["Manager Dashboard<br/>[ManagerShell.tsx]"]
end

subgraph group_commerce["Commerce Operations"]
  node_orders["Orders and Kitchen<br/>[OrderService.java]"]
  node_menu["Menu and Allergens<br/>[MenuService.java]"]
  node_fiscal["Fiscal Signing"]
  node_delivery["Delivery Dispatch"]
  node_inventory["Inventory and Purchasing"]
end

subgraph group_platform["Platform Services"]
  node_gateway["API Gateway"]
  node_payments["Payments and Refunds"]
  node_identity["Identity and Stores<br/>[UserService.java]"]
  node_staff_ops["Shifts and Sessions"]
  node_customers_data["Customer Records"]
  node_reviews["Reviews and Moderation<br/>[ReviewService.java]"]
  node_notifications["Notifications"]
end

subgraph group_insights["Intelligence"]
  node_intelligence["Analytics and Forecasts"]
end

node_customers(("Customers"))
node_staff(("Restaurant Staff"))
node_rabbitmq["RabbitMQ"]
node_datastores[("MongoDB and PostgreSQL")]

node_customers -->|"orders through"| node_customer_app
node_staff -->|"manages through"| node_manager_ui
node_staff -->|"delivers through"| node_driver_app
node_customer_app -->|"sends requests"| node_gateway
node_driver_app -.->|"uses platform"| node_gateway
node_manager_ui -.->|"uses platform"| node_gateway
node_gateway -->|"routes requests"| node_orders
node_gateway -->|"routes requests"| node_identity
node_gateway -->|"routes requests"| node_payments
node_gateway -->|"routes requests"| node_delivery
node_gateway -->|"routes requests"| node_intelligence
node_orders -->|"persists orders"| node_datastores
node_orders -->|"queries menu"| node_menu
node_orders -->|"queries delivery"| node_delivery
node_orders -->|"signs completion"| node_fiscal
node_orders -->|"publishes events"| node_rabbitmq
node_payments -->|"relays paid status"| node_orders
node_delivery -.->|"assigns deliveries"| node_driver_app
node_gateway -.->|"routes requests"| node_inventory
node_gateway -.->|"routes requests"| node_reviews
node_gateway -.->|"routes requests"| node_staff_ops
node_gateway -.->|"routes requests"| node_customers_data
node_orders -.->|"notifies on events"| node_notifications
node_rabbitmq -->|"carries events"| node_notifications
node_manager_ui -.->|"views insights"| node_intelligence

click node_customer_app "https://github.com/svamseekar/masova-platform/blob/main/frontend/src/App.tsx"
click node_driver_app "https://github.com/svamseekar/masova-platform/blob/main/frontend/src/apps/DriverApp/DriverDashboard.tsx"
click node_manager_ui "https://github.com/svamseekar/masova-platform/blob/main/frontend/src/pages/manager/ManagerShell.tsx"
click node_gateway "https://github.com/svamseekar/masova-platform/blob/main/api-gateway/src/main/java/com/MaSoVa/gateway/ApiGatewayApplication.java"
click node_orders "https://github.com/svamseekar/masova-platform/blob/main/commerce-service/src/main/java/com/MaSoVa/commerce/order/service/OrderService.java"
click node_menu "https://github.com/svamseekar/masova-platform/blob/main/commerce-service/src/main/java/com/MaSoVa/commerce/menu/service/MenuService.java"
click node_fiscal "https://github.com/svamseekar/masova-platform/blob/main/commerce-service/src/main/java/com/MaSoVa/commerce/fiscal/FiscalSigningService.java"
click node_payments "https://github.com/svamseekar/masova-platform/blob/main/payment-service/src/main/java/com/MaSoVa/payment/service/PaymentService.java"
click node_delivery "https://github.com/svamseekar/masova-platform/blob/main/logistics-service/src/main/java/com/MaSoVa/logistics/delivery/service/AutoDispatchService.java"
click node_inventory "https://github.com/svamseekar/masova-platform/blob/main/logistics-service/src/main/java/com/MaSoVa/logistics/inventory/service/InventoryService.java"
click node_identity "https://github.com/svamseekar/masova-platform/blob/main/core-service/src/main/java/com/MaSoVa/core/user/service/UserService.java"
click node_staff_ops "https://github.com/svamseekar/masova-platform/blob/main/core-service/src/main/java/com/MaSoVa/core/user/service/WorkingSessionService.java"
click node_customers_data "https://github.com/svamseekar/masova-platform/blob/main/core-service/src/main/java/com/MaSoVa/core/customer/service/CustomerService.java"
click node_reviews "https://github.com/svamseekar/masova-platform/blob/main/core-service/src/main/java/com/MaSoVa/core/review/service/ReviewService.java"
click node_notifications "https://github.com/svamseekar/masova-platform/blob/main/core-service/src/main/java/com/MaSoVa/core/notification/service/NotificationService.java"
click node_intelligence "https://github.com/svamseekar/masova-platform/blob/main/intelligence-service/src/main/java/com/MaSoVa/intelligence/service/BIEngineService.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_customer_app,node_driver_app,node_manager_ui toneBlue
class node_orders,node_menu,node_fiscal,node_delivery,node_inventory,node_datastores toneAmber
class node_gateway,node_payments,node_identity,node_staff_ops,node_customers_data,node_reviews,node_notifications toneMint
class node_intelligence toneRose
class node_customers,node_staff,node_rabbitmq toneIndigo
```

## Components

### User Experience

- [Customer App](https://github.com/svamseekar/masova-platform/blob/main/frontend/src/App.tsx): `frontend/src/App.tsx`
- [Driver App](https://github.com/svamseekar/masova-platform/blob/main/frontend/src/apps/DriverApp/DriverDashboard.tsx): `frontend/src/apps/DriverApp/DriverDashboard.tsx`
- [Manager Dashboard](https://github.com/svamseekar/masova-platform/blob/main/frontend/src/pages/manager/ManagerShell.tsx): `frontend/src/pages/manager/ManagerShell.tsx`

### Commerce Operations

- [Orders and Kitchen](https://github.com/svamseekar/masova-platform/blob/main/commerce-service/src/main/java/com/MaSoVa/commerce/order/service/OrderService.java): `commerce-service/src/main/java/com/MaSoVa/commerce/order/service/OrderService.java`
- [Menu and Allergens](https://github.com/svamseekar/masova-platform/blob/main/commerce-service/src/main/java/com/MaSoVa/commerce/menu/service/MenuService.java): `commerce-service/src/main/java/com/MaSoVa/commerce/menu/service/MenuService.java`
- [Fiscal Signing](https://github.com/svamseekar/masova-platform/blob/main/commerce-service/src/main/java/com/MaSoVa/commerce/fiscal/FiscalSigningService.java): `commerce-service/src/main/java/com/MaSoVa/commerce/fiscal/FiscalSigningService.java`
- [Delivery Dispatch](https://github.com/svamseekar/masova-platform/blob/main/logistics-service/src/main/java/com/MaSoVa/logistics/delivery/service/AutoDispatchService.java): `logistics-service/src/main/java/com/MaSoVa/logistics/delivery/service/AutoDispatchService.java`
- [Inventory and Purchasing](https://github.com/svamseekar/masova-platform/blob/main/logistics-service/src/main/java/com/MaSoVa/logistics/inventory/service/InventoryService.java): `logistics-service/src/main/java/com/MaSoVa/logistics/inventory/service/InventoryService.java`

### Platform Services

- [API Gateway](https://github.com/svamseekar/masova-platform/blob/main/api-gateway/src/main/java/com/MaSoVa/gateway/ApiGatewayApplication.java): `api-gateway/src/main/java/com/MaSoVa/gateway/ApiGatewayApplication.java`
- [Payments and Refunds](https://github.com/svamseekar/masova-platform/blob/main/payment-service/src/main/java/com/MaSoVa/payment/service/PaymentService.java): `payment-service/src/main/java/com/MaSoVa/payment/service/PaymentService.java`
- [Identity and Stores](https://github.com/svamseekar/masova-platform/blob/main/core-service/src/main/java/com/MaSoVa/core/user/service/UserService.java): `core-service/src/main/java/com/MaSoVa/core/user/service/UserService.java`
- [Shifts and Sessions](https://github.com/svamseekar/masova-platform/blob/main/core-service/src/main/java/com/MaSoVa/core/user/service/WorkingSessionService.java): `core-service/src/main/java/com/MaSoVa/core/user/service/WorkingSessionService.java`
- [Customer Records](https://github.com/svamseekar/masova-platform/blob/main/core-service/src/main/java/com/MaSoVa/core/customer/service/CustomerService.java): `core-service/src/main/java/com/MaSoVa/core/customer/service/CustomerService.java`
- [Reviews and Moderation](https://github.com/svamseekar/masova-platform/blob/main/core-service/src/main/java/com/MaSoVa/core/review/service/ReviewService.java): `core-service/src/main/java/com/MaSoVa/core/review/service/ReviewService.java`
- [Notifications](https://github.com/svamseekar/masova-platform/blob/main/core-service/src/main/java/com/MaSoVa/core/notification/service/NotificationService.java): `core-service/src/main/java/com/MaSoVa/core/notification/service/NotificationService.java`

### Intelligence

- [Analytics and Forecasts](https://github.com/svamseekar/masova-platform/blob/main/intelligence-service/src/main/java/com/MaSoVa/intelligence/service/BIEngineService.java): `intelligence-service/src/main/java/com/MaSoVa/intelligence/service/BIEngineService.java`

### Other components

- **Customers**
- **Restaurant Staff**
- **RabbitMQ**
- **MongoDB and PostgreSQL**

## Connections

- Customers → Customer App: orders through (evidence: `README.md`)
- Restaurant Staff → Manager Dashboard: manages through (evidence: `README.md`)
- Restaurant Staff → Driver App: delivers through (evidence: `README.md`)
- Customer App → API Gateway: sends requests (evidence: `README.md`)
- Driver App → API Gateway: uses platform
- Manager Dashboard → API Gateway: uses platform
- API Gateway → Orders and Kitchen: routes requests (evidence: `README.md`)
- API Gateway → Identity and Stores: routes requests (evidence: `README.md`)
- API Gateway → Payments and Refunds: routes requests (evidence: `README.md`)
- API Gateway → Delivery Dispatch: routes requests (evidence: `README.md`)
- API Gateway → Analytics and Forecasts: routes requests (evidence: `README.md`)
- Orders and Kitchen → MongoDB and PostgreSQL: persists orders (evidence: `commerce-service/src/main/java/com/MaSoVa/commerce/order/service/OrderService.java`)
- Orders and Kitchen → Menu and Allergens: queries menu (evidence: `commerce-service/src/main/java/com/MaSoVa/commerce/order/service/OrderService.java`)
- Orders and Kitchen → Delivery Dispatch: queries delivery (evidence: `commerce-service/src/main/java/com/MaSoVa/commerce/order/service/OrderService.java`)
- Orders and Kitchen → Fiscal Signing: signs completion (evidence: `README.md`)
- Orders and Kitchen → RabbitMQ: publishes events (evidence: `README.md`)
- Payments and Refunds → Orders and Kitchen: relays paid status (evidence: `payment-service/src/main/java/com/MaSoVa/payment/service/PaymentService.java`)
- Delivery Dispatch → Driver App: assigns deliveries
- API Gateway → Inventory and Purchasing: routes requests
- API Gateway → Reviews and Moderation: routes requests
- API Gateway → Shifts and Sessions: routes requests
- API Gateway → Customer Records: routes requests
- Orders and Kitchen → Notifications: notifies on events
- RabbitMQ → Notifications: carries events (evidence: `README.md`)
- Manager Dashboard → Analytics and Forecasts: views insights
