# will930u/album_digital architecture

> Architecture diagram of the GitHub repository will930u/album_digital, generated by GitDiagram from its file tree, README and a sample of source files (last updated 2026-10-08). It is an AI-made overview: check details against the source.

- Interactive diagram: https://gitdiagram.com/will930u/album_digital
- Repository: https://github.com/will930u/album_digital

## Overview

This is a small Flask backend for an Álbum Digital service. Its main workflow receives purchase or withdrawal requests and sends the supplied details to an administrator through Telegram. It also accepts Telegram commands and exposes a BCV rate lookup backed by DolarApi. The sampled app.py shows these routes and integrations; the README is empty, and index.html was not sampled, so frontend behavior and any Supabase data workflow are not represented.

Main entry points: [`app.py`](https://github.com/will930u/album_digital/blob/main/app.py) (Telegram Sender)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_api["HTTP API"]
  node_purchase["Purchase Notice<br/>[app.py]"]
  node_withdrawal["Withdrawal Notice<br/>[app.py]"]
  node_telegram_webhook["Telegram Webhook<br/>[app.py]"]
end

subgraph group_notifications["Telegram Notifications"]
  node_telegram_sender["Telegram Sender<br/>[app.py]"]
end

subgraph group_rates["Rate Lookup"]
  node_bcv_rate["BCV Rate Route<br/>[app.py]"]
end

node_client(("API Client"))
node_telegram_platform(("Telegram Platform"))
node_dolarapi(("DolarApi"))

node_client -->|"posts purchase"| node_purchase
node_client -->|"posts withdrawal"| node_withdrawal
node_telegram_platform -->|"posts updates"| node_telegram_webhook
node_client -->|"requests rate"| node_bcv_rate
node_purchase -->|"sends notice"| node_telegram_sender
node_withdrawal -->|"sends notice"| node_telegram_sender
node_telegram_webhook -->|"sends replies"| node_telegram_sender
node_telegram_sender -->|"posts message"| node_telegram_platform
node_bcv_rate -->|"fetches rate"| node_dolarapi

click node_purchase "https://github.com/will930u/album_digital/blob/main/app.py"
click node_withdrawal "https://github.com/will930u/album_digital/blob/main/app.py"
click node_telegram_webhook "https://github.com/will930u/album_digital/blob/main/app.py"
click node_telegram_sender "https://github.com/will930u/album_digital/blob/main/app.py"
click node_bcv_rate "https://github.com/will930u/album_digital/blob/main/app.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_purchase,node_withdrawal,node_telegram_webhook,node_client toneBlue
class node_telegram_sender toneAmber
class node_bcv_rate,node_dolarapi toneMint
class node_telegram_platform toneIndigo
```

## Components

### HTTP API

- [Purchase Notice](https://github.com/will930u/album_digital/blob/main/app.py): `app.py`
- [Withdrawal Notice](https://github.com/will930u/album_digital/blob/main/app.py): `app.py`
- [Telegram Webhook](https://github.com/will930u/album_digital/blob/main/app.py): `app.py`

### Telegram Notifications

- [Telegram Sender](https://github.com/will930u/album_digital/blob/main/app.py): `app.py`

### Rate Lookup

- [BCV Rate Route](https://github.com/will930u/album_digital/blob/main/app.py): `app.py`

### Other components

- **API Client**
- **Telegram Platform**
- **DolarApi**

## Connections

- API Client → Purchase Notice: posts purchase (evidence: `app.py`)
- API Client → Withdrawal Notice: posts withdrawal (evidence: `app.py`)
- Telegram Platform → Telegram Webhook: posts updates (evidence: `app.py`)
- API Client → BCV Rate Route: requests rate (evidence: `app.py`)
- Purchase Notice → Telegram Sender: sends notice (evidence: `app.py`)
- Withdrawal Notice → Telegram Sender: sends notice (evidence: `app.py`)
- Telegram Webhook → Telegram Sender: sends replies (evidence: `app.py`)
- Telegram Sender → Telegram Platform: posts message (evidence: `app.py`)
- BCV Rate Route → DolarApi: fetches rate (evidence: `app.py`)
