# kluroshan/capstoneproject architecture

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

- Interactive diagram: https://gitdiagram.com/kluroshan/capstoneproject
- Repository: https://github.com/kluroshan/capstoneproject

## Overview

The platform has two user-facing testing workflows: staged load testing produces capacity metrics, while Engine 2 performs static or load-differential security scans and reports findings. The React interface exposes both; command-line scanners provide an additional Engine 2 entry point. Security phase wiring is supported by the scan module’s documented phases and SOURCE INDEX references; unsampled details are not expanded.

Main entry points: [`backend/app/security/scan.py`](https://github.com/kluroshan/capstoneproject/blob/main/backend/app/security/scan.py) (Scan orchestration), [`backend/app/security/models.py`](https://github.com/kluroshan/capstoneproject/blob/main/backend/app/security/models.py) (Scan data models), [`backend/app/security/api.py`](https://github.com/kluroshan/capstoneproject/blob/main/backend/app/security/api.py) (Scan routes), [`frontend/src/App.jsx`](https://github.com/kluroshan/capstoneproject/blob/main/frontend/src/App.jsx) (Web dashboard)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_interface["User interfaces"]
  node_web_ui["Web dashboard<br/>[App.jsx]"]
  node_api["FastAPI routes<br/>[main.py]"]
end

subgraph group_load["Load engine"]
  node_job_manager["Load job manager<br/>[loadtest.py]"]
  node_locust["Locust ramp<br/>[locustfile.py]"]
  node_run_csv["Run CSV results<br/>[loadtest.py]"]
  node_capacity_analysis["Capacity analysis<br/>[analysis.py]"]
end

subgraph group_security["Security engine"]
  node_scan_api["Scan routes<br/>[api.py]"]
  node_scan_jobs["Scan job manager<br/>[jobs.py]"]
  node_scanner["Scan orchestration<br/>[scan.py]"]
  node_discovery["API discovery<br/>[discovery.py]"]
  node_probe_catalogue["Probe catalogue<br/>[probes.py]"]
  node_probe_runner["Probe runner<br/>[runner.py]"]
  node_differ["Finding analysis<br/>[differ.py]"]
  node_scan_models["Scan data models<br/>[models.py]"]
end

subgraph group_security_cli["Security CLI"]
  node_cli_scan_url["URL scan CLI<br/>[scan_url.py]"]
  node_cli_run_scan["Scan runner CLI<br/>[run_scan.py]"]
end

node_tester(("Authorized tester"))
node_target(("Test target"))

node_tester -->|"operates"| node_web_ui
node_web_ui -->|"calls API"| node_api
node_api -->|"creates or controls"| node_job_manager
node_job_manager -->|"launches"| node_locust
node_locust -->|"generates load"| node_target
node_locust -->|"writes results"| node_run_csv
node_job_manager -->|"reads live CSV"| node_run_csv
node_run_csv -->|"analyzed into report"| node_capacity_analysis
node_tester -->|"runs scan"| node_cli_scan_url
node_tester -->|"runs scan"| node_cli_run_scan
node_api -->|"mounts routes"| node_scan_api
node_web_ui -->|"polls scan results"| node_scan_api
node_scan_api -->|"creates and queries"| node_scan_jobs
node_scan_jobs -->|"runs scan"| node_scanner
node_scanner -->|"discovers endpoints"| node_discovery
node_scanner -->|"builds probe suite"| node_probe_catalogue
node_scanner -->|"runs probes"| node_probe_runner
node_scanner -->|"compares observations"| node_differ
node_scanner -->|"uses scan data"| node_scan_models
node_probe_catalogue -->|"defines probes"| node_scan_models
node_probe_runner -->|"produces observations"| node_scan_models
node_differ -->|"produces findings"| node_scan_models
node_scan_api -->|"builds credentials"| node_scan_models
node_cli_scan_url -->|"invokes scanner"| node_scanner
node_cli_run_scan -->|"uses scanner"| node_scanner

click node_web_ui "https://github.com/kluroshan/capstoneproject/blob/main/frontend/src/App.jsx"
click node_api "https://github.com/kluroshan/capstoneproject/blob/main/backend/app/main.py"
click node_job_manager "https://github.com/kluroshan/capstoneproject/blob/main/backend/app/loadtest.py"
click node_locust "https://github.com/kluroshan/capstoneproject/blob/main/backend/app/locustfile.py"
click node_run_csv "https://github.com/kluroshan/capstoneproject/blob/main/backend/app/loadtest.py"
click node_capacity_analysis "https://github.com/kluroshan/capstoneproject/blob/main/backend/app/analysis.py"
click node_scan_api "https://github.com/kluroshan/capstoneproject/blob/main/backend/app/security/api.py"
click node_scan_jobs "https://github.com/kluroshan/capstoneproject/blob/main/backend/app/security/jobs.py"
click node_scanner "https://github.com/kluroshan/capstoneproject/blob/main/backend/app/security/scan.py"
click node_discovery "https://github.com/kluroshan/capstoneproject/blob/main/backend/app/security/discovery.py"
click node_probe_catalogue "https://github.com/kluroshan/capstoneproject/blob/main/backend/app/security/probes.py"
click node_probe_runner "https://github.com/kluroshan/capstoneproject/blob/main/backend/app/security/runner.py"
click node_differ "https://github.com/kluroshan/capstoneproject/blob/main/backend/app/security/differ.py"
click node_scan_models "https://github.com/kluroshan/capstoneproject/blob/main/backend/app/security/models.py"
click node_cli_scan_url "https://github.com/kluroshan/capstoneproject/blob/main/backend/scan_url.py"
click node_cli_run_scan "https://github.com/kluroshan/capstoneproject/blob/main/backend/run_scan.py"

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_ui,node_api toneBlue
class node_job_manager,node_locust,node_run_csv,node_capacity_analysis toneAmber
class node_scan_api,node_scan_jobs,node_scanner,node_discovery,node_probe_catalogue,node_probe_runner,node_differ,node_scan_models toneMint
class node_cli_scan_url,node_cli_run_scan toneRose
class node_tester,node_target toneIndigo
```

## Components

### User interfaces

- [Web dashboard](https://github.com/kluroshan/capstoneproject/blob/main/frontend/src/App.jsx): `frontend/src/App.jsx`
- [FastAPI routes](https://github.com/kluroshan/capstoneproject/blob/main/backend/app/main.py): `backend/app/main.py`

### Load engine

- [Load job manager](https://github.com/kluroshan/capstoneproject/blob/main/backend/app/loadtest.py): `backend/app/loadtest.py`
- [Locust ramp](https://github.com/kluroshan/capstoneproject/blob/main/backend/app/locustfile.py): `backend/app/locustfile.py`
- [Run CSV results](https://github.com/kluroshan/capstoneproject/blob/main/backend/app/loadtest.py): `backend/app/loadtest.py`
- [Capacity analysis](https://github.com/kluroshan/capstoneproject/blob/main/backend/app/analysis.py): `backend/app/analysis.py`

### Security engine

- [Scan routes](https://github.com/kluroshan/capstoneproject/blob/main/backend/app/security/api.py): `backend/app/security/api.py`
- [Scan job manager](https://github.com/kluroshan/capstoneproject/blob/main/backend/app/security/jobs.py): `backend/app/security/jobs.py`
- [Scan orchestration](https://github.com/kluroshan/capstoneproject/blob/main/backend/app/security/scan.py): `backend/app/security/scan.py`
- [API discovery](https://github.com/kluroshan/capstoneproject/blob/main/backend/app/security/discovery.py): `backend/app/security/discovery.py`
- [Probe catalogue](https://github.com/kluroshan/capstoneproject/blob/main/backend/app/security/probes.py): `backend/app/security/probes.py`
- [Probe runner](https://github.com/kluroshan/capstoneproject/blob/main/backend/app/security/runner.py): `backend/app/security/runner.py`
- [Finding analysis](https://github.com/kluroshan/capstoneproject/blob/main/backend/app/security/differ.py): `backend/app/security/differ.py`
- [Scan data models](https://github.com/kluroshan/capstoneproject/blob/main/backend/app/security/models.py): `backend/app/security/models.py`

### Security CLI

- [URL scan CLI](https://github.com/kluroshan/capstoneproject/blob/main/backend/scan_url.py): `backend/scan_url.py`
- [Scan runner CLI](https://github.com/kluroshan/capstoneproject/blob/main/backend/run_scan.py): `backend/run_scan.py`

### Other components

- **Authorized tester**
- **Test target**

## Connections

- Authorized tester → Web dashboard: operates (evidence: `README.md`)
- Web dashboard → FastAPI routes: calls API (evidence: `README.md`)
- FastAPI routes → Load job manager: creates or controls (evidence: `backend/app/main.py`)
- Load job manager → Locust ramp: launches (evidence: `backend/app/loadtest.py`)
- Locust ramp → Test target: generates load (evidence: `README.md`)
- Locust ramp → Run CSV results: writes results (evidence: `README.md`)
- Load job manager → Run CSV results: reads live CSV (evidence: `backend/app/loadtest.py`)
- Run CSV results → Capacity analysis: analyzed into report (evidence: `README.md`)
- Authorized tester → URL scan CLI: runs scan (evidence: `backend/scan_url.py`)
- Authorized tester → Scan runner CLI: runs scan (evidence: `backend/run_scan.py`)
- FastAPI routes → Scan routes: mounts routes (evidence: `backend/app/main.py`)
- Web dashboard → Scan routes: polls scan results (evidence: `frontend/src/App.jsx`)
- Scan routes → Scan job manager: creates and queries (evidence: `backend/app/security/api.py`)
- Scan job manager → Scan orchestration: runs scan (evidence: `backend/app/security/jobs.py`)
- Scan orchestration → API discovery: discovers endpoints (evidence: `backend/app/security/scan.py`)
- Scan orchestration → Probe catalogue: builds probe suite (evidence: `backend/app/security/scan.py`)
- Scan orchestration → Probe runner: runs probes (evidence: `backend/app/security/scan.py`)
- Scan orchestration → Finding analysis: compares observations (evidence: `backend/app/security/scan.py`)
- Scan orchestration → Scan data models: uses scan data (evidence: `backend/app/security/scan.py`)
- Probe catalogue → Scan data models: defines probes (evidence: `backend/app/security/probes.py`)
- Probe runner → Scan data models: produces observations (evidence: `backend/app/security/runner.py`)
- Finding analysis → Scan data models: produces findings (evidence: `backend/app/security/differ.py`)
- Scan routes → Scan data models: builds credentials (evidence: `backend/app/security/api.py`)
- URL scan CLI → Scan orchestration: invokes scanner (evidence: `backend/scan_url.py`)
- Scan runner CLI → Scan orchestration: uses scanner (evidence: `backend/run_scan.py`)
