# bhoomith1522/vertex-ops architecture

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

- Interactive diagram: https://gitdiagram.com/bhoomith1522/vertex-ops
- Repository: https://github.com/bhoomith1522/vertex-ops

## Overview

Vertex-Ops is an initialization-phase cloud-operations platform. Its implemented workflow is a React dashboard for viewing incident metrics and creating or managing incidents through a Node/Express API; users can also request AI incident analysis, which calls Groq and persists analysis records. The README additionally describes monitoring and self-healing as product goals, but the repository shows route modules rather than sampled implementations for those capabilities. Edges reflect excerpts, SOURCE INDEX references, or README claims; unsampled behavior is not inferred.

Main entry points: [`frontend/src/pages/DashboardPage.jsx`](https://github.com/bhoomith1522/vertex-ops/blob/main/frontend/src/pages/DashboardPage.jsx) (Dashboard page), [`backend/routes/v1/index.js`](https://github.com/bhoomith1522/vertex-ops/blob/main/backend/routes/v1/index.js) (API route registry), [`backend/server.js`](https://github.com/bhoomith1522/vertex-ops/blob/main/backend/server.js) (Express server), [`frontend/src/api/api.js`](https://github.com/bhoomith1522/vertex-ops/blob/main/frontend/src/api/api.js) (HTTP client)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_frontend["Web dashboard"]
  node_dashboard_page["Dashboard page<br/>[DashboardPage.jsx]"]
  node_dashboard_ui["Dashboard stats<br/>[Dashboard.jsx]"]
  node_incident_create["Create incident<br/>[CreateIncident.jsx]"]
  node_incident_table["Incident table<br/>[IncidentTable.jsx]"]
  node_incident_chart["Incident chart<br/>[IncidentChart.jsx]"]
  node_stat_card["Stat card<br/>[StatCard.jsx]"]
  node_analysis_modal["Analysis modal"]
  node_frontend_api["HTTP client<br/>[api.js]"]
end

subgraph group_api["API and operations"]
  node_server["Express server<br/>[server.js]"]
  node_v1_routes["API route registry<br/>[index.js]"]
  node_incident_routes["Incident routes<br/>[incidentRoutes.js]"]
  node_dashboard_routes["Dashboard routes<br/>[dashboardRoutes.js]"]
  node_health_routes["Health routes<br/>[healthRoutes.js]"]
  node_monitoring_routes["Monitoring routes"]
  node_healing_routes["Self-healing routes"]
  node_incident_controller["Incident controller"]
  node_dashboard_controller["Dashboard controller"]
  node_health_controller["Health controller"]
  node_ai_routes["AI analysis routes"]
  node_ai_controller["AI analysis controller"]
  node_metrics["Metrics endpoint<br/>[metrics.js]"]
end

subgraph group_analysis["Incident intelligence"]
  node_incident_service["Incident service<br/>[incidentService.js]"]
  node_dashboard_service["Dashboard service"]
  node_ai_service["AI analysis service"]
  node_health_service["Health service<br/>[healthService.js]"]
end

subgraph group_state["Persistence and integrations"]
  node_incident_model[("Incident model<br/>[incident.js]")]
  node_analysis_model[("Analysis model<br/>[AIAnalysis.js]")]
  node_database_config["Database connection<br/>[database.js]"]
end

node_user(("Operator"))
node_mongo[("MongoDB")]
node_groq{{"Groq AI"}}

node_user -->|"uses"| node_dashboard_page
node_dashboard_page -->|"renders"| node_dashboard_ui
node_dashboard_page -->|"renders"| node_incident_create
node_dashboard_page -->|"renders"| node_incident_table
node_dashboard_page -->|"renders"| node_incident_chart
node_dashboard_page -->|"loads stats"| node_frontend_api
node_dashboard_ui -->|"requests data"| node_frontend_api
node_dashboard_ui -->|"renders"| node_stat_card
node_incident_create -->|"submits incident"| node_frontend_api
node_incident_table -->|"requests incidents"| node_frontend_api
node_incident_table -->|"opens analysis"| node_analysis_modal
node_server -->|"mounts API"| node_v1_routes
node_server -->|"mounts health"| node_health_routes
node_server -->|"connects database"| node_database_config
node_server -->|"registers metrics"| node_metrics
node_v1_routes -->|"registers"| node_incident_routes
node_v1_routes -->|"registers"| node_dashboard_routes
node_v1_routes -->|"registers"| node_ai_routes
node_v1_routes -->|"registers"| node_monitoring_routes
node_v1_routes -->|"registers"| node_healing_routes
node_incident_routes -->|"dispatches"| node_incident_controller
node_dashboard_routes -->|"dispatches"| node_dashboard_controller
node_health_routes -->|"dispatches"| node_health_controller
node_incident_controller -->|"calls"| node_incident_service
node_dashboard_controller -->|"calls"| node_dashboard_service
node_health_controller -->|"calls"| node_health_service
node_ai_routes -->|"dispatches"| node_ai_controller
node_ai_controller -->|"calls"| node_ai_service
node_ai_controller -->|"looks up incident"| node_incident_model
node_ai_service -->|"stores and reads"| node_analysis_model
node_ai_service -->|"requests analysis"| node_groq
node_database_config -->|"connects"| node_mongo

click node_dashboard_page "https://github.com/bhoomith1522/vertex-ops/blob/main/frontend/src/pages/DashboardPage.jsx"
click node_dashboard_ui "https://github.com/bhoomith1522/vertex-ops/blob/main/frontend/src/components/Dashboard.jsx"
click node_incident_create "https://github.com/bhoomith1522/vertex-ops/blob/main/frontend/src/components/CreateIncident.jsx"
click node_incident_table "https://github.com/bhoomith1522/vertex-ops/blob/main/frontend/src/components/IncidentTable.jsx"
click node_incident_chart "https://github.com/bhoomith1522/vertex-ops/blob/main/frontend/src/components/IncidentChart.jsx"
click node_stat_card "https://github.com/bhoomith1522/vertex-ops/blob/main/frontend/src/components/StatCard.jsx"
click node_analysis_modal "https://github.com/bhoomith1522/vertex-ops/blob/main/frontend/src/components/AIAnalysisModal.jsx"
click node_frontend_api "https://github.com/bhoomith1522/vertex-ops/blob/main/frontend/src/api/api.js"
click node_server "https://github.com/bhoomith1522/vertex-ops/blob/main/backend/server.js"
click node_v1_routes "https://github.com/bhoomith1522/vertex-ops/blob/main/backend/routes/v1/index.js"
click node_incident_routes "https://github.com/bhoomith1522/vertex-ops/blob/main/backend/routes/v1/incidentRoutes.js"
click node_dashboard_routes "https://github.com/bhoomith1522/vertex-ops/blob/main/backend/routes/v1/dashboardRoutes.js"
click node_health_routes "https://github.com/bhoomith1522/vertex-ops/blob/main/backend/routes/healthRoutes.js"
click node_monitoring_routes "https://github.com/bhoomith1522/vertex-ops/blob/main/backend/routes/v1/monitoringRoutes.js"
click node_healing_routes "https://github.com/bhoomith1522/vertex-ops/blob/main/backend/routes/v1/selfHealingRoutes.js"
click node_incident_controller "https://github.com/bhoomith1522/vertex-ops/blob/main/backend/controllers/incidentController.js"
click node_dashboard_controller "https://github.com/bhoomith1522/vertex-ops/blob/main/backend/controllers/dashboardController.js"
click node_health_controller "https://github.com/bhoomith1522/vertex-ops/blob/main/backend/controllers/healthController.js"
click node_incident_service "https://github.com/bhoomith1522/vertex-ops/blob/main/backend/services/incidentService.js"
click node_dashboard_service "https://github.com/bhoomith1522/vertex-ops/blob/main/backend/services/dashboardService.js"
click node_ai_routes "https://github.com/bhoomith1522/vertex-ops/blob/main/backend/routes/v1/aiAnalysisRoutes.js"
click node_ai_controller "https://github.com/bhoomith1522/vertex-ops/blob/main/backend/controllers/aiAnalysisController.js"
click node_ai_service "https://github.com/bhoomith1522/vertex-ops/blob/main/backend/services/aiAnalysisService.js"
click node_health_service "https://github.com/bhoomith1522/vertex-ops/blob/main/backend/services/healthService.js"
click node_incident_model "https://github.com/bhoomith1522/vertex-ops/blob/main/backend/models/incident.js"
click node_analysis_model "https://github.com/bhoomith1522/vertex-ops/blob/main/backend/models/AIAnalysis.js"
click node_database_config "https://github.com/bhoomith1522/vertex-ops/blob/main/backend/config/database.js"
click node_metrics "https://github.com/bhoomith1522/vertex-ops/blob/main/backend/config/metrics.js"

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_page,node_dashboard_ui,node_incident_create,node_incident_table,node_incident_chart,node_stat_card,node_analysis_modal,node_frontend_api toneBlue
class node_server,node_v1_routes,node_incident_routes,node_dashboard_routes,node_health_routes,node_monitoring_routes,node_healing_routes,node_incident_controller,node_dashboard_controller,node_health_controller,node_ai_routes,node_ai_controller,node_metrics,node_mongo toneAmber
class node_incident_service,node_dashboard_service,node_ai_service,node_health_service toneMint
class node_incident_model,node_analysis_model,node_database_config toneRose
class node_user,node_groq toneIndigo
```

## Components

### Web dashboard

- [Dashboard page](https://github.com/bhoomith1522/vertex-ops/blob/main/frontend/src/pages/DashboardPage.jsx): `frontend/src/pages/DashboardPage.jsx`
- [Dashboard stats](https://github.com/bhoomith1522/vertex-ops/blob/main/frontend/src/components/Dashboard.jsx): `frontend/src/components/Dashboard.jsx`
- [Create incident](https://github.com/bhoomith1522/vertex-ops/blob/main/frontend/src/components/CreateIncident.jsx): `frontend/src/components/CreateIncident.jsx`
- [Incident table](https://github.com/bhoomith1522/vertex-ops/blob/main/frontend/src/components/IncidentTable.jsx): `frontend/src/components/IncidentTable.jsx`
- [Incident chart](https://github.com/bhoomith1522/vertex-ops/blob/main/frontend/src/components/IncidentChart.jsx): `frontend/src/components/IncidentChart.jsx`
- [Stat card](https://github.com/bhoomith1522/vertex-ops/blob/main/frontend/src/components/StatCard.jsx): `frontend/src/components/StatCard.jsx`
- [Analysis modal](https://github.com/bhoomith1522/vertex-ops/blob/main/frontend/src/components/AIAnalysisModal.jsx): `frontend/src/components/AIAnalysisModal.jsx`
- [HTTP client](https://github.com/bhoomith1522/vertex-ops/blob/main/frontend/src/api/api.js): `frontend/src/api/api.js`

### API and operations

- [Express server](https://github.com/bhoomith1522/vertex-ops/blob/main/backend/server.js): `backend/server.js`
- [API route registry](https://github.com/bhoomith1522/vertex-ops/blob/main/backend/routes/v1/index.js): `backend/routes/v1/index.js`
- [Incident routes](https://github.com/bhoomith1522/vertex-ops/blob/main/backend/routes/v1/incidentRoutes.js): `backend/routes/v1/incidentRoutes.js`
- [Dashboard routes](https://github.com/bhoomith1522/vertex-ops/blob/main/backend/routes/v1/dashboardRoutes.js): `backend/routes/v1/dashboardRoutes.js`
- [Health routes](https://github.com/bhoomith1522/vertex-ops/blob/main/backend/routes/healthRoutes.js): `backend/routes/healthRoutes.js`
- [Monitoring routes](https://github.com/bhoomith1522/vertex-ops/blob/main/backend/routes/v1/monitoringRoutes.js): `backend/routes/v1/monitoringRoutes.js`
- [Self-healing routes](https://github.com/bhoomith1522/vertex-ops/blob/main/backend/routes/v1/selfHealingRoutes.js): `backend/routes/v1/selfHealingRoutes.js`
- [Incident controller](https://github.com/bhoomith1522/vertex-ops/blob/main/backend/controllers/incidentController.js): `backend/controllers/incidentController.js`
- [Dashboard controller](https://github.com/bhoomith1522/vertex-ops/blob/main/backend/controllers/dashboardController.js): `backend/controllers/dashboardController.js`
- [Health controller](https://github.com/bhoomith1522/vertex-ops/blob/main/backend/controllers/healthController.js): `backend/controllers/healthController.js`
- [AI analysis routes](https://github.com/bhoomith1522/vertex-ops/blob/main/backend/routes/v1/aiAnalysisRoutes.js): `backend/routes/v1/aiAnalysisRoutes.js`
- [AI analysis controller](https://github.com/bhoomith1522/vertex-ops/blob/main/backend/controllers/aiAnalysisController.js): `backend/controllers/aiAnalysisController.js`
- [Metrics endpoint](https://github.com/bhoomith1522/vertex-ops/blob/main/backend/config/metrics.js): `backend/config/metrics.js`

### Incident intelligence

- [Incident service](https://github.com/bhoomith1522/vertex-ops/blob/main/backend/services/incidentService.js): `backend/services/incidentService.js`
- [Dashboard service](https://github.com/bhoomith1522/vertex-ops/blob/main/backend/services/dashboardService.js): `backend/services/dashboardService.js`
- [AI analysis service](https://github.com/bhoomith1522/vertex-ops/blob/main/backend/services/aiAnalysisService.js): `backend/services/aiAnalysisService.js`
- [Health service](https://github.com/bhoomith1522/vertex-ops/blob/main/backend/services/healthService.js): `backend/services/healthService.js`

### Persistence and integrations

- [Incident model](https://github.com/bhoomith1522/vertex-ops/blob/main/backend/models/incident.js): `backend/models/incident.js`
- [Analysis model](https://github.com/bhoomith1522/vertex-ops/blob/main/backend/models/AIAnalysis.js): `backend/models/AIAnalysis.js`
- [Database connection](https://github.com/bhoomith1522/vertex-ops/blob/main/backend/config/database.js): `backend/config/database.js`

### Other components

- **Operator**
- **MongoDB**
- **Groq AI**

## Connections

- Operator → Dashboard page: uses (evidence: `README.md`)
- Dashboard page → Dashboard stats: renders (evidence: `frontend/src/pages/DashboardPage.jsx`)
- Dashboard page → Create incident: renders (evidence: `frontend/src/pages/DashboardPage.jsx`)
- Dashboard page → Incident table: renders (evidence: `frontend/src/pages/DashboardPage.jsx`)
- Dashboard page → Incident chart: renders (evidence: `frontend/src/pages/DashboardPage.jsx`)
- Dashboard page → HTTP client: loads stats (evidence: `frontend/src/pages/DashboardPage.jsx`)
- Dashboard stats → HTTP client: requests data (evidence: `frontend/src/components/Dashboard.jsx`)
- Dashboard stats → Stat card: renders (evidence: `frontend/src/components/Dashboard.jsx`)
- Create incident → HTTP client: submits incident (evidence: `frontend/src/components/CreateIncident.jsx`)
- Incident table → HTTP client: requests incidents (evidence: `frontend/src/components/IncidentTable.jsx`)
- Incident table → Analysis modal: opens analysis (evidence: `frontend/src/components/IncidentTable.jsx`)
- Express server → API route registry: mounts API (evidence: `backend/server.js`)
- Express server → Health routes: mounts health (evidence: `backend/server.js`)
- Express server → Database connection: connects database (evidence: `backend/server.js`)
- Express server → Metrics endpoint: registers metrics (evidence: `backend/server.js`)
- API route registry → Incident routes: registers (evidence: `backend/routes/v1/index.js`)
- API route registry → Dashboard routes: registers (evidence: `backend/routes/v1/index.js`)
- API route registry → AI analysis routes: registers (evidence: `backend/routes/v1/index.js`)
- API route registry → Monitoring routes: registers (evidence: `backend/routes/v1/index.js`)
- API route registry → Self-healing routes: registers (evidence: `backend/routes/v1/index.js`)
- Incident routes → Incident controller: dispatches (evidence: `backend/routes/v1/incidentRoutes.js`)
- Dashboard routes → Dashboard controller: dispatches (evidence: `backend/routes/v1/dashboardRoutes.js`)
- Health routes → Health controller: dispatches (evidence: `backend/routes/healthRoutes.js`)
- Incident controller → Incident service: calls (evidence: `backend/controllers/incidentController.js`)
- Dashboard controller → Dashboard service: calls (evidence: `backend/controllers/dashboardController.js`)
- Health controller → Health service: calls (evidence: `backend/controllers/healthController.js`)
- AI analysis routes → AI analysis controller: dispatches (evidence: `backend/routes/v1/aiAnalysisRoutes.js`)
- AI analysis controller → AI analysis service: calls (evidence: `backend/controllers/aiAnalysisController.js`)
- AI analysis controller → Incident model: looks up incident (evidence: `backend/controllers/aiAnalysisController.js`)
- AI analysis service → Analysis model: stores and reads (evidence: `backend/services/aiAnalysisService.js`)
- AI analysis service → Groq AI: requests analysis (evidence: `backend/services/aiAnalysisService.js`)
- Database connection → MongoDB: connects (evidence: `backend/config/database.js`)
