# lucasgomezponce/smarthome architecture

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

- Interactive diagram: https://gitdiagram.com/lucasgomezponce/smarthome
- Repository: https://github.com/lucasgomezponce/smarthome

## Overview

Para diseñar el diagrama de arquitectura más claro y preciso para “SmartHome Solutions – Sistema Básico de Gestión de Dispositivos”, sigue estos pasos:

##### Identificación del tipo de proyecto y propósito
- Este es una aplicación de consola (CLI) en Python para la gestión de dispositivos inteligentes en el hogar.
- No hay servicios externos ni bases de datos; todos los datos se guardan en memoria como una lista de diccionarios.

##### Análisis de la estructura de ficheros
- main.py: Punto de entrada, menú principal y flujo de control.
- dispositivos.py: Módulo con funciones CRUD (crear, leer, eliminar) y generación de ID para dispositivos.
- automatizacion.py: Módulo responsable del “Modo Ahorro de Energía” que filtra/apaga dispositivos no esenciales.
- utils.py: Funciones auxiliares (p. ej., validaciones, formateo de datos).
- __pycache__: Caché de Python, sin relevancia en el diagrama lógico.

##### Insights del README
- Cada miembro del equipo implementa una funcionalidad principal (menú, listado, adición, búsqueda, eliminación, automatización).
- El modelo de datos es una lista en memoria de diccionarios, cada uno con atributos como ID, nombre y esencialidad.

##### Componentes principales y relaciones
a. Componentes:
- CLI (main.py)
- Módulo Dispositivos (dispositivos.py)
- Módulo Automatización (automatizacion.py)
- Módulo Utilidades (utils.py)
- Data Store en memoria (lista de diccionarios)
b. Interacciones:
- CLI → llama a funciones de Dispositivos para crear, buscar y eliminar.
- CLI → invoca Automatización para activar/desactivar modo ahorro.
- Dispositivos y Automatización → usan Utilidades para validaciones y formateo.
- Todos los módulos comparten la “lista de dispositivos” como único repositorio de datos.
c. Patrones y principios:
- Separación por responsabilidad (módulos bien acotados).
- Flujo unidireccional de datos (CLI coordina, módulos especializados gestionan datos).
d. Tecnologías clave:
- Python 3.x
- Estructuras nativas (diccionarios, listas)
- Programación orientada a objetos y modularidad.

##### Guía para el diagrama (módulo compacto / herramienta CLI)
- Dibuja un rectángulo para el CLI (“main.py”).
- Dibuja otros rectángulos para cada módulo: Dispositivos, Automatización y Utilidades.
- Representa la “lista de dispositivos” como un cilindro o contenedor de datos en memoria.
- Conecta el CLI con flechas hacia los módulos Dispositivos y Automatización (indicando llamadas de función).
- Desde Dispositivos y Automatización, traza flechas hacia la “lista de dispositivos” (lectura/escritura).
- Haz flechas desde Dispositivos y Automatización hacia Utilidades (uso de helpers).

##### Elementos a incluir en el diagrama
- Etiquetas claras (nombre de cada módulo).
- Flechas direccionales para cada llamada o flujo de datos:
- “main.py → crear_dispositivo() → dispositivos.py”
- “dispositivos.py ↔ lista_dispositivos (read/write)”
- “main.py → activar_modo_ahorro() → automatizacion.py”
- Azul para módulos de negocio (Dispositivos, Automatización)
- Verde para el CLI
- Gris para utilidades
- Amarillo para el almacén en memoria

##### Detalle y precisión
- No agregues componentes innecesarios; muestra cada módulo real del proyecto.
- Señala en notas al lado de cada módulo las funciones clave (por ejemplo, “dispositivos.py: add_device(), find_by_id(), delete_device()”).
- Asegúrate de que las flechas reflejen correctamente si es lectura, escritura o simple invocación de función.

Resultado: un diagrama modular, con etiquetas y flechas claras, que refleja fielmente la arquitectura en memoria y la interacción entre main.py y los módulos especializados, destacando la ruta de datos (lista de dispositivos) y la responsabilidad de cada componente.

## Diagram (Mermaid)

```mermaid
flowchart TB
    %% Nodes
    CLI["main.py\n(menu principal, flujo de control)"]:::cli
    Dispositivos["dispositivos.py\nadd_device(), find_by_id(), delete_device()"]:::business
    Automatizacion["automatizacion.py\nactivar_modo_ahorro()"]:::business
    Utils["utils.py\nvalidaciones, formateo"]:::utils
    DataStore["Lista de dispositivos\n(in-memory)"]:::storage

    %% Connections
    CLI -->|"crear_dispositivo()/buscar/eliminar"| Dispositivos
    CLI -->|"activar_modo_ahorro()"| Automatizacion
    Dispositivos -->|"read/write"| DataStore
    Automatizacion -->|"read/write"| DataStore
    Dispositivos -->|"utiliza"| Utils
    Automatizacion -->|"utiliza"| Utils

    %% Click events
    click CLI "https://github.com/lucasgomezponce/smarthome/blob/master/main.py"
    click Dispositivos "https://github.com/lucasgomezponce/smarthome/blob/master/dispositivos.py"
    click Automatizacion "https://github.com/lucasgomezponce/smarthome/blob/master/automatizacion.py"
    click Utils "https://github.com/lucasgomezponce/smarthome/blob/master/utils.py"

    %% Styles
    classDef cli fill:#ccffcc,stroke:#333,stroke-width:1px
    classDef business fill:#cce5ff,stroke:#333,stroke-width:1px
    classDef utils fill:#e0e0e0,stroke:#333,stroke-width:1px
    classDef storage fill:#ffffcc,stroke:#333,stroke-width:1px
```
