# cloud-tamil/shopsphere-helm-project architecture

> Architecture diagram of the GitHub repository cloud-tamil/shopsphere-helm-project, 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/cloud-tamil/shopsphere-helm-project
- Repository: https://github.com/cloud-tamil/shopsphere-helm-project

## Overview

ShopSphere combines a storefront and Express e-commerce API with a Kubernetes deployment platform. The principal flow is shopper → storefront → product browsing or order submission → API response; the backend excerpt shows in-memory seeded catalog and order state, not live PostgreSQL or Redis access. Helm environment configurations, ArgoCD GitOps, and Jenkins CI/CD are documented product capabilities. Frontend and deployment internals were not sampled, so those relationships are limited to README statements.

Main entry points: [`helm/shopsphere/Chart.yaml`](https://github.com/cloud-tamil/shopsphere-helm-project/blob/main/helm/shopsphere/Chart.yaml) (Helm chart), [`app/backend/server.js`](https://github.com/cloud-tamil/shopsphere-helm-project/blob/main/app/backend/server.js) (Express REST API), [`app/frontend/index.html`](https://github.com/cloud-tamil/shopsphere-helm-project/blob/main/app/frontend/index.html) (Storefront UI), [`app/frontend/nginx.conf`](https://github.com/cloud-tamil/shopsphere-helm-project/blob/main/app/frontend/nginx.conf) (Nginx routing)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_commerce["Commerce experience"]
  node_storefront["Storefront UI<br/>[index.html]"]
  node_nginx["Nginx routing<br/>[nginx.conf]"]
end

subgraph group_backend["Backend API"]
  node_api["Express REST API<br/>[server.js]"]
  node_catalog[("Product catalog<br/>[server.js]")]
  node_orders["Order handling<br/>[server.js]"]
  node_probes["Health probes<br/>[server.js]"]
end

subgraph group_deploy["Kubernetes deployment"]
  node_helm["Helm chart<br/>[Chart.yaml]"]
  node_helmworkloads["Kubernetes workloads"]
  node_frontendworkload["Frontend workload"]
  node_ingress["Ingress routing<br/>[ingress.yaml]"]
  node_environment["Environment values<br/>[values-dev.yaml]"]
end

subgraph group_delivery["Delivery platform"]
  node_argocd["ArgoCD applications"]
  node_jenkins["Jenkins pipeline"]
  node_jenkinsconfig["Jenkins setup<br/>[casc.yaml]"]
end

node_shopper(("Shopper"))

node_shopper -->|"uses"| node_storefront
node_storefront -->|"served by"| node_nginx
node_nginx -->|"proxies requests"| node_api
node_api -->|"reads"| node_catalog
node_api -->|"creates and lists"| node_orders
node_api -->|"provides"| node_probes
node_environment -->|"configures"| node_helm
node_helm -->|"renders"| node_helmworkloads
node_helm -->|"renders"| node_frontendworkload
node_helm -->|"renders"| node_ingress
node_argocd -.->|"deploys"| node_helm
node_jenkinsconfig -->|"configures"| node_jenkins

click node_storefront "https://github.com/cloud-tamil/shopsphere-helm-project/blob/main/app/frontend/index.html"
click node_nginx "https://github.com/cloud-tamil/shopsphere-helm-project/blob/main/app/frontend/nginx.conf"
click node_api "https://github.com/cloud-tamil/shopsphere-helm-project/blob/main/app/backend/server.js"
click node_catalog "https://github.com/cloud-tamil/shopsphere-helm-project/blob/main/app/backend/server.js"
click node_orders "https://github.com/cloud-tamil/shopsphere-helm-project/blob/main/app/backend/server.js"
click node_probes "https://github.com/cloud-tamil/shopsphere-helm-project/blob/main/app/backend/server.js"
click node_helm "https://github.com/cloud-tamil/shopsphere-helm-project/blob/main/helm/shopsphere/Chart.yaml"
click node_helmworkloads "https://github.com/cloud-tamil/shopsphere-helm-project/blob/main/helm/shopsphere/templates/backend-deployment.yaml"
click node_frontendworkload "https://github.com/cloud-tamil/shopsphere-helm-project/blob/main/helm/shopsphere/templates/frontend-deployment.yaml"
click node_ingress "https://github.com/cloud-tamil/shopsphere-helm-project/blob/main/helm/shopsphere/templates/ingress.yaml"
click node_environment "https://github.com/cloud-tamil/shopsphere-helm-project/blob/main/helm/shopsphere/values-dev.yaml"
click node_argocd "https://github.com/cloud-tamil/shopsphere-helm-project/blob/main/argocd/application-dev.yaml"
click node_jenkins "https://github.com/cloud-tamil/shopsphere-helm-project/blob/main/Jenkinsfile"
click node_jenkinsconfig "https://github.com/cloud-tamil/shopsphere-helm-project/blob/main/jenkins/casc.yaml"

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_storefront,node_nginx toneBlue
class node_api,node_catalog,node_orders,node_probes toneAmber
class node_helm,node_helmworkloads,node_frontendworkload,node_ingress,node_environment toneMint
class node_argocd,node_jenkins,node_jenkinsconfig toneRose
class node_shopper toneIndigo
```

## Components

### Commerce experience

- [Storefront UI](https://github.com/cloud-tamil/shopsphere-helm-project/blob/main/app/frontend/index.html): `app/frontend/index.html`
- [Nginx routing](https://github.com/cloud-tamil/shopsphere-helm-project/blob/main/app/frontend/nginx.conf): `app/frontend/nginx.conf`

### Backend API

- [Express REST API](https://github.com/cloud-tamil/shopsphere-helm-project/blob/main/app/backend/server.js): `app/backend/server.js`
- [Product catalog](https://github.com/cloud-tamil/shopsphere-helm-project/blob/main/app/backend/server.js): `app/backend/server.js`
- [Order handling](https://github.com/cloud-tamil/shopsphere-helm-project/blob/main/app/backend/server.js): `app/backend/server.js`
- [Health probes](https://github.com/cloud-tamil/shopsphere-helm-project/blob/main/app/backend/server.js): `app/backend/server.js`

### Kubernetes deployment

- [Helm chart](https://github.com/cloud-tamil/shopsphere-helm-project/blob/main/helm/shopsphere/Chart.yaml): `helm/shopsphere/Chart.yaml`
- [Kubernetes workloads](https://github.com/cloud-tamil/shopsphere-helm-project/blob/main/helm/shopsphere/templates/backend-deployment.yaml): `helm/shopsphere/templates/backend-deployment.yaml`
- [Frontend workload](https://github.com/cloud-tamil/shopsphere-helm-project/blob/main/helm/shopsphere/templates/frontend-deployment.yaml): `helm/shopsphere/templates/frontend-deployment.yaml`
- [Ingress routing](https://github.com/cloud-tamil/shopsphere-helm-project/blob/main/helm/shopsphere/templates/ingress.yaml): `helm/shopsphere/templates/ingress.yaml`
- [Environment values](https://github.com/cloud-tamil/shopsphere-helm-project/blob/main/helm/shopsphere/values-dev.yaml): `helm/shopsphere/values-dev.yaml`

### Delivery platform

- [ArgoCD applications](https://github.com/cloud-tamil/shopsphere-helm-project/blob/main/argocd/application-dev.yaml): `argocd/application-dev.yaml`
- [Jenkins pipeline](https://github.com/cloud-tamil/shopsphere-helm-project/blob/main/Jenkinsfile): `Jenkinsfile`
- [Jenkins setup](https://github.com/cloud-tamil/shopsphere-helm-project/blob/main/jenkins/casc.yaml): `jenkins/casc.yaml`

### Other components

- **Shopper**

## Connections

- Shopper → Storefront UI: uses (evidence: `README.md`)
- Storefront UI → Nginx routing: served by (evidence: `README.md`)
- Nginx routing → Express REST API: proxies requests (evidence: `README.md`)
- Express REST API → Product catalog: reads (evidence: `app/backend/server.js`)
- Express REST API → Order handling: creates and lists (evidence: `app/backend/server.js`)
- Express REST API → Health probes: provides (evidence: `app/backend/server.js`)
- Environment values → Helm chart: configures (evidence: `README.md`)
- Helm chart → Kubernetes workloads: renders (evidence: `README.md`)
- Helm chart → Frontend workload: renders (evidence: `README.md`)
- Helm chart → Ingress routing: renders (evidence: `README.md`)
- ArgoCD applications → Helm chart: deploys (evidence: `README.md`)
- Jenkins setup → Jenkins pipeline: configures (evidence: `README.md`)
