# 1712n/dn-institute architecture

> Architecture diagram of the GitHub repository 1712n/dn-institute, generated by GitDiagram from its file tree, README and a sample of source files (last updated 2026-09-30). It is an AI-made overview: check details against the source.

- Interactive diagram: https://gitdiagram.com/1712n/dn-institute
- Repository: https://github.com/1712n/dn-institute

## Overview

This repository is a Hugo research and education site for the Distributed Networks Institute. Visitors browse research on cyberattack incidents and attack concepts, market-health analyses and metric documentation, and AI research; Hugo templates present that content, with JavaScript and CSS supporting interactive presentation. The README also describes the institute’s research and challenge program, but this tree does not show a challenge-management application. Source excerpts are limited, so presentation and content relationships are marked unverified rather than asserted as observed calls.

Main entry points: [`layouts`](https://github.com/1712n/dn-institute/tree/main/layouts) (Page layouts), [`content/_index.md`](https://github.com/1712n/dn-institute/blob/main/content/_index.md) (Home content), [`content/research/ai`](https://github.com/1712n/dn-institute/tree/main/content/research/ai) (AI research), [`content/research/cyberattacks/incidents`](https://github.com/1712n/dn-institute/tree/main/content/research/cyberattacks/incidents) (Incident archive)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_research["Research content"]
  node_home_content["Home content<br/>[_index.md]"]
  node_ai_research["AI research"]
  node_incident_archive["Incident archive"]
  node_attack_wiki["Attack wiki"]
  node_market_health["Market health"]
end

subgraph group_presentation["Site presentation"]
  node_site_layouts["Page layouts"]
  node_content_templates["Content templates"]
  node_site_partials["Shared partials"]
  node_shortcodes["Content shortcodes"]
  node_site_styles["Site styles"]
end

subgraph group_interactions["Interactive assets"]
  node_chart_script["Chart script<br/>[chart.js]"]
  node_widget_script["Widget script<br/>[widget.js]"]
  node_splide["Splide carousel<br/>[splide.js]"]
end

node_visitor(("Site visitor"))
node_hugo["Hugo site"]

node_visitor -.->|"browses site"| node_hugo
node_hugo -.->|"renders content"| node_home_content
node_hugo -.->|"renders content"| node_ai_research
node_hugo -.->|"renders content"| node_incident_archive
node_hugo -.->|"renders content"| node_attack_wiki
node_hugo -.->|"renders content"| node_market_health
node_hugo -.->|"uses layouts"| node_site_layouts
node_site_layouts -.->|"uses templates"| node_content_templates
node_site_layouts -.->|"uses partials"| node_site_partials
node_site_layouts -.->|"uses shortcodes"| node_shortcodes
node_site_layouts -.->|"uses styles"| node_site_styles
node_site_layouts -.->|"uses script"| node_chart_script
node_site_layouts -.->|"uses script"| node_widget_script
node_site_layouts -.->|"uses carousel"| node_splide

click node_home_content "https://github.com/1712n/dn-institute/blob/main/content/_index.md"
click node_ai_research "https://github.com/1712n/dn-institute/tree/main/content/research/ai"
click node_incident_archive "https://github.com/1712n/dn-institute/tree/main/content/research/cyberattacks/incidents"
click node_attack_wiki "https://github.com/1712n/dn-institute/tree/main/content/research/cyberattacks/wiki"
click node_market_health "https://github.com/1712n/dn-institute/tree/main/content/research/market-health"
click node_site_layouts "https://github.com/1712n/dn-institute/tree/main/layouts"
click node_content_templates "https://github.com/1712n/dn-institute/tree/main/layouts/_default"
click node_site_partials "https://github.com/1712n/dn-institute/tree/main/layouts/partials"
click node_shortcodes "https://github.com/1712n/dn-institute/tree/main/layouts/shortcodes"
click node_site_styles "https://github.com/1712n/dn-institute/tree/main/assets/css"
click node_chart_script "https://github.com/1712n/dn-institute/blob/main/assets/js/chart.js"
click node_widget_script "https://github.com/1712n/dn-institute/blob/main/assets/js/widget.js"
click node_splide "https://github.com/1712n/dn-institute/blob/main/static/js/splide.js"

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_home_content,node_ai_research,node_incident_archive,node_attack_wiki,node_market_health toneBlue
class node_site_layouts,node_content_templates,node_site_partials,node_shortcodes,node_site_styles toneAmber
class node_chart_script,node_widget_script,node_splide toneMint
class node_visitor,node_hugo toneIndigo
```

## Components

### Research content

- [Home content](https://github.com/1712n/dn-institute/blob/main/content/_index.md): `content/_index.md`
- [AI research](https://github.com/1712n/dn-institute/tree/main/content/research/ai): `content/research/ai`
- [Incident archive](https://github.com/1712n/dn-institute/tree/main/content/research/cyberattacks/incidents): `content/research/cyberattacks/incidents`
- [Attack wiki](https://github.com/1712n/dn-institute/tree/main/content/research/cyberattacks/wiki): `content/research/cyberattacks/wiki`
- [Market health](https://github.com/1712n/dn-institute/tree/main/content/research/market-health): `content/research/market-health`

### Site presentation

- [Page layouts](https://github.com/1712n/dn-institute/tree/main/layouts): `layouts`
- [Content templates](https://github.com/1712n/dn-institute/tree/main/layouts/_default): `layouts/_default`
- [Shared partials](https://github.com/1712n/dn-institute/tree/main/layouts/partials): `layouts/partials`
- [Content shortcodes](https://github.com/1712n/dn-institute/tree/main/layouts/shortcodes): `layouts/shortcodes`
- [Site styles](https://github.com/1712n/dn-institute/tree/main/assets/css): `assets/css`

### Interactive assets

- [Chart script](https://github.com/1712n/dn-institute/blob/main/assets/js/chart.js): `assets/js/chart.js`
- [Widget script](https://github.com/1712n/dn-institute/blob/main/assets/js/widget.js): `assets/js/widget.js`
- [Splide carousel](https://github.com/1712n/dn-institute/blob/main/static/js/splide.js): `static/js/splide.js`

### Other components

- **Site visitor**
- **Hugo site**

## Connections

- Site visitor → Hugo site: browses site
- Hugo site → Home content: renders content
- Hugo site → AI research: renders content
- Hugo site → Incident archive: renders content
- Hugo site → Attack wiki: renders content
- Hugo site → Market health: renders content
- Hugo site → Page layouts: uses layouts
- Page layouts → Content templates: uses templates
- Page layouts → Shared partials: uses partials
- Page layouts → Content shortcodes: uses shortcodes
- Page layouts → Site styles: uses styles
- Page layouts → Chart script: uses script
- Page layouts → Widget script: uses script
- Page layouts → Splide carousel: uses carousel