# harshithrao1103/cloudmart architecture

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

- Interactive diagram: https://gitdiagram.com/harshithrao1103/cloudmart
- Repository: https://github.com/harshithrao1103/cloudmart

## Overview

CloudMart is a cloud-hosted commerce application with customer, product, and order APIs, plus an administrative dashboard and operational reporting. The principal workflow is an administrator signing in, then using the dashboard to retrieve product, order, and customer data; reports are generated from sales data and stored for later access. The source excerpts show database access and dashboard API calls, but the README only names the product and the infrastructure templates were not sampled, so API routing and event-trigger wiring are not verified.

Main entry points: [`database/schema.sql`](https://github.com/harshithrao1103/cloudmart/blob/main/database/schema.sql) (Commerce database), [`dashboard/app.py`](https://github.com/harshithrao1103/cloudmart/blob/main/dashboard/app.py) (Admin dashboard), [`lambda/product/product_lambda.py`](https://github.com/harshithrao1103/cloudmart/blob/main/lambda/product/product_lambda.py) (Product API), [`lambda/order/order_lambda.py`](https://github.com/harshithrao1103/cloudmart/blob/main/lambda/order/order_lambda.py) (Order API)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_admin["Admin experience"]
  node_dashboard_web["Admin dashboard<br/>[app.py]"]
end

subgraph group_commerce["Commerce APIs"]
  node_login["Login<br/>[login_lambda.py]"]
  node_authorizer["JWT authorizer"]
  node_customers["Customer API<br/>[customer_lambda.py]"]
  node_products["Product API<br/>[product_lambda.py]"]
  node_orders["Order API<br/>[order_lambda.py]"]
  node_dashboard_api["Dashboard API"]
end

subgraph group_data["Data and reporting"]
  node_database[("Commerce database<br/>[schema.sql]")]
  node_db_init["Schema initializer<br/>[db_init_lambda.py]"]
  node_daily_report["Daily sales report"]
  node_reports_bucket[("Report storage")]
end

subgraph group_ops["Events and operations"]
  node_event_bus["EventBridge"]
  node_notification["Order notifications"]
  node_monitoring["Metrics publisher"]
  node_alarm_notification["Alarm notifier"]
end

node_admin_user(("Administrator"))
node_api_gateway{{"API endpoint"}}
node_cloudwatch[("CloudWatch")]
node_sns["SNS topic"]

node_admin_user -->|"uses"| node_dashboard_web
node_dashboard_web -->|"requests API"| node_api_gateway
node_api_gateway -.->|"routes requests"| node_dashboard_api
node_api_gateway -.->|"routes requests"| node_login
node_api_gateway -.->|"checks tokens"| node_authorizer
node_api_gateway -.->|"routes requests"| node_customers
node_api_gateway -.->|"routes requests"| node_products
node_api_gateway -.->|"routes requests"| node_orders
node_dashboard_api -->|"queries"| node_database
node_customers -->|"reads and writes"| node_database
node_products -->|"reads and writes"| node_database
node_orders -->|"reads and writes"| node_database
node_login -->|"checks credentials"| node_database
node_authorizer -->|"returns authorization"| node_api_gateway
node_db_init -->|"initializes schema"| node_database
node_daily_report -->|"reads sales"| node_database
node_daily_report -->|"stores CSV"| node_reports_bucket
node_dashboard_web -->|"lists and retrieves reports"| node_reports_bucket
node_orders -.->|"publishes events"| node_event_bus
node_products -.->|"publishes inventory events"| node_event_bus
node_event_bus -.->|"delivers order events"| node_notification
node_event_bus -.->|"delivers events"| node_monitoring
node_monitoring -->|"publishes metrics"| node_cloudwatch
node_cloudwatch -.->|"triggers alarm handler"| node_alarm_notification
node_alarm_notification -->|"publishes alert"| node_sns

click node_dashboard_web "https://github.com/harshithrao1103/cloudmart/blob/main/dashboard/app.py"
click node_login "https://github.com/harshithrao1103/cloudmart/blob/main/lambda/login/login_lambda.py"
click node_authorizer "https://github.com/harshithrao1103/cloudmart/blob/main/lambda/authorizer/authorizer_lambda.py"
click node_customers "https://github.com/harshithrao1103/cloudmart/blob/main/lambda/customer/customer_lambda.py"
click node_products "https://github.com/harshithrao1103/cloudmart/blob/main/lambda/product/product_lambda.py"
click node_orders "https://github.com/harshithrao1103/cloudmart/blob/main/lambda/order/order_lambda.py"
click node_dashboard_api "https://github.com/harshithrao1103/cloudmart/blob/main/lambda/dashboard/dashboard_lambda.py"
click node_database "https://github.com/harshithrao1103/cloudmart/blob/main/database/schema.sql"
click node_db_init "https://github.com/harshithrao1103/cloudmart/blob/main/lambda/db_init/db_init_lambda.py"
click node_daily_report "https://github.com/harshithrao1103/cloudmart/blob/main/lambda/daily_report/daily_report_lambda.py"
click node_notification "https://github.com/harshithrao1103/cloudmart/blob/main/lambda/notification/notification_lambda.py"
click node_monitoring "https://github.com/harshithrao1103/cloudmart/blob/main/lambda/monitoring/monitoring_lambda.py"
click node_alarm_notification "https://github.com/harshithrao1103/cloudmart/blob/main/lambda/alarm_notification/alarm_notification_lambda.py"

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_dashboard_web toneBlue
class node_login,node_authorizer,node_customers,node_products,node_orders,node_dashboard_api,node_cloudwatch toneAmber
class node_database,node_db_init,node_daily_report,node_reports_bucket,node_api_gateway toneMint
class node_event_bus,node_notification,node_monitoring,node_alarm_notification toneRose
class node_admin_user,node_sns toneIndigo
```

## Components

### Admin experience

- [Admin dashboard](https://github.com/harshithrao1103/cloudmart/blob/main/dashboard/app.py): `dashboard/app.py`

### Commerce APIs

- [Login](https://github.com/harshithrao1103/cloudmart/blob/main/lambda/login/login_lambda.py): `lambda/login/login_lambda.py`
- [JWT authorizer](https://github.com/harshithrao1103/cloudmart/blob/main/lambda/authorizer/authorizer_lambda.py): `lambda/authorizer/authorizer_lambda.py`
- [Customer API](https://github.com/harshithrao1103/cloudmart/blob/main/lambda/customer/customer_lambda.py): `lambda/customer/customer_lambda.py`
- [Product API](https://github.com/harshithrao1103/cloudmart/blob/main/lambda/product/product_lambda.py): `lambda/product/product_lambda.py`
- [Order API](https://github.com/harshithrao1103/cloudmart/blob/main/lambda/order/order_lambda.py): `lambda/order/order_lambda.py`
- [Dashboard API](https://github.com/harshithrao1103/cloudmart/blob/main/lambda/dashboard/dashboard_lambda.py): `lambda/dashboard/dashboard_lambda.py`

### Data and reporting

- [Commerce database](https://github.com/harshithrao1103/cloudmart/blob/main/database/schema.sql): `database/schema.sql`
- [Schema initializer](https://github.com/harshithrao1103/cloudmart/blob/main/lambda/db_init/db_init_lambda.py): `lambda/db_init/db_init_lambda.py`
- [Daily sales report](https://github.com/harshithrao1103/cloudmart/blob/main/lambda/daily_report/daily_report_lambda.py): `lambda/daily_report/daily_report_lambda.py`
- **Report storage**

### Events and operations

- **EventBridge**
- [Order notifications](https://github.com/harshithrao1103/cloudmart/blob/main/lambda/notification/notification_lambda.py): `lambda/notification/notification_lambda.py`
- [Metrics publisher](https://github.com/harshithrao1103/cloudmart/blob/main/lambda/monitoring/monitoring_lambda.py): `lambda/monitoring/monitoring_lambda.py`
- [Alarm notifier](https://github.com/harshithrao1103/cloudmart/blob/main/lambda/alarm_notification/alarm_notification_lambda.py): `lambda/alarm_notification/alarm_notification_lambda.py`

### Other components

- **Administrator**
- **API endpoint**
- **CloudWatch**
- **SNS topic**

## Connections

- Administrator → Admin dashboard: uses (evidence: `dashboard/app.py`)
- Admin dashboard → API endpoint: requests API (evidence: `dashboard/app.py`)
- API endpoint → Dashboard API: routes requests
- API endpoint → Login: routes requests
- API endpoint → JWT authorizer: checks tokens
- API endpoint → Customer API: routes requests
- API endpoint → Product API: routes requests
- API endpoint → Order API: routes requests
- Dashboard API → Commerce database: queries (evidence: `lambda/dashboard/dashboard_lambda.py`)
- Customer API → Commerce database: reads and writes (evidence: `lambda/customer/customer_lambda.py`)
- Product API → Commerce database: reads and writes (evidence: `lambda/product/product_lambda.py`)
- Order API → Commerce database: reads and writes (evidence: `lambda/order/order_lambda.py`)
- Login → Commerce database: checks credentials (evidence: `lambda/login/login_lambda.py`)
- JWT authorizer → API endpoint: returns authorization (evidence: `lambda/authorizer/authorizer_lambda.py`)
- Schema initializer → Commerce database: initializes schema (evidence: `lambda/db_init/db_init_lambda.py`)
- Daily sales report → Commerce database: reads sales (evidence: `lambda/daily_report/daily_report_lambda.py`)
- Daily sales report → Report storage: stores CSV (evidence: `lambda/daily_report/daily_report_lambda.py`)
- Admin dashboard → Report storage: lists and retrieves reports (evidence: `dashboard/app.py`)
- Order API → EventBridge: publishes events
- Product API → EventBridge: publishes inventory events
- EventBridge → Order notifications: delivers order events
- EventBridge → Metrics publisher: delivers events
- Metrics publisher → CloudWatch: publishes metrics (evidence: `lambda/monitoring/monitoring_lambda.py`)
- CloudWatch → Alarm notifier: triggers alarm handler
- Alarm notifier → SNS topic: publishes alert (evidence: `lambda/alarm_notification/alarm_notification_lambda.py`)
