# ajithselvam/devsecops architecture

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

- Interactive diagram: https://gitdiagram.com/ajithselvam/devsecops
- Repository: https://github.com/ajithselvam/devsecops

## Overview

DevSec-Ops-Ai is an authenticated DevSecOps dashboard that centralizes scans and remediation across Dockerfiles and images, Kubernetes, Jenkins, GitHub repositories, logs, and dependencies. Users choose a feature in the routed frontend, submit input through its API client, and receive findings or AI-assisted fixes; GitHub can also create PRs. Backend routes own feature-specific orchestration, using scanners, background jobs, persistence, and AI services where applicable. The README documents the full capability set; several frontend pages and backend routes were not excerpted, so their individual runtime links are not asserted here.

Main entry points: [`frontend/src/App.tsx`](https://github.com/ajithselvam/devsecops/blob/main/frontend/src/App.tsx) (App routing), [`frontend/src/services/api.ts`](https://github.com/ajithselvam/devsecops/blob/main/frontend/src/services/api.ts) (API client), [`backend/src/shared/ai/index.ts`](https://github.com/ajithselvam/devsecops/blob/main/backend/src/shared/ai/index.ts) (AI service), [`backend/src/shared/database/index.ts`](https://github.com/ajithselvam/devsecops/blob/main/backend/src/shared/database/index.ts) (Database access)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_ui["Dashboard"]
  node_app["App routing<br/>[App.tsx]"]
  node_api["API client<br/>[api.ts]"]
  node_docker_ui["Docker scans<br/>[DockerScanner.tsx]"]
  node_dockerfile_ui["Dockerfile fixes"]
  node_k8s_ui["Kubernetes assistant"]
  node_jenkins_ui["Jenkins assistant"]
  node_github_ui["GitHub security<br/>[GitHubSecurity.tsx]"]
  node_logs_ui["Log investigation"]
  node_deps_ui["Dependency radar"]
  node_settings_ui["Settings<br/>[Settings.tsx]"]
end

subgraph group_features["Security workflows"]
  node_docker_routes["Docker routes<br/>[routes.ts]"]
  node_dockerfile_routes["Dockerfile routes<br/>[routes.ts]"]
  node_k8s_routes["Kubernetes routes<br/>[routes.ts]"]
  node_jenkins_routes["Jenkins routes<br/>[routes.ts]"]
  node_github_routes["GitHub routes<br/>[routes.ts]"]
  node_logs_routes["Log routes<br/>[routes.ts]"]
  node_deps_routes["Dependency routes<br/>[routes.ts]"]
  node_scanners["Feature scanners"]
end

subgraph group_runtime["Backend services"]
  node_queue["Job queue<br/>[index.ts]"]
  node_ai["AI service<br/>[index.ts]"]
  node_database[("Database access<br/>[index.ts]")]
  node_insforge_storage["InsForge storage<br/>[insforge.ts]"]
end

subgraph group_identity["Identity and state"]
  node_auth_ui["Auth context<br/>[AuthContext.tsx]"]
  node_session["Session persistence<br/>[session.ts]"]
end

node_user(("Engineer"))
node_github_service["GitHub API"]

node_user -->|"opens dashboard"| node_app
node_app -->|"routes to"| node_docker_ui
node_app -->|"routes to"| node_dockerfile_ui
node_app -->|"routes to"| node_k8s_ui
node_app -->|"routes to"| node_jenkins_ui
node_app -->|"routes to"| node_github_ui
node_app -->|"routes to"| node_logs_ui
node_app -->|"routes to"| node_deps_ui
node_app -->|"routes to"| node_settings_ui
node_app -->|"checks auth"| node_auth_ui
node_docker_ui -.->|"uses API"| node_api
node_dockerfile_ui -.->|"uses API"| node_api
node_k8s_ui -.->|"uses API"| node_api
node_jenkins_ui -.->|"uses API"| node_api
node_github_ui -.->|"uses API"| node_api
node_logs_ui -.->|"uses API"| node_api
node_deps_ui -->|"calls API"| node_api
node_settings_ui -->|"calls API"| node_api
node_auth_ui -->|"restores session"| node_session
node_auth_ui -->|"loads profile"| node_api
node_api -->|"reads token"| node_session
node_docker_routes -->|"enqueues jobs"| node_queue
node_dockerfile_routes -->|"enqueues jobs"| node_queue
node_k8s_routes -->|"enqueues jobs"| node_queue
node_jenkins_routes -->|"enqueues jobs"| node_queue
node_queue -->|"dispatches scans"| node_scanners
node_deps_routes -->|"scans dependencies"| node_scanners
node_github_routes -->|"scans repository"| node_scanners
node_github_routes -->|"authenticates token"| node_github_service
node_docker_routes -.->|"reads and writes"| node_database
node_dockerfile_routes -.->|"reads and writes"| node_database
node_k8s_routes -.->|"reads and writes"| node_database
node_jenkins_routes -.->|"reads and writes"| node_database
node_github_routes -->|"reads and writes"| node_database
node_deps_routes -->|"reads and writes"| node_database
node_logs_routes -->|"reads and writes"| node_database
node_logs_routes -->|"stores log files"| node_insforge_storage
node_docker_routes -.->|"requests remediation"| node_ai
node_dockerfile_routes -.->|"requests remediation"| node_ai
node_k8s_routes -.->|"requests remediation"| node_ai
node_jenkins_routes -.->|"requests assistance"| node_ai
node_github_routes -->|"requests fixes"| node_ai
node_logs_routes -.->|"investigates logs"| node_ai
node_deps_routes -->|"requests remediation"| node_ai

click node_app "https://github.com/ajithselvam/devsecops/blob/main/frontend/src/App.tsx"
click node_api "https://github.com/ajithselvam/devsecops/blob/main/frontend/src/services/api.ts"
click node_docker_ui "https://github.com/ajithselvam/devsecops/blob/main/frontend/src/pages/DockerScanner.tsx"
click node_dockerfile_ui "https://github.com/ajithselvam/devsecops/blob/main/frontend/src/pages/DockerfileFixer.tsx"
click node_k8s_ui "https://github.com/ajithselvam/devsecops/blob/main/frontend/src/pages/KubernetesAssistant.tsx"
click node_jenkins_ui "https://github.com/ajithselvam/devsecops/blob/main/frontend/src/pages/JenkinsAssistant.tsx"
click node_github_ui "https://github.com/ajithselvam/devsecops/blob/main/frontend/src/pages/GitHubSecurity.tsx"
click node_logs_ui "https://github.com/ajithselvam/devsecops/blob/main/frontend/src/pages/LogInvestigation.tsx"
click node_deps_ui "https://github.com/ajithselvam/devsecops/blob/main/frontend/src/pages/DependencyRadar.tsx"
click node_settings_ui "https://github.com/ajithselvam/devsecops/blob/main/frontend/src/pages/Settings.tsx"
click node_auth_ui "https://github.com/ajithselvam/devsecops/blob/main/frontend/src/context/AuthContext.tsx"
click node_session "https://github.com/ajithselvam/devsecops/blob/main/frontend/src/lib/session.ts"
click node_docker_routes "https://github.com/ajithselvam/devsecops/blob/main/backend/src/modules/docker/routes.ts"
click node_dockerfile_routes "https://github.com/ajithselvam/devsecops/blob/main/backend/src/modules/dockerfile/routes.ts"
click node_k8s_routes "https://github.com/ajithselvam/devsecops/blob/main/backend/src/modules/kubernetes/routes.ts"
click node_jenkins_routes "https://github.com/ajithselvam/devsecops/blob/main/backend/src/modules/jenkins/routes.ts"
click node_github_routes "https://github.com/ajithselvam/devsecops/blob/main/backend/src/modules/github/routes.ts"
click node_logs_routes "https://github.com/ajithselvam/devsecops/blob/main/backend/src/modules/logs/routes.ts"
click node_deps_routes "https://github.com/ajithselvam/devsecops/blob/main/backend/src/modules/dependencies/routes.ts"
click node_scanners "https://github.com/ajithselvam/devsecops/tree/main/backend/src/modules"
click node_queue "https://github.com/ajithselvam/devsecops/blob/main/backend/src/shared/queue/index.ts"
click node_ai "https://github.com/ajithselvam/devsecops/blob/main/backend/src/shared/ai/index.ts"
click node_database "https://github.com/ajithselvam/devsecops/blob/main/backend/src/shared/database/index.ts"
click node_insforge_storage "https://github.com/ajithselvam/devsecops/blob/main/backend/src/shared/database/insforge.ts"

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_api,node_docker_ui,node_dockerfile_ui,node_k8s_ui,node_jenkins_ui,node_github_ui,node_logs_ui,node_deps_ui,node_settings_ui toneBlue
class node_docker_routes,node_dockerfile_routes,node_k8s_routes,node_jenkins_routes,node_github_routes,node_logs_routes,node_deps_routes,node_scanners toneAmber
class node_queue,node_ai,node_database,node_insforge_storage,node_github_service toneMint
class node_auth_ui,node_session toneRose
class node_user toneIndigo
```

## Components

### Dashboard

- [App routing](https://github.com/ajithselvam/devsecops/blob/main/frontend/src/App.tsx): `frontend/src/App.tsx`
- [API client](https://github.com/ajithselvam/devsecops/blob/main/frontend/src/services/api.ts): `frontend/src/services/api.ts`
- [Docker scans](https://github.com/ajithselvam/devsecops/blob/main/frontend/src/pages/DockerScanner.tsx): `frontend/src/pages/DockerScanner.tsx`
- [Dockerfile fixes](https://github.com/ajithselvam/devsecops/blob/main/frontend/src/pages/DockerfileFixer.tsx): `frontend/src/pages/DockerfileFixer.tsx`
- [Kubernetes assistant](https://github.com/ajithselvam/devsecops/blob/main/frontend/src/pages/KubernetesAssistant.tsx): `frontend/src/pages/KubernetesAssistant.tsx`
- [Jenkins assistant](https://github.com/ajithselvam/devsecops/blob/main/frontend/src/pages/JenkinsAssistant.tsx): `frontend/src/pages/JenkinsAssistant.tsx`
- [GitHub security](https://github.com/ajithselvam/devsecops/blob/main/frontend/src/pages/GitHubSecurity.tsx): `frontend/src/pages/GitHubSecurity.tsx`
- [Log investigation](https://github.com/ajithselvam/devsecops/blob/main/frontend/src/pages/LogInvestigation.tsx): `frontend/src/pages/LogInvestigation.tsx`
- [Dependency radar](https://github.com/ajithselvam/devsecops/blob/main/frontend/src/pages/DependencyRadar.tsx): `frontend/src/pages/DependencyRadar.tsx`
- [Settings](https://github.com/ajithselvam/devsecops/blob/main/frontend/src/pages/Settings.tsx): `frontend/src/pages/Settings.tsx`

### Security workflows

- [Docker routes](https://github.com/ajithselvam/devsecops/blob/main/backend/src/modules/docker/routes.ts): `backend/src/modules/docker/routes.ts`
- [Dockerfile routes](https://github.com/ajithselvam/devsecops/blob/main/backend/src/modules/dockerfile/routes.ts): `backend/src/modules/dockerfile/routes.ts`
- [Kubernetes routes](https://github.com/ajithselvam/devsecops/blob/main/backend/src/modules/kubernetes/routes.ts): `backend/src/modules/kubernetes/routes.ts`
- [Jenkins routes](https://github.com/ajithselvam/devsecops/blob/main/backend/src/modules/jenkins/routes.ts): `backend/src/modules/jenkins/routes.ts`
- [GitHub routes](https://github.com/ajithselvam/devsecops/blob/main/backend/src/modules/github/routes.ts): `backend/src/modules/github/routes.ts`
- [Log routes](https://github.com/ajithselvam/devsecops/blob/main/backend/src/modules/logs/routes.ts): `backend/src/modules/logs/routes.ts`
- [Dependency routes](https://github.com/ajithselvam/devsecops/blob/main/backend/src/modules/dependencies/routes.ts): `backend/src/modules/dependencies/routes.ts`
- [Feature scanners](https://github.com/ajithselvam/devsecops/tree/main/backend/src/modules): `backend/src/modules`

### Backend services

- [Job queue](https://github.com/ajithselvam/devsecops/blob/main/backend/src/shared/queue/index.ts): `backend/src/shared/queue/index.ts`
- [AI service](https://github.com/ajithselvam/devsecops/blob/main/backend/src/shared/ai/index.ts): `backend/src/shared/ai/index.ts`
- [Database access](https://github.com/ajithselvam/devsecops/blob/main/backend/src/shared/database/index.ts): `backend/src/shared/database/index.ts`
- [InsForge storage](https://github.com/ajithselvam/devsecops/blob/main/backend/src/shared/database/insforge.ts): `backend/src/shared/database/insforge.ts`

### Identity and state

- [Auth context](https://github.com/ajithselvam/devsecops/blob/main/frontend/src/context/AuthContext.tsx): `frontend/src/context/AuthContext.tsx`
- [Session persistence](https://github.com/ajithselvam/devsecops/blob/main/frontend/src/lib/session.ts): `frontend/src/lib/session.ts`

### Other components

- **Engineer**
- **GitHub API**

## Connections

- Engineer → App routing: opens dashboard (evidence: `frontend/src/App.tsx`)
- App routing → Docker scans: routes to (evidence: `frontend/src/App.tsx`)
- App routing → Dockerfile fixes: routes to (evidence: `frontend/src/App.tsx`)
- App routing → Kubernetes assistant: routes to (evidence: `frontend/src/App.tsx`)
- App routing → Jenkins assistant: routes to (evidence: `frontend/src/App.tsx`)
- App routing → GitHub security: routes to (evidence: `frontend/src/App.tsx`)
- App routing → Log investigation: routes to (evidence: `frontend/src/App.tsx`)
- App routing → Dependency radar: routes to (evidence: `frontend/src/App.tsx`)
- App routing → Settings: routes to (evidence: `frontend/src/App.tsx`)
- App routing → Auth context: checks auth (evidence: `frontend/src/App.tsx`)
- Docker scans → API client: uses API
- Dockerfile fixes → API client: uses API
- Kubernetes assistant → API client: uses API
- Jenkins assistant → API client: uses API
- GitHub security → API client: uses API
- Log investigation → API client: uses API
- Dependency radar → API client: calls API (evidence: `frontend/src/pages/DependencyRadar.tsx`)
- Settings → API client: calls API (evidence: `frontend/src/pages/Settings.tsx`)
- Auth context → Session persistence: restores session (evidence: `frontend/src/context/AuthContext.tsx`)
- Auth context → API client: loads profile (evidence: `frontend/src/context/AuthContext.tsx`)
- API client → Session persistence: reads token (evidence: `frontend/src/services/api.ts`)
- Docker routes → Job queue: enqueues jobs (evidence: `backend/src/shared/queue/index.ts`)
- Dockerfile routes → Job queue: enqueues jobs (evidence: `backend/src/shared/queue/index.ts`)
- Kubernetes routes → Job queue: enqueues jobs (evidence: `backend/src/modules/kubernetes/routes.ts`)
- Jenkins routes → Job queue: enqueues jobs (evidence: `backend/src/modules/jenkins/routes.ts`)
- Job queue → Feature scanners: dispatches scans (evidence: `backend/src/shared/queue/index.ts`)
- Dependency routes → Feature scanners: scans dependencies (evidence: `backend/src/modules/dependencies/routes.ts`)
- GitHub routes → Feature scanners: scans repository (evidence: `backend/src/modules/github/routes.ts`)
- GitHub routes → GitHub API: authenticates token (evidence: `backend/src/modules/github/routes.ts`)
- Docker routes → Database access: reads and writes (evidence: `backend/src/modules/docker/routes.ts`)
- Dockerfile routes → Database access: reads and writes (evidence: `backend/src/modules/dockerfile/routes.ts`)
- Kubernetes routes → Database access: reads and writes (evidence: `backend/src/modules/kubernetes/routes.ts`)
- Jenkins routes → Database access: reads and writes (evidence: `backend/src/modules/jenkins/routes.ts`)
- GitHub routes → Database access: reads and writes (evidence: `backend/src/modules/github/routes.ts`)
- Dependency routes → Database access: reads and writes (evidence: `backend/src/modules/dependencies/routes.ts`)
- Log routes → Database access: reads and writes (evidence: `backend/src/modules/logs/routes.ts`)
- Log routes → InsForge storage: stores log files (evidence: `backend/src/modules/logs/routes.ts`)
- Docker routes → AI service: requests remediation (evidence: `backend/src/modules/docker/routes.ts`)
- Dockerfile routes → AI service: requests remediation (evidence: `backend/src/modules/dockerfile/routes.ts`)
- Kubernetes routes → AI service: requests remediation (evidence: `backend/src/modules/kubernetes/routes.ts`)
- Jenkins routes → AI service: requests assistance (evidence: `backend/src/modules/jenkins/routes.ts`)
- GitHub routes → AI service: requests fixes (evidence: `backend/src/modules/github/routes.ts`)
- Log routes → AI service: investigates logs (evidence: `backend/src/modules/logs/routes.ts`)
- Dependency routes → AI service: requests remediation (evidence: `backend/src/modules/dependencies/routes.ts`)
