# avnishsinha/ecowattch architecture

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

- Interactive diagram: https://gitdiagram.com/avnishsinha/ecowattch
- Repository: https://github.com/avnishsinha/ecowattch

## Overview

##### Project type and purpose
- ecoWattch is a static “brochure-style” website for a CS capstone project. There is no dynamic backend or database—just HTML pages and assets hosted on the NAU CES Share Servers.

##### File structure
- Top-level files: LICENSE, README.md, two PDFs (Requirement Specification, Technological Feasibility).
- HTML pages: index.html (home), about.html, archive.html, demo.html, team.html, timeline.html.
- Static assets folder: img/ (images used by the pages).

##### README for additional insights
- Confirms that this is version 1.0.1 of a static website, with future enhancements planned (UX refinements, performance).
- No mention of a server-side component or API—pure front end.

a. Client Browser
b. Static Web Server (NAU CES Share Servers)
c. Static Assets Storage (HTML files, img folder, PDF docs)
d. External Links/Services (GitHub repo, MIT License URL)

##### Relationships and interactions
- Client sends HTTP GET requests to the Web Server
- Server responds with HTML, images, PDFs
- Client renders pages, follows external links to GitHub or MIT license page
- (Future) potential enhancements: separate CSS/JS hosting, analytics service

##### Architectural pattern and design principles
- Static-site architecture—no application server or database
- Separation of concerns:
- Content (HTML)
- Assets (images, docs)
- Metadata (README, license)
- Can be extended later with a JAMstack approach (e.g., add client-side JS, CDN, headless CMS)

##### Technologies & frameworks
- Core: HTML5, potentially CSS/JS (not yet in tree)
- Hosting: NAU CES Share Static Hosting
- Version control: GitHub
- Documentation: PDF requirement/feasibility analyses

##### Essential elements
- Clear labels on each component (Browser, Web Server, Assets, External Links)

## Diagram (Mermaid)

```mermaid
flowchart TB
    %% Client
    Browser(("Browser")):::client

    %% Static Server and Assets
    subgraph "Static Web Server"
        direction TB
        subgraph "HTML Pages"
            direction TB
            index["index.html"]:::server
            about["about.html"]:::server
            archive["archive.html"]:::server
            demo["demo.html"]:::server
            team["team.html"]:::server
            timeline["timeline.html"]:::server
        end
        subgraph "Images"
            direction TB
            img["img/"]:::server
        end
        subgraph "Documents"
            direction TB
            req["Requirement Specification Document.pdf"]:::server
            tech["Technological Feasibility Analysis.pdf"]:::server
        end
    end

    %% External Services
    subgraph "External Services"
        direction TB
        GitHub{{"GitHub Repository"}}:::external
        License{{"MIT License"}}:::external
        README["README.md"]:::external
    end

    %% Data Flows
    Browser -->|"GET /index.html"| index
    Browser -->|"GET /about.html"| about
    Browser -->|"GET /archive.html"| archive
    Browser -->|"GET /demo.html"| demo
    Browser -->|"GET /team.html"| team
    Browser -->|"GET /timeline.html"| timeline
    Browser -->|"GET assets"| img
    Browser -->|"GET docs"| req
    Browser -->|"GET docs"| tech

    index -->|"200 OK + HTML"| Browser
    about -->|"200 OK + HTML"| Browser
    archive -->|"200 OK + HTML"| Browser
    demo -->|"200 OK + HTML"| Browser
    team -->|"200 OK + HTML"| Browser
    timeline -->|"200 OK + HTML"| Browser
    img -->|"200 OK + Images"| Browser
    req -->|"200 OK + PDF"| Browser
    tech -->|"200 OK + PDF"| Browser

    Browser -->|"Navigate"| GitHub
    Browser -->|"Navigate"| License
    GitHub -->|"Contains README"| README

    %% Click Events
    click index "https://github.com/avnishsinha/ecowattch/blob/main/index.html"
    click about "https://github.com/avnishsinha/ecowattch/blob/main/about.html"
    click archive "https://github.com/avnishsinha/ecowattch/blob/main/archive.html"
    click demo "https://github.com/avnishsinha/ecowattch/blob/main/demo.html"
    click team "https://github.com/avnishsinha/ecowattch/blob/main/team.html"
    click timeline "https://github.com/avnishsinha/ecowattch/blob/main/timeline.html"
    click img "https://github.com/avnishsinha/ecowattch/tree/main/img/"
    click req "https://github.com/avnishsinha/ecowattch/blob/main/Requirement Specification Document.pdf"
    click tech "https://github.com/avnishsinha/ecowattch/blob/main/Technological Feasibility Analysis.pdf"
    click README "https://github.com/avnishsinha/ecowattch/blob/main/README.md"
    click License "https://github.com/avnishsinha/ecowattch/tree/main/LICENSE"

    %% Styles
    classDef client fill:#ADD8E6,stroke:#000,stroke-width:1px;
    classDef server fill:#D3D3C0,stroke:#000,stroke-width:1px;
    classDef external fill:#90EE90,stroke:#000,stroke-width:1px;
```
