How svamseekar/masova-platform works
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: ApiGatewayApplication.java API Gateway · OrderService.java Orders and Kitchen · ManagerShell.tsx Manager Dashboard · DriverDashboard.tsx Driver App
Components 20
User Experience
- Customer App
frontend/src/App.tsx - Driver App
frontend/src/apps/DriverApp/DriverDashboard.tsx - Manager Dashboard
frontend/src/pages/manager/ManagerShell.tsx
Commerce Operations
- Orders and Kitchen
commerce-service/src/main/java/com/MaSoVa/commerce/order/service/OrderService.java - Menu and Allergens
commerce-service/src/main/java/com/MaSoVa/commerce/menu/service/MenuService.java - Fiscal Signing
commerce-service/src/main/java/com/MaSoVa/commerce/fiscal/FiscalSigningService.java - Delivery Dispatch
logistics-service/src/main/java/com/MaSoVa/logistics/delivery/service/AutoDispatchService.java - Inventory and Purchasing
logistics-service/src/main/java/com/MaSoVa/logistics/inventory/service/InventoryService.java
Platform Services
- API Gateway
api-gateway/src/main/java/com/MaSoVa/gateway/ApiGatewayApplication.java - Payments and Refunds
payment-service/src/main/java/com/MaSoVa/payment/service/PaymentService.java - Identity and Stores
core-service/src/main/java/com/MaSoVa/core/user/service/UserService.java - Shifts and Sessions
core-service/src/main/java/com/MaSoVa/core/user/service/WorkingSessionService.java - Customer Records
core-service/src/main/java/com/MaSoVa/core/customer/service/CustomerService.java - Reviews and Moderation
core-service/src/main/java/com/MaSoVa/core/review/service/ReviewService.java - Notifications
core-service/src/main/java/com/MaSoVa/core/notification/service/NotificationService.java
Intelligence
- Analytics and Forecasts
intelligence-service/src/main/java/com/MaSoVa/intelligence/service/BIEngineService.java
Other components
- Customers
- Restaurant Staff
- RabbitMQ
- MongoDB and PostgreSQL
Connections 25
- Customers → Customer App: orders through
README.md - Restaurant Staff → Manager Dashboard: manages through
README.md - Restaurant Staff → Driver App: delivers through
README.md - Customer App → API Gateway: sends requests
README.md - Driver App → API Gateway: uses platform
- Manager Dashboard → API Gateway: uses platform
- API Gateway → Orders and Kitchen: routes requests
README.md - API Gateway → Identity and Stores: routes requests
README.md - API Gateway → Payments and Refunds: routes requests
README.md - API Gateway → Delivery Dispatch: routes requests
README.md - API Gateway → Analytics and Forecasts: routes requests
README.md - Orders and Kitchen → MongoDB and PostgreSQL: persists orders
commerce-service/src/main/java/com/MaSoVa/commerce/order/service/OrderService.java - Orders and Kitchen → Menu and Allergens: queries menu
commerce-service/src/main/java/com/MaSoVa/commerce/order/service/OrderService.java - Orders and Kitchen → Delivery Dispatch: queries delivery
commerce-service/src/main/java/com/MaSoVa/commerce/order/service/OrderService.java - Orders and Kitchen → Fiscal Signing: signs completion
README.md - Orders and Kitchen → RabbitMQ: publishes events
README.md - Payments and Refunds → Orders and Kitchen: relays paid status
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
README.md - Manager Dashboard → Analytics and Forecasts: views insights