# mkg789/devops_proj1 architecture

> Architecture diagram of the GitHub repository mkg789/devops_proj1, 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/mkg789/devops_proj1
- Repository: https://github.com/mkg789/devops_proj1

## Overview

This repository packages and deploys the ElectronicsWeb application rather than containing its application code. Its documented workflow builds frontend and backend container images, publishes them to GHCR, transfers them to Harbor, and deploys the services to Kubernetes; user requests then flow through the frontend’s Nginx proxy to the backend and MongoDB Atlas. Docker, Kubernetes, and Helm configuration are represented. Relationships are based on the README because no source excerpts were provided; Helm and Argo CD are described as planned, so no Argo CD runtime component is shown.

Main entry points: [`kubernetes/backend-service.yaml`](https://github.com/mkg789/devops_proj1/blob/main/kubernetes/backend-service.yaml) (Backend Service), [`kubernetes/frontend-service.yaml`](https://github.com/mkg789/devops_proj1/blob/main/kubernetes/frontend-service.yaml) (Frontend Service), [`.github/workflows/build-images.yml`](https://github.com/mkg789/devops_proj1/blob/main/.github/workflows/build-images.yml) (GitHub Actions Workflow), [`docker/frontend/nginx.conf`](https://github.com/mkg789/devops_proj1/blob/main/docker/frontend/nginx.conf) (Nginx Proxy)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_delivery["Image Delivery"]
  node_workflow["GitHub Actions Workflow<br/>[build-images.yml]"]
  node_docker_build["Docker Image Builds"]
  node_ghcr[("GHCR")]
  node_harbor[("Harbor Registry")]
end

subgraph group_containers["Container Configuration"]
  node_backend_docker["Backend Dockerfile"]
  node_frontend_docker["Frontend Dockerfile"]
  node_nginx["Nginx Proxy<br/>[nginx.conf]"]
end

subgraph group_cluster["Kubernetes Deployment"]
  node_helm_chart["Helm Chart"]
  node_backend_deploy["Backend Deployment"]
  node_backend_service["Backend Service"]
  node_frontend_deploy["Frontend Deployment"]
  node_frontend_service["Frontend Service"]
end

subgraph group_runtime["Application Runtime"]
  node_frontend["React Frontend"]
  node_backend["Node.js / Express Backend"]
end

node_developer(("Developer"))
node_app_repos["Application Repositories"]
node_user(("Browser User"))
node_mongodb[("MongoDB Atlas")]

node_developer -->|"pushes changes"| node_app_repos
node_app_repos -->|"triggers build"| node_workflow
node_workflow -->|"builds images"| node_docker_build
node_backend_docker -->|"configures backend"| node_docker_build
node_frontend_docker -->|"configures frontend"| node_docker_build
node_docker_build -->|"publishes images"| node_ghcr
node_ghcr -->|"manual transfer"| node_harbor
node_harbor -->|"provides images"| node_backend_deploy
node_harbor -->|"provides images"| node_frontend_deploy
node_backend_deploy -->|"exposes backend"| node_backend_service
node_frontend_deploy -->|"exposes frontend"| node_frontend_service
node_user -->|"accesses"| node_frontend_service
node_frontend_service -->|"routes requests"| node_frontend
node_frontend -->|"serves through"| node_nginx
node_nginx -->|"proxies API requests"| node_backend_service
node_backend_service -->|"routes requests"| node_backend
node_backend -->|"communicates with"| node_mongodb

click node_workflow "https://github.com/mkg789/devops_proj1/blob/main/.github/workflows/build-images.yml"
click node_backend_docker "https://github.com/mkg789/devops_proj1/blob/main/docker/backend/Dockerfile"
click node_frontend_docker "https://github.com/mkg789/devops_proj1/blob/main/docker/frontend/Dockerfile"
click node_nginx "https://github.com/mkg789/devops_proj1/blob/main/docker/frontend/nginx.conf"
click node_helm_chart "https://github.com/mkg789/devops_proj1/tree/main/helm/electronicsweb"
click node_backend_deploy "https://github.com/mkg789/devops_proj1/blob/main/kubernetes/backend-deployment.yaml"
click node_backend_service "https://github.com/mkg789/devops_proj1/blob/main/kubernetes/backend-service.yaml"
click node_frontend_deploy "https://github.com/mkg789/devops_proj1/blob/main/kubernetes/frontend-deployment.yaml"
click node_frontend_service "https://github.com/mkg789/devops_proj1/blob/main/kubernetes/frontend-service.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_workflow,node_docker_build,node_ghcr,node_harbor,node_user toneBlue
class node_backend_docker,node_frontend_docker,node_nginx,node_mongodb toneAmber
class node_helm_chart,node_backend_deploy,node_backend_service,node_frontend_deploy,node_frontend_service toneMint
class node_frontend,node_backend toneRose
class node_developer,node_app_repos toneIndigo
```

## Components

### Image Delivery

- [GitHub Actions Workflow](https://github.com/mkg789/devops_proj1/blob/main/.github/workflows/build-images.yml): `.github/workflows/build-images.yml`
- **Docker Image Builds**
- **GHCR**
- **Harbor Registry**

### Container Configuration

- [Backend Dockerfile](https://github.com/mkg789/devops_proj1/blob/main/docker/backend/Dockerfile): `docker/backend/Dockerfile`
- [Frontend Dockerfile](https://github.com/mkg789/devops_proj1/blob/main/docker/frontend/Dockerfile): `docker/frontend/Dockerfile`
- [Nginx Proxy](https://github.com/mkg789/devops_proj1/blob/main/docker/frontend/nginx.conf): `docker/frontend/nginx.conf`

### Kubernetes Deployment

- [Helm Chart](https://github.com/mkg789/devops_proj1/tree/main/helm/electronicsweb): `helm/electronicsweb`
- [Backend Deployment](https://github.com/mkg789/devops_proj1/blob/main/kubernetes/backend-deployment.yaml): `kubernetes/backend-deployment.yaml`
- [Backend Service](https://github.com/mkg789/devops_proj1/blob/main/kubernetes/backend-service.yaml): `kubernetes/backend-service.yaml`
- [Frontend Deployment](https://github.com/mkg789/devops_proj1/blob/main/kubernetes/frontend-deployment.yaml): `kubernetes/frontend-deployment.yaml`
- [Frontend Service](https://github.com/mkg789/devops_proj1/blob/main/kubernetes/frontend-service.yaml): `kubernetes/frontend-service.yaml`

### Application Runtime

- **React Frontend**
- **Node.js / Express Backend**

### Other components

- **Developer**
- **Application Repositories**
- **Browser User**
- **MongoDB Atlas**

## Connections

- Developer → Application Repositories: pushes changes (evidence: `README.md`)
- Application Repositories → GitHub Actions Workflow: triggers build (evidence: `README.md`)
- GitHub Actions Workflow → Docker Image Builds: builds images (evidence: `README.md`)
- Backend Dockerfile → Docker Image Builds: configures backend (evidence: `README.md`)
- Frontend Dockerfile → Docker Image Builds: configures frontend (evidence: `README.md`)
- Docker Image Builds → GHCR: publishes images (evidence: `README.md`)
- GHCR → Harbor Registry: manual transfer (evidence: `README.md`)
- Harbor Registry → Backend Deployment: provides images (evidence: `README.md`)
- Harbor Registry → Frontend Deployment: provides images (evidence: `README.md`)
- Backend Deployment → Backend Service: exposes backend (evidence: `README.md`)
- Frontend Deployment → Frontend Service: exposes frontend (evidence: `README.md`)
- Browser User → Frontend Service: accesses (evidence: `README.md`)
- Frontend Service → React Frontend: routes requests (evidence: `README.md`)
- React Frontend → Nginx Proxy: serves through (evidence: `README.md`)
- Nginx Proxy → Backend Service: proxies API requests (evidence: `README.md`)
- Backend Service → Node.js / Express Backend: routes requests (evidence: `README.md`)
- Node.js / Express Backend → MongoDB Atlas: communicates with (evidence: `README.md`)
