# kiwait1725/sistemainventario architecture

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

- Interactive diagram: https://gitdiagram.com/kiwait1725/sistemainventario
- Repository: https://github.com/kiwait1725/sistemainventario

## Overview

Para representar de forma precisa la arquitectura del “Sistema de Inventario” en un diagrama de diseño de sistema, sigue estos pasos detallados, adaptados al proyecto provisto:

##### Identificación del tipo de proyecto y propósito
- Es una aplicación monolítica de escritorio (cliente pesado) desarrollada en Python con PyQt6 para la interfaz gráfica y MySQL como base de datos.
- Se organiza internamente bajo un patrón similar a MVC:
- Views: componentes de interfaz (PyQt6)
- Controllers: lógica de interacción
- Models: representación de tablas de BD y objetos de dominio

##### Análisis de la estructura de carpetas
- app/main.py: punto de entrada de la aplicación.
- app/views: ventanas y formularios de PyQt6 (login, dashboard, gestión de productos, pedidos, proveedores, usuarios).
- app/controllers: clases que reciben eventos de la vista y coordinan operaciones.
- app/models: clases que mapean tablas (productos, proveedores, pedidos).
- app/utils/database.py: capa de conexión y ORM mínimo (MySQL Connector).
- app/utils/pdf: generación de manuales PDF.
- app/utils/scripts: recursos de inicialización (SQL scripts, CSV, JSON para sesiones y contraseñas).
- app/images: assets gráficos para la UI.

##### Inspección del README
- Confirma tecnologías: Python 3.10+, PyQt6, MySQL.
- Módulos: autenticación, gestión de productos, proveedores y dashboard.
- Indica flujo básico: usuario → login → módulo → CRUD → BD.

##### Componentes clave a incluir en el diagrama
a. Interfaz de usuario (UI Layer)
- Vista de Login
- Dashboard
- Vistas CRUD (Productos, Proveedores, Pedidos, Usuarios)
b. Lógica de aplicación (Controller Layer)
- Orden de llamadas: Views → Controllers
c. Capa de datos (Data Layer)
- Models → MySQL Database
- Módulo de conexión: app/utils/database.py
d. Recursos auxiliares
- Scripts de inicialización (SQL, JSON, CSV)
- Generador de PDF (user_instruction.pdf)
- Assets gráficos

##### Relaciones e interacciones
- El usuario interactúa con la UI (flechas bidireccionales de View ↔ User).
- Cada vista envía eventos al controller correspondiente (flechas View → Controller).
- El controller invoca operations en Model y/o en app/utils/database.py (flechas Controller → Model/Data).
- El Model traduce llamadas a consultas SQL y retorna datos al Controller (Model ↔ Database).
- El Controller actualiza la View con resultados o abre PDFs desde app/utils/pdf.
- Scripts de arranque (SQL, JSON) inicializan la BD al desplegar (relación externa con Database).

##### Patrones y principios arquitectónicos
- MVC (separación clara entre UI, lógica de negocio y datos).
- Módulos cohesionados: controllers solo manejan lógica, views la presentación, models la persistencia.
- Dependencia unidireccional: View → Controller → Model → Database.

##### Guía para un diagrama de aplicación de escritorio
- Dibuja capas horizontales o verticales:
[Usuario] → [UI Layer (Views)] → [Controller Layer] → [Data Layer (Models + DB)]
- Muestra los recursos auxiliares en un área aparte con conexiones a las capas que los usan (p.ej., PDF generator conectado al Controller).
- Incluye el módulo de conexión a BD como componente separado.
- Añade un “Contexto de Entorno” para scripts de inicialización y configuración (JSON, CSV, SQL files).

##### Elementos gráficos recomendados
- Etiquetas claras: nombres de componentes igual a los de carpetas/archivos (e.g., “productos_view”, “orders_con”).
- Flechas con dirección para flujos: UI → Controlador → Modelo → BD.
- Azul (UI/Views)
- Verde (Controllers)
- Naranja (Models / Data Layer)
- Gris (Utils / scripts / recursos estáticos)
- Leyenda en el diagrama explicando colores y símbolos.

##### Detalle adicional
- Incluye main.py como orquestador principal que inicializa la ventana de login.
- Señala la conexión a MySQL indicando host/puerto en la capa de datos.
- Marca la dependencia de PyQt6 y mysql-connector en las capas correspondientes.

Con este enfoque, tendrás un diagrama detallado, modular y fiel a la estructura del repositorio, que resaltará claramente los componentes, sus interacciones y las tecnologías usadas.

## Diagram (Mermaid)

