# shivanshks06/skyforge architecture

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

- Interactive diagram: https://gitdiagram.com/shivanshks06/skyforge
- Repository: https://github.com/shivanshks06/skyforge

## Overview

SkyForge is a web application for deploying GitHub projects into each user's AWS account, then monitoring, securing, and tearing down those deployments. The main workflow runs from project selection and planning in the browser, through API-enqueued deployment jobs, to worker-managed builds and AWS provisioning; health checks gate the LIVE state. Separate product branches cover security controls and incident response, monitoring and recovery, rollback, and verified destruction. The graph follows documented and indexed relationships; unsampled subsystems are included where README describes them, with uncertain wiring omitted.

Main entry points: [`server/workers/deploymentWorker.js`](https://github.com/shivanshks06/skyforge/blob/main/server/workers/deploymentWorker.js) (Deployment worker), [`server/server.js`](https://github.com/shivanshks06/skyforge/blob/main/server/server.js) (Express API), [`server/controllers/deploymentController.js`](https://github.com/shivanshks06/skyforge/blob/main/server/controllers/deploymentController.js) (Deployment requests), [`server/config/db.js`](https://github.com/shivanshks06/skyforge/blob/main/server/config/db.js) (Project state)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_ui["Web client"]
  node_web["SkyForge UI<br/>[App.jsx]"]
  node_project_ui["Project workflow<br/>[DeploymentPlan.jsx]"]
  node_deploy_ui["Deployment console"]
  node_security_ui["Security dashboard<br/>[Security.jsx]"]
end

subgraph group_api["API and data"]
  node_api["Express API<br/>[server.js]"]
  node_auth["Authentication<br/>[authMiddleware.js]"]
  node_projects["Project management"]
  node_planning["Planning and environment"]
  node_deployment_api["Deployment requests"]
  node_database[("Project state<br/>[db.js]")]
  node_aws_auth["AWS connections"]
end

subgraph group_deploy["Build and deploy"]
  node_queue["Job queues<br/>[deploymentQueue.js]"]
  node_worker["Deployment worker"]
  node_source["Repository checkout<br/>[sourceService.js]"]
  node_detect["Stack detection<br/>[detectionEngine.js]"]
  node_envscan["Environment scan<br/>[envScanner.js]"]
  node_buildplan["Build planning<br/>[buildPlanner.js]"]
  node_templates["Docker templates<br/>[templateEngine.js]"]
  node_ecr["Image registry<br/>[ecrService.js]"]
  node_ecs["Container deployment<br/>[ecsService.js]"]
  node_static["Static deployment<br/>[staticDeployer.js]"]
  node_health["Health checks<br/>[healthService.js]"]
end

subgraph group_operations["Operations"]
  node_monitor["Monitoring worker<br/>[monitorWorker.js]"]
  node_monitor_queue["Monitor schedule<br/>[monitorQueue.js]"]
  node_rollback["Rollback worker<br/>[rollbackWorker.js]"]
  node_destroy["Destroy workflow<br/>[destroyWorker.js]"]
end

subgraph group_security["Security"]
  node_security_api["Security controls"]
  node_security["Security scanning<br/>[securityService.js]"]
  node_automation["Security automation"]
  node_waf["WAF protection<br/>[wafService.js]"]
  node_incidents["Incident response<br/>[incidentService.js]"]
end

node_operator(("Project operator"))
node_github["GitHub"]
node_aws["User AWS account"]

node_operator -->|"uses"| node_web
node_web -->|"navigates"| node_project_ui
node_web -->|"navigates"| node_deploy_ui
node_web -->|"navigates"| node_security_ui
node_project_ui -.->|"requests plans"| node_api
node_deploy_ui -.->|"requests deploy"| node_api
node_security_ui -.->|"requests controls"| node_api
node_api -->|"protects routes"| node_auth
node_api -->|"routes to"| node_projects
node_api -->|"routes to"| node_planning
node_api -->|"routes to"| node_deployment_api
node_auth -->|"looks up user"| node_database
node_projects -->|"reads and writes"| node_database
node_planning -.->|"reads and writes"| node_database
node_deployment_api -->|"enqueues jobs"| node_queue
node_deployment_api -.->|"records deployment"| node_database
node_worker -.->|"consumes jobs"| node_queue
node_worker -->|"updates deployment"| node_database
node_worker -->|"resolves credentials"| node_aws_auth
node_worker -->|"checks out source"| node_source
node_source -.->|"downloads repository"| node_github
node_worker -->|"checks requirements"| node_envscan
node_worker -->|"plans build"| node_buildplan
node_buildplan -->|"detects stack"| node_detect
node_buildplan -->|"generates Dockerfile"| node_templates
node_worker -->|"pushes image"| node_ecr
node_worker -->|"provisions container"| node_ecs
node_worker -->|"deploys static site"| node_static
node_ecs -.->|"creates AWS resources"| node_aws
node_static -.->|"creates S3 and CDN"| node_aws
node_worker -->|"checks live health"| node_health
node_health -.->|"returns health result"| node_worker
node_monitor_queue -->|"schedules checks"| node_monitor
node_monitor -->|"checks availability"| node_health
node_monitor -->|"runs security jobs"| node_automation
node_deployment_api -.->|"queues rollback"| node_rollback
node_rollback -->|"restores deployment"| node_ecs
node_deployment_api -.->|"queues teardown"| node_destroy
node_destroy -.->|"removes resources"| node_ecs
node_destroy -.->|"removes static resources"| node_static
node_api -->|"routes security"| node_security_api
node_security_api -->|"runs checks"| node_security
node_security_api -->|"lists incidents"| node_incidents
node_security -->|"configures firewall"| node_waf
node_automation -->|"syncs protection"| node_waf
node_automation -->|"records incidents"| node_incidents
node_security -.->|"scans deployed app"| node_aws

click node_web "https://github.com/shivanshks06/skyforge/blob/main/client/src/App.jsx"
click node_project_ui "https://github.com/shivanshks06/skyforge/blob/main/client/src/pages/DeploymentPlan.jsx"
click node_deploy_ui "https://github.com/shivanshks06/skyforge/blob/main/client/src/pages/DeploymentConsole.jsx"
click node_security_ui "https://github.com/shivanshks06/skyforge/blob/main/client/src/pages/Security.jsx"
click node_api "https://github.com/shivanshks06/skyforge/blob/main/server/server.js"
click node_auth "https://github.com/shivanshks06/skyforge/blob/main/server/middleware/authMiddleware.js"
click node_projects "https://github.com/shivanshks06/skyforge/blob/main/server/controllers/projectController.js"
click node_planning "https://github.com/shivanshks06/skyforge/blob/main/server/controllers/planningController.js"
click node_deployment_api "https://github.com/shivanshks06/skyforge/blob/main/server/controllers/deploymentController.js"
click node_database "https://github.com/shivanshks06/skyforge/blob/main/server/config/db.js"
click node_aws_auth "https://github.com/shivanshks06/skyforge/blob/main/server/services/awsConnectionService.js"
click node_queue "https://github.com/shivanshks06/skyforge/blob/main/server/queues/deploymentQueue.js"
click node_worker "https://github.com/shivanshks06/skyforge/blob/main/server/workers/deploymentWorker.js"
click node_source "https://github.com/shivanshks06/skyforge/blob/main/server/services/sourceService.js"
click node_detect "https://github.com/shivanshks06/skyforge/blob/main/server/services/detectionEngine.js"
click node_envscan "https://github.com/shivanshks06/skyforge/blob/main/server/services/envScanner.js"
click node_buildplan "https://github.com/shivanshks06/skyforge/blob/main/server/services/buildPlanner.js"
click node_templates "https://github.com/shivanshks06/skyforge/blob/main/server/services/templateEngine.js"
click node_ecr "https://github.com/shivanshks06/skyforge/blob/main/server/services/ecrService.js"
click node_ecs "https://github.com/shivanshks06/skyforge/blob/main/server/services/ecsService.js"
click node_static "https://github.com/shivanshks06/skyforge/blob/main/server/services/staticDeployer.js"
click node_health "https://github.com/shivanshks06/skyforge/blob/main/server/services/healthService.js"
click node_monitor "https://github.com/shivanshks06/skyforge/blob/main/server/workers/monitorWorker.js"
click node_monitor_queue "https://github.com/shivanshks06/skyforge/blob/main/server/queues/monitorQueue.js"
click node_rollback "https://github.com/shivanshks06/skyforge/blob/main/server/workers/rollbackWorker.js"
click node_destroy "https://github.com/shivanshks06/skyforge/blob/main/server/workers/destroyWorker.js"
click node_security_api "https://github.com/shivanshks06/skyforge/blob/main/server/controllers/securityController.js"
click node_security "https://github.com/shivanshks06/skyforge/blob/main/server/services/securityService.js"
click node_automation "https://github.com/shivanshks06/skyforge/blob/main/server/services/securityAutomation.js"
click node_waf "https://github.com/shivanshks06/skyforge/blob/main/server/services/wafService.js"
click node_incidents "https://github.com/shivanshks06/skyforge/blob/main/server/services/incidentService.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_web,node_project_ui,node_deploy_ui,node_security_ui,node_aws toneBlue
class node_api,node_auth,node_projects,node_planning,node_deployment_api,node_database,node_aws_auth toneAmber
class node_queue,node_worker,node_source,node_detect,node_envscan,node_buildplan,node_templates,node_ecr,node_ecs,node_static,node_health toneMint
class node_monitor,node_monitor_queue,node_rollback,node_destroy toneRose
class node_security_api,node_security,node_automation,node_waf,node_incidents,node_operator,node_github toneIndigo
```

## Components

### Web client

- [SkyForge UI](https://github.com/shivanshks06/skyforge/blob/main/client/src/App.jsx): `client/src/App.jsx`
- [Project workflow](https://github.com/shivanshks06/skyforge/blob/main/client/src/pages/DeploymentPlan.jsx): `client/src/pages/DeploymentPlan.jsx`
- [Deployment console](https://github.com/shivanshks06/skyforge/blob/main/client/src/pages/DeploymentConsole.jsx): `client/src/pages/DeploymentConsole.jsx`
- [Security dashboard](https://github.com/shivanshks06/skyforge/blob/main/client/src/pages/Security.jsx): `client/src/pages/Security.jsx`

### API and data

- [Express API](https://github.com/shivanshks06/skyforge/blob/main/server/server.js): `server/server.js`
- [Authentication](https://github.com/shivanshks06/skyforge/blob/main/server/middleware/authMiddleware.js): `server/middleware/authMiddleware.js`
- [Project management](https://github.com/shivanshks06/skyforge/blob/main/server/controllers/projectController.js): `server/controllers/projectController.js`
- [Planning and environment](https://github.com/shivanshks06/skyforge/blob/main/server/controllers/planningController.js): `server/controllers/planningController.js`
- [Deployment requests](https://github.com/shivanshks06/skyforge/blob/main/server/controllers/deploymentController.js): `server/controllers/deploymentController.js`
- [Project state](https://github.com/shivanshks06/skyforge/blob/main/server/config/db.js): `server/config/db.js`
- [AWS connections](https://github.com/shivanshks06/skyforge/blob/main/server/services/awsConnectionService.js): `server/services/awsConnectionService.js`

### Build and deploy

- [Job queues](https://github.com/shivanshks06/skyforge/blob/main/server/queues/deploymentQueue.js): `server/queues/deploymentQueue.js`
- [Deployment worker](https://github.com/shivanshks06/skyforge/blob/main/server/workers/deploymentWorker.js): `server/workers/deploymentWorker.js`
- [Repository checkout](https://github.com/shivanshks06/skyforge/blob/main/server/services/sourceService.js): `server/services/sourceService.js`
- [Stack detection](https://github.com/shivanshks06/skyforge/blob/main/server/services/detectionEngine.js): `server/services/detectionEngine.js`
- [Environment scan](https://github.com/shivanshks06/skyforge/blob/main/server/services/envScanner.js): `server/services/envScanner.js`
- [Build planning](https://github.com/shivanshks06/skyforge/blob/main/server/services/buildPlanner.js): `server/services/buildPlanner.js`
- [Docker templates](https://github.com/shivanshks06/skyforge/blob/main/server/services/templateEngine.js): `server/services/templateEngine.js`
- [Image registry](https://github.com/shivanshks06/skyforge/blob/main/server/services/ecrService.js): `server/services/ecrService.js`
- [Container deployment](https://github.com/shivanshks06/skyforge/blob/main/server/services/ecsService.js): `server/services/ecsService.js`
- [Static deployment](https://github.com/shivanshks06/skyforge/blob/main/server/services/staticDeployer.js): `server/services/staticDeployer.js`
- [Health checks](https://github.com/shivanshks06/skyforge/blob/main/server/services/healthService.js): `server/services/healthService.js`

### Operations

- [Monitoring worker](https://github.com/shivanshks06/skyforge/blob/main/server/workers/monitorWorker.js): `server/workers/monitorWorker.js`
- [Monitor schedule](https://github.com/shivanshks06/skyforge/blob/main/server/queues/monitorQueue.js): `server/queues/monitorQueue.js`
- [Rollback worker](https://github.com/shivanshks06/skyforge/blob/main/server/workers/rollbackWorker.js): `server/workers/rollbackWorker.js`
- [Destroy workflow](https://github.com/shivanshks06/skyforge/blob/main/server/workers/destroyWorker.js): `server/workers/destroyWorker.js`

### Security

- [Security controls](https://github.com/shivanshks06/skyforge/blob/main/server/controllers/securityController.js): `server/controllers/securityController.js`
- [Security scanning](https://github.com/shivanshks06/skyforge/blob/main/server/services/securityService.js): `server/services/securityService.js`
- [Security automation](https://github.com/shivanshks06/skyforge/blob/main/server/services/securityAutomation.js): `server/services/securityAutomation.js`
- [WAF protection](https://github.com/shivanshks06/skyforge/blob/main/server/services/wafService.js): `server/services/wafService.js`
- [Incident response](https://github.com/shivanshks06/skyforge/blob/main/server/services/incidentService.js): `server/services/incidentService.js`

### Other components

- **Project operator**
- **GitHub**
- **User AWS account**

## Connections

- Project operator → SkyForge UI: uses (evidence: `README.md`)
- SkyForge UI → Project workflow: navigates (evidence: `client/src/App.jsx`)
- SkyForge UI → Deployment console: navigates (evidence: `client/src/App.jsx`)
- SkyForge UI → Security dashboard: navigates (evidence: `client/src/App.jsx`)
- Project workflow → Express API: requests plans
- Deployment console → Express API: requests deploy
- Security dashboard → Express API: requests controls
- Express API → Authentication: protects routes (evidence: `server/server.js`)
- Express API → Project management: routes to (evidence: `server/server.js`)
- Express API → Planning and environment: routes to
- Express API → Deployment requests: routes to (evidence: `server/server.js`)
- Authentication → Project state: looks up user (evidence: `server/middleware/authMiddleware.js`)
- Project management → Project state: reads and writes (evidence: `server/controllers/projectController.js`)
- Planning and environment → Project state: reads and writes
- Deployment requests → Job queues: enqueues jobs (evidence: `server/controllers/deploymentController.js`)
- Deployment requests → Project state: records deployment (evidence: `server/controllers/deploymentController.js`)
- Deployment worker → Job queues: consumes jobs
- Deployment worker → Project state: updates deployment (evidence: `server/workers/deploymentWorker.js`)
- Deployment worker → AWS connections: resolves credentials (evidence: `server/workers/deploymentWorker.js`)
- Deployment worker → Repository checkout: checks out source (evidence: `server/workers/deploymentWorker.js`)
- Repository checkout → GitHub: downloads repository
- Deployment worker → Environment scan: checks requirements (evidence: `server/workers/deploymentWorker.js`)
- Deployment worker → Build planning: plans build (evidence: `server/workers/deploymentWorker.js`)
- Build planning → Stack detection: detects stack
- Build planning → Docker templates: generates Dockerfile (evidence: `server/services/templateEngine.js`)
- Deployment worker → Image registry: pushes image (evidence: `server/workers/deploymentWorker.js`)
- Deployment worker → Container deployment: provisions container (evidence: `server/workers/deploymentWorker.js`)
- Deployment worker → Static deployment: deploys static site (evidence: `server/workers/deploymentWorker.js`)
- Container deployment → User AWS account: creates AWS resources
- Static deployment → User AWS account: creates S3 and CDN
- Deployment worker → Health checks: checks live health (evidence: `server/workers/deploymentWorker.js`)
- Health checks → Deployment worker: returns health result (evidence: `server/workers/deploymentWorker.js`)
- Monitor schedule → Monitoring worker: schedules checks (evidence: `server/queues/monitorQueue.js`)
- Monitoring worker → Health checks: checks availability (evidence: `server/workers/monitorWorker.js`)
- Monitoring worker → Security automation: runs security jobs (evidence: `server/workers/monitorWorker.js`)
- Deployment requests → Rollback worker: queues rollback
- Rollback worker → Container deployment: restores deployment (evidence: `server/workers/rollbackWorker.js`)
- Deployment requests → Destroy workflow: queues teardown
- Destroy workflow → Container deployment: removes resources
- Destroy workflow → Static deployment: removes static resources
- Express API → Security controls: routes security
- Security controls → Security scanning: runs checks (evidence: `server/controllers/securityController.js`)
- Security controls → Incident response: lists incidents (evidence: `server/controllers/securityController.js`)
- Security scanning → WAF protection: configures firewall (evidence: `server/services/securityService.js`)
- Security automation → WAF protection: syncs protection (evidence: `server/services/securityAutomation.js`)
- Security automation → Incident response: records incidents (evidence: `server/services/securityAutomation.js`)
- Security scanning → User AWS account: scans deployed app
