# rodrigomatiaslopez/tp-integrador-algoritmos-y-estructuras-de-datos architecture

> Architecture diagram of the GitHub repository rodrigomatiaslopez/tp-integrador-algoritmos-y-estructuras-de-datos, generated by GitDiagram from its file tree, README and a sample of source files (last updated 2026-11-19). It is an AI-made overview: check details against the source.

- Interactive diagram: https://gitdiagram.com/rodrigomatiaslopez/tp-integrador-algoritmos-y-estructuras-de-datos
- Repository: https://github.com/rodrigomatiaslopez/tp-integrador-algoritmos-y-estructuras-de-datos

## Overview

This is a command-line music-library application. A user selects catalog, detail, search, sort, playlist, playback-history, queue, and file operations in the menu; the entry point delegates those operations to the catalog/player, algorithms, and persistence modules. The catalog models songs and recursive versions, while the player maintains a bounded playlist and uses stack and queue structures for playback. The excerpts establish the main delegation and data-structure relationships; unsampled menu branches are represented only where the README or source index supports them.

Main entry points: [`esqueleto/src/main.py`](https://github.com/rodrigomatiaslopez/tp-integrador-algoritmos-y-estructuras-de-datos/blob/main/esqueleto/src/main.py) (Menu and workflow), [`esqueleto/src/dominio/Fonoteca.py`](https://github.com/rodrigomatiaslopez/tp-integrador-algoritmos-y-estructuras-de-datos/blob/main/esqueleto/src/dominio/Fonoteca.py) (Catalog and player), [`esqueleto/src/tads/lista_enlazada.py`](https://github.com/rodrigomatiaslopez/tp-integrador-algoritmos-y-estructuras-de-datos/blob/main/esqueleto/src/tads/lista_enlazada.py) (Linked list), [`esqueleto/src/persistencia/binario.py`](https://github.com/rodrigomatiaslopez/tp-integrador-algoritmos-y-estructuras-de-datos/blob/main/esqueleto/src/persistencia/binario.py) (Binary persistence)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_application["CLI and domain"]
  node_main["Menu and workflow<br/>[main.py]"]
  node_fonoteca["Catalog and player<br/>[Fonoteca.py]"]
  node_song["Song model<br/>[cancion.py]"]
  node_config["Theme config<br/>[config.py]"]
  node_errors["Domain errors<br/>[excepciones.py]"]
end

subgraph group_algorithms["Catalog algorithms"]
  node_search["Catalog search<br/>[busqueda.py]"]
  node_sort["Catalog sorting<br/>[ordenamiento.py]"]
end

subgraph group_persistence["Persistence"]
  node_text["Text persistence<br/>[texto.py]"]
  node_binary["Binary persistence<br/>[binario.py]"]
  node_versions[("Song versions data<br/>[versiones.csv]")]
end

subgraph group_structures["Data structures"]
  node_linked["Linked list<br/>[lista_enlazada.py]"]
  node_node["List node<br/>[nodo.py]"]
  node_stack["Playback history stack<br/>[pila.py]"]
  node_queue["Upcoming songs queue<br/>[cola.py]"]
end

node_user(("User"))

node_user -->|"chooses operations"| node_main
node_main -->|"reads theme"| node_config
node_main -->|"delegates catalog and playback"| node_fonoteca
node_main -->|"calls search"| node_search
node_main -->|"calls sorting"| node_sort
node_main -->|"loads and saves"| node_text
node_main -->|"loads and saves"| node_binary
node_main -->|"builds catalog rows"| node_song
node_fonoteca -->|"creates songs"| node_song
node_fonoteca -->|"reads versions"| node_versions
node_fonoteca -->|"uses playlist list"| node_linked
node_fonoteca -->|"uses history"| node_stack
node_fonoteca -->|"uses upcoming queue"| node_queue
node_song -->|"builds catalog from text"| node_text
node_binary -->|"serializes songs"| node_song
node_binary -->|"builds loaded catalog"| node_linked
node_text -->|"raises file errors"| node_errors
node_binary -->|"raises file errors"| node_errors
node_linked -->|"creates nodes"| node_node
node_stack -->|"stores items in"| node_linked
node_queue -->|"stores items in"| node_linked

click node_main "https://github.com/rodrigomatiaslopez/tp-integrador-algoritmos-y-estructuras-de-datos/blob/main/esqueleto/src/main.py"
click node_fonoteca "https://github.com/rodrigomatiaslopez/tp-integrador-algoritmos-y-estructuras-de-datos/blob/main/esqueleto/src/dominio/Fonoteca.py"
click node_song "https://github.com/rodrigomatiaslopez/tp-integrador-algoritmos-y-estructuras-de-datos/blob/main/esqueleto/src/dominio/cancion.py"
click node_config "https://github.com/rodrigomatiaslopez/tp-integrador-algoritmos-y-estructuras-de-datos/blob/main/esqueleto/src/config.py"
click node_errors "https://github.com/rodrigomatiaslopez/tp-integrador-algoritmos-y-estructuras-de-datos/blob/main/esqueleto/src/excepciones.py"
click node_search "https://github.com/rodrigomatiaslopez/tp-integrador-algoritmos-y-estructuras-de-datos/blob/main/esqueleto/src/algoritmos/busqueda.py"
click node_sort "https://github.com/rodrigomatiaslopez/tp-integrador-algoritmos-y-estructuras-de-datos/blob/main/esqueleto/src/algoritmos/ordenamiento.py"
click node_text "https://github.com/rodrigomatiaslopez/tp-integrador-algoritmos-y-estructuras-de-datos/blob/main/esqueleto/src/persistencia/texto.py"
click node_binary "https://github.com/rodrigomatiaslopez/tp-integrador-algoritmos-y-estructuras-de-datos/blob/main/esqueleto/src/persistencia/binario.py"
click node_versions "https://github.com/rodrigomatiaslopez/tp-integrador-algoritmos-y-estructuras-de-datos/blob/main/esqueleto/data/versiones.csv"
click node_linked "https://github.com/rodrigomatiaslopez/tp-integrador-algoritmos-y-estructuras-de-datos/blob/main/esqueleto/src/tads/lista_enlazada.py"
click node_node "https://github.com/rodrigomatiaslopez/tp-integrador-algoritmos-y-estructuras-de-datos/blob/main/esqueleto/src/tads/nodo.py"
click node_stack "https://github.com/rodrigomatiaslopez/tp-integrador-algoritmos-y-estructuras-de-datos/blob/main/esqueleto/src/tads/pila.py"
click node_queue "https://github.com/rodrigomatiaslopez/tp-integrador-algoritmos-y-estructuras-de-datos/blob/main/esqueleto/src/tads/cola.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_main,node_fonoteca,node_song,node_config,node_errors,node_user toneBlue
class node_search,node_sort toneAmber
class node_text,node_binary,node_versions toneMint
class node_linked,node_node,node_stack,node_queue toneRose
```

## Components

### CLI and domain

- [Menu and workflow](https://github.com/rodrigomatiaslopez/tp-integrador-algoritmos-y-estructuras-de-datos/blob/main/esqueleto/src/main.py): `esqueleto/src/main.py`
- [Catalog and player](https://github.com/rodrigomatiaslopez/tp-integrador-algoritmos-y-estructuras-de-datos/blob/main/esqueleto/src/dominio/Fonoteca.py): `esqueleto/src/dominio/Fonoteca.py`
- [Song model](https://github.com/rodrigomatiaslopez/tp-integrador-algoritmos-y-estructuras-de-datos/blob/main/esqueleto/src/dominio/cancion.py): `esqueleto/src/dominio/cancion.py`
- [Theme config](https://github.com/rodrigomatiaslopez/tp-integrador-algoritmos-y-estructuras-de-datos/blob/main/esqueleto/src/config.py): `esqueleto/src/config.py`
- [Domain errors](https://github.com/rodrigomatiaslopez/tp-integrador-algoritmos-y-estructuras-de-datos/blob/main/esqueleto/src/excepciones.py): `esqueleto/src/excepciones.py`

### Catalog algorithms

- [Catalog search](https://github.com/rodrigomatiaslopez/tp-integrador-algoritmos-y-estructuras-de-datos/blob/main/esqueleto/src/algoritmos/busqueda.py): `esqueleto/src/algoritmos/busqueda.py`
- [Catalog sorting](https://github.com/rodrigomatiaslopez/tp-integrador-algoritmos-y-estructuras-de-datos/blob/main/esqueleto/src/algoritmos/ordenamiento.py): `esqueleto/src/algoritmos/ordenamiento.py`

### Persistence

- [Text persistence](https://github.com/rodrigomatiaslopez/tp-integrador-algoritmos-y-estructuras-de-datos/blob/main/esqueleto/src/persistencia/texto.py): `esqueleto/src/persistencia/texto.py`
- [Binary persistence](https://github.com/rodrigomatiaslopez/tp-integrador-algoritmos-y-estructuras-de-datos/blob/main/esqueleto/src/persistencia/binario.py): `esqueleto/src/persistencia/binario.py`
- [Song versions data](https://github.com/rodrigomatiaslopez/tp-integrador-algoritmos-y-estructuras-de-datos/blob/main/esqueleto/data/versiones.csv): `esqueleto/data/versiones.csv`

### Data structures

- [Linked list](https://github.com/rodrigomatiaslopez/tp-integrador-algoritmos-y-estructuras-de-datos/blob/main/esqueleto/src/tads/lista_enlazada.py): `esqueleto/src/tads/lista_enlazada.py`
- [List node](https://github.com/rodrigomatiaslopez/tp-integrador-algoritmos-y-estructuras-de-datos/blob/main/esqueleto/src/tads/nodo.py): `esqueleto/src/tads/nodo.py`
- [Playback history stack](https://github.com/rodrigomatiaslopez/tp-integrador-algoritmos-y-estructuras-de-datos/blob/main/esqueleto/src/tads/pila.py): `esqueleto/src/tads/pila.py`
- [Upcoming songs queue](https://github.com/rodrigomatiaslopez/tp-integrador-algoritmos-y-estructuras-de-datos/blob/main/esqueleto/src/tads/cola.py): `esqueleto/src/tads/cola.py`

### Other components

- **User**

## Connections

- User → Menu and workflow: chooses operations (evidence: `README.md`)
- Menu and workflow → Theme config: reads theme (evidence: `esqueleto/src/main.py`)
- Menu and workflow → Catalog and player: delegates catalog and playback (evidence: `esqueleto/src/main.py`)
- Menu and workflow → Catalog search: calls search (evidence: `esqueleto/src/main.py`)
- Menu and workflow → Catalog sorting: calls sorting (evidence: `esqueleto/src/main.py`)
- Menu and workflow → Text persistence: loads and saves (evidence: `esqueleto/src/main.py`)
- Menu and workflow → Binary persistence: loads and saves (evidence: `esqueleto/src/main.py`)
- Menu and workflow → Song model: builds catalog rows (evidence: `esqueleto/src/main.py`)
- Catalog and player → Song model: creates songs (evidence: `esqueleto/src/dominio/Fonoteca.py`)
- Catalog and player → Song versions data: reads versions (evidence: `esqueleto/src/dominio/Fonoteca.py`)
- Catalog and player → Linked list: uses playlist list (evidence: `esqueleto/src/dominio/Fonoteca.py`)
- Catalog and player → Playback history stack: uses history (evidence: `esqueleto/src/dominio/Fonoteca.py`)
- Catalog and player → Upcoming songs queue: uses upcoming queue (evidence: `esqueleto/src/dominio/Fonoteca.py`)
- Song model → Text persistence: builds catalog from text (evidence: `esqueleto/src/dominio/cancion.py`)
- Binary persistence → Song model: serializes songs (evidence: `esqueleto/src/persistencia/binario.py`)
- Binary persistence → Linked list: builds loaded catalog (evidence: `esqueleto/src/persistencia/binario.py`)
- Text persistence → Domain errors: raises file errors (evidence: `esqueleto/src/persistencia/texto.py`)
- Binary persistence → Domain errors: raises file errors (evidence: `esqueleto/src/persistencia/binario.py`)
- Linked list → List node: creates nodes (evidence: `esqueleto/src/tads/lista_enlazada.py`)
- Playback history stack → Linked list: stores items in (evidence: `esqueleto/src/tads/pila.py`)
- Upcoming songs queue → Linked list: stores items in (evidence: `esqueleto/src/tads/cola.py`)
