# maxisimonazzi/introduccion-python-y-micropython-utnfrt architecture

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

- Interactive diagram: https://gitdiagram.com/maxisimonazzi/introduccion-python-y-micropython-utnfrt
- Repository: https://github.com/maxisimonazzi/introduccion-python-y-micropython-utnfrt

## Overview

##### Main Components
- Curriculum Materials: At the root level you have PDF files (Clase01.pdf through Clase09.pdf and extra classes) which serve as lecture slide decks.
- README and Course Description: Acts as the “front door” giving an overview of the course contents, schedule, technologies, and external links.
- Examples by Topic: Multiple “ejemplos_claseXX” directories (for functions, objects, GPIO, communication, WiFi, and laboratory exercises) containing sample Python and MicroPython scripts to illustrate specific topics.
- Drivers & External Resources: A dedicated “driverCH9102X” directory that contains driver archives needed for hardware connectivity, linking hardware support to course exercises.
- Projects Directory: Contains subdirectories for individual student or demo projects. Each project folder (e.g., Barraza_Carbajales_Cuello_DelCastano, Copa_Elias_Fernandez, etc.) typically includes a main script, a README, documentation files, supportive multimedia (videos, images), and sometimes shared libraries (like i2c_lcd.py, lcd_api.py).

##### Relationships and Interactions
- The README sits at the top, directing users to different modules.
- The PDF files (slides) are loosely connected to each “clase” which explains the theory behind each practical example.
- Each “ejemplos_claseXX” folder corresponds to the lecture material and drives home practical examples on the topics covered.
- The “driverCH9102X” folder supports hardware interfacing required by the course’s MicroPython exercises.
- The “proyectos” folder encapsulates real-life or simulation projects, which may reuse code from the “ejemplos” folders (for instance, similar libraries such as i2c_lcd.py appear in both examples and projects).

##### Architectural Patterns and Design Principles
- Modularity/Separation of Concerns: The repository is segmented by purpose (theoretical slides, practical examples, projects) ensuring that each area focuses on a specific learning objective.
- Reusability: Common code (e.g., LCD display libraries) is often replicated across multiple assignments and projects.
- Scalability of Content: The “proyectos” directory shows how the course allows students or groups to build larger applications/or demonstrations that build upon base lessons.

##### Technologies, Frameworks, and External Integrations
- Python and MicroPython as core programming environments.
- Hardware integration using the ESP32 board (supported by provided drivers) and tested via the Wokwi simulation environment.
- Integration of standard libraries and popular third-party libraries (NumPy, matplotlib) as seen in extra class examples.
- External tools like Visual Studio Code and Thonny are referenced as development environments.
- Communication protocols (I2C, UART, SPI) are demonstrated via the examples provided.

## Diagram (Mermaid)

