# joelyustiz/poo-python architecture

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

- Interactive diagram: https://gitdiagram.com/joelyustiz/poo-python
- Repository: https://github.com/joelyustiz/poo-python

## Overview

##### Main components
- OOP Concepts / Examples – Several files (e.g., abstraccion.py, decomposicion.py, herencia.py, polimorfismo.py, getters_and_setters.py, instancias.py) show how classes, instances, inheritance, and encapsulation are built and used.
- Algorithm Modules – Files that implement algorithmic concepts such as busqueda_lineal.py, busqueda_binaria.py, ordenamiento_burbuja.py, ordenamiento_insercion.py, ordenamiento_mezcla.py, and complejidad_algoritmica.py. These components illustrate complexity analysis, Big O notation, and different algorithmic paradigms.
- Optimization Problem – The “morral.py” script demonstrates a classic optimization (knapsack) problem.
- Graphing Component – The “graficado” directory (with graficado_simple.py and an accompanying HTML file) shows the integration of Bokeh for visualizing data.
- Supporting/Utility Scripts – Various helper scripts and tests (e.g., caja_cristal_test.py, caja_negra_test.py, etc.) that support the educational demonstration.

##### Architectural patterns and design principles
- That the repository is built with modularity in mind – each file is a standalone example of a concept. This shows principles like separation of concerns and decomposition.
- For OOP, note the use of inheritance and polymorphism (with examples in herencia.py and polimorfismo.py), and how encapsulation is shown via getters and setters.
- For algorithm examples, note that recursion, iteration (loops), and divide & conquer (in merge sort and binary search) are demonstrated.

##### Key technologies and frameworks
- Python is the language, so you might add a “Python Interpreter” or “Python Runtime” as a base component.
- Bokeh is used for graphing (as seen in graficado/graficado_simple.py).
- Although not a full web application, there is mention of ambientes virtuales and pip – you might add a note (or a small component) illustrating the development environment setup.

- Nodes with clear names (e.g., “OOP – Abstracción & Decomposición”, “Algoritmos de Búsqueda y Ordenación”, “Complejidad Algorítmica”, “Optimización - Problema del Morral”, “Graficado (Bokeh)”).

- Separates the project into logical clusters (OOP fundamentals, algorithm examples, optimization, and visualization).
- Is detailed enough to capture the various topics taught by the project, ensuring that no essential block is omitted.

## Diagram (Mermaid)

```mermaid
graph TD
    subgraph "OOP Fundamentals"
        OOP1("Abstracción"):::oop
        OOP2("Decomposición"):::oop
        OOP3("Herencia"):::oop
        OOP4("Polimorfismo"):::oop
        OOP5("Encapsulación"):::oop
        OOP6("Instancias"):::oop
    end

    subgraph "Search & Sorting Algorithms"
        SSA1("Busqueda Lineal"):::sorting
        SSA2("Busqueda Binaria"):::sorting
        SSA3("Ordenamiento Burbuja"):::sorting
        SSA4("Ordenamiento Inserción"):::sorting
        SSA5("Ordenamiento Mezcla"):::sorting
    end

    subgraph "Algorithm Analysis"
        AA1("Complejidad Algorítmica"):::analysis
    end

    subgraph "Optimization"
        OPT1("Problema del Morral"):::optim
    end

    subgraph "Graphing / Visualización"
        G1("Graficado (Bokeh)"):::graphing
    end

    OOP6 -->|"leads_to"| SSA1
    SSA5 -->|"leads_to"| AA1
    AA1 -->|"leads_to"| OPT1
    OPT1 -->|"leads_to"| G1

    click OOP1 "https://github.com/joelyustiz/poo-python/blob/master/Scripts/abstraccion.py"
    click OOP2 "https://github.com/joelyustiz/poo-python/blob/master/Scripts/decomposicion.py"
    click OOP3 "https://github.com/joelyustiz/poo-python/blob/master/herencia.py"
    click OOP4 "https://github.com/joelyustiz/poo-python/blob/master/polimorfismo.py"
    click OOP5 "https://github.com/joelyustiz/poo-python/blob/master/getters_and_setters.py"
    click OOP6 "https://github.com/joelyustiz/poo-python/blob/master/instancias.py"
    click SSA1 "https://github.com/joelyustiz/poo-python/blob/master/busqueda_lineal.py"
    click SSA2 "https://github.com/joelyustiz/poo-python/blob/master/busqueda_binaria.py"
    click SSA3 "https://github.com/joelyustiz/poo-python/blob/master/ordenamiento_burbuja.py"
    click SSA4 "https://github.com/joelyustiz/poo-python/blob/master/ordenamiento_insercion.py"
    click SSA5 "https://github.com/joelyustiz/poo-python/blob/master/ordenamiento_mezcla.py"
    click AA1 "https://github.com/joelyustiz/poo-python/blob/master/complejidad_algoritmica.py"
    click OPT1 "https://github.com/joelyustiz/poo-python/blob/master/morral.py"
    click G1 "https://github.com/joelyustiz/poo-python/blob/master/graficado/graficado_simple.py"

    classDef oop fill:#FFD700,stroke:#333,stroke-width:2px;
    classDef sorting fill:#87CEEB,stroke:#333,stroke-width:2px;
    classDef analysis fill:#F08080,stroke:#333,stroke-width:2px;
    classDef optim fill:#98FB98,stroke:#333,stroke-width:2px;
    classDef graphing fill:#DDA0DD,stroke:#333,stroke-width:2px;
```