```mermaid
flowchart TD
    %% Actors
    User["Usuario"]:::external
    Main["app/main.py"]:::orchestrator

    %% UI Layer
    subgraph "UI Layer (Views)"
        direction TB
        Login["Login View"]:::ui
        Dashboard["Dashboard View"]:::ui
        ProductosView["Productos CRUD View"]:::ui
        OrdersView["Orders CRUD View"]:::ui
        SuppliersView["Suppliers CRUD View"]:::ui
        UsersView["Users CRUD View"]:::ui
    end

    %% Controller Layer
    subgraph "Controller Layer"
        direction TB
        ProductsCon["Products Controller"]:::controller
        OrdersCon["Orders Controller"]:::controller
        SuppliersCon["Suppliers Controller"]:::controller
        UsersCon["Users Controller"]:::controller
    end

    %% Data Layer
    subgraph "Data Layer"
        direction TB
        ProductosModel["Producto Model"]:::data
        PedidoModel["Pedido Model"]:::data
        ProveedorModel["Proveedor Model"]:::data
        Database["MySQL Database"]:::database
    end

    %% Utils and Resources
    subgraph "Utils / Resources"
        direction TB
        DBConn["Database Connection\n(app/utils/database.py)"]:::utils
        PDFGen["User Instruction PDF"]:::utils
        Scripts["Initialization Scripts"]:::utils
        Images["Static Assets (Graphics)"]:::utils
    end

    %% Environment Context
    subgraph "Environment Context"
        direction TB
        SQLInit["SQL Scripts"]:::utils
        CSVRes["CSV Resources"]:::utils
        JSONConf["JSON Configurations"]:::utils
    end

    %% Connections
    User -->|interactúa con| Login
    User -->|interactúa con| Dashboard
    User -->|interactúa con| ProductosView
    User -->|interactúa con| OrdersView
    User -->|interactúa con| SuppliersView
    User -->|interactúa con| UsersView

    Main -->|inicia| Login

    %% UI to Controllers
    Login -->|events| UsersCon
    Dashboard -->|events| ProductsCon
    ProductosView -->|events| ProductsCon
    OrdersView -->|events| OrdersCon
    SuppliersView -->|events| SuppliersCon
    UsersView -->|events| UsersCon

    %% Controllers to Models and DBConn
    ProductsCon -->|CRUD ops| ProductosModel
    OrdersCon -->|CRUD ops| PedidoModel
    SuppliersCon -->|CRUD ops| ProveedorModel
    UsersCon -->|CRUD ops| Database
    ProductsCon -->|usa| DBConn
    OrdersCon -->|usa| DBConn
    SuppliersCon -->|usa| DBConn
    UsersCon -->|usa| DBConn

    %% Models to Database
    ProductosModel -->|queries| Database
    PedidoModel -->|queries| Database
    ProveedorModel -->|queries| Database

    %% PDF Generation
    UsersCon -->|genera manual| PDFGen

    %% Utils to Database
    DBConn -->|conecta a| Database
    SQLInit -->|inicializa| Database
    CSVRes -->|carga datos| Database
    JSONConf -->|configura| Database

    %% Resources
    Scripts --> SQLInit
    Scripts --> CSVRes
    Scripts --> JSONConf
    Images -.-> Dashboard

    %% Click Events
    click Main "https://github.com/kiwait1725/sistemainventario/blob/master/app/main.py"
    click Login "https://github.com/kiwait1725/sistemainventario/blob/master/app/views/login_view.py"
    click Dashboard "https://github.com/kiwait1725/sistemainventario/blob/master/app/views/Dashboard.py"
    click ProductosView "https://github.com/kiwait1725/sistemainventario/blob/master/app/views/productos_view.py"
    click OrdersView "https://github.com/kiwait1725/sistemainventario/blob/master/app/views/orders_view.py"
    click SuppliersView "https://github.com/kiwait1725/sistemainventario/blob/master/app/views/suppliers_view.py"
    click UsersView "https://github.com/kiwait1725/sistemainventario/blob/master/app/views/user_view.py"
    click ProductsCon "https://github.com/kiwait1725/sistemainventario/blob/master/app/controllers/products_con.py"
    click OrdersCon "https://github.com/kiwait1725/sistemainventario/blob/master/app/controllers/orders_con.py"
    click SuppliersCon "https://github.com/kiwait1725/sistemainventario/blob/master/app/controllers/suppliers_con.py"
    click UsersCon "https://github.com/kiwait1725/sistemainventario/blob/master/app/controllers/user_con.py"
    click ProductosModel "https://github.com/kiwait1725/sistemainventario/blob/master/app/models/productos.py"
    click PedidoModel "https://github.com/kiwait1725/sistemainventario/blob/master/app/models/pedidos.py"
    click ProveedorModel "https://github.com/kiwait1725/sistemainventario/blob/master/app/models/proveedores.py"
    click DBConn "https://github.com/kiwait1725/sistemainventario/blob/master/app/utils/database.py"
    click PDFGen "https://github.com/kiwait1725/sistemainventario/blob/master/app/utils/pdf/user_instruction.pdf"
    click SQLInit "https://github.com/kiwait1725/sistemainventario/blob/master/app/utils/scripts/sql/sistema_db.sql"
    click CSVRes "https://github.com/kiwait1725/sistemainventario/blob/master/app/utils/scripts/documents/registros_productos.csv"
    click JSONConf "https://github.com/kiwait1725/sistemainventario/blob/master/app/utils/scripts/json/contraseñas.json"

    %% Styling
    classDef external fill:#ffffff,stroke:#000,stroke-width:1px
    classDef orchestrator fill:#f0f0f0,stroke:#999,stroke-width:1px
    classDef ui fill:#add8e6,stroke:#036,stroke-width:1px
    classDef controller fill:#98fb98,stroke:#060,stroke-width:1px
    classDef data fill:#ffcc99,stroke:#c60,stroke-width:1px
    classDef database fill:#ffcc99,stroke:#c60,stroke-width:2px,stroke-dasharray: 5 5
    classDef utils fill:#d3d3d3,stroke:#666,stroke-width:1px
```
