# harshsoni8780/microservies-orchestration-platform architecture

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

- Interactive diagram: https://gitdiagram.com/harshsoni8780/microservies-orchestration-platform
- Repository: https://github.com/harshsoni8780/microservies-orchestration-platform

## Overview

This repository pairs a React microservices control center with an Express/PostgreSQL API and Kubernetes deployment configurations. The main user workflow is to open the dashboard, which polls API and database health and lists items; users can submit a named item, which the API stores in PostgreSQL and returns to the dashboard. The UI also presents topology, deployment-status, container, and telemetry panels. The README documents both Kustomize and Helm deployment options. Deployment manifests and Terraform are included as product infrastructure; their internal wiring was not sampled.

Main entry points: [`frontend/src/App.tsx`](https://github.com/harshsoni8780/microservies-orchestration-platform/blob/main/frontend/src/App.tsx) (Dashboard app), [`backend/src/index.js`](https://github.com/harshsoni8780/microservies-orchestration-platform/blob/main/backend/src/index.js) (Express API), [`k8s/base`](https://github.com/harshsoni8780/microservies-orchestration-platform/tree/main/k8s/base) (Kustomize manifests), [`helm/microservices`](https://github.com/harshsoni8780/microservies-orchestration-platform/tree/main/helm/microservices) (Helm chart)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_dashboard["Control Center UI"]
  node_app["Dashboard app<br/>[App.tsx]"]
  node_entry["React entry point<br/>[main.tsx]"]
  node_system["System status<br/>[SystemStatus.tsx]"]
  node_topology["Topology view<br/>[TopologyGraph.tsx]"]
  node_timeline["Deployment timeline"]
  node_registry["Item registry<br/>[ItemRegistry.tsx]"]
  node_containers["Container status"]
  node_metrics["Metrics dashboard"]
end

subgraph group_runtime["API and Data"]
  node_api["Express API<br/>[index.js]"]
  node_postgres[("PostgreSQL")]
end

subgraph group_deployment["Deployment Infrastructure"]
  node_kustomize["Kustomize manifests"]
  node_helm["Helm chart"]
  node_cloud["AWS infrastructure"]
end

node_operator(("Dashboard user"))
node_prometheus(("Metrics scraper"))
node_cluster["Kubernetes cluster"]

node_operator -->|"uses"| node_app
node_entry -->|"renders"| node_app
node_app -->|"renders"| node_system
node_app -->|"renders"| node_topology
node_app -->|"renders"| node_timeline
node_app -->|"renders"| node_registry
node_app -->|"renders"| node_containers
node_app -->|"renders"| node_metrics
node_app -->|"polls health"| node_api
node_app -->|"fetches items"| node_api
node_app -->|"creates items"| node_api
node_api -->|"queries"| node_postgres
node_prometheus -.->|"scrapes metrics"| node_api
node_operator -->|"applies"| node_kustomize
node_operator -->|"installs"| node_helm
node_kustomize -->|"deploys to"| node_cluster
node_helm -->|"deploys to"| node_cluster

click node_app "https://github.com/harshsoni8780/microservies-orchestration-platform/blob/main/frontend/src/App.tsx"
click node_entry "https://github.com/harshsoni8780/microservies-orchestration-platform/blob/main/frontend/src/main.tsx"
click node_system "https://github.com/harshsoni8780/microservies-orchestration-platform/blob/main/frontend/src/components/SystemStatus.tsx"
click node_topology "https://github.com/harshsoni8780/microservies-orchestration-platform/blob/main/frontend/src/components/TopologyGraph.tsx"
click node_timeline "https://github.com/harshsoni8780/microservies-orchestration-platform/blob/main/frontend/src/components/DeploymentTimeline.tsx"
click node_registry "https://github.com/harshsoni8780/microservies-orchestration-platform/blob/main/frontend/src/components/ItemRegistry.tsx"
click node_containers "https://github.com/harshsoni8780/microservies-orchestration-platform/blob/main/frontend/src/components/DockerContainers.tsx"
click node_metrics "https://github.com/harshsoni8780/microservies-orchestration-platform/blob/main/frontend/src/components/MetricsDashboard.tsx"
click node_api "https://github.com/harshsoni8780/microservies-orchestration-platform/blob/main/backend/src/index.js"
click node_kustomize "https://github.com/harshsoni8780/microservies-orchestration-platform/tree/main/k8s/base"
click node_helm "https://github.com/harshsoni8780/microservies-orchestration-platform/tree/main/helm/microservices"
click node_cloud "https://github.com/harshsoni8780/microservies-orchestration-platform/tree/main/terraform"

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_app,node_entry,node_system,node_topology,node_timeline,node_registry,node_containers,node_metrics,node_operator toneBlue
class node_api,node_postgres toneAmber
class node_kustomize,node_helm,node_cloud toneMint
class node_prometheus,node_cluster toneIndigo
```

## Components

### Control Center UI

- [Dashboard app](https://github.com/harshsoni8780/microservies-orchestration-platform/blob/main/frontend/src/App.tsx): `frontend/src/App.tsx`
- [React entry point](https://github.com/harshsoni8780/microservies-orchestration-platform/blob/main/frontend/src/main.tsx): `frontend/src/main.tsx`
- [System status](https://github.com/harshsoni8780/microservies-orchestration-platform/blob/main/frontend/src/components/SystemStatus.tsx): `frontend/src/components/SystemStatus.tsx`
- [Topology view](https://github.com/harshsoni8780/microservies-orchestration-platform/blob/main/frontend/src/components/TopologyGraph.tsx): `frontend/src/components/TopologyGraph.tsx`
- [Deployment timeline](https://github.com/harshsoni8780/microservies-orchestration-platform/blob/main/frontend/src/components/DeploymentTimeline.tsx): `frontend/src/components/DeploymentTimeline.tsx`
- [Item registry](https://github.com/harshsoni8780/microservies-orchestration-platform/blob/main/frontend/src/components/ItemRegistry.tsx): `frontend/src/components/ItemRegistry.tsx`
- [Container status](https://github.com/harshsoni8780/microservies-orchestration-platform/blob/main/frontend/src/components/DockerContainers.tsx): `frontend/src/components/DockerContainers.tsx`
- [Metrics dashboard](https://github.com/harshsoni8780/microservies-orchestration-platform/blob/main/frontend/src/components/MetricsDashboard.tsx): `frontend/src/components/MetricsDashboard.tsx`

### API and Data

- [Express API](https://github.com/harshsoni8780/microservies-orchestration-platform/blob/main/backend/src/index.js): `backend/src/index.js`
- **PostgreSQL**

### Deployment Infrastructure

- [Kustomize manifests](https://github.com/harshsoni8780/microservies-orchestration-platform/tree/main/k8s/base): `k8s/base`
- [Helm chart](https://github.com/harshsoni8780/microservies-orchestration-platform/tree/main/helm/microservices): `helm/microservices`
- [AWS infrastructure](https://github.com/harshsoni8780/microservies-orchestration-platform/tree/main/terraform): `terraform`

### Other components

- **Dashboard user**
- **Metrics scraper**
- **Kubernetes cluster**

## Connections

- Dashboard user → Dashboard app: uses
- React entry point → Dashboard app: renders (evidence: `frontend/src/main.tsx`)
- Dashboard app → System status: renders (evidence: `frontend/src/App.tsx`)
- Dashboard app → Topology view: renders (evidence: `frontend/src/App.tsx`)
- Dashboard app → Deployment timeline: renders (evidence: `frontend/src/App.tsx`)
- Dashboard app → Item registry: renders (evidence: `frontend/src/App.tsx`)
- Dashboard app → Container status: renders (evidence: `frontend/src/App.tsx`)
- Dashboard app → Metrics dashboard: renders (evidence: `frontend/src/App.tsx`)
- Dashboard app → Express API: polls health (evidence: `frontend/src/App.tsx`)
- Dashboard app → Express API: fetches items (evidence: `frontend/src/App.tsx`)
- Dashboard app → Express API: creates items (evidence: `frontend/src/App.tsx`)
- Express API → PostgreSQL: queries (evidence: `backend/src/index.js`)
- Metrics scraper → Express API: scrapes metrics
- Dashboard user → Kustomize manifests: applies (evidence: `README.md`)
- Dashboard user → Helm chart: installs (evidence: `README.md`)
- Kustomize manifests → Kubernetes cluster: deploys to (evidence: `README.md`)
- Helm chart → Kubernetes cluster: deploys to (evidence: `README.md`)