```mermaid
flowchart TB
    M["Curso Introducción a Python y MicroPython"]:::main

    subgraph "Curriculum & Slides"
        direction TB
        A1["README.md (Course Overview)"]:::curriculum
        subgraph "Lecture Slides"
            direction TB
            P1["Clase01.pdf"]:::curriculum
            P2["Clase02.pdf"]:::curriculum
            P3["Clase03.pdf"]:::curriculum
            P4["Clase04.pdf"]:::curriculum
            P5["Clase05.pdf"]:::curriculum
            P6["Clase06.pdf"]:::curriculum
            P7["Clase07.pdf"]:::curriculum
            P8["Clase08.pdf"]:::curriculum
            P9["Clase09.pdf"]:::curriculum
            P10["Clase_extra01.pdf"]:::curriculum
            P11["Clase_extra02.pdf"]:::curriculum
        end
    end

    subgraph "Practical Examples"
        direction TB
        E1["ejemplos_clase04_funciones"]:::examples
        E2["ejemplos_clase05_objetos"]:::examples
        E3["ejemplos_clase06_thonny"]:::examples
        E4["ejemplos_clase07_gpios"]:::examples
        E5["ejemplos_clase08_comunicacion"]:::examples
        E6["ejemplos_clase09_wifi"]:::examples
        E7["ejemplos_clase10_laboratorio"]:::examples
        E8["ejemplos_clase_extra1_paquetes"]:::examples
    end

    subgraph "Projects"
        direction TB
        PR1["proyectos/README.md"]:::projects
        PR2["proyectos/Barraza_Carbajales_Cuello_DelCastano"]:::projects
        PR3["proyectos/Copa_Elias_Fernandez"]:::projects
        PR4["proyectos/Gao_Tejerina"]:::projects
        PR5["proyectos/Juarez_Robles_Perez"]:::projects
        PR6["proyectos/Padula_Sardi"]:::projects
    end

    D1["driverCH9102X"]:::drivers

    %% Connections from the main course node to primary sections
    M -->|"entry"| A1
    M -->|"entry"| E1
    M -->|"entry"| PR1
    M -->|"entry"| D1

    %% Connections within Curriculum & Slides
    A1 -->|"contains"| P1
    A1 -->|"contains"| P2
    A1 -->|"contains"| P3
    A1 -->|"contains"| P4
    A1 -->|"contains"| P5
    A1 -->|"contains"| P6
    A1 -->|"contains"| P7
    A1 -->|"contains"| P8
    A1 -->|"contains"| P9
    A1 -->|"contains"| P10
    A1 -->|"contains"| P11

    %% Specific relationship: Theory to Practical Example
    P6 -->|"inspires"| E3

    %% Relationship: Practical Examples providing libraries reused in Projects
    E5 -->|"provides_libs"| PR3
    E3 -->|"supports"| PR2

    %% Additional guidance from README to examples and projects
    A1 -->|"guides"| E1
    A1 -->|"guides"| PR1

    %% Style Definitions
    classDef main fill:#a2d5f2,stroke:#333,stroke-width:2px;
    classDef curriculum fill:#f9d5e5,stroke:#333,stroke-width:2px;
    classDef examples fill:#d5f5e3,stroke:#333,stroke-width:2px;
    classDef projects fill:#d6eaf8,stroke:#333,stroke-width:2px;
    classDef drivers fill:#fcf3cf,stroke:#333,stroke-width:2px;

    %% Click Events for Curriculum Materials
    click A1 "https://github.com/maxisimonazzi/introduccion-python-y-micropython-utnfrt/blob/main/README.md"
    click P1 "https://github.com/maxisimonazzi/introduccion-python-y-micropython-utnfrt/blob/main/Clase01.pdf"
    click P2 "https://github.com/maxisimonazzi/introduccion-python-y-micropython-utnfrt/blob/main/Clase02.pdf"
    click P3 "https://github.com/maxisimonazzi/introduccion-python-y-micropython-utnfrt/blob/main/Clase03.pdf"
    click P4 "https://github.com/maxisimonazzi/introduccion-python-y-micropython-utnfrt/blob/main/Clase04.pdf"
    click P5 "https://github.com/maxisimonazzi/introduccion-python-y-micropython-utnfrt/blob/main/Clase05.pdf"
    click P6 "https://github.com/maxisimonazzi/introduccion-python-y-micropython-utnfrt/blob/main/Clase06.pdf"
    click P7 "https://github.com/maxisimonazzi/introduccion-python-y-micropython-utnfrt/blob/main/Clase07.pdf"
    click P8 "https://github.com/maxisimonazzi/introduccion-python-y-micropython-utnfrt/blob/main/Clase08.pdf"
    click P9 "https://github.com/maxisimonazzi/introduccion-python-y-micropython-utnfrt/blob/main/Clase09.pdf"
    click P10 "https://github.com/maxisimonazzi/introduccion-python-y-micropython-utnfrt/blob/main/Clase_extra01.pdf"
    click P11 "https://github.com/maxisimonazzi/introduccion-python-y-micropython-utnfrt/blob/main/Clase_extra02.pdf"

    %% Click Events for Practical Examples
    click E1 "https://github.com/maxisimonazzi/introduccion-python-y-micropython-utnfrt/tree/main/ejemplos_clase04_funciones"
    click E2 "https://github.com/maxisimonazzi/introduccion-python-y-micropython-utnfrt/tree/main/ejemplos_clase05_objetos"
    click E3 "https://github.com/maxisimonazzi/introduccion-python-y-micropython-utnfrt/tree/main/ejemplos_clase06_thonny"
    click E4 "https://github.com/maxisimonazzi/introduccion-python-y-micropython-utnfrt/tree/main/ejemplos_clase07_gpios"
    click E5 "https://github.com/maxisimonazzi/introduccion-python-y-micropython-utnfrt/tree/main/ejemplos_clase08_comunicacion"
    click E6 "https://github.com/maxisimonazzi/introduccion-python-y-micropython-utnfrt/tree/main/ejemplos_clase09_wifi"
    click E7 "https://github.com/maxisimonazzi/introduccion-python-y-micropython-utnfrt/tree/main/ejemplos_clase10_laboratorio"
    click E8 "https://github.com/maxisimonazzi/introduccion-python-y-micropython-utnfrt/tree/main/ejemplos_clase_extra1_paquetes"

    %% Click Events for Projects
    click PR1 "https://github.com/maxisimonazzi/introduccion-python-y-micropython-utnfrt/blob/main/proyectos/README.md"
    click PR2 "https://github.com/maxisimonazzi/introduccion-python-y-micropython-utnfrt/tree/main/proyectos/Barraza_Carbajales_Cuello_DelCastano"
    click PR3 "https://github.com/maxisimonazzi/introduccion-python-y-micropython-utnfrt/tree/main/proyectos/Copa_Elias_Fernandez"
    click PR4 "https://github.com/maxisimonazzi/introduccion-python-y-micropython-utnfrt/tree/main/proyectos/Gao_Tejerina"
    click PR5 "https://github.com/maxisimonazzi/introduccion-python-y-micropython-utnfrt/tree/main/proyectos/Juarez_Robles_Perez"
    click PR6 "https://github.com/maxisimonazzi/introduccion-python-y-micropython-utnfrt/tree/main/proyectos/Padula_Sardi"

    %% Click Event for Drivers & External Resources
    click D1 "https://github.com/maxisimonazzi/introduccion-python-y-micropython-utnfrt/tree/main/driverCH9102X"
```
