# cyberazy/webhacklist architecture

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

- Interactive diagram: https://gitdiagram.com/cyberazy/webhacklist
- Repository: https://github.com/cyberazy/webhacklist

## Overview

Webhacklist is a curated archive of annual Top 10 Web Hacking Techniques nominations and winners, with preserved announcement PDFs and a browser-based archive. The main reader workflow is to browse/search/filter the annual records, select an item, and open its preserved document. The README documents those user-facing capabilities; source excerpts are limited, so links among unsampled website modules are omitted rather than inferred.

Main entry points: [`website/app.js`](https://github.com/cyberazy/webhacklist/blob/master/website/app.js) (Archive interface), [`2006.md`](https://github.com/cyberazy/webhacklist/blob/master/2006.md) (Annual collections), [`website/pdf-reader.mjs`](https://github.com/cyberazy/webhacklist/blob/master/website/pdf-reader.mjs) (PDF reader), [`original-listings`](https://github.com/cyberazy/webhacklist/tree/master/original-listings) (Announcement PDFs)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_archive["Curated Archive"]
  node_annual["Annual collections<br/>[2006.md]"]
  node_registry["Publishing registry<br/>[archive-years.json]"]
end

subgraph group_web["Archive Website"]
  node_app["Archive interface<br/>[app.js]"]
  node_discovery["Search and discovery<br/>[discovery.js]"]
  node_constellation["Archive constellation<br/>[constellation.js]"]
  node_shortlist["Shortlist<br/>[shortlist.js]"]
  node_saved["Saved state<br/>[saved-state.js]"]
  node_pdfreader["PDF reader<br/>[pdf-reader.mjs]"]
  node_pages["Page templates<br/>[build-pages.mjs]"]
end

subgraph group_preservation["Document Preservation"]
  node_pdfs["Announcement PDFs"]
  node_capture["PDF capture<br/>[capture_pdf.py]"]
end

node_reader(("Archive reader"))

node_reader -->|"browses archive"| node_app
node_app -->|"searches and filters"| node_discovery
node_app -->|"browses records"| node_annual
node_app -->|"opens documents"| node_pdfreader
node_pdfreader -->|"reads snapshots"| node_pdfs
node_annual -->|"publishing registry"| node_registry
node_capture -->|"captures snapshots"| node_pdfs

click node_annual "https://github.com/cyberazy/webhacklist/blob/master/2006.md"
click node_registry "https://github.com/cyberazy/webhacklist/blob/master/website/archive-years.json"
click node_pdfs "https://github.com/cyberazy/webhacklist/tree/master/original-listings"
click node_app "https://github.com/cyberazy/webhacklist/blob/master/website/app.js"
click node_discovery "https://github.com/cyberazy/webhacklist/blob/master/website/discovery.js"
click node_constellation "https://github.com/cyberazy/webhacklist/blob/master/website/constellation.js"
click node_shortlist "https://github.com/cyberazy/webhacklist/blob/master/website/shortlist.js"
click node_saved "https://github.com/cyberazy/webhacklist/blob/master/website/saved-state.js"
click node_pdfreader "https://github.com/cyberazy/webhacklist/blob/master/website/pdf-reader.mjs"
click node_pages "https://github.com/cyberazy/webhacklist/blob/master/website/build-pages.mjs"
click node_capture "https://github.com/cyberazy/webhacklist/blob/master/tools/capture_pdf.py"

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_annual,node_registry toneBlue
class node_app,node_discovery,node_constellation,node_shortlist,node_saved,node_pdfreader,node_pages toneAmber
class node_pdfs,node_capture toneMint
class node_reader toneIndigo
```

## Components

### Curated Archive

- [Annual collections](https://github.com/cyberazy/webhacklist/blob/master/2006.md): `2006.md`
- [Publishing registry](https://github.com/cyberazy/webhacklist/blob/master/website/archive-years.json): `website/archive-years.json`

### Archive Website

- [Archive interface](https://github.com/cyberazy/webhacklist/blob/master/website/app.js): `website/app.js`
- [Search and discovery](https://github.com/cyberazy/webhacklist/blob/master/website/discovery.js): `website/discovery.js`
- [Archive constellation](https://github.com/cyberazy/webhacklist/blob/master/website/constellation.js): `website/constellation.js`
- [Shortlist](https://github.com/cyberazy/webhacklist/blob/master/website/shortlist.js): `website/shortlist.js`
- [Saved state](https://github.com/cyberazy/webhacklist/blob/master/website/saved-state.js): `website/saved-state.js`
- [PDF reader](https://github.com/cyberazy/webhacklist/blob/master/website/pdf-reader.mjs): `website/pdf-reader.mjs`
- [Page templates](https://github.com/cyberazy/webhacklist/blob/master/website/build-pages.mjs): `website/build-pages.mjs`

### Document Preservation

- [Announcement PDFs](https://github.com/cyberazy/webhacklist/tree/master/original-listings): `original-listings`
- [PDF capture](https://github.com/cyberazy/webhacklist/blob/master/tools/capture_pdf.py): `tools/capture_pdf.py`

### Other components

- **Archive reader**

## Connections

- Archive reader → Archive interface: browses archive (evidence: `README.md`)
- Archive interface → Search and discovery: searches and filters (evidence: `README.md`)
- Archive interface → Annual collections: browses records (evidence: `README.md`)
- Archive interface → PDF reader: opens documents (evidence: `README.md`)
- PDF reader → Announcement PDFs: reads snapshots (evidence: `README.md`)
- Annual collections → Publishing registry: publishing registry (evidence: `README.md`)
- PDF capture → Announcement PDFs: captures snapshots (evidence: `README.md`)
