# ctechfilmuniversity/lecture_ss23_procedural_generation_and_simulation architecture

> Architecture diagram of the GitHub repository ctechfilmuniversity/lecture_ss23_procedural_generation_and_simulation, generated by GitDiagram from its file tree, README and a sample of source files (last updated 2025-05-13). It is an AI-made overview: check details against the source.

- Interactive diagram: https://gitdiagram.com/ctechfilmuniversity/lecture_ss23_procedural_generation_and_simulation
- Repository: https://github.com/ctechfilmuniversity/lecture_ss23_procedural_generation_and_simulation

## Overview

##### Project type and purpose
- This is a static-site repository for a university course (“Procedural Generation and Simulation”). It holds lecture materials (slides, scripts, session notes) under `docs/` and student assignment deliverables under `assignments/`. It publishes via GitHub Pages (see `_config.yml` in `docs/`).

##### File structure
- Top-level:
- README.md & errata.md – high-level pointers
- `assignments/` – per-student folders, each containing subfolders for individual assignment deliveries (HTML, CSS, JS, shaders, media, Cargo/Rust demos, etc.)
- `docs/` – Jekyll source:
– `01_sessions/`, `02_scripts/`, `03_slides/` – markdown, HTML, images grouped by lecture
– `_config.yml`, `index.md` – site configuration and entry point
- There are no backend services or dynamic code—this is purely a content repo plus static-site generator.

##### README for additional insights
- The README URL points to the published site: a Jekyll-powered GitHub Pages site that renders all markdown, HTML, images, code snippets, and student projects.

##### Elements
- “git push” from Content Repo → Jekyll Generator
- “build” from Jekyll Generator → GitHub Pages
- “serve” from GitHub Pages → Browser Clients
- Source files (Markdown, assets)
- Build process (Jekyll)
- Hosting service
- Runtime environment (web browser)
- Optionally, annotate external dependencies (e.g., remark.js CDN).

##### Be very detailed
- That assets (images, videos, shaders) flow directly into the static site.
- Development vs. production paths if necessary (e.g., local `jekyll serve` for preview).

## Diagram (Mermaid)

```mermaid
flowchart TB
    %% Content Authoring Layer
    subgraph "Content Authoring Layer"
        direction TB
        docs01["docs/01_sessions/"]:::content
        docs02["docs/02_scripts/"]:::content
        docs03["docs/03_slides/"]:::content
        docsIndex["docs/index.md"]:::content
        assignments["assignments/"]:::content
    end

    %% Static Site Generator
    Jekyll["Jekyll Generator\n(docs/_config.yml)"]:::build

    %% External Dependency for Slides
    remark["remark.js CDN\n(docs/03_slides/remark/)"]:::external

    %% Hosting Layer
    GitHubPages["GitHub Pages Hosting"]:::hosting

    %% Runtime Layer
    Browser["Browser Clients"]:::runtime

    %% Student Demos Details
    subgraph "Student Demos" 
        direction TB
        subgraph "WebGL Shader Demos"
            direction TB
            angelovaBrick["brick_angelova.frag"]:::content
            angelovaExp["experiments_angelova.frag"]:::content
            aviramBrick["brick_aviram.frag"]:::content
            aviramExp["experiments_aviram.frag"]:::content
        end
        rustDemo["Rust/Cargo Fluid Simulation"]:::content
    end

    %% Relationships
    docs01 -->|sources| Jekyll
    docs02 -->|sources| Jekyll
    docs03 -->|sources| Jekyll
    docsIndex -->|sources| Jekyll
    assignments -->|includes demos| Jekyll
    remark -->|dependency| Jekyll

    Jekyll -->|deploy| GitHubPages
    GitHubPages -->|serve over HTTPS| Browser

    assignments -->|contains| angelovaBrick
    assignments -->|contains| angelovaExp
    assignments -->|contains| aviramBrick
    assignments -->|contains| aviramExp
    assignments -->|contains| rustDemo

    %% Click Events
    click docs01 "https://github.com/ctechfilmuniversity/lecture_ss23_procedural_generation_and_simulation/tree/main/docs/01_sessions/"
    click docs02 "https://github.com/ctechfilmuniversity/lecture_ss23_procedural_generation_and_simulation/tree/main/docs/02_scripts/"
    click docs03 "https://github.com/ctechfilmuniversity/lecture_ss23_procedural_generation_and_simulation/tree/main/docs/03_slides/"
    click docsIndex "https://github.com/ctechfilmuniversity/lecture_ss23_procedural_generation_and_simulation/blob/main/docs/index.md"
    click Jekyll "https://github.com/ctechfilmuniversity/lecture_ss23_procedural_generation_and_simulation/blob/main/docs/_config.yml"
    click remark "https://github.com/ctechfilmuniversity/lecture_ss23_procedural_generation_and_simulation/tree/main/docs/03_slides/remark/"
    click assignments "https://github.com/ctechfilmuniversity/lecture_ss23_procedural_generation_and_simulation/tree/main/assignments/"
    click angelovaBrick "https://github.com/ctechfilmuniversity/lecture_ss23_procedural_generation_and_simulation/blob/main/assignments/angelova/03/brick_angelova.frag"
    click angelovaExp "https://github.com/ctechfilmuniversity/lecture_ss23_procedural_generation_and_simulation/blob/main/assignments/angelova/03/experiments_angelova.frag"
    click aviramBrick "https://github.com/ctechfilmuniversity/lecture_ss23_procedural_generation_and_simulation/blob/main/assignments/aviram/03-04/brick_aviram.frag"
    click aviramExp "https://github.com/ctechfilmuniversity/lecture_ss23_procedural_generation_and_simulation/blob/main/assignments/aviram/03-04/experiments_aviram.frag"
    click rustDemo "https://github.com/ctechfilmuniversity/lecture_ss23_procedural_generation_and_simulation/tree/main/assignments/passing/09/fluid-simulation/"

    %% Styles
    classDef content fill:#e0f7fa,stroke:#00838f,color:#004d40
    classDef build fill:#fff9c4,stroke:#f9a825,color:#bf360c
    classDef hosting fill:#c8e6c9,stroke:#388e3c,color:#1b5e20
    classDef runtime fill:#ffe0b2,stroke:#fb8c00,color:#e65100
    classDef external fill:#d1c4e9,stroke:#6a1b9a,color:#311b92
```
