# jhackisneros/examen_3 architecture

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

- Interactive diagram: https://gitdiagram.com/jhackisneros/examen_3
- Repository: https://github.com/jhackisneros/examen_3

## Overview

##### Project type and purpose
- This is a Python-based, desktop library‐management application (an academic “examen_3” project).
- It provides CRUD-style operations over books, users, and loans, storing data in CSV files and offering a GUI for interaction.

##### File structure
- Top-level modules:
- base_datos: CSV read/write abstraction (csv_manager.py)
- catalogo: domain classes for books and genres (book.py, book_genre.py)
- usuarios: domain classes for user types (usuario.py, empleado.py)
- prestamos: business logic for loans (gestor_prestamos.py)
- interfaz: GUI forms and main window (ventana_principal.py, formulario_*.py)
- main.py: application entry point
- Data folder “datos” and root CSV files: persistent storage for books, users, and loans
- requirements.txt: lists external dependencies (e.g., tkinter, standard library)

##### Review README for architecture hints
- No network or external services—purely local

a. Main components:
- UI Layer: “interfaz” package (forms, main window)
- Application Logic:
- Prestamos Manager (gestor_prestamos.py)
- Catalog domain (book, book_genre)
- User domain (usuario, empleado)
- Data Access Layer: base_datos.csv_manager
- Persistence: CSV files in “datos” and root directory
b. Relationships & interactions:
- UI Layer → invokes methods on Application Logic classes
- Application Logic → uses Data Access Layer to read/write CSVs
- Data Access Layer → directly reads/writes CSV files
- Domain classes act as DTOs carried between layers
c. Architectural patterns & principles:
- MVC-ish separation:
- Model: catalogo, usuarios, prestamos domain classes
- View: interfaz forms
- Controller: gestor_prestamos, main.py glue code
- Single Responsibility: each module handles one aspect (CSV I/O, business rules, UI)
d. Key technologies & libraries:
- Python 3.x (OOP)
- CSV module (built-in) via base_datos.csv_manager
- GUI: likely tkinter (in interfaz)
- No external DB—file-based persistence

## Diagram (Mermaid)

```mermaid
flowchart TB
    %% UI Layer
    subgraph "UI Layer"
        Ventana["Ventana Principal"]:::ui
        FormLibro["Formulario Libros"]:::ui
        FormUsuario["Formulario Usuarios"]:::ui
    end

    %% Application Logic
    subgraph "Application Logic"
        Main["main.py"]:::logic
        PrestamosMgr["Gestor Prestamos"]:::logic
        subgraph "Catalog Domain"
            Book["Book"]:::logic
            Genre["Book Genre"]:::logic
        end
        subgraph "User Domain"
            Usuario["Usuario"]:::logic
            Empleado["Empleado"]:::logic
        end
    end

    %% Data Access Layer
    subgraph "Data Access Layer"
        CSVMgr["CSV Manager"]:::dataaccess
    end

    %% Persistence
    subgraph "Persistence"
        libroCSV[(libro.csv)]:::datastore
        prestamosCSV[(prestamos.csv)]:::datastore
        usuariosCSV[(usuarios.csv)]:::datastore
    end

    %% Connections
    Main --> Ventana
    Main --> PrestamosMgr
    Ventana --> PrestamosMgr
    FormLibro --> PrestamosMgr
    FormUsuario --> PrestamosMgr

    PrestamosMgr --> CSVMgr
    PrestamosMgr --> Book
    PrestamosMgr --> Genre
    PrestamosMgr --> Usuario
    PrestamosMgr --> Empleado

    CSVMgr --> libroCSV
    CSVMgr --> prestamosCSV
    CSVMgr --> usuariosCSV

    %% Click Events
    click Ventana "https://github.com/jhackisneros/examen_3/blob/main/interfaz/ventana_principal.py"
    click FormLibro "https://github.com/jhackisneros/examen_3/blob/main/interfaz/formulario_libros.py"
    click FormUsuario "https://github.com/jhackisneros/examen_3/blob/main/interfaz/formulario_usuarios.py"
    click PrestamosMgr "https://github.com/jhackisneros/examen_3/blob/main/prestamos/gestor_prestamos.py"
    click Book "https://github.com/jhackisneros/examen_3/blob/main/catalogo/book.py"
    click Genre "https://github.com/jhackisneros/examen_3/blob/main/catalogo/book_genre.py"
    click Usuario "https://github.com/jhackisneros/examen_3/blob/main/usuarios/usuario.py"
    click Empleado "https://github.com/jhackisneros/examen_3/blob/main/usuarios/empleado.py"
    click CSVMgr "https://github.com/jhackisneros/examen_3/blob/main/base_datos/csv_manager.py"
    click libroCSV "https://github.com/jhackisneros/examen_3/blob/main/datos/libro.csv"
    click prestamosCSV "https://github.com/jhackisneros/examen_3/blob/main/datos/prestamos.csv"
    click usuariosCSV "https://github.com/jhackisneros/examen_3/blob/main/datos/usuarios.csv"

    %% Styles
    classDef ui fill:#ADD8E6,stroke:#333,stroke-width:1px
    classDef logic fill:#90EE90,stroke:#333,stroke-width:1px
    classDef dataaccess fill:#FFA07A,stroke:#333,stroke-width:1px
    classDef datastore fill:#D3D3D3,stroke:#333,stroke-width:1px
```
