# elmarcinho/proyecto-final-mcdia-mod1 architecture

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

- Interactive diagram: https://gitdiagram.com/elmarcinho/proyecto-final-mcdia-mod1
- Repository: https://github.com/elmarcinho/proyecto-final-mcdia-mod1

## Overview

Para representar de forma precisa la arquitectura de este sistema de gestión de imágenes médicas COVID‑19 (una aplicación CLI en Python con patrón MVC y almacenamiento en JSON + sistema de archivos), sigue estos pasos:

##### Identificación de componentes principales
- **Presentación (Vista)**
- Módulo utils/menu.py
- main.py como entry‑point que invoca el menú
- **Controlador**
- controllers/controller_image.py
- **Modelo**
- models/model_image.py (clase Image + metadata)
- models/storage.py (abstracción de lectura/escritura JSON)
- **Servicio de persistencia (Capa Data Access)**
- services/storage.py
- Lectura/escritura del archivo storage.json
- Manejo de nuevas imágenes en new_images/ y services/dataset/images/
- **Almacenamiento**
- Archivo storage.json (cilindro en el diagrama)
- Carpetas de imágenes en disco (new_images/ y services/dataset/images/)
- **Dependencias externas**
- OpenCV, NumPy (representados como cajas auxiliares o nubes externas)

##### Relaciones e interacciones
- El **Usuario** (CLI) → selecciona opción en **Vista** (utils/menu)
- **Vista** → invoca métodos del **Controlador**
- **Controlador** → orquesta la lógica, crea/lee/actualiza/elimina instancias de **Modelos**
- **Modelos** + **Servicio de persistencia** → acceden a **storage.json** y al sistema de archivos
- **Servicio** retorna datos al **Controlador**, que finalmente devuelve resultados a la **Vista**

##### Patrón arquitectónico
- Se trata de un clásico **MVC en capas**:
[CLI View] → [Controller] → [Service/DAO] → [Data Storage]
- Modularización clara: cada carpeta representa una capa distinta
- Principio de responsabilidad única: modelos no tocan I/O, controladores no tocan disco directamente

##### Tecnologías clave
- Lenguaje: Python 3.12+
- Persistencia: JSON + sistema de archivos local
- Procesamiento de imágenes: OpenCV, NumPy

##### Guía para el diagrama
- Usa **rectángulos** para módulos/paquetes (por ejemplo, “controllers/”, “models/”).
- Usa **cilindros** para artefactos de almacenamiento (storage.json, carpetas de imágenes).
- Representa **nubes o cajas auxiliares** para dependencias externas (OpenCV, NumPy).
- Dibuja **flechas dirigidas** para indicar flujos de datos y llamadas (menu → controller → service → storage).
- Emplea **colores distintos** para cada capa:
- Azul claro = Vista/CLI
- Verde = Controlador
- Amarillo = Modelo/Servicio
- Gris cilindro = Almacenamiento

##### Detalles adicionales a capturar
- Módulo `main.py` como punto de entrada conecta directo con `menu.py`.
- La carpeta `services/dataset/` almacena el dataset original (solo lectura).
- `new_images/` representa el área de staging para nuevas radiografías.
- Enumerar métodos clave en cada componente: e.g., `ControllerImage.create()`, `StorageService.save_metadata()`, `ModelImage.load()`.

##### Adaptación al tipo de proyecto (CLI/Tool)
- Enfatiza el flujo de comandos de texto → controladores → persistencia.
- Destaca puntos de extensión:
- Sustitución de JSON por DB relacional (futura migración).
- Interfaz gráfica en lugar de CLI (futuro GUI).

##### Elementos del diagrama final
- **Etiquetas claras** en cada caja/objeto
- **Flechas con dirección** y, si lo deseas, anotaciones de “request/response”
- **Leyenda de colores** o formas para cada tipo de componente
- **Notas** sobre tecnologías (OpenCV, NumPy) y formatos de datos (JSON, JPEG/PNG)

