# wahidsaidmaroc/devopssitewebhtml architecture

> Architecture diagram of the GitHub repository wahidsaidmaroc/devopssitewebhtml, 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/wahidsaidmaroc/devopssitewebhtml
- Repository: https://github.com/wahidsaidmaroc/devopssitewebhtml

## Overview

##### Project type and purpose
- This is a simple static HTML website (“DevOps SiteWeb HTML Simple”) consisting of a handful of HTML pages and a GitHub Actions workflow for CI/CD to Azure Static Web Apps.
- No backend services or databases live in this codebase—its sole function is to publish and host static content.

##### File structure
- Top-level HTML files: index.html, contact.html, mesprojets.html, MyEvent.html → these are the pages the site serves.
- .github/workflows/azure-static-web-apps-…yml → GitHub Actions pipeline definition for building/deploying to Azure Static Web Apps.
- README.md → project description: a simple DevOps workflow for a static site.

##### README for additional insights
- Confirms it’s a “DevOps SiteWeb HTML Simple” project.
- No mention of databases, APIs, or build processes beyond the static-site CI/CD.

a. Main components
- Developer workstation / Git client
- GitHub repository (with code + workflow YAML)
- GitHub Actions runner (CI/CD)
- Azure Static Web Apps service (hosting + global CDN)
- End users’ browsers
- (Optional) Custom domain / DNS layer
b. Relationships and interactions
1. Developer pushes commits to GitHub
2. GitHub Actions workflow is triggered
3. Runner packages static files and calls Azure Static Web Apps deployment API
4. Azure hosts files behind a CDN edge network
5. End users request pages; served from nearest CDN edge
c. Architectural patterns and design principles
- GitOps: infrastructure and deploy logic live in Git repo
- CI/CD pipeline: automated build → test (none here) → deploy
- CDN-backed static hosting: high availability, low latency, zero-backend overhead
d. Key technologies/frameworks
- HTML/CSS (static files)
- GitHub Actions (pipeline orchestration)
- Azure Static Web Apps (hosting + CDN)
- YAML (workflow configuration)

## Diagram (Mermaid)

```mermaid
flowchart TD
    %% Developer
    subgraph "Developer Environment"
        Dev["Developer Workstation"]:::dev
    end

    %% Source Control
    subgraph "GitHub (Source of Truth)"
        Repo["GitHub Repository"]:::repo
        Docs["README.md"]:::docs
        Workflow["CI/CD Pipeline Definition"]:::pipeline
        subgraph "Static Site Content"
            index["index.html"]:::content
            contact["contact.html"]:::content
            mesprojets["mesprojets.html"]:::content
            MyEvent["MyEvent.html"]:::content
        end
    end

    %% CI/CD
    subgraph "CI/CD Pipeline"
        Runner["GitHub Actions Runner"]:::pipeline
    end

    %% Hosting
    subgraph "Azure Static Web Apps"
        StaticHost["Static Web Apps Service"]:::azure
        CDN["Global CDN"]:::cdn
    end

    %% DNS
    DNS["Custom Domain / DNS"]:::dns

    %% End Users
    subgraph "End Users"
        Browser["End User Browser"]:::user
    end

    %% Connections
    Dev -->|git push| Repo
    Repo -->|triggers workflow| Runner
    Runner -->|deploy via SWA API| StaticHost
    StaticHost -->|serves content| CDN
    DNS -->|resolves domain| CDN
    CDN -->|HTTP GET| Browser

    %% Click Events
    click Repo "https://github.com/wahidsaidmaroc/devopssitewebhtml/tree/main//"
    click index "https://github.com/wahidsaidmaroc/devopssitewebhtml/blob/main/index.html"
    click contact "https://github.com/wahidsaidmaroc/devopssitewebhtml/blob/main/contact.html"
    click mesprojets "https://github.com/wahidsaidmaroc/devopssitewebhtml/blob/main/mesprojets.html"
    click MyEvent "https://github.com/wahidsaidmaroc/devopssitewebhtml/blob/main/MyEvent.html"
    click Workflow "https://github.com/wahidsaidmaroc/devopssitewebhtml/blob/main/.github/workflows/azure-static-web-apps-black-dune-084b15210.yml"
    click Docs "https://github.com/wahidsaidmaroc/devopssitewebhtml/blob/main/README.md"

    %% Styles
    classDef dev fill:#D0E1F9,stroke:#2B6CB0;
    classDef repo fill:#EBF8FF,stroke:#2C5282;
    classDef pipeline fill:#F0FFF4,stroke:#2F855A;
    classDef azure fill:#E0F7FA,stroke:#0288D1;
    classDef cdn fill:#E1E2E1,stroke:#4A5568;
    classDef dns fill:#FAF0E6,stroke:#DD6B20;
    classDef user fill:#FFF5F5,stroke:#C53030;
    classDef docs fill:#FFF8DC,stroke:#B7791F;
    classDef content fill:#FFFAF0,stroke:#D69E2E;
```
