# hannahcrowell/proyecto_integrador_primer_departamental architecture

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

- Interactive diagram: https://gitdiagram.com/hannahcrowell/proyecto_integrador_primer_departamental
- Repository: https://github.com/hannahcrowell/proyecto_integrador_primer_departamental

## Overview

##### Project type and purpose
- This is a “Proyecto Integrador” that aggregates multiple small front-end/mini back-end web apps (games like the Chrome Dino clone, memorama, landing page, weather app, etc.).
- Each mini-project lives in its own directory, contains HTML/CSS/JS, and some include a simple `server.js` (Node/Express) to serve static files or provide minimal API endpoints.

##### File structure
- Top-level directories:
- CSS (global styles?)
- Juego_Dino, Juego_html, Juego_memorama, Practica, Practica3_…, Practica5_…, PrimeraPractica, SegundaPractica – each a standalone mini-app
- Common patterns:
- `index.html` or `<Name>.html` + `script.js` + `style.css`
- Some include `server.js` and a `node_modules` folder → lightweight Express servers
- No centralized database; external public APIs used (e.g., weather/geolocation)

##### README
- Very concise: “Proyecto Integrador” that collects all first-term practices and the Dino-style game.
- No deeper architectural notes given.

a. Main components
- User’s Browser
- Static Asset Hosts (Nginx/Apache or Express servers per mini-app)
- Node.js/Express server instances (for apps with `server.js`)
- External Third-Party APIs (Weather API, Geolocation API)
b. Relationships & interactions
- Browser ↔ Static Server: serves HTML/CSS/JS for pure front-end apps
- Browser ↔ Node.js/Express: serves static files + minimal dynamic routes (e.g., API proxy)
- Node.js/Express ↔ External API: fetch weather/geolocation data on behalf of client
c. Architectural patterns & principles
- Micro-frontend style: each practice is a self-contained module
- Separation of concerns: UI assets vs. back-end servers
- Reuse of common static-serving pattern (Express)
d. Key technologies
- HTML5, CSS3, vanilla JavaScript
- Node.js, Express (in `server.js`)
- External REST APIs (e.g., OpenWeatherMap, Geolocation)

##### Detailed steps for the engineer
1. A “User Browser” node at the left.
a. Static Hosting: list all pure-frontend practices (e.g., Juego_html, PrimeraPractica, SegundaPractica, etc.).
b. Dynamic Hosting: list practices with `server.js` (Practica, Juego_memorama, Practica3_…, Practica5_…).
6. Callouts for shared assets (e.g., CSS, Multimedia folders).

## Diagram (Mermaid)

```mermaid
flowchart TD
    %% Nodes
    Browser["User Browser"]:::client

    subgraph "Static Hosting"
        CSS["Global Styles"]:::static
        Dino["Chrome Dino Clone"]:::static
        Primera["Primera Practica"]:::static
        Segunda["Segunda Practica"]:::static
        Principal["Principal Landing Page"]:::static
    end

    subgraph "Dynamic Hosting"
        JuegoHTML["Juego_html (Express)"]:::dynamic
        Memorama["Juego_memorama (Express)"]:::dynamic
        PracticaBasic["Practica (Express)"]:::dynamic
        Practica3["Practica3_LandingPageInteractivaconValidaciondeFormulario"]:::dynamic
        Practica5["Practica5_AppdeClimaLocalconAPIyGeolocalizacion"]:::dynamic
    end

    subgraph "External APIs"
        WeatherAPI["OpenWeatherMap API"]:::api
        GeolocationAPI["Geolocation API"]:::api
    end

    %% Connections: Browser to Static
    Browser -->|"GET /Style.css"| CSS
    Browser -->|"GET /Dino.html"| Dino
    Browser -->|"GET /pagina1.html"| Primera
    Browser -->|"GET /index.html"| Segunda
    Browser -->|"GET /Principal.html"| Principal

    %% Connections: Browser to Dynamic
    Browser -->|"GET /juego.html"| JuegoHTML
    Browser -->|"GET /Index.html"| Memorama
    Browser -->|"GET /Index.html"| PracticaBasic
    Browser -->|"GET /Index.html"| Practica3
    Browser -->|"GET /index.html"| Practica5

    %% Dynamic to External APIs
    Practica5 -->|"GET /weather?..."| WeatherAPI
    Practica5 -->|"GET /geolocation?..."| GeolocationAPI

    %% Click Events for Static Hosting
    click CSS "https://github.com/hannahcrowell/proyecto_integrador_primer_departamental/blob/main/CSS/Style.css"
    click Dino "https://github.com/hannahcrowell/proyecto_integrador_primer_departamental/blob/main/Juego_Dino/Dino.html"
    click Primera "https://github.com/hannahcrowell/proyecto_integrador_primer_departamental/blob/main/PrimeraPractica/pagina1.html"
    click Segunda "https://github.com/hannahcrowell/proyecto_integrador_primer_departamental/blob/main/SegundaPractica/index.html"
    click Principal "https://github.com/hannahcrowell/proyecto_integrador_primer_departamental/blob/main/Principal.html"

    %% Click Events for Dynamic Hosting
    click JuegoHTML "https://github.com/hannahcrowell/proyecto_integrador_primer_departamental/blob/main/Juego_html/server.js"
    click Memorama "https://github.com/hannahcrowell/proyecto_integrador_primer_departamental/blob/main/Juego_memorama/server.js"
    click PracticaBasic "https://github.com/hannahcrowell/proyecto_integrador_primer_departamental/blob/main/Practica/app.js"
    click Practica3 "https://github.com/hannahcrowell/proyecto_integrador_primer_departamental/blob/main/Practica3_LandingPageInteractivaconValidaciondeFormulario/server.js"
    click Practica5 "https://github.com/hannahcrowell/proyecto_integrador_primer_departamental/blob/main/Practica5_AppdeClimaLocalconAPIyGeolocalizacion/server.js"

    %% Styles
    classDef client fill:#E0E0E0,stroke:#757575
    classDef static fill:#D0E6FF,stroke:#0288D1
    classDef dynamic fill:#C8E6C9,stroke:#388E3C
    classDef api fill:#FFF3E0,stroke:#F57C00,stroke-dasharray: 5 5,stroke-width:2,stroke-linecap:round
    class CSS,Dino,Primera,Segunda,Principal static
    class JuegoHTML,Memorama,PracticaBasic,Practica3,Practica5 dynamic
    class WeatherAPI,GeolocationAPI api
    class Browser client
```
