# robert-abela/hackspace architecture

> Architecture diagram of the GitHub repository robert-abela/hackspace, 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/robert-abela/hackspace
- Repository: https://github.com/robert-abela/hackspace

## Overview

This repository hosts the MCAST HackSpace website and includes standalone security workshop demonstrations. The main visitor workflow is browsing the site’s landing, article, event, sponsor, and joining pages. A service worker provides offline support by caching selected pages and assets and serving cached responses when network fetches fail. Workshop examples cover Linux function tracing, Windows clipboard hooking, and a Log4Shell demonstration. Source excerpts show the service-worker cache behavior and parts of the demos; relationships among unsampled pages and workshop files are therefore not inferred.

Main entry points: [`serviceworker.js`](https://github.com/robert-abela/hackspace/blob/main/serviceworker.js) (Service worker), [`workshops/win-clipbaord-hooking/Injection/notepad.py`](https://github.com/robert-abela/hackspace/blob/main/workshops/win-clipbaord-hooking/Injection/notepad.py) (Notepad injector), [`workshops/log4shell/log4JDemo/src/main/java/log4JDemo/Log4ShellDemo.java`](https://github.com/robert-abela/hackspace/blob/main/workshops/log4shell/log4JDemo/src/main/java/log4JDemo/Log4ShellDemo.java) (Log4Shell demo), [`README.md`](https://github.com/robert-abela/hackspace/blob/main/README.md) (HackSpace site)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_web["HackSpace website"]
  node_website["HackSpace site<br/>[README.md]"]
  node_home["Home page<br/>[index.html]"]
  node_articles["Articles<br/>[articles-list.html]"]
  node_article["Article pages"]
  node_sessions["Planned sessions"]
  node_join["Join page<br/>[join.html]"]
  node_sponsors["Sponsors<br/>[sponsors.html]"]
end

subgraph group_offline["Offline support"]
  node_serviceworker["Service worker<br/>[serviceworker.js]"]
  node_assetcache[("Cache storage")]
end

subgraph group_linux["Linux tracing workshop"]
  node_linuxhooks["Linux API hooks<br/>[read.js]"]
end

subgraph group_demos["Security demos"]
  node_wincontroller["Notepad injector<br/>[notepad.py]"]
  node_winhook["Clipboard hook<br/>[Inject.js]"]
  node_winhandlers["Clipboard handlers"]
  node_wininit["Clipboard setup<br/>[init.js]"]
  node_log4demo["Log4Shell demo<br/>[Log4ShellDemo.java]"]
end

node_visitor(("Site visitor"))
node_log4j["Log4j library"]

node_visitor -->|"browses"| node_website
node_serviceworker -->|"caches assets"| node_assetcache
node_wincontroller -->|"loads script"| node_winhook
node_log4demo -->|"logs through"| node_log4j

click node_website "https://github.com/robert-abela/hackspace/blob/main/README.md"
click node_home "https://github.com/robert-abela/hackspace/blob/main/index.html"
click node_articles "https://github.com/robert-abela/hackspace/blob/main/articles-list.html"
click node_article "https://github.com/robert-abela/hackspace/blob/main/article-cyberroot.html"
click node_sessions "https://github.com/robert-abela/hackspace/blob/main/planned-sessions.html"
click node_join "https://github.com/robert-abela/hackspace/blob/main/join.html"
click node_sponsors "https://github.com/robert-abela/hackspace/blob/main/sponsors.html"
click node_serviceworker "https://github.com/robert-abela/hackspace/blob/main/serviceworker.js"
click node_linuxhooks "https://github.com/robert-abela/hackspace/blob/main/workshops/lnx-hooking/__handlers__/libpthread_2.31.so/read.js"
click node_wincontroller "https://github.com/robert-abela/hackspace/blob/main/workshops/win-clipbaord-hooking/Injection/notepad.py"
click node_winhook "https://github.com/robert-abela/hackspace/blob/main/workshops/win-clipbaord-hooking/Injection/Inject.js"
click node_winhandlers "https://github.com/robert-abela/hackspace/blob/main/workshops/win-clipbaord-hooking/__handlers__/USER32.dll/GetClipboardData.js"
click node_wininit "https://github.com/robert-abela/hackspace/blob/main/workshops/win-clipbaord-hooking/init.js"
click node_log4demo "https://github.com/robert-abela/hackspace/blob/main/workshops/log4shell/log4JDemo/src/main/java/log4JDemo/Log4ShellDemo.java"

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_website,node_home,node_articles,node_article,node_sessions,node_join,node_sponsors toneBlue
class node_serviceworker,node_assetcache toneAmber
class node_linuxhooks toneMint
class node_wincontroller,node_winhook,node_winhandlers,node_wininit,node_log4demo toneRose
class node_visitor,node_log4j toneIndigo
```

## Components

### HackSpace website

- [HackSpace site](https://github.com/robert-abela/hackspace/blob/main/README.md): `README.md`
- [Home page](https://github.com/robert-abela/hackspace/blob/main/index.html): `index.html`
- [Articles](https://github.com/robert-abela/hackspace/blob/main/articles-list.html): `articles-list.html`
- [Article pages](https://github.com/robert-abela/hackspace/blob/main/article-cyberroot.html): `article-cyberroot.html`
- [Planned sessions](https://github.com/robert-abela/hackspace/blob/main/planned-sessions.html): `planned-sessions.html`
- [Join page](https://github.com/robert-abela/hackspace/blob/main/join.html): `join.html`
- [Sponsors](https://github.com/robert-abela/hackspace/blob/main/sponsors.html): `sponsors.html`

### Offline support

- [Service worker](https://github.com/robert-abela/hackspace/blob/main/serviceworker.js): `serviceworker.js`
- **Cache storage**

### Linux tracing workshop

- [Linux API hooks](https://github.com/robert-abela/hackspace/blob/main/workshops/lnx-hooking/__handlers__/libpthread_2.31.so/read.js): `workshops/lnx-hooking/__handlers__/libpthread_2.31.so/read.js`

### Security demos

- [Notepad injector](https://github.com/robert-abela/hackspace/blob/main/workshops/win-clipbaord-hooking/Injection/notepad.py): `workshops/win-clipbaord-hooking/Injection/notepad.py`
- [Clipboard hook](https://github.com/robert-abela/hackspace/blob/main/workshops/win-clipbaord-hooking/Injection/Inject.js): `workshops/win-clipbaord-hooking/Injection/Inject.js`
- [Clipboard handlers](https://github.com/robert-abela/hackspace/blob/main/workshops/win-clipbaord-hooking/__handlers__/USER32.dll/GetClipboardData.js): `workshops/win-clipbaord-hooking/__handlers__/USER32.dll/GetClipboardData.js`
- [Clipboard setup](https://github.com/robert-abela/hackspace/blob/main/workshops/win-clipbaord-hooking/init.js): `workshops/win-clipbaord-hooking/init.js`
- [Log4Shell demo](https://github.com/robert-abela/hackspace/blob/main/workshops/log4shell/log4JDemo/src/main/java/log4JDemo/Log4ShellDemo.java): `workshops/log4shell/log4JDemo/src/main/java/log4JDemo/Log4ShellDemo.java`

### Other components

- **Site visitor**
- **Log4j library**

## Connections

- Site visitor → HackSpace site: browses (evidence: `README.md`)
- Service worker → Cache storage: caches assets (evidence: `serviceworker.js`)
- Notepad injector → Clipboard hook: loads script (evidence: `workshops/win-clipbaord-hooking/Injection/notepad.py`)
- Log4Shell demo → Log4j library: logs through (evidence: `workshops/log4shell/log4JDemo/src/main/java/log4JDemo/Log4ShellDemo.java`)
