# melzt1/inventario-para-pymes architecture

> Architecture diagram of the GitHub repository melzt1/inventario-para-pymes, generated by GitDiagram from its file tree, README and a sample of source files (last updated 2026-11-20). It is an AI-made overview: check details against the source.

- Interactive diagram: https://gitdiagram.com/melzt1/inventario-para-pymes
- Repository: https://github.com/melzt1/inventario-para-pymes

## Overview

Aplicación de inventario para PYMEs operada por terminal: el usuario inicia sesión y navega menús para gestionar catálogos, almacenes, inventario y movimientos; las operaciones pasan por presentación, reglas de negocio y persistencia Peewee/MySQL. El README documenta además usuarios, roles, secciones, asignaciones y borrado lógico. Los vínculos entre capas se apoyan en el README y las referencias del SOURCE INDEX; no se inspeccionó el código de los módulos marcados como no leídos.

Main entry points: [`presentacion/menu.py`](https://github.com/melzt1/inventario-para-pymes/blob/main/presentacion/menu.py) (Menús y despacho), [`datos/repositorios`](https://github.com/melzt1/inventario-para-pymes/tree/main/datos/repositorios) (Consultas por entidad), [`presentacion`](https://github.com/melzt1/inventario-para-pymes/tree/main/presentacion) (Catálogos), [`presentacion/presentacion_inventario.py`](https://github.com/melzt1/inventario-para-pymes/blob/main/presentacion/presentacion_inventario.py) (Inventario y movimientos)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_ui["Interacción terminal"]
  node_entry["Arranque<br/>[app.py]"]
  node_session_ui["Inicio de sesión"]
  node_menus["Menús y despacho<br/>[menu.py]"]
  node_catalog_ui["Catálogos"]
  node_inventory_ui["Inventario y movimientos"]
  node_movement_ui["Operaciones de movimiento"]
  node_user_ui["Usuarios y almacenes"]
end

subgraph group_business["Reglas de negocio"]
  node_session["Autenticación y sesión<br/>[negocio_sesion.py]"]
  node_catalog_rules["Reglas de catálogos"]
  node_inventory_rules["Reglas de inventario"]
  node_movement_rules["Reglas de movimientos"]
  node_user_rules["Reglas de usuarios<br/>[negocio_usuario.py]"]
  node_assignment_rules["Asignaciones y secciones"]
end

subgraph group_data["Persistencia"]
  node_repositories["Consultas por entidad"]
  node_models["Modelos Peewee"]
  node_connection["Conexión DB<br/>[conexion.py]"]
end

subgraph group_shared["Servicios compartidos"]
  node_input["Entrada validada<br/>[entradas.py]"]
  node_messages["Mensajes y menús<br/>[mensajes.py]"]
  node_security["Seguridad de contraseñas<br/>[seguridad.py]"]
  node_validation["Validaciones comunes<br/>[validaciones.py]"]
end

node_user(("Usuario terminal"))
node_mysql[("MySQL")]

node_user -->|"inicia"| node_entry
node_entry -->|"abre sesión"| node_session_ui
node_menus -->|"despacha"| node_session_ui
node_menus -->|"despacha"| node_catalog_ui
node_menus -->|"despacha"| node_inventory_ui
node_menus -->|"despacha"| node_movement_ui
node_menus -->|"despacha"| node_user_ui
node_session_ui -.->|"solicita autenticación"| node_session
node_catalog_ui -->|"solicita operaciones"| node_catalog_rules
node_inventory_ui -->|"solicita operaciones"| node_inventory_rules
node_movement_ui -->|"solicita operaciones"| node_movement_rules
node_user_ui -->|"solicita operaciones"| node_user_rules
node_user_rules -->|"verifica contraseñas"| node_security
node_user_rules -->|"consulta y guarda"| node_repositories
node_catalog_rules -->|"consulta y guarda"| node_repositories
node_movement_rules -->|"consulta movimientos"| node_repositories
node_inventory_rules -.->|"consulta inventario"| node_repositories
node_assignment_rules -.->|"consulta y guarda"| node_repositories
node_repositories -->|"opera sobre modelos"| node_models
node_models -->|"obtiene conexión"| node_connection
node_connection -->|"conecta"| node_mysql
node_catalog_ui -->|"valida entrada"| node_input
node_inventory_ui -->|"valida entrada"| node_input
node_menus -->|"usa mensajes"| node_messages
node_catalog_rules -.->|"valida datos"| node_validation

click node_entry "https://github.com/melzt1/inventario-para-pymes/blob/main/app.py"
click node_session_ui "https://github.com/melzt1/inventario-para-pymes/blob/main/presentacion/presentacion_sesion.py"
click node_menus "https://github.com/melzt1/inventario-para-pymes/blob/main/presentacion/menu.py"
click node_catalog_ui "https://github.com/melzt1/inventario-para-pymes/tree/main/presentacion"
click node_inventory_ui "https://github.com/melzt1/inventario-para-pymes/blob/main/presentacion/presentacion_inventario.py"
click node_movement_ui "https://github.com/melzt1/inventario-para-pymes/blob/main/presentacion/presentacion_movimiento.py"
click node_user_ui "https://github.com/melzt1/inventario-para-pymes/tree/main/presentacion"
click node_session "https://github.com/melzt1/inventario-para-pymes/blob/main/negocio/negocio_sesion.py"
click node_catalog_rules "https://github.com/melzt1/inventario-para-pymes/tree/main/negocio"
click node_inventory_rules "https://github.com/melzt1/inventario-para-pymes/blob/main/negocio/negocio_inventario.py"
click node_movement_rules "https://github.com/melzt1/inventario-para-pymes/blob/main/negocio/negocio_movimiento.py"
click node_user_rules "https://github.com/melzt1/inventario-para-pymes/blob/main/negocio/negocio_usuario.py"
click node_assignment_rules "https://github.com/melzt1/inventario-para-pymes/tree/main/negocio"
click node_repositories "https://github.com/melzt1/inventario-para-pymes/tree/main/datos/repositorios"
click node_models "https://github.com/melzt1/inventario-para-pymes/tree/main/datos/modelos"
click node_input "https://github.com/melzt1/inventario-para-pymes/blob/main/auxiliares/entradas.py"
click node_messages "https://github.com/melzt1/inventario-para-pymes/blob/main/auxiliares/mensajes.py"
click node_security "https://github.com/melzt1/inventario-para-pymes/blob/main/auxiliares/seguridad.py"
click node_validation "https://github.com/melzt1/inventario-para-pymes/blob/main/auxiliares/validaciones.py"
click node_connection "https://github.com/melzt1/inventario-para-pymes/blob/main/datos/conexion.py"

classDef toneNeutral fill:#f8fafc,stroke:#334155,stroke-width:1.5px,color:#0f172a
classDef toneBlue fill:#dbeafe,stroke:#2563eb,stroke-width:1.5px,color:#172554
classDef toneAmber fill:#fef3c7,stroke:#d97706,stroke-width:1.5px,color:#78350f
classDef toneMint fill:#dcfce7,stroke:#16a34a,stroke-width:1.5px,color:#14532d
classDef toneRose fill:#ffe4e6,stroke:#e11d48,stroke-width:1.5px,color:#881337
classDef toneIndigo fill:#e0e7ff,stroke:#4f46e5,stroke-width:1.5px,color:#312e81
classDef toneTeal fill:#ccfbf1,stroke:#0f766e,stroke-width:1.5px,color:#134e4a
class node_entry,node_session_ui,node_menus,node_catalog_ui,node_inventory_ui,node_movement_ui,node_user_ui toneBlue
class node_session,node_catalog_rules,node_inventory_rules,node_movement_rules,node_user_rules,node_assignment_rules,node_mysql toneAmber
class node_repositories,node_models,node_connection toneMint
class node_input,node_messages,node_security,node_validation toneRose
class node_user toneIndigo
```

## Components

### Interacción terminal

- [Arranque](https://github.com/melzt1/inventario-para-pymes/blob/main/app.py): `app.py`
- [Inicio de sesión](https://github.com/melzt1/inventario-para-pymes/blob/main/presentacion/presentacion_sesion.py): `presentacion/presentacion_sesion.py`
- [Menús y despacho](https://github.com/melzt1/inventario-para-pymes/blob/main/presentacion/menu.py): `presentacion/menu.py`
- [Catálogos](https://github.com/melzt1/inventario-para-pymes/tree/main/presentacion): `presentacion`
- [Inventario y movimientos](https://github.com/melzt1/inventario-para-pymes/blob/main/presentacion/presentacion_inventario.py): `presentacion/presentacion_inventario.py`
- [Operaciones de movimiento](https://github.com/melzt1/inventario-para-pymes/blob/main/presentacion/presentacion_movimiento.py): `presentacion/presentacion_movimiento.py`
- [Usuarios y almacenes](https://github.com/melzt1/inventario-para-pymes/tree/main/presentacion): `presentacion`

### Reglas de negocio

- [Autenticación y sesión](https://github.com/melzt1/inventario-para-pymes/blob/main/negocio/negocio_sesion.py): `negocio/negocio_sesion.py`
- [Reglas de catálogos](https://github.com/melzt1/inventario-para-pymes/tree/main/negocio): `negocio`
- [Reglas de inventario](https://github.com/melzt1/inventario-para-pymes/blob/main/negocio/negocio_inventario.py): `negocio/negocio_inventario.py`
- [Reglas de movimientos](https://github.com/melzt1/inventario-para-pymes/blob/main/negocio/negocio_movimiento.py): `negocio/negocio_movimiento.py`
- [Reglas de usuarios](https://github.com/melzt1/inventario-para-pymes/blob/main/negocio/negocio_usuario.py): `negocio/negocio_usuario.py`
- [Asignaciones y secciones](https://github.com/melzt1/inventario-para-pymes/tree/main/negocio): `negocio`

### Persistencia

- [Consultas por entidad](https://github.com/melzt1/inventario-para-pymes/tree/main/datos/repositorios): `datos/repositorios`
- [Modelos Peewee](https://github.com/melzt1/inventario-para-pymes/tree/main/datos/modelos): `datos/modelos`
- [Conexión DB](https://github.com/melzt1/inventario-para-pymes/blob/main/datos/conexion.py): `datos/conexion.py`

### Servicios compartidos

- [Entrada validada](https://github.com/melzt1/inventario-para-pymes/blob/main/auxiliares/entradas.py): `auxiliares/entradas.py`
- [Mensajes y menús](https://github.com/melzt1/inventario-para-pymes/blob/main/auxiliares/mensajes.py): `auxiliares/mensajes.py`
- [Seguridad de contraseñas](https://github.com/melzt1/inventario-para-pymes/blob/main/auxiliares/seguridad.py): `auxiliares/seguridad.py`
- [Validaciones comunes](https://github.com/melzt1/inventario-para-pymes/blob/main/auxiliares/validaciones.py): `auxiliares/validaciones.py`

### Other components

- **Usuario terminal**
- **MySQL**

## Connections

- Usuario terminal → Arranque: inicia (evidence: `README.md`)
- Arranque → Inicio de sesión: abre sesión (evidence: `app.py`)
- Menús y despacho → Inicio de sesión: despacha (evidence: `presentacion/menu.py`)
- Menús y despacho → Catálogos: despacha (evidence: `presentacion/menu.py`)
- Menús y despacho → Inventario y movimientos: despacha (evidence: `presentacion/menu.py`)
- Menús y despacho → Operaciones de movimiento: despacha (evidence: `presentacion/menu.py`)
- Menús y despacho → Usuarios y almacenes: despacha (evidence: `presentacion/menu.py`)
- Inicio de sesión → Autenticación y sesión: solicita autenticación
- Catálogos → Reglas de catálogos: solicita operaciones (evidence: `presentacion/presentacion_producto.py`)
- Inventario y movimientos → Reglas de inventario: solicita operaciones (evidence: `presentacion/presentacion_inventario.py`)
- Operaciones de movimiento → Reglas de movimientos: solicita operaciones (evidence: `presentacion/presentacion_movimiento.py`)
- Usuarios y almacenes → Reglas de usuarios: solicita operaciones (evidence: `presentacion/presentacion_usuario.py`)
- Reglas de usuarios → Seguridad de contraseñas: verifica contraseñas (evidence: `negocio/negocio_usuario.py`)
- Reglas de usuarios → Consultas por entidad: consulta y guarda (evidence: `negocio/negocio_usuario.py`)
- Reglas de catálogos → Consultas por entidad: consulta y guarda (evidence: `negocio/negocio_producto.py`)
- Reglas de movimientos → Consultas por entidad: consulta movimientos (evidence: `negocio/negocio_movimiento.py`)
- Reglas de inventario → Consultas por entidad: consulta inventario
- Asignaciones y secciones → Consultas por entidad: consulta y guarda (evidence: `negocio/negocio_usuario.py`)
- Consultas por entidad → Modelos Peewee: opera sobre modelos (evidence: `datos/repositorios/repositorio_inventario.py`)
- Modelos Peewee → Conexión DB: obtiene conexión (evidence: `datos/modelos/models.py`)
- Conexión DB → MySQL: conecta (evidence: `README.md`)
- Catálogos → Entrada validada: valida entrada (evidence: `presentacion/presentacion_producto.py`)
- Inventario y movimientos → Entrada validada: valida entrada (evidence: `presentacion/presentacion_inventario.py`)
- Menús y despacho → Mensajes y menús: usa mensajes (evidence: `presentacion/menu.py`)
- Reglas de catálogos → Validaciones comunes: valida datos (evidence: `negocio/negocio_proveedor.py`)
