# arlotetxu/python_projects architecture

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

- Interactive diagram: https://gitdiagram.com/arlotetxu/python_projects
- Repository: https://github.com/arlotetxu/python_projects

## Overview

##### Main Components

A. Independent Applications Layer:
- Calculator GUI Application
- Task Management Applications (Multiple Implementations)
- Inventory Management System
- Contact Management System

B. Database Layer:
- SQLite3 Implementations
- MongoDB Atlas Connection
- Firebase Integration
- File-based Storage

**Level 1 (Top): Project Categories**
**Level 2: Individual Applications**
**Level 3: Implementation Details**
**Level 4 (Bottom): Storage Solutions**

##### Component Relationships

- Blue rectangles: Main applications
- Yellow hexagons: GUI components
- Gray rectangles: Utility modules
- Orange diamonds: External services (Firebase, MongoDB Atlas)

##### Specific Implementation Details

For each major component, show:

A. Calculator GUI:
- GUI Interface (calculadora_gui.py)
- Calculation Logic (calc_functions.py)
- Testing Module (testing.py)

B. Task Management Systems:
- Firebase Implementation
- SQLite3 Implementation
- File-based Implementation
Relationship between:
- Main application files
- Database interaction layers
- Utility functions

C. Inventory Management:
- MongoDB connection
- CRUD operations
- Utility functions

##### Important Elements to Highlight

a. Database Connections:
- Different database implementations (SQLite3, MongoDB, Firebase)
- Local vs. cloud storage

b. Application Structure:
- Separate utility modules from main application code
- Configuration files and their relationship to main components

c. External Services:
- Firebase and MongoDB Atlas as cloud services
- Authentication and configuration flows

- GUI Applications    |

- Task Management      |

- Inventory Management   |

- Storage Solutions    |

## Diagram (Mermaid)

```mermaid
graph TB
    subgraph "GUI Applications"
        Calculator["Calculator GUI"]:::gui
        click Calculator "https://github.com/arlotetxu/Python_Projects/blob/main/calculadora_gui/src/calculadora_gui.py"
        CalcLogic["Calculation Logic"]:::logic
        click CalcLogic "https://github.com/arlotetxu/Python_Projects/blob/main/calculadora_gui/src/calc_functions.py"
        Testing["Testing Module"]:::testing
        click Testing "https://github.com/arlotetxu/Python_Projects/blob/main/calculadora_gui/src/testing.py"
        Calculator --> CalcLogic
        CalcLogic --> Testing
    end

    subgraph "Task Management Systems"
        TaskFirebase["Firebase Tasks"]:::app
        click TaskFirebase "https://github.com/arlotetxu/Python_Projects/blob/main/lista_tareas_firebase/src/lista_tareas_firebase.py"
        FirebaseOps["Firebase Operations"]:::logic
        click FirebaseOps "https://github.com/arlotetxu/Python_Projects/blob/main/lista_tareas_firebase/src/db_crud.py"
        FirebaseConfig["Firebase Config"]:::config
        click FirebaseConfig "https://github.com/arlotetxu/Python_Projects/blob/main/lista_tareas_firebase/src/firebase_config.py"
        
        TaskSQLite["SQLite3 Tasks"]:::app
        click TaskSQLite "https://github.com/arlotetxu/Python_Projects/blob/main/lista_tareas_prioridades_sqlite3/lista_tareas_prioridad.py"
        
        TaskFile["File-based Tasks"]:::app
        click TaskFile "https://github.com/arlotetxu/Python_Projects/blob/main/lista_tareas_persistente/lista_tareas_persistente.py"
        
        TaskFirebase --> FirebaseOps
        FirebaseOps --> FirebaseConfig
        TaskFirebase --> FirebaseUtils["Firebase Utils"]:::util
        click FirebaseUtils "https://github.com/arlotetxu/Python_Projects/blob/main/lista_tareas_firebase/src/utils.py"
        
        TaskSQLite --> TaskUtils["Task Utils"]:::util
        click TaskUtils "https://github.com/arlotetxu/Python_Projects/blob/main/lista_tareas_prioridades_sqlite3/utils.py"
    end

    subgraph "Inventory Management"
        InventoryApp["Inventory System"]:::app
        click InventoryApp "https://github.com/arlotetxu/Python_Projects/blob/main/gestion_inventario_mongodb/inventario_mongodb.py"
        DBFunctions["Database Functions"]:::logic
        click DBFunctions "https://github.com/arlotetxu/Python_Projects/blob/main/gestion_inventario_mongodb/db_functions.py"
        ConnChecker["Connection Checker"]:::util
        click ConnChecker "https://github.com/arlotetxu/Python_Projects/blob/main/gestion_inventario_mongodb/check_conection.py"
        InventoryUtils["Inventory Utils"]:::util
        click InventoryUtils "https://github.com/arlotetxu/Python_Projects/blob/main/gestion_inventario_mongodb/utils.py"
        
        InventoryApp --> DBFunctions
        DBFunctions --> ConnChecker
        InventoryApp --> InventoryUtils
    end

    subgraph "Contact Management"
        ContactApp["Contact System"]:::app
        click ContactApp "https://github.com/arlotetxu/Python_Projects/blob/main/admin_contacts_sqlite3/admin_contacts_sqlite3.py"
        ContactsDB["Contacts Database"]:::database
        click ContactsDB "https://github.com/arlotetxu/Python_Projects/blob/main/admin_contacts_sqlite3/contacts.db"
        
        ContactApp --> ContactsDB
    end

    subgraph "Storage Solutions"
        Firebase[("Firebase Cloud")]:::cloud
        MongoDB[("MongoDB Atlas")]:::cloud
        SQLite3[("SQLite3 DB")]:::database
        click SQLite3 "https://github.com/arlotetxu/Python_Projects/blob/main/lista_tareas_prioridades_sqlite3/tareas.db"
        FileStorage[("File Storage")]:::file
        click FileStorage "https://github.com/arlotetxu/Python_Projects/blob/main/lista_tareas_persistente/tareas.txt"
    end

    TaskFirebase -.-> Firebase
    InventoryApp -.-> MongoDB
    TaskSQLite -.-> SQLite3
    TaskFile -.-> FileStorage
    ContactApp -.-> SQLite3

    classDef app fill:#3498db,stroke:#2980b9,color:white
    classDef logic fill:#2ecc71,stroke:#27ae60,color:white
    classDef util fill:#95a5a6,stroke:#7f8c8d,color:white
    classDef database fill:#e67e22,stroke:#d35400,color:white
    classDef cloud fill:#e74c3c,stroke:#c0392b,color:white
    classDef config fill:#9b59b6,stroke:#8e44ad,color:white
    classDef file fill:#f1c40f,stroke:#f39c12,color:white
    classDef testing fill:#1abc9c,stroke:#16a085,color:white
    classDef gui fill:#34495e,stroke:#2c3e50,color:white
```
