# amrityam/spring-boot-reactjs-kubernetes architecture

> Architecture diagram of the GitHub repository amrityam/spring-boot-reactjs-kubernetes, generated by GitDiagram from its file tree, README and a sample of source files (last updated 2026-11-22). It is an AI-made overview: check details against the source.

- Interactive diagram: https://gitdiagram.com/amrityam/spring-boot-reactjs-kubernetes
- Repository: https://github.com/amrityam/spring-boot-reactjs-kubernetes

## Overview

This repository demonstrates a COVID-19 country-statistics dashboard with a React frontend and Spring Boot backend, plus a separate comment CRUD API backed by MongoDB. The main user flow is browser navigation to the dashboard, an HTTP request for country statistics, and rendering the returned rows. The README also documents Docker and Kubernetes deployment, including MongoDB and port-forwarding. Comment CRUD calls are visible in the sampled backend source; statistics implementation and deployment wiring are not sampled, so those relationships are documented rather than inferred from unseen code.

Main entry points: [`corona-tracker-frontend/src/index.js`](https://github.com/amrityam/spring-boot-reactjs-kubernetes/blob/main/corona-tracker-frontend/src/index.js) (Router entry), [`corona-tracker-frontend/src/App.js`](https://github.com/amrityam/spring-boot-reactjs-kubernetes/blob/main/corona-tracker-frontend/src/App.js) (Statistics dashboard), [`corona-tracker-backend/src/main/java/com/hackforfun/coronatrackerbackend/service/CommentService.java`](https://github.com/amrityam/spring-boot-reactjs-kubernetes/blob/main/corona-tracker-backend/src/main/java/com/hackforfun/coronatrackerbackend/service/CommentService.java) (Comment service), [`corona-tracker-backend/src/main/java/com/hackforfun/coronatrackerbackend/repository/CommentRepository.java`](https://github.com/amrityam/spring-boot-reactjs-kubernetes/blob/main/corona-tracker-backend/src/main/java/com/hackforfun/coronatrackerbackend/repository/CommentRepository.java) (Comment repository)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_frontend["React frontend"]
  node_frontend_entry["Router entry<br/>[index.js]"]
  node_navigation["Navigation<br/>[Navigation.js]"]
  node_dashboard["Statistics dashboard<br/>[App.js]"]
  node_service_page["Service page<br/>[Service.js]"]
  node_about_page["About page<br/>[About.js]"]
  node_web_vitals["Web vitals<br/>[reportWebVitals.js]"]
end

subgraph group_backend["Spring backend"]
  node_statistics_api["Statistics API"]
  node_comment_api["Comment endpoints"]
  node_comment_service["Comment service"]
  node_comment_exception["Comment errors"]
  node_backend_bootstrap["Backend bootstrap"]
  node_mongo_config["Mongo validation config"]
end

subgraph group_persistence["Comment persistence"]
  node_comment_model["Comment document<br/>[Comment.java]"]
  node_comment_repository["Comment repository"]
  node_mongodb[("MongoDB")]
end

subgraph group_deployment["Kubernetes deployment"]
  node_k8s_frontend["Frontend workload"]
  node_k8s_backend["Backend workload"]
  node_k8s_mongo["Mongo workload<br/>[mongo.yaml]"]
end

node_visitor(("Browser user"))

node_visitor -->|"opens app"| node_frontend_entry
node_frontend_entry -->|"renders"| node_navigation
node_frontend_entry -->|"routes to"| node_dashboard
node_frontend_entry -->|"routes to"| node_service_page
node_frontend_entry -->|"routes to"| node_about_page
node_frontend_entry -->|"calls"| node_web_vitals
node_dashboard -->|"requests statistics"| node_statistics_api
node_dashboard -->|"renders rows"| node_visitor
node_visitor -.->|"uses comment API"| node_comment_api
node_comment_api -->|"delegates to"| node_comment_service
node_comment_service -->|"queries and saves"| node_comment_repository
node_comment_service -->|"raises"| node_comment_exception
node_comment_repository -->|"persists"| node_comment_model
node_comment_repository -.->|"stores documents"| node_mongodb
node_backend_bootstrap -.->|"connects to"| node_mongodb
node_k8s_frontend -.->|"exposes frontend API"| node_k8s_backend
node_k8s_backend -->|"connects backend"| node_k8s_mongo
node_k8s_mongo -->|"runs"| node_mongodb

click node_frontend_entry "https://github.com/amrityam/spring-boot-reactjs-kubernetes/blob/main/corona-tracker-frontend/src/index.js"
click node_navigation "https://github.com/amrityam/spring-boot-reactjs-kubernetes/blob/main/corona-tracker-frontend/src/components/Navigation.js"
click node_dashboard "https://github.com/amrityam/spring-boot-reactjs-kubernetes/blob/main/corona-tracker-frontend/src/App.js"
click node_service_page "https://github.com/amrityam/spring-boot-reactjs-kubernetes/blob/main/corona-tracker-frontend/src/components/Service.js"
click node_about_page "https://github.com/amrityam/spring-boot-reactjs-kubernetes/blob/main/corona-tracker-frontend/src/components/About.js"
click node_web_vitals "https://github.com/amrityam/spring-boot-reactjs-kubernetes/blob/main/corona-tracker-frontend/src/reportWebVitals.js"
click node_statistics_api "https://github.com/amrityam/spring-boot-reactjs-kubernetes/blob/main/corona-tracker-backend/src/main/java/com/hackforfun/coronatrackerbackend/controller/CoronaTrackerController.java"
click node_comment_api "https://github.com/amrityam/spring-boot-reactjs-kubernetes/blob/main/corona-tracker-backend/src/main/java/com/hackforfun/coronatrackerbackend/controller/CommentController.java"
click node_comment_service "https://github.com/amrityam/spring-boot-reactjs-kubernetes/blob/main/corona-tracker-backend/src/main/java/com/hackforfun/coronatrackerbackend/service/CommentService.java"
click node_comment_exception "https://github.com/amrityam/spring-boot-reactjs-kubernetes/blob/main/corona-tracker-backend/src/main/java/com/hackforfun/coronatrackerbackend/exception/CommentCollectionException.java"
click node_backend_bootstrap "https://github.com/amrityam/spring-boot-reactjs-kubernetes/blob/main/corona-tracker-backend/src/main/java/com/hackforfun/coronatrackerbackend/CoronaTrackerBackendApplication.java"
click node_mongo_config "https://github.com/amrityam/spring-boot-reactjs-kubernetes/blob/main/corona-tracker-backend/src/main/java/com/hackforfun/coronatrackerbackend/MongoValidationConfig.java"
click node_comment_model "https://github.com/amrityam/spring-boot-reactjs-kubernetes/blob/main/corona-tracker-backend/src/main/java/com/hackforfun/coronatrackerbackend/model/Comment.java"
click node_comment_repository "https://github.com/amrityam/spring-boot-reactjs-kubernetes/blob/main/corona-tracker-backend/src/main/java/com/hackforfun/coronatrackerbackend/repository/CommentRepository.java"
click node_k8s_frontend "https://github.com/amrityam/spring-boot-reactjs-kubernetes/blob/main/kubernetes/corona-tracker-frontend.yaml"
click node_k8s_backend "https://github.com/amrityam/spring-boot-reactjs-kubernetes/blob/main/kubernetes/corona-tracker-backend.yaml"
click node_k8s_mongo "https://github.com/amrityam/spring-boot-reactjs-kubernetes/blob/main/kubernetes/mongo.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_frontend_entry,node_navigation,node_dashboard,node_service_page,node_about_page,node_web_vitals,node_visitor toneBlue
class node_statistics_api,node_comment_api,node_comment_service,node_comment_exception,node_backend_bootstrap,node_mongo_config toneAmber
class node_comment_model,node_comment_repository,node_mongodb toneMint
class node_k8s_frontend,node_k8s_backend,node_k8s_mongo toneRose
```

## Components

### React frontend

- [Router entry](https://github.com/amrityam/spring-boot-reactjs-kubernetes/blob/main/corona-tracker-frontend/src/index.js): `corona-tracker-frontend/src/index.js`
- [Navigation](https://github.com/amrityam/spring-boot-reactjs-kubernetes/blob/main/corona-tracker-frontend/src/components/Navigation.js): `corona-tracker-frontend/src/components/Navigation.js`
- [Statistics dashboard](https://github.com/amrityam/spring-boot-reactjs-kubernetes/blob/main/corona-tracker-frontend/src/App.js): `corona-tracker-frontend/src/App.js`
- [Service page](https://github.com/amrityam/spring-boot-reactjs-kubernetes/blob/main/corona-tracker-frontend/src/components/Service.js): `corona-tracker-frontend/src/components/Service.js`
- [About page](https://github.com/amrityam/spring-boot-reactjs-kubernetes/blob/main/corona-tracker-frontend/src/components/About.js): `corona-tracker-frontend/src/components/About.js`
- [Web vitals](https://github.com/amrityam/spring-boot-reactjs-kubernetes/blob/main/corona-tracker-frontend/src/reportWebVitals.js): `corona-tracker-frontend/src/reportWebVitals.js`

### Spring backend

- [Statistics API](https://github.com/amrityam/spring-boot-reactjs-kubernetes/blob/main/corona-tracker-backend/src/main/java/com/hackforfun/coronatrackerbackend/controller/CoronaTrackerController.java): `corona-tracker-backend/src/main/java/com/hackforfun/coronatrackerbackend/controller/CoronaTrackerController.java`
- [Comment endpoints](https://github.com/amrityam/spring-boot-reactjs-kubernetes/blob/main/corona-tracker-backend/src/main/java/com/hackforfun/coronatrackerbackend/controller/CommentController.java): `corona-tracker-backend/src/main/java/com/hackforfun/coronatrackerbackend/controller/CommentController.java`
- [Comment service](https://github.com/amrityam/spring-boot-reactjs-kubernetes/blob/main/corona-tracker-backend/src/main/java/com/hackforfun/coronatrackerbackend/service/CommentService.java): `corona-tracker-backend/src/main/java/com/hackforfun/coronatrackerbackend/service/CommentService.java`
- [Comment errors](https://github.com/amrityam/spring-boot-reactjs-kubernetes/blob/main/corona-tracker-backend/src/main/java/com/hackforfun/coronatrackerbackend/exception/CommentCollectionException.java): `corona-tracker-backend/src/main/java/com/hackforfun/coronatrackerbackend/exception/CommentCollectionException.java`
- [Backend bootstrap](https://github.com/amrityam/spring-boot-reactjs-kubernetes/blob/main/corona-tracker-backend/src/main/java/com/hackforfun/coronatrackerbackend/CoronaTrackerBackendApplication.java): `corona-tracker-backend/src/main/java/com/hackforfun/coronatrackerbackend/CoronaTrackerBackendApplication.java`
- [Mongo validation config](https://github.com/amrityam/spring-boot-reactjs-kubernetes/blob/main/corona-tracker-backend/src/main/java/com/hackforfun/coronatrackerbackend/MongoValidationConfig.java): `corona-tracker-backend/src/main/java/com/hackforfun/coronatrackerbackend/MongoValidationConfig.java`

### Comment persistence

- [Comment document](https://github.com/amrityam/spring-boot-reactjs-kubernetes/blob/main/corona-tracker-backend/src/main/java/com/hackforfun/coronatrackerbackend/model/Comment.java): `corona-tracker-backend/src/main/java/com/hackforfun/coronatrackerbackend/model/Comment.java`
- [Comment repository](https://github.com/amrityam/spring-boot-reactjs-kubernetes/blob/main/corona-tracker-backend/src/main/java/com/hackforfun/coronatrackerbackend/repository/CommentRepository.java): `corona-tracker-backend/src/main/java/com/hackforfun/coronatrackerbackend/repository/CommentRepository.java`
- **MongoDB**

### Kubernetes deployment

- [Frontend workload](https://github.com/amrityam/spring-boot-reactjs-kubernetes/blob/main/kubernetes/corona-tracker-frontend.yaml): `kubernetes/corona-tracker-frontend.yaml`
- [Backend workload](https://github.com/amrityam/spring-boot-reactjs-kubernetes/blob/main/kubernetes/corona-tracker-backend.yaml): `kubernetes/corona-tracker-backend.yaml`
- [Mongo workload](https://github.com/amrityam/spring-boot-reactjs-kubernetes/blob/main/kubernetes/mongo.yaml): `kubernetes/mongo.yaml`

### Other components

- **Browser user**

## Connections

- Browser user → Router entry: opens app (evidence: `README.md`)
- Router entry → Navigation: renders (evidence: `corona-tracker-frontend/src/index.js`)
- Router entry → Statistics dashboard: routes to (evidence: `corona-tracker-frontend/src/index.js`)
- Router entry → Service page: routes to (evidence: `corona-tracker-frontend/src/index.js`)
- Router entry → About page: routes to (evidence: `corona-tracker-frontend/src/index.js`)
- Router entry → Web vitals: calls (evidence: `corona-tracker-frontend/src/index.js`)
- Statistics dashboard → Statistics API: requests statistics (evidence: `corona-tracker-frontend/src/App.js`)
- Statistics dashboard → Browser user: renders rows (evidence: `corona-tracker-frontend/src/App.js`)
- Browser user → Comment endpoints: uses comment API
- Comment endpoints → Comment service: delegates to (evidence: `corona-tracker-backend/src/main/java/com/hackforfun/coronatrackerbackend/controller/CommentController.java`)
- Comment service → Comment repository: queries and saves (evidence: `corona-tracker-backend/src/main/java/com/hackforfun/coronatrackerbackend/service/CommentService.java`)
- Comment service → Comment errors: raises (evidence: `corona-tracker-backend/src/main/java/com/hackforfun/coronatrackerbackend/service/CommentService.java`)
- Comment repository → Comment document: persists (evidence: `corona-tracker-backend/src/main/java/com/hackforfun/coronatrackerbackend/repository/CommentRepository.java`)
- Comment repository → MongoDB: stores documents
- Backend bootstrap → MongoDB: connects to
- Frontend workload → Backend workload: exposes frontend API (evidence: `README.md`)
- Backend workload → Mongo workload: connects backend (evidence: `README.md`)
- Mongo workload → MongoDB: runs (evidence: `README.md`)
