# devcop95/bugbounty-lab101 architecture

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

- Interactive diagram: https://gitdiagram.com/devcop95/bugbounty-lab101
- Repository: https://github.com/devcop95/bugbounty-lab101

## Overview

Bug Bounty Lab is a HackerOne research workspace centered on documenting program scope, checking authorization, scanning targets, and preparing reports. The README describes a full recon-to-report workflow, a 400+ tool arsenal, Burp and browser integrations, duplicate checking, and a local VM practice lab; it also documents T3MP3ST as an optional external war room. Edges use README workflow statements and the sampled scope-guard/Burp code. Other shell workflows are represented at their documented subsystem level because their implementation was not sampled.

Main entry points: [`bugbounty/bugbounty-hunter.sh`](https://github.com/devcop95/bugbounty-lab101/blob/main/bugbounty/bugbounty-hunter.sh) (Bounty Hunter), [`scripts/scope_guard.py`](https://github.com/devcop95/bugbounty-lab101/blob/main/scripts/scope_guard.py) (Scope Guard), [`auto-scanner/burp-integration/burp_api.py`](https://github.com/devcop95/bugbounty-lab101/blob/main/auto-scanner/burp-integration/burp_api.py) (Burp Integration), [`programs`](https://github.com/devcop95/bugbounty-lab101/tree/main/programs) (Program Scope)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_bounty["Bounty Workflow"]
  node_programs["Program Scope"]
  node_hunter["Bounty Hunter"]
  node_scope_guard["Scope Guard<br/>[scope_guard.py]"]
  node_recon["Recon"]
  node_vuln_scan["Vulnerability Scan"]
end

subgraph group_scanning["Scanning Arsenal"]
  node_auto_scanner["Tool Arsenal"]
  node_burp_api["Burp Integration<br/>[burp_api.py]"]
  node_browser_capture["Browser Capture<br/>[browser_capture.js]"]
end

subgraph group_reporting["Report Triage"]
  node_report_stage["Report Preparation"]
  node_report_template["HackerOne Template<br/>[report-template.md]"]
  node_duplicate_check["Duplicate Check<br/>[duplicate_check.py]"]
end

subgraph group_support["Practice And AI"]
  node_vm_lab["Local VM Lab"]
  node_t3mp3st["T3MP3ST War Room"]
end

node_researcher(("Researcher"))
node_burp_service["Burp Suite"]
node_hackerone["HackerOne"]
node_target["Authorized Target"]

node_researcher -->|"documents scope"| node_programs
node_researcher -->|"runs commands"| node_hunter
node_hunter -->|"checks scope"| node_scope_guard
node_hunter -->|"runs phase"| node_recon
node_hunter -->|"runs phase"| node_vuln_scan
node_hunter -->|"prepares report"| node_report_stage
node_scope_guard -->|"reads scope"| node_programs
node_scope_guard -->|"authorizes host"| node_target
node_recon -->|"uses arsenal"| node_auto_scanner
node_vuln_scan -->|"uses arsenal"| node_auto_scanner
node_report_stage -->|"uses template"| node_report_template
node_researcher -->|"checks duplicates"| node_duplicate_check
node_duplicate_check -->|"reads report tables"| node_programs
node_report_stage -->|"submits report"| node_hackerone
node_researcher -->|"runs integration"| node_burp_api
node_burp_api -->|"authorizes target"| node_scope_guard
node_burp_api -->|"calls API"| node_burp_service
node_researcher -->|"runs capture"| node_browser_capture
node_researcher -->|"practices locally"| node_vm_lab
node_researcher -->|"starts war room"| node_t3mp3st

click node_programs "https://github.com/devcop95/bugbounty-lab101/tree/main/programs"
click node_hunter "https://github.com/devcop95/bugbounty-lab101/blob/main/bugbounty/bugbounty-hunter.sh"
click node_scope_guard "https://github.com/devcop95/bugbounty-lab101/blob/main/scripts/scope_guard.py"
click node_recon "https://github.com/devcop95/bugbounty-lab101/blob/main/bugbounty/bugbounty-hunter.sh"
click node_vuln_scan "https://github.com/devcop95/bugbounty-lab101/blob/main/bugbounty/bugbounty-hunter.sh"
click node_report_stage "https://github.com/devcop95/bugbounty-lab101/blob/main/bugbounty/bugbounty-hunter.sh"
click node_report_template "https://github.com/devcop95/bugbounty-lab101/blob/main/bugbounty/templates/report-template.md"
click node_duplicate_check "https://github.com/devcop95/bugbounty-lab101/blob/main/scripts/duplicate_check.py"
click node_auto_scanner "https://github.com/devcop95/bugbounty-lab101/tree/main/auto-scanner"
click node_burp_api "https://github.com/devcop95/bugbounty-lab101/blob/main/auto-scanner/burp-integration/burp_api.py"
click node_browser_capture "https://github.com/devcop95/bugbounty-lab101/blob/main/auto-scanner/integrations/browser_capture.js"
click node_vm_lab "https://github.com/devcop95/bugbounty-lab101/tree/main/legacy-vm-practice"

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_programs,node_hunter,node_scope_guard,node_recon,node_vuln_scan toneBlue
class node_auto_scanner,node_burp_api,node_browser_capture toneAmber
class node_report_stage,node_report_template,node_duplicate_check toneMint
class node_vm_lab,node_t3mp3st toneRose
class node_researcher,node_burp_service,node_hackerone,node_target toneIndigo
```

## Components

### Bounty Workflow

- [Program Scope](https://github.com/devcop95/bugbounty-lab101/tree/main/programs): `programs`
- [Bounty Hunter](https://github.com/devcop95/bugbounty-lab101/blob/main/bugbounty/bugbounty-hunter.sh): `bugbounty/bugbounty-hunter.sh`
- [Scope Guard](https://github.com/devcop95/bugbounty-lab101/blob/main/scripts/scope_guard.py): `scripts/scope_guard.py`
- [Recon](https://github.com/devcop95/bugbounty-lab101/blob/main/bugbounty/bugbounty-hunter.sh): `bugbounty/bugbounty-hunter.sh`
- [Vulnerability Scan](https://github.com/devcop95/bugbounty-lab101/blob/main/bugbounty/bugbounty-hunter.sh): `bugbounty/bugbounty-hunter.sh`

### Scanning Arsenal

- [Tool Arsenal](https://github.com/devcop95/bugbounty-lab101/tree/main/auto-scanner): `auto-scanner`
- [Burp Integration](https://github.com/devcop95/bugbounty-lab101/blob/main/auto-scanner/burp-integration/burp_api.py): `auto-scanner/burp-integration/burp_api.py`
- [Browser Capture](https://github.com/devcop95/bugbounty-lab101/blob/main/auto-scanner/integrations/browser_capture.js): `auto-scanner/integrations/browser_capture.js`

### Report Triage

- [Report Preparation](https://github.com/devcop95/bugbounty-lab101/blob/main/bugbounty/bugbounty-hunter.sh): `bugbounty/bugbounty-hunter.sh`
- [HackerOne Template](https://github.com/devcop95/bugbounty-lab101/blob/main/bugbounty/templates/report-template.md): `bugbounty/templates/report-template.md`
- [Duplicate Check](https://github.com/devcop95/bugbounty-lab101/blob/main/scripts/duplicate_check.py): `scripts/duplicate_check.py`

### Practice And AI

- [Local VM Lab](https://github.com/devcop95/bugbounty-lab101/tree/main/legacy-vm-practice): `legacy-vm-practice`
- **T3MP3ST War Room**

### Other components

- **Researcher**
- **Burp Suite**
- **HackerOne**
- **Authorized Target**

## Connections

- Researcher → Program Scope: documents scope (evidence: `README.md`)
- Researcher → Bounty Hunter: runs commands (evidence: `README.md`)
- Bounty Hunter → Scope Guard: checks scope (evidence: `README.md`)
- Bounty Hunter → Recon: runs phase (evidence: `README.md`)
- Bounty Hunter → Vulnerability Scan: runs phase (evidence: `README.md`)
- Bounty Hunter → Report Preparation: prepares report (evidence: `README.md`)
- Scope Guard → Program Scope: reads scope (evidence: `scripts/scope_guard.py`)
- Scope Guard → Authorized Target: authorizes host (evidence: `scripts/scope_guard.py`)
- Recon → Tool Arsenal: uses arsenal (evidence: `README.md`)
- Vulnerability Scan → Tool Arsenal: uses arsenal (evidence: `README.md`)
- Report Preparation → HackerOne Template: uses template (evidence: `README.md`)
- Researcher → Duplicate Check: checks duplicates (evidence: `README.md`)
- Duplicate Check → Program Scope: reads report tables (evidence: `scripts/duplicate_check.py`)
- Report Preparation → HackerOne: submits report (evidence: `README.md`)
- Researcher → Burp Integration: runs integration (evidence: `auto-scanner/burp-integration/burp_api.py`)
- Burp Integration → Scope Guard: authorizes target (evidence: `auto-scanner/burp-integration/burp_api.py`)
- Burp Integration → Burp Suite: calls API (evidence: `auto-scanner/burp-integration/burp_api.py`)
- Researcher → Browser Capture: runs capture (evidence: `auto-scanner/integrations/browser_capture.js`)
- Researcher → Local VM Lab: practices locally (evidence: `README.md`)
- Researcher → T3MP3ST War Room: starts war room (evidence: `README.md`)
