# redeifabbri/seratest architecture

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

- Interactive diagram: https://gitdiagram.com/redeifabbri/seratest
- Repository: https://github.com/redeifabbri/seratest

## Overview

##### Project Type and Purpose
- This is a static, content‐rich website (a “JAMstack”/static site) for the Collegium Seraphicum organization.
- No traditional backend or database—just HTML pages, CSS/JS assets, image and document files—all served statically.
- Continuous deployment via Netlify from the GitHub repo.

##### Key Parts of the File Structure
- Top level:
- HTML entry points (index.html, Rolunk.html, Galeria.html, etc.)
- package.json + node_modules (dev toolchain)
- x86_64-*-simple-http-server binaries for local testing
- src/
– documents/ (PDFs, DOCXs)
– pictures/ (galleries, logos)
– scripts/ (gallery logic, slideshows, navigation)
– style/ (layout-*.css, design.css)
– svg/
- README describes CSS split (layout vs. design) and page structure (header, navbar, content, footer).

##### Main Components
A. Developer Environment
- GitHub repo (source)
- Local dev server (simple-http-server binary invoked via runnner.js)
- Node/npm toolchain (linting, bundling if any)
B. CI/CD Pipeline
- Netlify build process (pulls from GitHub, runs any build scripts, publishes to CDN)
C. Static Hosting / CDN
- Netlify’s edge network (serving HTML, CSS, JS, assets globally)
D. End User (Browser)
- Requests HTML
- Loads CSS and JS
- Fetches images and documents as needed

##### Relationships and Data Flows
- Developer → (git push) → GitHub
- GitHub → (webhook) → Netlify Build
- Netlify Build → (deploy) → CDN / Static File Store
- Browser ↔ CDN (HTTP GET pages, assets)
- Optionally Browser ↔ Local Dev Server (during development)

##### Architectural Patterns & Principles
- JAMstack: Pre-built markup and assets delivered over CDN
- Single Responsibility: Each folder holds a specific asset type (scripts, style, pictures, documents)
- Separation of Concerns: CSS layout vs. design, JS classes vs. page logic

##### Technologies & Frameworks to Label
- HTML5 pages (no framework)
- Vanilla JS modules (gallery, slideshow, navigation)
- CSS (modular layout-*.css + design.css + color_swatch.css)
- Netlify (CI/CD + CDN)
- simple-http-server (local dev)
- GitHub (source repository)

##### Essentials to Capture
- Clear separation: Dev environment vs. CI/CD vs. Hosting vs. Client
- Asset types and their folders under one “Static Assets” component

## Diagram (Mermaid)

```mermaid
flowchart TD
    %% Developer Environment
    subgraph "Developer Environment"
        Developer["Developer"]:::actor
        GHRepo["GitHub Repository"]:::service
        subgraph "GitHub Repo Files"
            DotGitHub[".github/"]:::storage
            GitIgnore[".gitignore"]:::storage
        end
        NodeTool["Node/npm Toolchain"]:::toolchain
        subgraph "Toolchain Files"
            PackageJSON["package.json"]:::storage
            PackageLock["package-lock.json"]:::storage
            NodeModules["node_modules/"]:::storage
        end
        LocalDev["Local Dev Server"]:::service
        subgraph "Local Server Binaries"
            BinaryWin["x86_64-pc-windows-msvc-simple-http-server.exe"]:::storage
            BinaryLinux["x86_64-unknown-linux-musl-simple-http-server"]:::storage
            Runner["runnner.js"]:::storage
        end
    end

    %% CI/CD Pipeline
    subgraph "CI/CD Pipeline"
        Netlify["Netlify Build Service"]:::service
        subgraph "Build Output"
            HTMLFiles["Root HTML Files"]:::storage
        end
    end

    %% Hosting / CDN
    subgraph "Static Hosting / CDN"
        CDN["CDN / Static File Store"]:::storage
        subgraph "Static Assets"
            Style["src/style/"]:::storage
            Scripts["src/scripts/"]:::storage
            SVGs["src/svg/"]:::storage
            Pictures["src/pictures/"]:::storage
            Documents["src/documents/"]:::storage
            RootDoc["src/Szeráf_KÉSZ_velemjáró.pdf"]:::storage
        end
    end

    %% End User
    Browser["End User Browser"]:::client

    %% Relationships
    Developer -->|git push| GHRepo
    GHRepo -->|webhook trigger| Netlify
    Netlify -->|deploy static files| CDN
    Browser -->|HTTP GET HTML, CSS, JS| CDN
    CDN -->|serves assets| Browser
    Developer -->|runs| LocalDev
    Browser <-->|"HTTP GET (dev)"| LocalDev

    %% Click Events
    click DotGitHub "https://github.com/redeifabbri/seratest/tree/main/.github/"
    click GitIgnore "https://github.com/redeifabbri/seratest/blob/main/.gitignore"
    click PackageJSON "https://github.com/redeifabbri/seratest/blob/main/package.json"
    click PackageLock "https://github.com/redeifabbri/seratest/blob/main/package-lock.json"
    click NodeModules "https://github.com/redeifabbri/seratest/tree/main/node_modules/"
    click BinaryWin "https://github.com/redeifabbri/seratest/blob/main/x86_64-pc-windows-msvc-simple-http-server.exe"
    click BinaryLinux "https://github.com/redeifabbri/seratest/tree/main/x86_64-unknown-linux-musl-simple-http-server"
    click Runner "https://github.com/redeifabbri/seratest/blob/main/runnner.js"
    click HTMLFiles "https://github.com/redeifabbri/seratest/blob/main/index.html"
    click Style "https://github.com/redeifabbri/seratest/tree/main/src/style/"
    click Scripts "https://github.com/redeifabbri/seratest/tree/main/src/scripts/"
    click SVGs "https://github.com/redeifabbri/seratest/tree/main/src/svg/"
    click Pictures "https://github.com/redeifabbri/seratest/tree/main/src/pictures/"
    click Documents "https://github.com/redeifabbri/seratest/tree/main/src/documents/"
    click RootDoc "https://github.com/redeifabbri/seratest/blob/main/src/Szeráf_KÉSZ_velemjáró.pdf"

    %% Styles
    classDef actor fill:#a2d2ff,stroke:#000,color:#000;
    classDef service fill:#90e0ef,stroke:#000,color:#000;
    classDef storage fill:#ffb703,stroke:#000,color:#000;
    classDef client fill:#cdb4db,stroke:#000,color:#000;
    classDef toolchain fill:#bde0fe,stroke:#000,color:#000;
```
