# dvid-security/dvidv2-opensource architecture

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

- Interactive diagram: https://gitdiagram.com/dvid-security/dvidv2-opensource
- Repository: https://github.com/dvid-security/dvidv2-opensource

## Overview

DVID is an open-source collection of CTF challenges, hardware exercises, escape-game material, and solution write-ups—not one unified runtime application. The clearest user path is a learner exploring a challenge or workshop and working toward its flag; contributors add material through the documented review process. The graph groups the repository by its major collections and shows sampled firmware-to-image dependencies where source references support them. Several challenge and workshop directories are represented at directory level because their implementation was not sampled.

Main entry points: [`battleExperience/editions`](https://github.com/dvid-security/dvidv2-opensource/tree/main/battleExperience/editions) (Battle Challenges), [`workshop/thcon2025/uart/src/main.cpp`](https://github.com/dvid-security/dvidv2-opensource/blob/main/workshop/thcon2025/uart/src/main.cpp) (THCON 2025 UART), [`write-up/DaVinciCTF2025/goldenScarab/src/main.cpp`](https://github.com/dvid-security/dvidv2-opensource/blob/main/write-up/DaVinciCTF2025/goldenScarab/src/main.cpp) (Golden Scarab), [`write-up/DaVinciCTF2025/louvreSecuritySystem/src/main.cpp`](https://github.com/dvid-security/dvidv2-opensource/blob/main/write-up/DaVinciCTF2025/louvreSecuritySystem/src/main.cpp) (Louvre Security)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_battle["Battle Experience"]
  node_battle_collection["Battle Challenges"]
  node_helloworld["Hello World<br/>[helloworld.ino]"]
  node_edition_one["Edition One"]
end

subgraph group_escape["Escape Game"]
  node_escape_game["Escape Game"]
  node_decrypt["Database Decryptor<br/>[decrypt.py]"]
end

subgraph group_workshops["Workshops"]
  node_thcon25["THCON 2025 UART<br/>[main.cpp]"]
  node_thcon25_images["UART Images<br/>[images.cpp]"]
  node_thcon26["THCON 2026"]
end

subgraph group_writeups["CTF Write-ups"]
  node_golden["Golden Scarab<br/>[main.cpp]"]
  node_golden_images["Scarab Images<br/>[images.cpp]"]
  node_louvre["Louvre Security<br/>[main.cpp]"]
  node_louvre_images["Louvre Images<br/>[images.cpp]"]
  node_lungo["Lungo Detector"]
  node_samothrace["Samothrace Security<br/>[main.cpp]"]
  node_samothrace_images["Samothrace Images<br/>[images.cpp]"]
end

node_learner(("Learner"))
node_contributor(("Contributor"))

node_learner -.->|"explores"| node_battle_collection
node_learner -.->|"explores"| node_escape_game
node_learner -.->|"practices with"| node_thcon25
node_learner -.->|"practices with"| node_thcon26
node_learner -.->|"solves"| node_golden
node_learner -.->|"solves"| node_louvre
node_learner -.->|"solves"| node_lungo
node_learner -.->|"solves"| node_samothrace
node_contributor -->|"contributes to"| node_battle_collection
node_contributor -->|"contributes to"| node_escape_game
node_contributor -->|"contributes to"| node_thcon25
node_contributor -->|"contributes to"| node_golden
node_battle_collection -.->|"includes"| node_helloworld
node_battle_collection -.->|"includes"| node_edition_one
node_thcon25 -->|"references"| node_thcon25_images
node_golden -->|"references"| node_golden_images
node_louvre -->|"references"| node_louvre_images
node_samothrace -->|"references"| node_samothrace_images

click node_battle_collection "https://github.com/dvid-security/dvidv2-opensource/tree/main/battleExperience/editions"
click node_helloworld "https://github.com/dvid-security/dvidv2-opensource/blob/main/battleExperience/editions/_helloworld/helloworld.ino"
click node_edition_one "https://github.com/dvid-security/dvidv2-opensource/tree/main/battleExperience/editions/edition%231"
click node_escape_game "https://github.com/dvid-security/dvidv2-opensource/tree/main/escapeGame"
click node_decrypt "https://github.com/dvid-security/dvidv2-opensource/blob/main/escapeGame/decrypt.py"
click node_thcon25 "https://github.com/dvid-security/dvidv2-opensource/blob/main/workshop/thcon2025/uart/src/main.cpp"
click node_thcon25_images "https://github.com/dvid-security/dvidv2-opensource/blob/main/workshop/thcon2025/uart/lib/images.cpp"
click node_thcon26 "https://github.com/dvid-security/dvidv2-opensource/tree/main/workshop/thcon2026"
click node_golden "https://github.com/dvid-security/dvidv2-opensource/blob/main/write-up/DaVinciCTF2025/goldenScarab/src/main.cpp"
click node_golden_images "https://github.com/dvid-security/dvidv2-opensource/blob/main/write-up/DaVinciCTF2025/goldenScarab/lib/images.cpp"
click node_louvre "https://github.com/dvid-security/dvidv2-opensource/blob/main/write-up/DaVinciCTF2025/louvreSecuritySystem/src/main.cpp"
click node_louvre_images "https://github.com/dvid-security/dvidv2-opensource/blob/main/write-up/DaVinciCTF2025/louvreSecuritySystem/lib/images.cpp"
click node_lungo "https://github.com/dvid-security/dvidv2-opensource/tree/main/write-up/DaVinciCTF2025/lungoMovementDetector/app"
click node_samothrace "https://github.com/dvid-security/dvidv2-opensource/blob/main/write-up/DaVinciCTF2025/victoryOfSamothrace/src/main.cpp"
click node_samothrace_images "https://github.com/dvid-security/dvidv2-opensource/blob/main/write-up/DaVinciCTF2025/victoryOfSamothrace/lib/utils/images.cpp"

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_battle_collection,node_helloworld,node_edition_one toneBlue
class node_escape_game,node_decrypt toneAmber
class node_thcon25,node_thcon25_images,node_thcon26 toneMint
class node_golden,node_golden_images,node_louvre,node_louvre_images,node_lungo,node_samothrace,node_samothrace_images toneRose
class node_learner,node_contributor toneIndigo
```

## Components

### Battle Experience

- [Battle Challenges](https://github.com/dvid-security/dvidv2-opensource/tree/main/battleExperience/editions): `battleExperience/editions`
- [Hello World](https://github.com/dvid-security/dvidv2-opensource/blob/main/battleExperience/editions/_helloworld/helloworld.ino): `battleExperience/editions/_helloworld/helloworld.ino`
- [Edition One](https://github.com/dvid-security/dvidv2-opensource/tree/main/battleExperience/editions/edition%231): `battleExperience/editions/edition#1`

### Escape Game

- [Escape Game](https://github.com/dvid-security/dvidv2-opensource/tree/main/escapeGame): `escapeGame`
- [Database Decryptor](https://github.com/dvid-security/dvidv2-opensource/blob/main/escapeGame/decrypt.py): `escapeGame/decrypt.py`

### Workshops

- [THCON 2025 UART](https://github.com/dvid-security/dvidv2-opensource/blob/main/workshop/thcon2025/uart/src/main.cpp): `workshop/thcon2025/uart/src/main.cpp`
- [UART Images](https://github.com/dvid-security/dvidv2-opensource/blob/main/workshop/thcon2025/uart/lib/images.cpp): `workshop/thcon2025/uart/lib/images.cpp`
- [THCON 2026](https://github.com/dvid-security/dvidv2-opensource/tree/main/workshop/thcon2026): `workshop/thcon2026`

### CTF Write-ups

- [Golden Scarab](https://github.com/dvid-security/dvidv2-opensource/blob/main/write-up/DaVinciCTF2025/goldenScarab/src/main.cpp): `write-up/DaVinciCTF2025/goldenScarab/src/main.cpp`
- [Scarab Images](https://github.com/dvid-security/dvidv2-opensource/blob/main/write-up/DaVinciCTF2025/goldenScarab/lib/images.cpp): `write-up/DaVinciCTF2025/goldenScarab/lib/images.cpp`
- [Louvre Security](https://github.com/dvid-security/dvidv2-opensource/blob/main/write-up/DaVinciCTF2025/louvreSecuritySystem/src/main.cpp): `write-up/DaVinciCTF2025/louvreSecuritySystem/src/main.cpp`
- [Louvre Images](https://github.com/dvid-security/dvidv2-opensource/blob/main/write-up/DaVinciCTF2025/louvreSecuritySystem/lib/images.cpp): `write-up/DaVinciCTF2025/louvreSecuritySystem/lib/images.cpp`
- [Lungo Detector](https://github.com/dvid-security/dvidv2-opensource/tree/main/write-up/DaVinciCTF2025/lungoMovementDetector/app): `write-up/DaVinciCTF2025/lungoMovementDetector/app`
- [Samothrace Security](https://github.com/dvid-security/dvidv2-opensource/blob/main/write-up/DaVinciCTF2025/victoryOfSamothrace/src/main.cpp): `write-up/DaVinciCTF2025/victoryOfSamothrace/src/main.cpp`
- [Samothrace Images](https://github.com/dvid-security/dvidv2-opensource/blob/main/write-up/DaVinciCTF2025/victoryOfSamothrace/lib/utils/images.cpp): `write-up/DaVinciCTF2025/victoryOfSamothrace/lib/utils/images.cpp`

### Other components

- **Learner**
- **Contributor**

## Connections

- Learner → Battle Challenges: explores
- Learner → Escape Game: explores
- Learner → THCON 2025 UART: practices with
- Learner → THCON 2026: practices with
- Learner → Golden Scarab: solves
- Learner → Louvre Security: solves
- Learner → Lungo Detector: solves
- Learner → Samothrace Security: solves
- Contributor → Battle Challenges: contributes to (evidence: `README.md`)
- Contributor → Escape Game: contributes to (evidence: `README.md`)
- Contributor → THCON 2025 UART: contributes to (evidence: `README.md`)
- Contributor → Golden Scarab: contributes to (evidence: `README.md`)
- Battle Challenges → Hello World: includes
- Battle Challenges → Edition One: includes
- THCON 2025 UART → UART Images: references (evidence: `workshop/thcon2025/uart/src/main.cpp`)
- Golden Scarab → Scarab Images: references (evidence: `write-up/DaVinciCTF2025/goldenScarab/src/main.cpp`)
- Louvre Security → Louvre Images: references (evidence: `write-up/DaVinciCTF2025/louvreSecuritySystem/src/main.cpp`)
- Samothrace Security → Samothrace Images: references (evidence: `write-up/DaVinciCTF2025/victoryOfSamothrace/src/main.cpp`)