Siguiendo esta guía tu diagrama mostrará con claridad la separación en capas, los flujos de datos y las dependencias críticas, capturando la esencia arquitectónica de este sistema MVC CLI de gestión de imágenes médicas COVID‑19.

## Diagram (Mermaid)

```mermaid
flowchart TB
    %% Presentation Layer
    subgraph "Presentation (View)"
        Main["main.py"]:::view
        Menu["utils/menu.py"]:::view
    end

    %% Controller Layer
    subgraph "Controller"
        ControllerImage["controllers/controller_image.py\nControllerImage"]:::controller
    end

    %% Model Layer
    subgraph "Model"
        ModelImage["models/model_image.py\nImageModel"]:::model
        StorageAbstraction["models/storage.py\nStorage"]:::model
    end

    %% Service/DAO Layer
    subgraph "Service/DAO"
        StorageService["services/storage.py\nStorageService"]:::service
    end

    %% Data Storage
    subgraph "Data Storage"
        JSON["storage.json"]:::storage
        NewImages["new_images/"]:::storage
        DatasetImages["services/dataset/images/"]:::storage
        MetadataCSV["services/dataset/COVID.metadata.csv"]:::storage
    end

    %% External Dependencies
    OpenCV["OpenCV"]:::external
    NumPy["NumPy"]:::external

    %% Flows
    Main -->|invokes| Menu
    Menu -->|calls| ControllerImage
    ControllerImage -->|orchestrates| ModelImage
    ControllerImage -->|uses| StorageService
    ControllerImage -->|processes images with| OpenCV
    ControllerImage -->|processes math with| NumPy

    ModelImage -->|loads/saves metadata via| StorageAbstraction
    StorageAbstraction -->|I/O JSON| JSON

    StorageService -->|read/write metadata| JSON
    StorageService -->|store new files| NewImages
    StorageService -->|read-only dataset images| DatasetImages
    StorageService -->|read-only dataset metadata| MetadataCSV

    %% Click Events
    click Main "https://github.com/elmarcinho/proyecto-final-mcdia-mod1/blob/main/main.py"
    click Menu "https://github.com/elmarcinho/proyecto-final-mcdia-mod1/blob/main/utils/menu.py"
    click ControllerImage "https://github.com/elmarcinho/proyecto-final-mcdia-mod1/blob/main/controllers/controller_image.py"
    click ModelImage "https://github.com/elmarcinho/proyecto-final-mcdia-mod1/blob/main/models/model_image.py"
    click StorageAbstraction "https://github.com/elmarcinho/proyecto-final-mcdia-mod1/blob/main/models/storage.py"
    click StorageService "https://github.com/elmarcinho/proyecto-final-mcdia-mod1/blob/main/services/storage.py"
    click JSON "https://github.com/elmarcinho/proyecto-final-mcdia-mod1/blob/main/storage.json"
    click NewImages "https://github.com/elmarcinho/proyecto-final-mcdia-mod1/tree/main/new_images/"
    click DatasetImages "https://github.com/elmarcinho/proyecto-final-mcdia-mod1/tree/main/services/dataset/images/"
    click MetadataCSV "https://github.com/elmarcinho/proyecto-final-mcdia-mod1/blob/main/services/dataset/COVID.metadata.csv"

    %% Styles
    classDef view fill:#ADD8E6,stroke:#333,stroke-width:1px
    classDef controller fill:#90EE90,stroke:#333,stroke-width:1px
    classDef model fill:#FFFF99,stroke:#333,stroke-width:1px
    classDef service fill:#FFFACD,stroke:#333,stroke-width:1px
    classDef storage fill:#D3D3D3,stroke:#333,stroke-width:1px,stroke-dasharray: 5 5
    classDef external fill:#DDDDFF,stroke:#333,stroke-width:1px,stroke-dasharray: 2 2
```
