# saikumar-bali/aagam_e-commerce architecture

> Architecture diagram of the GitHub repository saikumar-bali/aagam_e-commerce, generated by GitDiagram from its file tree, README and a sample of source files (last updated 2026-09-29). It is an AI-made overview: check details against the source.

- Interactive diagram: https://gitdiagram.com/saikumar-bali/aagam_e-commerce
- Repository: https://github.com/saikumar-bali/aagam_e-commerce

## Overview

Aagam is a commerce and local-delivery platform spanning customer, store, rider, and administrator experiences. The principal workflow is customer shopping and checkout, followed by store fulfillment, rider dispatch and delivery, with tracking and notifications supporting the journey. Subscriptions and partner onboarding are additional domain branches. The tree identifies these capabilities, while sampled controller/service excerpts confirm selected API calls; the README is empty and many client and backend paths were not sampled, so uncertain wiring is omitted.

Main entry points: [`apps/api-gateway/src/main.ts`](https://github.com/saikumar-bali/aagam_e-commerce/blob/main/apps/api-gateway/src/main.ts) (API Gateway), [`apps/api-gateway/src/orders/store-fulfillment.service.ts`](https://github.com/saikumar-bali/aagam_e-commerce/blob/main/apps/api-gateway/src/orders/store-fulfillment.service.ts) (Store Fulfillment), [`apps/admin-dashboard/src/app/(shop)/shop/page.tsx`](https://github.com/saikumar-bali/aagam_e-commerce/blob/main/apps/admin-dashboard/src/app/(shop)/shop/page.tsx) (Customer Web), [`apps/admin-dashboard/src/app/(admin)/admin/page.tsx`](https://github.com/saikumar-bali/aagam_e-commerce/blob/main/apps/admin-dashboard/src/app/(admin)/admin/page.tsx) (Admin Dashboard)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_clients["User Experiences"]
  node_customerweb["Customer Web<br/>[page.tsx]"]
  node_adminweb["Admin Dashboard<br/>[page.tsx]"]
  node_storeweb["Store Portal<br/>[page.tsx]"]
  node_riderweb["Rider Portal<br/>[page.tsx]"]
  node_mobilecustomer["Customer App<br/>[App.tsx]"]
end

subgraph group_commerce["Commerce"]
  node_catalog["Products and Stores<br/>[product.service.ts]"]
  node_checkout["Checkout"]
  node_orders["Order Management<br/>[order.service.ts]"]
end

subgraph group_operations["Fulfillment Operations"]
  node_fulfillment["Store Fulfillment"]
  node_dispatch["Dispatch"]
  node_riderops["Rider Operations"]
  node_tracking["Live Tracking"]
end

subgraph group_recurring["Subscriptions"]
  node_subscriptions["Subscriptions and Routes"]
end

subgraph group_platform["Platform Services"]
  node_gateway["API Gateway<br/>[main.ts]"]
  node_auth["Authentication<br/>[auth.service.ts]"]
  node_onboarding["Partner Onboarding"]
  node_notifications["Notifications"]
  node_database[("Application Database")]
end

node_customer(("Customer"))
node_storeuser(("Store Owner"))
node_rideruser(("Rider"))
node_adminuser(("Administrator"))
node_push["Push Provider"]

node_customer -->|"uses"| node_customerweb
node_customer -->|"uses"| node_mobilecustomer
node_storeuser -->|"uses"| node_storeweb
node_rideruser -->|"uses"| node_riderweb
node_adminuser -->|"uses"| node_adminweb
node_customerweb -->|"API requests"| node_gateway
node_mobilecustomer -->|"API requests"| node_gateway
node_storeweb -->|"API requests"| node_gateway
node_riderweb -->|"API requests"| node_gateway
node_adminweb -->|"API requests"| node_gateway
node_gateway -->|"routes auth"| node_auth
node_gateway -->|"routes catalog"| node_catalog
node_gateway -->|"routes checkout"| node_checkout
node_gateway -->|"routes orders"| node_orders
node_gateway -->|"routes fulfillment"| node_fulfillment
node_gateway -->|"routes dispatch"| node_dispatch
node_gateway -->|"routes rider"| node_riderops
node_gateway -->|"routes tracking"| node_tracking
node_gateway -->|"routes subscriptions"| node_subscriptions
node_gateway -->|"routes onboarding"| node_onboarding
node_gateway -->|"routes notifications"| node_notifications
node_fulfillment -->|"updates status"| node_orders
node_auth -->|"reads and writes"| node_database
node_fulfillment -->|"reads and writes"| node_database
node_tracking -->|"stores tracking"| node_database
node_subscriptions -->|"reads and writes"| node_database
node_notifications -.->|"delivers push"| node_push

click node_customerweb "https://github.com/saikumar-bali/aagam_e-commerce/blob/main/apps/admin-dashboard/src/app/(shop)/shop/page.tsx"
click node_adminweb "https://github.com/saikumar-bali/aagam_e-commerce/blob/main/apps/admin-dashboard/src/app/(admin)/admin/page.tsx"
click node_storeweb "https://github.com/saikumar-bali/aagam_e-commerce/blob/main/apps/admin-dashboard/src/app/(store)/store/page.tsx"
click node_riderweb "https://github.com/saikumar-bali/aagam_e-commerce/blob/main/apps/admin-dashboard/src/app/(rider)/rider/page.tsx"
click node_mobilecustomer "https://github.com/saikumar-bali/aagam_e-commerce/blob/main/apps/mobile-customer/App.tsx"
click node_gateway "https://github.com/saikumar-bali/aagam_e-commerce/blob/main/apps/api-gateway/src/main.ts"
click node_auth "https://github.com/saikumar-bali/aagam_e-commerce/blob/main/apps/api-gateway/src/auth/auth.service.ts"
click node_catalog "https://github.com/saikumar-bali/aagam_e-commerce/blob/main/apps/api-gateway/src/products/product.service.ts"
click node_checkout "https://github.com/saikumar-bali/aagam_e-commerce/blob/main/apps/api-gateway/src/checkout/checkout.service.ts"
click node_orders "https://github.com/saikumar-bali/aagam_e-commerce/blob/main/apps/api-gateway/src/orders/order.service.ts"
click node_fulfillment "https://github.com/saikumar-bali/aagam_e-commerce/blob/main/apps/api-gateway/src/orders/store-fulfillment.service.ts"
click node_dispatch "https://github.com/saikumar-bali/aagam_e-commerce/blob/main/apps/api-gateway/src/orders/dispatch.service.ts"
click node_riderops "https://github.com/saikumar-bali/aagam_e-commerce/blob/main/apps/api-gateway/src/riders/rider-portal.service.ts"
click node_tracking "https://github.com/saikumar-bali/aagam_e-commerce/blob/main/apps/api-gateway/src/tracking/tracking.service.ts"
click node_subscriptions "https://github.com/saikumar-bali/aagam_e-commerce/blob/main/apps/api-gateway/src/subscriptions/subscriptions.controller.ts"
click node_onboarding "https://github.com/saikumar-bali/aagam_e-commerce/blob/main/apps/api-gateway/src/partner-onboarding/partner-onboarding.controller.ts"
click node_notifications "https://github.com/saikumar-bali/aagam_e-commerce/blob/main/apps/api-gateway/src/notifications/notifications.controller.ts"

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_customerweb,node_adminweb,node_storeweb,node_riderweb,node_mobilecustomer toneBlue
class node_catalog,node_checkout,node_orders toneAmber
class node_fulfillment,node_dispatch,node_riderops,node_tracking toneMint
class node_subscriptions toneRose
class node_gateway,node_auth,node_onboarding,node_notifications,node_database,node_customer,node_storeuser,node_rideruser,node_adminuser,node_push toneIndigo
```

## Components

### User Experiences

- [Customer Web](https://github.com/saikumar-bali/aagam_e-commerce/blob/main/apps/admin-dashboard/src/app/(shop)/shop/page.tsx): `apps/admin-dashboard/src/app/(shop)/shop/page.tsx`
- [Admin Dashboard](https://github.com/saikumar-bali/aagam_e-commerce/blob/main/apps/admin-dashboard/src/app/(admin)/admin/page.tsx): `apps/admin-dashboard/src/app/(admin)/admin/page.tsx`
- [Store Portal](https://github.com/saikumar-bali/aagam_e-commerce/blob/main/apps/admin-dashboard/src/app/(store)/store/page.tsx): `apps/admin-dashboard/src/app/(store)/store/page.tsx`
- [Rider Portal](https://github.com/saikumar-bali/aagam_e-commerce/blob/main/apps/admin-dashboard/src/app/(rider)/rider/page.tsx): `apps/admin-dashboard/src/app/(rider)/rider/page.tsx`
- [Customer App](https://github.com/saikumar-bali/aagam_e-commerce/blob/main/apps/mobile-customer/App.tsx): `apps/mobile-customer/App.tsx`

### Commerce

- [Products and Stores](https://github.com/saikumar-bali/aagam_e-commerce/blob/main/apps/api-gateway/src/products/product.service.ts): `apps/api-gateway/src/products/product.service.ts`
- [Checkout](https://github.com/saikumar-bali/aagam_e-commerce/blob/main/apps/api-gateway/src/checkout/checkout.service.ts): `apps/api-gateway/src/checkout/checkout.service.ts`
- [Order Management](https://github.com/saikumar-bali/aagam_e-commerce/blob/main/apps/api-gateway/src/orders/order.service.ts): `apps/api-gateway/src/orders/order.service.ts`

### Fulfillment Operations

- [Store Fulfillment](https://github.com/saikumar-bali/aagam_e-commerce/blob/main/apps/api-gateway/src/orders/store-fulfillment.service.ts): `apps/api-gateway/src/orders/store-fulfillment.service.ts`
- [Dispatch](https://github.com/saikumar-bali/aagam_e-commerce/blob/main/apps/api-gateway/src/orders/dispatch.service.ts): `apps/api-gateway/src/orders/dispatch.service.ts`
- [Rider Operations](https://github.com/saikumar-bali/aagam_e-commerce/blob/main/apps/api-gateway/src/riders/rider-portal.service.ts): `apps/api-gateway/src/riders/rider-portal.service.ts`
- [Live Tracking](https://github.com/saikumar-bali/aagam_e-commerce/blob/main/apps/api-gateway/src/tracking/tracking.service.ts): `apps/api-gateway/src/tracking/tracking.service.ts`

### Subscriptions

- [Subscriptions and Routes](https://github.com/saikumar-bali/aagam_e-commerce/blob/main/apps/api-gateway/src/subscriptions/subscriptions.controller.ts): `apps/api-gateway/src/subscriptions/subscriptions.controller.ts`

### Platform Services

- [API Gateway](https://github.com/saikumar-bali/aagam_e-commerce/blob/main/apps/api-gateway/src/main.ts): `apps/api-gateway/src/main.ts`
- [Authentication](https://github.com/saikumar-bali/aagam_e-commerce/blob/main/apps/api-gateway/src/auth/auth.service.ts): `apps/api-gateway/src/auth/auth.service.ts`
- [Partner Onboarding](https://github.com/saikumar-bali/aagam_e-commerce/blob/main/apps/api-gateway/src/partner-onboarding/partner-onboarding.controller.ts): `apps/api-gateway/src/partner-onboarding/partner-onboarding.controller.ts`
- [Notifications](https://github.com/saikumar-bali/aagam_e-commerce/blob/main/apps/api-gateway/src/notifications/notifications.controller.ts): `apps/api-gateway/src/notifications/notifications.controller.ts`
- **Application Database**

### Other components

- **Customer**
- **Store Owner**
- **Rider**
- **Administrator**
- **Push Provider**

## Connections

- Customer → Customer Web: uses
- Customer → Customer App: uses
- Store Owner → Store Portal: uses
- Rider → Rider Portal: uses
- Administrator → Admin Dashboard: uses
- Customer Web → API Gateway: API requests
- Customer App → API Gateway: API requests
- Store Portal → API Gateway: API requests
- Rider Portal → API Gateway: API requests
- Admin Dashboard → API Gateway: API requests
- API Gateway → Authentication: routes auth
- API Gateway → Products and Stores: routes catalog
- API Gateway → Checkout: routes checkout
- API Gateway → Order Management: routes orders
- API Gateway → Store Fulfillment: routes fulfillment
- API Gateway → Dispatch: routes dispatch
- API Gateway → Rider Operations: routes rider
- API Gateway → Live Tracking: routes tracking
- API Gateway → Subscriptions and Routes: routes subscriptions
- API Gateway → Partner Onboarding: routes onboarding
- API Gateway → Notifications: routes notifications
- Store Fulfillment → Order Management: updates status
- Authentication → Application Database: reads and writes
- Store Fulfillment → Application Database: reads and writes
- Live Tracking → Application Database: stores tracking
- Subscriptions and Routes → Application Database: reads and writes
- Notifications → Push Provider: delivers push