# waledroid/daq_numerique_2025 architecture

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

- Interactive diagram: https://gitdiagram.com/waledroid/daq_numerique_2025
- Repository: https://github.com/waledroid/daq_numerique_2025

## Overview

##### Site_Web_CodaQ – A static website that includes assets, custom CSS, and HTML.
3. hivegames-frontend – A more complex, single‑page application (SPA) built with modern JavaScript (using React, JSX components, Vite as a bundler, and likely npm dependencies) which includes a service layer (api.js) to handle external or backend interactions.
4. portfolio – A website meant for presenting your CV and projects, organized with its own assets and content pages.

##### And Isolate the Main Components
- If the portfolio website serves as a hub linking to these subprojects, include a top‑level “Portfolio Hub” that centrally connects to the other projects.

- For hivegames-frontend:
- React SPA nature by explicitly including components (Navbar, Footer, GameCard, GameList, and various pages like HomePage, LoginPage, etc.).
- That it uses Vite as a build tool, and there is a clear separation between the “src” (application logic and UI components) and “public” (static assets) directories.
- A “Services/API” component that suggests communication with external back-end services or data sources.
- For the portfolio section: Mark it as a web presentation layer that likely links out to or showcases the mini‑applications.

##### Relationships and Data Flow
- Client–side data flow: for static apps, one can simply show a user’s browser accessing the HTML/JS/CSS, whereas the React app may have more interactive and asynchronous flows.

##### Architectural Patterns or Design Principles
- For hivegames-frontend, mention the component-based architecture—a key characteristic of React applications.
- Use a separation-of-concerns principle by making sure that each mini-application is depicted as an isolated layer with its frontend technologies (and backend, if applicable).
- If the portfolio page acts as an aggregator, reflect that with a clear separation between the “presentation layer” (portfolio index) and the “application layers” (each mini‑app).

## Diagram (Mermaid)

```mermaid
graph TD
    %% Global Components
    PHub["Portfolio Hub (CV/Projects)"]:::portfolio
    Calc["Calculatrice (Static HTML/CSS/JS)"]:::static
    CodaQ["Site_Web_CodaQ (Static Website)"]:::static
    Hivegames["hivegames-frontend (React SPA)"]:::spa
    Portfolio["Portfolio (CV/Projects Website)"]:::portfolio

    %% High-level Relationships
    PHub -->|"navigates to"| Calc
    PHub -->|"navigates to"| CodaQ
    PHub -->|"navigates to"| Hivegames
    PHub -->|"navigates to"| Portfolio

    %% hivegames-frontend internal structure
    subgraph "hivegames-frontend Details"
        H_Main["Main App (index.html, package.json, vite.config.js)"]:::spa
        H_Components["UI Components (Navbar,Footer,GameCard,GameList)"]:::spa
        H_Pages["Pages (HomePage,LoginPage,RegisterPage,GameDetail)"]:::spa
        H_Services["Service Layer (api.js)"]:::spa
        Backend["Backend Service/API Endpoint"]:::backend
    end

    %% Connections inside hivegames-frontend
    Hivegames -->|"initializes"| H_Main
    H_Main -->|"renders"| H_Components
    H_Main -->|"routes to"| H_Pages
    H_Main -->|"invokes"| H_Services
    H_Services -->|"calls"| Backend

    %% Click Events
    click Calc "https://github.com/waledroid/daq_numerique_2025/tree/main/Calculatrice/"
    click CodaQ "https://github.com/waledroid/daq_numerique_2025/tree/main/Site_Web_CodaQ/"
    click Hivegames "https://github.com/waledroid/daq_numerique_2025/tree/main/hivegames-frontend/"
    click H_Main "https://github.com/waledroid/daq_numerique_2025/tree/main/hivegames-frontend/"
    click H_Components "https://github.com/waledroid/daq_numerique_2025/tree/main/hivegames-frontend/src/components/"
    click H_Pages "https://github.com/waledroid/daq_numerique_2025/tree/main/hivegames-frontend/src/pages/"
    click H_Services "https://github.com/waledroid/daq_numerique_2025/blob/main/hivegames-frontend/src/services/api.js"
    click Portfolio "https://github.com/waledroid/daq_numerique_2025/tree/main/portfolio/"

    %% Style Definitions
    classDef static fill:#f9e79f,stroke:#873600,stroke-width:2px;
    classDef spa fill:#aed6f1,stroke:#2471a3,stroke-width:2px;
    classDef portfolio fill:#a9dfbf,stroke:#229954,stroke-width:2px;
    classDef backend fill:#fad7a0,stroke:#d35400,stroke-width:2px;
```
