# enactusftuhanoi/yearbook architecture

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

- Interactive diagram: https://gitdiagram.com/enactusftuhanoi/yearbook
- Repository: https://github.com/enactusftuhanoi/yearbook

## Overview

##### Project type and purpose
- This is a static web-based “yearbook” site (an open-source, content-driven project).
- Purpose: serve HTML pages (index.html, yearbook.html) enriched with images, audio, and video to showcase the Enactus FTU Hanoi community.

##### File structure
- Top-level assets:
- index.html, yearbook.html – main entry points
- media files (audio.mp3, video.mp4)
- (README points to `assets/` for logos, though your provided tree is flattened)
- No backend code or server components—purely static.

##### README for additional insights
- Deployment likely via GitHub Pages or any static-site host.
- Contributors update content by forking, branching, and pull-request, implying a simple CI/CD pipeline (optional).

a. Main components
1. Developer Workstation (contributors)
2. Version Control (GitHub repo)
3. CI/CD Pipeline (optional: GitHub Actions or another)
4. Static Site Host (e.g., GitHub Pages, Netlify, Vercel)
5. End-User Browser
6. External Services (optional analytics, CDN for assets/media)
b. Relationships & data flow
- Developers → push code/content → GitHub
- GitHub triggers CI/CD → builds/deploys static assets → Host
- End-User Browser ↔ Host (HTTP GET index.html, yearbook.html, fetch assets & media)
- Browser may pull assets/media from CDN (if configured)
c. Architectural patterns/design principles
- Static site architecture (no server-side logic)
- Content-driven, declarative HTML pages
- Git-centric collaboration & deployment
d. Key technologies/frameworks
- HTML/CSS (no JS frameworks shown)
- Static hosting (GitHub Pages, Netlify, etc.)
- GitHub for version control and CI (GitHub Actions)
- Optional CDN for media

##### Detail and granularity
- How new media files flow through the pipeline (developer adds to `media/` → GitHub → deploy → CDN).

## Diagram (Mermaid)

```mermaid
flowchart TD
    %% Development Layer
    subgraph "Development Environment"
        Developer["Developer Workstation"]:::dev
        GitHub["GitHub Repository"]:::dev
        subgraph "Repository Contents"
            INDEX["index.html"]:::file
            YEARBOOK["yearbook.html"]:::file
            AUDIO["audio.mp3"]:::file
            VIDEO["video.mp4"]:::file
            README["README.md"]:::file
        end
    end

    %% Deployment Layer
    subgraph "CI/CD & Hosting"
        CI["CI/CD Pipeline (GitHub Actions)"]:::deploy
        Host["Static Site Host (GitHub Pages/Netlify)"]:::deploy
    end

    %% Runtime Layer
    subgraph "User & External Services"
        Browser["End-User Browser"]:::runtime
        CDN["Media CDN"]:::storage
        Analytics["Analytics Service"]:::external
    end

    %% Relationships
    Developer -->|"git push"| GitHub
    GitHub -->|"trigger CI"| CI
    CI -->|"build & deploy"| Host
    Host -->|"HTTP GET/200 OK"| Browser
    Browser -->|"fetch media"| CDN
    Browser -->|"load analytics snippet"| Analytics

    %% Click Events
    click INDEX "https://github.com/enactusftuhanoi/yearbook/blob/main/index.html"
    click YEARBOOK "https://github.com/enactusftuhanoi/yearbook/blob/main/yearbook.html"
    click AUDIO "https://github.com/enactusftuhanoi/yearbook/blob/main/audio.mp3"
    click VIDEO "https://github.com/enactusftuhanoi/yearbook/blob/main/video.mp4"
    click README "https://github.com/enactusftuhanoi/yearbook/blob/main/README.md"

    %% Styles
    classDef dev fill:#ADD8E6,stroke:#333,stroke-width:1px
    classDef deploy fill:#90EE90,stroke:#333,stroke-width:1px
    classDef runtime fill:#FFA500,stroke:#333,stroke-width:1px
    classDef storage fill:#FFD700,stroke:#333,stroke-width:1px
    classDef external fill:#D3D3D3,stroke:#333,stroke-width:1px
    classDef file fill:#FFFFFF,stroke:#333,stroke-width:1px,font-style:italic
```
