# sivaahari/l3m0nctf architecture

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

- Interactive diagram: https://gitdiagram.com/sivaahari/l3m0nctf
- Repository: https://github.com/sivaahari/l3m0nctf

## Overview

This repository is a research and design record for L3m0nCTF 2026, not a platform implementation. The documented workflow is that teams solve independent challenges; each solve unlocks story lore and advances an event progress meter. The design retains CTFd’s team, scoring, admin, API, and challenge-authoring capabilities, with planned hosting, abuse, event-stream, and CTFtime integrations. Components below are planned, not inspected runtime code; paths are null where no implementation path exists.

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_competition["Competition platform"]
  node_ctfd["CTFd engine"]
  node_challenge_authoring["Challenge authoring"]
  node_scoring["Scoring"]
  node_admin["Administration"]
  node_rest_api["REST API"]
  node_challenge_hosting["Challenge hosting"]
  node_instancer["External instancer"]
end

subgraph group_event["Event experience"]
  node_story_overlay["Story overlay"]
  node_lore["Lore unlocks"]
  node_progress_meter["Progress meter"]
end

subgraph group_operations["Platform operations"]
  node_event_stream["Event stream"]
  node_abuse_layer["Abuse layer"]
  node_hardened_deployment["Hardened deployment"]
end

subgraph group_integrations["External integrations"]
  node_ctftime["CTFtime"]
  node_live_feed["Live JSON feed"]
  node_oauth["CTFtime OAuth"]
end

node_teams(("Teams"))

node_teams -->|"use platform"| node_ctfd
node_ctfd -->|"supports authoring"| node_challenge_authoring
node_ctfd -->|"provides scoring"| node_scoring
node_ctfd -->|"provides admin"| node_admin
node_ctfd -->|"provides API"| node_rest_api
node_ctfd -->|"hosts challenges"| node_challenge_hosting
node_ctfd -->|"extends with"| node_instancer
node_teams -->|"submit solves"| node_ctfd
node_ctfd -->|"extends with"| node_story_overlay
node_story_overlay -->|"unlocks on solve"| node_lore
node_story_overlay -->|"advances on solve"| node_progress_meter
node_ctfd -->|"extends with"| node_event_stream
node_ctfd -->|"extends with"| node_abuse_layer
node_ctfd -->|"runs within"| node_hardened_deployment
node_ctfd -->|"publishes feed"| node_live_feed
node_live_feed -->|"serves scoreboard"| node_ctftime
node_ctfd -->|"adds login plugin"| node_oauth
node_oauth -->|"authenticates with"| node_ctftime

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_ctfd,node_challenge_authoring,node_scoring,node_admin,node_rest_api,node_challenge_hosting,node_instancer toneBlue
class node_story_overlay,node_lore,node_progress_meter toneAmber
class node_event_stream,node_abuse_layer,node_hardened_deployment toneMint
class node_ctftime,node_live_feed,node_oauth toneRose
class node_teams toneIndigo
```

## Components

### Competition platform

- **CTFd engine**
- **Challenge authoring**
- **Scoring**
- **Administration**
- **REST API**
- **Challenge hosting**
- **External instancer**

### Event experience

- **Story overlay**
- **Lore unlocks**
- **Progress meter**

### Platform operations

- **Event stream**
- **Abuse layer**
- **Hardened deployment**

### External integrations

- **CTFtime**
- **Live JSON feed**
- **CTFtime OAuth**

### Other components

- **Teams**

## Connections

- Teams → CTFd engine: use platform (evidence: `README.md`)
- CTFd engine → Challenge authoring: supports authoring (evidence: `README.md`)
- CTFd engine → Scoring: provides scoring (evidence: `README.md`)
- CTFd engine → Administration: provides admin (evidence: `README.md`)
- CTFd engine → REST API: provides API (evidence: `README.md`)
- CTFd engine → Challenge hosting: hosts challenges (evidence: `README.md`)
- CTFd engine → External instancer: extends with (evidence: `README.md`)
- Teams → CTFd engine: submit solves (evidence: `README.md`)
- CTFd engine → Story overlay: extends with (evidence: `README.md`)
- Story overlay → Lore unlocks: unlocks on solve (evidence: `README.md`)
- Story overlay → Progress meter: advances on solve (evidence: `README.md`)
- CTFd engine → Event stream: extends with (evidence: `README.md`)
- CTFd engine → Abuse layer: extends with (evidence: `README.md`)
- CTFd engine → Hardened deployment: runs within (evidence: `README.md`)
- CTFd engine → Live JSON feed: publishes feed (evidence: `README.md`)
- Live JSON feed → CTFtime: serves scoreboard (evidence: `README.md`)
- CTFd engine → CTFtime OAuth: adds login plugin (evidence: `README.md`)
- CTFtime OAuth → CTFtime: authenticates with (evidence: `README.md`)
