# jagganraj27/nj-secforge architecture

> Architecture diagram of the GitHub repository jagganraj27/nj-secforge, 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/jagganraj27/nj-secforge
- Repository: https://github.com/jagganraj27/nj-secforge

## Overview

NJ SecForge is a hands-on OWASP security-learning platform. Learners browse and filter labs, open a lab in vulnerable or secure mode, submit an attack, see a simulated result, and earn tracked progress; they can also reset practice state. The graph shows the server as the request orchestrator, the engine’s loading, challenge, listing and progress responsibilities, shared SQLite state, and the documented OWASP lab families. Source excerpts do not include the views or most lab handlers, so those implementation details are not inferred.

Main entry points: [`server.js`](https://github.com/jagganraj27/nj-secforge/blob/main/server.js) (HTTP routes), [`labs/supply-chain`](https://github.com/jagganraj27/nj-secforge/tree/main/labs/supply-chain) (Supply chain lab), [`engine/labLoader.js`](https://github.com/jagganraj27/nj-secforge/blob/main/engine/labLoader.js) (Mode loader), [`engine/progressManager.js`](https://github.com/jagganraj27/nj-secforge/blob/main/engine/progressManager.js) (Progress manager)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_entry["Web application"]
  node_server["HTTP routes<br/>[server.js]"]
end

subgraph group_engine["Lab engine"]
  node_lab_list["Lab catalogue<br/>[listLabs.js]"]
  node_lab_loader["Mode loader<br/>[labLoader.js]"]
  node_challenge["Challenge evaluator"]
  node_progress["Progress manager<br/>[progressManager.js]"]
  node_reset_loader["Reset loader<br/>[resetLoader.js]"]
  node_reset_lab["Lab reset handler<br/>[resetLab.js]"]
end

subgraph group_state["Practice state"]
  node_database[("SQLite state<br/>[db.js]")]
end

subgraph group_labs["OWASP labs"]
  node_access["Access control lab"]
  node_misconfig["Misconfiguration lab"]
  node_supply["Supply chain lab"]
  node_crypto["Crypto failures lab"]
  node_sqli["Injection lab"]
  node_design["Insecure design lab"]
  node_auth["Authentication lab"]
  node_integrity["Data integrity lab"]
  node_logging["Logging failures lab"]
  node_exceptions["Exception handling lab"]
  node_malicious["Malicious dependency<br/>[maliciousLib.js]"]
end

node_learner(("Learner"))

node_learner -->|"uses"| node_server
node_server -->|"lists labs"| node_lab_list
node_server -->|"reads progress"| node_progress
node_server -->|"loads lab"| node_lab_loader
node_server -->|"checks result"| node_challenge
node_server -->|"loads reset"| node_reset_loader
node_server -->|"resets state"| node_database
node_progress -->|"reads and writes"| node_database
node_server -.->|"serves practice"| node_access
node_server -.->|"serves practice"| node_misconfig
node_server -.->|"serves practice"| node_supply
node_server -.->|"serves practice"| node_crypto
node_server -.->|"serves practice"| node_sqli
node_server -.->|"serves practice"| node_design
node_server -.->|"serves practice"| node_auth
node_server -.->|"serves practice"| node_integrity
node_server -.->|"serves practice"| node_logging
node_server -.->|"serves practice"| node_exceptions
node_supply -->|"uses dependency"| node_malicious
node_lab_loader -->|"selects mode"| node_supply

click node_server "https://github.com/jagganraj27/nj-secforge/blob/main/server.js"
click node_lab_list "https://github.com/jagganraj27/nj-secforge/blob/main/engine/listLabs.js"
click node_lab_loader "https://github.com/jagganraj27/nj-secforge/blob/main/engine/labLoader.js"
click node_challenge "https://github.com/jagganraj27/nj-secforge/blob/main/engine/challengeChecker.js"
click node_progress "https://github.com/jagganraj27/nj-secforge/blob/main/engine/progressManager.js"
click node_reset_loader "https://github.com/jagganraj27/nj-secforge/blob/main/engine/resetLoader.js"
click node_reset_lab "https://github.com/jagganraj27/nj-secforge/blob/main/engine/resetLab.js"
click node_database "https://github.com/jagganraj27/nj-secforge/blob/main/config/db.js"
click node_access "https://github.com/jagganraj27/nj-secforge/tree/main/labs/access-control"
click node_misconfig "https://github.com/jagganraj27/nj-secforge/tree/main/labs/misconfiguration"
click node_supply "https://github.com/jagganraj27/nj-secforge/tree/main/labs/supply-chain"
click node_crypto "https://github.com/jagganraj27/nj-secforge/tree/main/labs/crypto-failures"
click node_sqli "https://github.com/jagganraj27/nj-secforge/tree/main/labs/sqli"
click node_design "https://github.com/jagganraj27/nj-secforge/tree/main/labs/insecure-design"
click node_auth "https://github.com/jagganraj27/nj-secforge/tree/main/labs/auth-failures"
click node_integrity "https://github.com/jagganraj27/nj-secforge/tree/main/labs/data-integrity"
click node_logging "https://github.com/jagganraj27/nj-secforge/tree/main/labs/logging-failures"
click node_exceptions "https://github.com/jagganraj27/nj-secforge/tree/main/labs/exception-handling"
click node_malicious "https://github.com/jagganraj27/nj-secforge/blob/main/labs/supply-chain/maliciousLib.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_server toneBlue
class node_lab_list,node_lab_loader,node_challenge,node_progress,node_reset_loader,node_reset_lab toneAmber
class node_database toneMint
class node_access,node_misconfig,node_supply,node_crypto,node_sqli,node_design,node_auth,node_integrity,node_logging,node_exceptions,node_malicious toneRose
class node_learner toneIndigo
```

## Components

### Web application

- [HTTP routes](https://github.com/jagganraj27/nj-secforge/blob/main/server.js): `server.js`

### Lab engine

- [Lab catalogue](https://github.com/jagganraj27/nj-secforge/blob/main/engine/listLabs.js): `engine/listLabs.js`
- [Mode loader](https://github.com/jagganraj27/nj-secforge/blob/main/engine/labLoader.js): `engine/labLoader.js`
- [Challenge evaluator](https://github.com/jagganraj27/nj-secforge/blob/main/engine/challengeChecker.js): `engine/challengeChecker.js`
- [Progress manager](https://github.com/jagganraj27/nj-secforge/blob/main/engine/progressManager.js): `engine/progressManager.js`
- [Reset loader](https://github.com/jagganraj27/nj-secforge/blob/main/engine/resetLoader.js): `engine/resetLoader.js`
- [Lab reset handler](https://github.com/jagganraj27/nj-secforge/blob/main/engine/resetLab.js): `engine/resetLab.js`

### Practice state

- [SQLite state](https://github.com/jagganraj27/nj-secforge/blob/main/config/db.js): `config/db.js`

### OWASP labs

- [Access control lab](https://github.com/jagganraj27/nj-secforge/tree/main/labs/access-control): `labs/access-control`
- [Misconfiguration lab](https://github.com/jagganraj27/nj-secforge/tree/main/labs/misconfiguration): `labs/misconfiguration`
- [Supply chain lab](https://github.com/jagganraj27/nj-secforge/tree/main/labs/supply-chain): `labs/supply-chain`
- [Crypto failures lab](https://github.com/jagganraj27/nj-secforge/tree/main/labs/crypto-failures): `labs/crypto-failures`
- [Injection lab](https://github.com/jagganraj27/nj-secforge/tree/main/labs/sqli): `labs/sqli`
- [Insecure design lab](https://github.com/jagganraj27/nj-secforge/tree/main/labs/insecure-design): `labs/insecure-design`
- [Authentication lab](https://github.com/jagganraj27/nj-secforge/tree/main/labs/auth-failures): `labs/auth-failures`
- [Data integrity lab](https://github.com/jagganraj27/nj-secforge/tree/main/labs/data-integrity): `labs/data-integrity`
- [Logging failures lab](https://github.com/jagganraj27/nj-secforge/tree/main/labs/logging-failures): `labs/logging-failures`
- [Exception handling lab](https://github.com/jagganraj27/nj-secforge/tree/main/labs/exception-handling): `labs/exception-handling`
- [Malicious dependency](https://github.com/jagganraj27/nj-secforge/blob/main/labs/supply-chain/maliciousLib.js): `labs/supply-chain/maliciousLib.js`

### Other components

- **Learner**

## Connections

- Learner → HTTP routes: uses
- HTTP routes → Lab catalogue: lists labs (evidence: `server.js`)
- HTTP routes → Progress manager: reads progress (evidence: `server.js`)
- HTTP routes → Mode loader: loads lab (evidence: `server.js`)
- HTTP routes → Challenge evaluator: checks result (evidence: `server.js`)
- HTTP routes → Reset loader: loads reset (evidence: `server.js`)
- HTTP routes → SQLite state: resets state (evidence: `server.js`)
- Progress manager → SQLite state: reads and writes (evidence: `engine/progressManager.js`)
- HTTP routes → Access control lab: serves practice
- HTTP routes → Misconfiguration lab: serves practice
- HTTP routes → Supply chain lab: serves practice
- HTTP routes → Crypto failures lab: serves practice
- HTTP routes → Injection lab: serves practice
- HTTP routes → Insecure design lab: serves practice
- HTTP routes → Authentication lab: serves practice
- HTTP routes → Data integrity lab: serves practice
- HTTP routes → Logging failures lab: serves practice
- HTTP routes → Exception handling lab: serves practice
- Supply chain lab → Malicious dependency: uses dependency (evidence: `labs/supply-chain/vulnerable.js`)
- Mode loader → Supply chain lab: selects mode (evidence: `engine/labLoader.js`)
