# mdiannibelli/javascript-dioneldev architecture

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

- Interactive diagram: https://gitdiagram.com/mdiannibelli/javascript-dioneldev
- Repository: https://github.com/mdiannibelli/javascript-dioneldev

## Overview

##### Project type and purpose
- This is not a running application but an open-source “exercise bank” of JavaScript problems organized by difficulty (facil, intermedio, dificil, teoria).
- Its purpose is to help learners practice JS by cloning the repo, opening an exercise in their editor (e.g., RunJS), and executing solutions interactively.

##### File structure
- At the root you have README.md plus four top-level folders:
- facil
- intermedio
- dificil
- teoria
- Each of those folders contains subfolders or files, each representing a single exercise or group of related exercises (e.g., “programacion-orientada-a-objetos”).
- There are no build scripts, no server code, no configs—just pure .js solutions.

##### README for additional insights
- The README confirms it’s a collection of solved JS exercises.
- It references RunJS as the chosen local execution environment.
- No external dependencies or runtime services are mentioned.

a. Main components:
- User (developer/learner)
- GitHub repository (source of truth)
- Local clone (developer machine)
- RunJS (JS execution environment)
- Exercise folders (facil, intermedio, dificil, teoria)
b. Relationships / interactions:
1. User → clones repo from → GitHub
2. Cloned repo → lives in → Local filesystem
3. User opens a specific exercise folder in an editor → code file
4. User runs code in → RunJS
c. Architectural patterns / principles:
- Purely hierarchical directory structure (no inter-module dependencies).
- Each exercise is an isolated module (single responsibility).
- Convention-over-configuration: folder name denotes difficulty, file name denotes problem.
d. Relevant technologies:
- Git/GitHub (version control)
- JavaScript (.js files)
- RunJS (local REPL / execution tool)

##### Detail
- That there is zero runtime coupling—each exercise is self-contained.
- Keep it simple—this is a static content repo, so the “system” is really the workflows and file organization.

## Diagram (Mermaid)

```mermaid
flowchart TB
    %% Actors and external
    User["Learner/Developer"]:::user
    GitHub["GitHub Repository"]:::component
    LocalFS["Local Filesystem (Cloned Repo)"]:::component
    RunJS["RunJS (Execution Environment)"]:::component

    %% Workflow
    User -->|"clones repo from"| GitHub
    GitHub -->|"cloned to"| LocalFS

    %% Local filesystem structure
    subgraph "Difficulty Folders"
        facil["facil"]:::folder
        intermedio["intermedio"]:::folder
        dificil["dificil"]:::folder
        teoria["teoria"]:::folder
    end

    LocalFS --> facil
    LocalFS --> intermedio
    LocalFS --> dificil
    LocalFS --> teoria

    %% Sample exercises
    facil --> oop_b["programacion-orientada-a-objetos"]:::file
    intermedio --> oop_a["programacion-orientada-a-objetos"]:::file
    dificil --> advent4["adventjs/exercise-4"]:::file
    teoria --> manejarErr["manejar-errores"]:::file

    %% Execution flow
    User -->|"opens exercise"| oop_b
    User -->|"opens exercise"| oop_a
    User -->|"opens exercise"| advent4
    User -->|"opens exercise"| manejarErr

    oop_b -->|"execute .js"| RunJS
    oop_a -->|"execute .js"| RunJS
    advent4 -->|"execute .js"| RunJS
    manejarErr -->|"execute .js"| RunJS

    %% Click Events
    click GitHub "https://github.com/mdiannibelli/javascript-dioneldev/blob/main//README.md"
    click LocalFS "https://github.com/mdiannibelli/javascript-dioneldev/tree/main//"
    click facil "https://github.com/mdiannibelli/javascript-dioneldev/tree/main//facil"
    click intermedio "https://github.com/mdiannibelli/javascript-dioneldev/tree/main//intermedio"
    click dificil "https://github.com/mdiannibelli/javascript-dioneldev/tree/main//dificil"
    click teoria "https://github.com/mdiannibelli/javascript-dioneldev/tree/main//teoria"
    click oop_b "https://github.com/mdiannibelli/javascript-dioneldev/tree/main//facil/programacion-orientada-a-objetos"
    click oop_a "https://github.com/mdiannibelli/javascript-dioneldev/tree/main//intermedio/programacion-orientada-a-objetos"
    click advent4 "https://github.com/mdiannibelli/javascript-dioneldev/tree/main//dificil/adventjs/exercise-4"
    click manejarErr "https://github.com/mdiannibelli/javascript-dioneldev/tree/main//teoria/manejar-errores"

    %% Styling
    classDef user fill:#f9f,stroke:#333,stroke-width:1px
    classDef component fill:#bbf,stroke:#333,stroke-width:1px
    classDef folder fill:#bfb,stroke:#333,stroke-width:1px
    classDef file fill:#ffb,stroke:#333,stroke-width:1px
```
