# tomvargas/programas architecture

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

- Interactive diagram: https://gitdiagram.com/tomvargas/programas
- Repository: https://github.com/tomvargas/programas

## Overview

##### Project type and purpose
- This repository is not a single full-stack application but a collection of practice programs in four languages (C++, Java, JavaScript, Python). Its purpose is educational—to provide standalone exercises and small projects for study and practice.

##### File structure
- Top-level directories by language: `C++/`, `java/`, `javascript/`, `python/`
- Under `java/`, several Maven-based subprojects (e.g., `Alquiler_libros`, `diccionarios-anidados`, `midespensa`, `restaurante`) and simple standalone classes.
- Each Java subproject follows standard Maven layout (`pom.xml`, `src/main/java/...`).
- C++ and Python directories contain individual `.cpp` and `.py` scripts. JavaScript contains standalone scripts.
- No shared library or cross-language service communication; each exercise is self-contained.

##### README for additional insights
- Confirms that these are practice programs for study, with no single runtime or deployment target.

##### Elements
- Clear labels: “C++ Exercises,” “Java Projects,” “JavaScript Scripts,” “Python Scripts”

##### Detailed breakdown
- Top-level: GitHub Repo
↓
- Developer clones → Developer IDE/CLI
↓
- Language area (4 containers side by side)
- C++
– control-de-listas.cpp
– ejemplo-de-clases.cpp
– etc.
(Compile → Binary → Run)
- Java
– Alquiler_libros (Maven module)
– midespensa (Maven module with controllers/models/repos/screens)
– diccionarios-anidados, inmutabilidad, restaurante, etc.
(Maven Build → JAR → JVM Run)
- JavaScript
– strings.js
(Node.js Run)
- Python
– calcular-ventas-de-sucursales.py
– sistema-de-biblioteca.py
(Python interpreter → Run)

## Diagram (Mermaid)

