# atlab-rocket/atlab architecture

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

## Overview

ATLab is a static website for a university aeronautics lab, presenting its rocket projects, technical teams, and ways to join or sponsor the lab. The documented authoring workflow is to edit JSON content or HTML templates, run the Python builder, then publish the generated home, sponsor, and team pages; visitors read those static pages directly. The builder also validates page links and local resources. The README identifies page-specific JavaScript and CSS, but their implementation was not sampled, so their internal connections are omitted.

Main entry points: [`scripts/build.py`](https://github.com/atlab-rocket/atlab/blob/main/scripts/build.py) (Static page builder), [`src/data`](https://github.com/atlab-rocket/atlab/tree/main/src/data) (Site and page data), [`src/templates/home`](https://github.com/atlab-rocket/atlab/tree/main/src/templates/home) (Home templates), [`src/templates/items`](https://github.com/atlab-rocket/atlab/tree/main/src/templates/items) (List item templates)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_content["Content sources"]
  node_content_data["Site and page data"]
  node_home_templates["Home templates"]
  node_item_templates["List item templates"]
  node_detail_templates["Sponsor and team templates"]
end

subgraph group_generation["Page generation"]
  node_builder["Static page builder<br/>[build.py]"]
end

subgraph group_published["Published pages"]
  node_home_page["Home page<br/>[index.html]"]
  node_sponsor_page["Sponsor page<br/>[index.html]"]
  node_team_pages["Technical team pages"]
end

subgraph group_resources["Browser resources"]
  node_styles["Page styles"]
  node_interactions["Browser interactions"]
  node_images["Site images"]
end

node_editor(("Site editor"))
node_visitor(("Site visitor"))

node_editor -->|"edits content"| node_content_data
node_editor -->|"edits layout"| node_home_templates
node_editor -->|"edits items"| node_item_templates
node_editor -->|"edits pages"| node_detail_templates
node_builder -->|"reads data"| node_content_data
node_builder -->|"renders"| node_home_templates
node_builder -->|"renders"| node_item_templates
node_builder -->|"renders"| node_detail_templates
node_builder -->|"writes page"| node_home_page
node_builder -->|"writes page"| node_sponsor_page
node_builder -->|"writes pages"| node_team_pages
node_visitor -->|"reads page"| node_home_page
node_visitor -->|"reads page"| node_sponsor_page
node_visitor -->|"reads pages"| node_team_pages

click node_content_data "https://github.com/atlab-rocket/atlab/tree/main/src/data"
click node_home_templates "https://github.com/atlab-rocket/atlab/tree/main/src/templates/home"
click node_item_templates "https://github.com/atlab-rocket/atlab/tree/main/src/templates/items"
click node_detail_templates "https://github.com/atlab-rocket/atlab/tree/main/src/templates/pages"
click node_builder "https://github.com/atlab-rocket/atlab/blob/main/scripts/build.py"
click node_home_page "https://github.com/atlab-rocket/atlab/blob/main/index.html"
click node_sponsor_page "https://github.com/atlab-rocket/atlab/blob/main/sponsor/index.html"
click node_team_pages "https://github.com/atlab-rocket/atlab/tree/main/teams"
click node_styles "https://github.com/atlab-rocket/atlab/tree/main/assets/css"
click node_interactions "https://github.com/atlab-rocket/atlab/tree/main/assets/js"
click node_images "https://github.com/atlab-rocket/atlab/tree/main/assets/images"

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_content_data,node_home_templates,node_item_templates,node_detail_templates toneBlue
class node_builder toneAmber
class node_home_page,node_sponsor_page,node_team_pages toneMint
class node_styles,node_interactions,node_images toneRose
class node_editor,node_visitor toneIndigo
```

## Components

### Content sources

- [Site and page data](https://github.com/atlab-rocket/atlab/tree/main/src/data): `src/data`
- [Home templates](https://github.com/atlab-rocket/atlab/tree/main/src/templates/home): `src/templates/home`
- [List item templates](https://github.com/atlab-rocket/atlab/tree/main/src/templates/items): `src/templates/items`
- [Sponsor and team templates](https://github.com/atlab-rocket/atlab/tree/main/src/templates/pages): `src/templates/pages`

### Page generation

- [Static page builder](https://github.com/atlab-rocket/atlab/blob/main/scripts/build.py): `scripts/build.py`

### Published pages

- [Home page](https://github.com/atlab-rocket/atlab/blob/main/index.html): `index.html`
- [Sponsor page](https://github.com/atlab-rocket/atlab/blob/main/sponsor/index.html): `sponsor/index.html`
- [Technical team pages](https://github.com/atlab-rocket/atlab/tree/main/teams): `teams`

### Browser resources

- [Page styles](https://github.com/atlab-rocket/atlab/tree/main/assets/css): `assets/css`
- [Browser interactions](https://github.com/atlab-rocket/atlab/tree/main/assets/js): `assets/js`
- [Site images](https://github.com/atlab-rocket/atlab/tree/main/assets/images): `assets/images`

### Other components

- **Site editor**
- **Site visitor**

## Connections

- Site editor → Site and page data: edits content (evidence: `README.md`)
- Site editor → Home templates: edits layout (evidence: `README.md`)
- Site editor → List item templates: edits items (evidence: `README.md`)
- Site editor → Sponsor and team templates: edits pages (evidence: `README.md`)
- Static page builder → Site and page data: reads data (evidence: `scripts/build.py`)
- Static page builder → Home templates: renders (evidence: `scripts/build.py`)
- Static page builder → List item templates: renders (evidence: `scripts/build.py`)
- Static page builder → Sponsor and team templates: renders (evidence: `scripts/build.py`)
- Static page builder → Home page: writes page (evidence: `scripts/build.py`)
- Static page builder → Sponsor page: writes page (evidence: `scripts/build.py`)
- Static page builder → Technical team pages: writes pages (evidence: `scripts/build.py`)
- Site visitor → Home page: reads page (evidence: `README.md`)
- Site visitor → Sponsor page: reads page (evidence: `README.md`)
- Site visitor → Technical team pages: reads pages (evidence: `README.md`)
