# viccode88/fssa_web architecture

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

- Interactive diagram: https://gitdiagram.com/viccode88/fssa_web
- Repository: https://github.com/viccode88/fssa_web

## Overview

##### Project type and purpose
- From the README (“國立鳳山高級中學學生會網站”) and the file tree (all `.html`, `.css`, `.js`, and static config files), this is a purely static website for a high-school student council. There is no backend code or database—only client‐side assets and hosting artifacts.

##### File structure
- Top level files:
- `.html` pages: index.html, about.html, contact.html, departments.html, events.html, documents.html
- Styles: style.css, about.css, contact.css, departments.css, events.css
- Script: script.js
- SEO/host config: robots.txt, sitemap.xml, webmap.xml, google…html
- `_headers`: likely used if deployed to a static host that supports custom headers (e.g. Netlify)
- No `src` or `backend` folders—this confirms a front-end only project.

##### Key insights from the README
- The site is maintained by successive student groups.
- No mention of dynamic features, databases, or API endpoints.

a. Main components
- User’s Browser (Client)
- Static File Host/CDN (e.g. GitHub Pages, Netlify, AWS S3 + CloudFront)
- Static Assets: HTML, CSS, JavaScript
- External Service(s): Google site-verification / Analytics (googlee9732a20410aa1a1.html)
b. Relationships and interactions
- Browser requests `index.html` (or other pages) from the Static Host
- Host serves HTML, CSS, JS directly (optionally via CDN caching)
- script.js may make in-page DOM updates or call external analytics
- Browser loads external service snippet (Google analytics)
c. Architectural patterns / design principles
- Presentation layer only—no application server or database
- CDN + static-site hosting for simplicity, scalability, and low maintenance
- Separation of concerns: one CSS per page for modular styles, central `style.css` for shared styling
d. Technologies & frameworks
- Plain HTML5 + CSS3 + vanilla JavaScript
- Static-site hosting (GitHub Pages / Netlify / AWS S3, etc.)
- External analytics/verification via Google

##### Elements
- Clear labels: e.g. “User Browser,” “Static File Host/CDN,” “Git Repository (source),” “External Analytics”

## Diagram (Mermaid)

```mermaid
graph TD
    %% Infrastructure Layer
    subgraph "Git Repository (Source)" 
        GitRepo["README.md"]:::assets
    end

    CICD["CI/CD Pipeline"]:::infra
    Host["Static File Host / CDN"]:::infra

    %% Static Assets grouped under Host
    subgraph "Static Assets" 
        subgraph "HTML Pages"
            Index["index.html"]:::assets
            About["about.html"]:::assets
            Contact["contact.html"]:::assets
            Departments["departments.html"]:::assets
            Events["events.html"]:::assets
            Documents["documents.html"]:::assets
        end

        subgraph "Stylesheets"
            SharedCSS["style.css"]:::assets
            AboutCSS["about.css"]:::assets
            ContactCSS["contact.css"]:::assets
            DepartmentsCSS["departments.css"]:::assets
            EventsCSS["events.css"]:::assets
        end

        subgraph "JavaScript"
            Script["script.js"]:::assets
        end

        subgraph "SEO & Host Config"
            Headers["_headers"]:::assets
            Robots["robots.txt"]:::assets
            Sitemap["sitemap.xml"]:::assets
            Webmap["webmap.xml"]:::assets
        end

        Verification["googlee9732a20410aa1a1.html"]:::external
    end

    %% Client Layer
    Browser["User Browser"]:::client

    %% External Services
    Analytics["Google Analytics"]:::external

    %% Connections
    GitRepo -->|triggers commit| CICD
    CICD -->|deploy static assets| Host
    Host -->|HTTP GET| Browser
    Browser -->|loads assets| Index
    Browser -->|loads assets| SharedCSS
    Browser -->|executes| Script
    Browser -->|loads analytics snippet| Verification
    Browser -->|sends data| Analytics

    %% Click Events
    click Index "https://github.com/viccode88/fssa_web/blob/main/index.html"
    click About "https://github.com/viccode88/fssa_web/blob/main/about.html"
    click Contact "https://github.com/viccode88/fssa_web/blob/main/contact.html"
    click Departments "https://github.com/viccode88/fssa_web/blob/main/departments.html"
    click Events "https://github.com/viccode88/fssa_web/blob/main/events.html"
    click Documents "https://github.com/viccode88/fssa_web/blob/main/documents.html"
    click SharedCSS "https://github.com/viccode88/fssa_web/blob/main/style.css"
    click AboutCSS "https://github.com/viccode88/fssa_web/blob/main/about.css"
    click ContactCSS "https://github.com/viccode88/fssa_web/blob/main/contact.css"
    click DepartmentsCSS "https://github.com/viccode88/fssa_web/blob/main/departments.css"
    click EventsCSS "https://github.com/viccode88/fssa_web/blob/main/events.css"
    click Script "https://github.com/viccode88/fssa_web/blob/main/script.js"
    click Headers "https://github.com/viccode88/fssa_web/tree/main/_headers"
    click Robots "https://github.com/viccode88/fssa_web/blob/main/robots.txt"
    click Sitemap "https://github.com/viccode88/fssa_web/blob/main/sitemap.xml"
    click Webmap "https://github.com/viccode88/fssa_web/blob/main/webmap.xml"
    click Verification "https://github.com/viccode88/fssa_web/blob/main/googlee9732a20410aa1a1.html"
    click GitRepo "https://github.com/viccode88/fssa_web/blob/main/README.md"

    %% Styles
    classDef infra fill:#fde293,stroke:#333,stroke-width:1px
    classDef client fill:#9fd3c7,stroke:#333,stroke-width:1px
    classDef assets fill:#a3d2ca,stroke:#333,stroke-width:1px
    classDef external fill:#e5989b,stroke:#333,stroke-width:1px
```