```mermaid
flowchart TB
    %% Actors and Repository
    Developer["Developer"]:::actor
    Repo["GitHub Repository"]:::docs
    Developer -->|"clones/pulls"| Repo

    %% C++ Exercises
    subgraph "C++ Exercises"
        direction TB
        CppControlList["control-de-listas.cpp"]:::cpp
        CppControlNotas["control-de-notas.cpp"]:::cpp
        CppConversion["conversion-de-grados-F-a-C.cpp"]:::cpp
        CppEjemploClases["ejemplo-de clases.cpp"]:::cpp
        CppJuegoTest["juego-test-de-personalidad.cpp"]:::cpp
        Repo -->|select folder| CppGroup["C++/"]:::cpp
        CppGroup --> CppControlList
        CppGroup --> CppControlNotas
        CppGroup --> CppConversion
        CppGroup --> CppEjemploClases
        CppGroup --> CppJuegoTest
        CppGroup -->|"compile"| GPP["g++/clang"]:::cpp
        GPP -->|"binary"| BinaryCPP["Binary"]:::cpp
        BinaryCPP -->|"run"| OutputCPP["Program Output"]:::output
    end

    %% Java Projects
    subgraph "Java Projects"
        direction TB
        Repo -->|select folder| JavaGroup["java/"]:::java
        subgraph "Alquiler_libros"
            AlqPom["pom.xml"]:::java
            AlqMain["Main.java"]:::java
        end
        subgraph "diccionarios-anidados"
            DicPom["pom.xml"]:::java
            DicMain["Main.java"]:::java
        end
        subgraph "inmutabilidad"
            InmPom["pom.xml"]:::java
            InmMain["Main.java"]:::java
        end
        subgraph "midespensa"
            MidPom["pom.xml"]:::java
            AppJava["App.java"]:::java
            Controllers["controllers/"]:::java
            Models["models/"]:::java
            Repos["repositories/"]:::java
            Screens["screens/"]:::java
            Utilities["DBUtil.java, Launch.java"]:::java
        end
        subgraph "restaurante"
            ResPom["pom.xml"]:::java
            ResMain["Main.java"]:::java
            Client["users/client.java"]:::java
        end
        subgraph "cuentas"
            CuentasFiles["cuenta.java, titular.java, main.java"]:::java
        end
        subgraph "progressbar-hilos"
            PBForm["main.form"]:::java
            PBMain["main.java"]:::java
        end
        MatricesFile["matrices.java"]:::java

        JavaGroup --> AlqPom
        JavaGroup --> DicPom
        JavaGroup --> InmPom
        JavaGroup --> MidPom
        JavaGroup --> ResPom
        JavaGroup --> CuentasFiles
        JavaGroup --> PBForm
        JavaGroup --> MatricesFile

        JavaGroup -->|"build"| Maven["Maven & JDK"]:::java
        Maven -->|"jar"| Jar["JAR"]:::java
        Jar -->|"run"| JVM["JVM"]:::java
        JVM -->|"output"| OutputJava["Program Output"]:::output
    end

    %% JavaScript Scripts
    subgraph "JavaScript Scripts"
        direction TB
        Repo -->|select folder| JSGroup["javascript/"]:::js
        StringsJS["strings.js"]:::js
        JSGroup --> StringsJS
        JSGroup -->|"run"| NodeJS["Node.js/Browser"]:::js
        NodeJS -->|"output"| OutputJS["Program Output"]:::output
    end

    %% Python Scripts
    subgraph "Python Scripts"
        direction TB
        Repo -->|select folder| PyGroup["python/"]:::py
        Py1["calcular-derivadas-simples.py"]:::py
        Py2["calcular-pago-empleados.py"]:::py
        Py3["calcular-ventas-de-sucursales.py"]:::py
        Py4["conversion-base-de-numeros.py"]:::py
        Py5["diagnosticar-leucemia-aguda.py"]:::py
        Py6["imprimir-factura.py"]:::py
        Py7["mostrar-hora-y-fecha.py"]:::py
        Py8["numeros-primos.py"]:::py
        Py9["registro-de-estudiantes.py"]:::py
        Py10["sistema-de-biblioteca.py"]:::py
        PyGroup --> Py1
        PyGroup --> Py2
        PyGroup --> Py3
        PyGroup --> Py4
        PyGroup --> Py5
        PyGroup --> Py6
        PyGroup --> Py7
        PyGroup --> Py8
        PyGroup --> Py9
        PyGroup --> Py10
        Repo -->|select folder| PyGroup
        PyGroup -->|"run"| PyInterp["Python Interpreter"]:::py
        PyInterp -->|"output"| OutputPy["Program Output"]:::output
    end

    %% Documentation
    subgraph "Documentation & Config"
        direction TB
        README["README.md"]:::docs
        CodeConduct["CODE_OF_CONDUCT.md"]:::docs
        GitIgnore[".gitignore"]:::docs
        License["LICENSE"]:::docs
        GHConfig[".github/"]:::docs
        Repo --> README
        Repo --> CodeConduct
        Repo --> GitIgnore
        Repo --> License
        Repo --> GHConfig
    end

    %% Click Events
    click Repo "https://github.com/tomvargas/programas/tree/main/./"
    click CppGroup "https://github.com/tomvargas/programas/tree/main/C++/"
    click CppControlList "https://github.com/tomvargas/programas/blob/main/C++/control-de-listas.cpp"
    click CppControlNotas "https://github.com/tomvargas/programas/blob/main/C++/control-de-notas.cpp"
    click CppConversion "https://github.com/tomvargas/programas/blob/main/C++/conversion-de-grados-F-a-C.cpp"
    click CppEjemploClases "https://github.com/tomvargas/programas/blob/main/C++/ejemplo-de clases.cpp"
    click CppJuegoTest "https://github.com/tomvargas/programas/blob/main/C++/juego-test-de-personalidad.cpp"
    click JavaGroup "https://github.com/tomvargas/programas/tree/main/java/"
    click AlqPom "https://github.com/tomvargas/programas/blob/main/java/Alquiler_libros/pom.xml"
    click AlqMain "https://github.com/tomvargas/programas/blob/main/java/Alquiler_libros/src/main/java/com/mycompany/alquiler_libros/main.java"
    click DicPom "https://github.com/tomvargas/programas/blob/main/java/diccionarios-anidados/pom.xml"
    click DicMain "https://github.com/tomvargas/programas/blob/main/java/diccionarios-anidados/src/main/java/com/mycompany/matrizenergeticas/main.java"
    click InmPom "https://github.com/tomvargas/programas/blob/main/java/inmutabilidad/pom.xml"
    click InmMain "https://github.com/tomvargas/programas/blob/main/java/inmutabilidad/src/main/java/com/mycompany/inmutabilidad/main.java"
    click MidPom "https://github.com/tomvargas/programas/blob/main/java/midespensa/pom.xml"
    click AppJava "https://github.com/tomvargas/programas/blob/main/java/midespensa/src/main/java/com/mycompany/midespensa/App.java"
    click Controllers "https://github.com/tomvargas/programas/tree/main/java/midespensa/src/main/java/com/mycompany/midespensa/controllers/"
    click Models "https://github.com/tomvargas/programas/tree/main/java/midespensa/src/main/java/com/mycompany/midespensa/models/"
    click Repos "https://github.com/tomvargas/programas/tree/main/java/midespensa/src/main/java/com/mycompany/midespensa/repositories/"
    click Screens "https://github.com/tomvargas/programas/tree/main/java/midespensa/src/main/java/com/mycompany/midespensa/screens/"
    click ResPom "https://github.com/tomvargas/programas/blob/main/java/restaurante/pom.xml"
    click ResMain "https://github.com/tomvargas/programas/blob/main/java/restaurante/src/main/java/com/mycompany/restaurante/main.java"
    click Client "https://github.com/tomvargas/programas/blob/main/java/restaurante/src/main/java/com/mycompany/restaurante/users/client.java"
    click CuentasFiles "https://github.com/tomvargas/programas/tree/main/java/cuentas/"
    click PBForm "https://github.com/tomvargas/programas/blob/main/java/progressbar-hilos/main.form"
    click PBMain "https://github.com/tomvargas/programas/blob/main/java/progressbar-hilos/main.java"
    click MatricesFile "https://github.com/tomvargas/programas/blob/main/java/matrices.java"
    click JSGroup "https://github.com/tomvargas/programas/tree/main/javascript/"
    click StringsJS "https://github.com/tomvargas/programas/blob/main/javascript/strings.js"
    click PyGroup "https://github.com/tomvargas/programas/tree/main/python/"
    click Py1 "https://github.com/tomvargas/programas/blob/main/python/calcular-derivadas-simples.py"
    click Py2 "https://github.com/tomvargas/programas/blob/main/python/calcular-pago-empleados.py"
    click Py3 "https://github.com/tomvargas/programas/blob/main/python/calcular-ventas-de-sucursales.py"
    click Py4 "https://github.com/tomvargas/programas/blob/main/python/conversion-base-de-numeros.py"
    click Py5 "https://github.com/tomvargas/programas/blob/main/python/diagnosticar-leucemia-aguda.py"
    click Py6 "https://github.com/tomvargas/programas/blob/main/python/imprimir-factura.py"
    click Py7 "https://github.com/tomvargas/programas/blob/main/python/mostrar-hora-y-fecha.py"
    click Py8 "https://github.com/tomvargas/programas/blob/main/python/numeros-primos.py"
    click Py9 "https://github.com/tomvargas/programas/blob/main/python/registro-de-estudiantes.py"
    click Py10 "https://github.com/tomvargas/programas/blob/main/python/sistema-de-biblioteca.py"
    click README "https://github.com/tomvargas/programas/blob/main/README.md"
    click CodeConduct "https://github.com/tomvargas/programas/blob/main/CODE_OF_CONDUCT.md"
    click GitIgnore "https://github.com/tomvargas/programas/blob/main/.gitignore"
    click License "https://github.com/tomvargas/programas/tree/main/LICENSE"
    click GHConfig "https://github.com/tomvargas/programas/tree/main/.github/"

    %% Styles
    classDef actor fill:#f2f2f2,stroke:#333,stroke-width:1px
    classDef docs fill:#e0e0e0,stroke:#999,stroke-width:1px
    classDef cpp fill:#bbdefb,stroke:#2196f3,stroke-width:1px
    classDef java fill:#ffcdd2,stroke:#f44336,stroke-width:1px
    classDef js fill:#fff9c4,stroke:#fbc02d,stroke-width:1px
    classDef py fill:#c8e6c9,stroke:#4caf50,stroke-width:1px
    classDef output fill:#eeeeee,stroke:#666,stroke-width:1px
```
