# cesarrondonm6-ui/deko-moda-telegram-bot architecture

> Architecture diagram of the GitHub repository cesarrondonm6-ui/deko-moda-telegram-bot, generated by GitDiagram from its file tree, README and a sample of source files (last updated 2026-09-25). It is an AI-made overview: check details against the source.

- Interactive diagram: https://gitdiagram.com/cesarrondonm6-ui/deko-moda-telegram-bot
- Repository: https://github.com/cesarrondonm6-ui/deko-moda-telegram-bot

## Overview

Deko Moda automatiza la preparación y publicación de productos de calzado: una persona envía fotos y especificaciones por Telegram, confirma el flujo y el sistema genera y revisa imágenes antes de publicar en Shopify. La vigilancia periódica desactiva productos vencidos y notifica el resultado. Los extractos muestran la captura, la espera de aprobación, partes de generación/QA, publicación y vigilancia; no permiten reconstruir todas las llamadas internas del pipeline.

Main entry points: [`pipeline.py`](https://github.com/cesarrondonm6-ui/deko-moda-telegram-bot/blob/main/pipeline.py) (Pipeline de producto), [`vigilancia_productos.py`](https://github.com/cesarrondonm6-ui/deko-moda-telegram-bot/blob/main/vigilancia_productos.py) (Vigilancia de vigencia), [`bot.py`](https://github.com/cesarrondonm6-ui/deko-moda-telegram-bot/blob/main/bot.py) (Bot de captura)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_intake["Captura y control"]
  node_bot["Bot de captura<br/>[bot.py]"]
  node_product_files["Archivos del producto"]
end

subgraph group_production["Preparación y publicación"]
  node_pipeline["Pipeline de producto<br/>[pipeline.py]"]
  node_image_generation["Generación de imágenes<br/>[pipeline.py]"]
  node_image_qa["Revisión de imágenes<br/>[pipeline.py]"]
  node_collage["Collage y entregables<br/>[pipeline.py]"]
  node_telegram_notify["Avisos y aprobación<br/>[pipeline.py]"]
end

subgraph group_lifecycle["Vigencia de productos"]
  node_monitor["Vigilancia de vigencia"]
  node_product_state[("Productos y metafields")]
end

node_operator(("Operador"))
node_telegram(("Telegram"))
node_shopify(("Tienda Shopify"))

node_operator -->|"envía fotos"| node_telegram
node_telegram -->|"entrega mensajes"| node_bot
node_bot -->|"guarda fotos y datos"| node_product_files
node_bot -->|"lanza pipeline"| node_pipeline
node_product_files -->|"lee datos"| node_pipeline
node_pipeline -->|"genera imágenes"| node_image_generation
node_pipeline -->|"verifica imágenes"| node_image_qa
node_pipeline -->|"genera collage"| node_collage
node_pipeline -->|"envía aviso y consulta"| node_telegram_notify
node_telegram -->|"devuelve respuesta"| node_pipeline
node_pipeline -->|"publica productos"| node_shopify
node_monitor -->|"lee vigencia"| node_product_state
node_monitor -->|"actualiza estado"| node_product_state
node_monitor -->|"consulta y desactiva"| node_shopify
node_monitor -->|"notifica vencimiento"| node_telegram

click node_bot "https://github.com/cesarrondonm6-ui/deko-moda-telegram-bot/blob/main/bot.py"
click node_pipeline "https://github.com/cesarrondonm6-ui/deko-moda-telegram-bot/blob/main/pipeline.py"
click node_image_generation "https://github.com/cesarrondonm6-ui/deko-moda-telegram-bot/blob/main/pipeline.py"
click node_image_qa "https://github.com/cesarrondonm6-ui/deko-moda-telegram-bot/blob/main/pipeline.py"
click node_collage "https://github.com/cesarrondonm6-ui/deko-moda-telegram-bot/blob/main/pipeline.py"
click node_telegram_notify "https://github.com/cesarrondonm6-ui/deko-moda-telegram-bot/blob/main/pipeline.py"
click node_monitor "https://github.com/cesarrondonm6-ui/deko-moda-telegram-bot/blob/main/vigilancia_productos.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_bot,node_product_files toneBlue
class node_pipeline,node_image_generation,node_image_qa,node_collage,node_telegram_notify toneAmber
class node_monitor,node_product_state toneMint
class node_operator,node_telegram,node_shopify toneIndigo
```

## Components

### Captura y control

- [Bot de captura](https://github.com/cesarrondonm6-ui/deko-moda-telegram-bot/blob/main/bot.py): `bot.py`
- **Archivos del producto**

### Preparación y publicación

- [Pipeline de producto](https://github.com/cesarrondonm6-ui/deko-moda-telegram-bot/blob/main/pipeline.py): `pipeline.py`
- [Generación de imágenes](https://github.com/cesarrondonm6-ui/deko-moda-telegram-bot/blob/main/pipeline.py): `pipeline.py`
- [Revisión de imágenes](https://github.com/cesarrondonm6-ui/deko-moda-telegram-bot/blob/main/pipeline.py): `pipeline.py`
- [Collage y entregables](https://github.com/cesarrondonm6-ui/deko-moda-telegram-bot/blob/main/pipeline.py): `pipeline.py`
- [Avisos y aprobación](https://github.com/cesarrondonm6-ui/deko-moda-telegram-bot/blob/main/pipeline.py): `pipeline.py`

### Vigencia de productos

- [Vigilancia de vigencia](https://github.com/cesarrondonm6-ui/deko-moda-telegram-bot/blob/main/vigilancia_productos.py): `vigilancia_productos.py`
- **Productos y metafields**

### Other components

- **Operador**
- **Telegram**
- **Tienda Shopify**

## Connections

- Operador → Telegram: envía fotos
- Telegram → Bot de captura: entrega mensajes
- Bot de captura → Archivos del producto: guarda fotos y datos
- Bot de captura → Pipeline de producto: lanza pipeline
- Archivos del producto → Pipeline de producto: lee datos
- Pipeline de producto → Generación de imágenes: genera imágenes
- Pipeline de producto → Revisión de imágenes: verifica imágenes
- Pipeline de producto → Collage y entregables: genera collage
- Pipeline de producto → Avisos y aprobación: envía aviso y consulta
- Telegram → Pipeline de producto: devuelve respuesta
- Pipeline de producto → Tienda Shopify: publica productos
- Vigilancia de vigencia → Productos y metafields: lee vigencia
- Vigilancia de vigencia → Productos y metafields: actualiza estado
- Vigilancia de vigencia → Tienda Shopify: consulta y desactiva
- Vigilancia de vigencia → Telegram: notifica vencimiento