# paradigmas-de-programacion/workspace architecture

> Architecture diagram of the GitHub repository paradigmas-de-programacion/workspace, generated by GitDiagram from its file tree, README and a sample of source files (last updated 2026-11-20). It is an AI-made overview: check details against the source.

- Interactive diagram: https://gitdiagram.com/paradigmas-de-programacion/workspace
- Repository: https://github.com/paradigmas-de-programacion/workspace

## Overview

This repository is a teaching workspace of programming-paradigm examples, not a single user-facing application. Its examples demonstrate basic collection and file handling, object-oriented modeling, and design patterns. The clearest end-to-end examples are building and querying a card collection/deck, and invoking small pattern demos. The graph groups related lessons; some nodes represent larger examples whose internal wiring is not shown in the sampled sources. Edges are limited to calls or references supported by excerpts or the source index.

Main entry points: [`basicas-colecciones/src/main/Main.java`](https://github.com/paradigmas-de-programacion/workspace/blob/master/basicas-colecciones/src/main/Main.java) (Card demo), [`basicas-colecciones/src/pokemon/Coleccion.java`](https://github.com/paradigmas-de-programacion/workspace/blob/master/basicas-colecciones/src/pokemon/Coleccion.java) (Collection), [`basicas-colecciones/src/pokemon/Mazo.java`](https://github.com/paradigmas-de-programacion/workspace/blob/master/basicas-colecciones/src/pokemon/Mazo.java) (Tournament deck), [`basicas-colecciones/src/pokemon/Carta.java`](https://github.com/paradigmas-de-programacion/workspace/blob/master/basicas-colecciones/src/pokemon/Carta.java) (Card model)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_basics["Programming basics"]
  node_cards_app["Card demo<br/>[Main.java]"]
  node_card["Card model<br/>[Carta.java]"]
  node_expansion["Expansion<br/>[Expansion.java]"]
  node_collection["Collection<br/>[Coleccion.java]"]
  node_deck["Tournament deck<br/>[Mazo.java]"]
  node_file_demo["File exercise<br/>[Main.java]"]
  node_resolution["Resolution<br/>[Resolucion.java]"]
  node_file_io["File handling<br/>[Archivo.java]"]
end

subgraph group_oop["Object-oriented examples"]
  node_oop_counter["Livestock counter"]
  node_vehicles["Vehicle logistics<br/>[Logistica.java]"]
  node_coffee["Coffee machines<br/>[MaquinaDeCafe.java]"]
  node_triathlon["Triathlon roles<br/>[Triatlonista.java]"]
end

subgraph group_structural["Structural patterns"]
  node_adapter_app["Music demo<br/>[App.java]"]
  node_music_player["Music player"]
  node_mp3_adapter["MP3 adapter"]
  node_mp3["MP3 file<br/>[MP3File.java]"]
  node_composite_app["Unit demo<br/>[App.java]"]
  node_platoon["Platoon composite<br/>[Peloton.java]"]
end

subgraph group_behavioral["Behavioral patterns"]
  node_chain["Operation chain"]
  node_operation["Operation handler<br/>[Operacion.java]"]
end

subgraph group_other["Other pattern examples"]
  node_iterator_demo["Matrix iteration<br/>[App.java]"]
  node_observer_demo["Observer demo<br/>[App.java]"]
  node_state_demo["Tank modes demo<br/>[App.java]"]
  node_tank["Tank state<br/>[Tanque.java]"]
  node_mario["Mario state example<br/>[Mario.java]"]
end

node_cards_app -->|"creates"| node_card
node_cards_app -->|"populates"| node_expansion
node_cards_app -->|"populates"| node_collection
node_cards_app -->|"builds"| node_deck
node_collection -->|"stores"| node_card
node_collection -->|"checks completeness"| node_expansion
node_collection -->|"checks availability"| node_deck
node_deck -->|"stores"| node_card
node_file_demo -->|"invokes"| node_resolution
node_resolution -->|"uses"| node_file_io
node_adapter_app -->|"creates"| node_music_player
node_adapter_app -->|"uses"| node_mp3_adapter
node_mp3_adapter -->|"adapts"| node_mp3
node_composite_app -->|"assembles"| node_platoon
node_chain -->|"extends"| node_operation
node_iterator_demo -.->|"unused"| node_platoon
node_state_demo -->|"invokes"| node_tank

click node_cards_app "https://github.com/paradigmas-de-programacion/workspace/blob/master/basicas-colecciones/src/main/Main.java"
click node_card "https://github.com/paradigmas-de-programacion/workspace/blob/master/basicas-colecciones/src/pokemon/Carta.java"
click node_expansion "https://github.com/paradigmas-de-programacion/workspace/blob/master/basicas-colecciones/src/pokemon/Expansion.java"
click node_collection "https://github.com/paradigmas-de-programacion/workspace/blob/master/basicas-colecciones/src/pokemon/Coleccion.java"
click node_deck "https://github.com/paradigmas-de-programacion/workspace/blob/master/basicas-colecciones/src/pokemon/Mazo.java"
click node_file_demo "https://github.com/paradigmas-de-programacion/workspace/blob/master/basicas-entrada-salida/src/main/Main.java"
click node_resolution "https://github.com/paradigmas-de-programacion/workspace/blob/master/basicas-entrada-salida/src/ejercicio/Resolucion.java"
click node_file_io "https://github.com/paradigmas-de-programacion/workspace/blob/master/basicas-entrada-salida/src/archivo/Archivo.java"
click node_oop_counter "https://github.com/paradigmas-de-programacion/workspace/blob/master/oop-introduccion/src/contador/ContadorGanado.java"
click node_vehicles "https://github.com/paradigmas-de-programacion/workspace/blob/master/oop-herencia-polimorfismo-vehiculos/src/edu/unlam/progava/vehiculos/Logistica.java"
click node_coffee "https://github.com/paradigmas-de-programacion/workspace/blob/master/oop-herencia-polimorfismo-maquinas-de-cafe/src/edu/unlam/progava/cafe/MaquinaDeCafe.java"
click node_triathlon "https://github.com/paradigmas-de-programacion/workspace/blob/master/oop-herencia-polimorfismo/src/edu/unlam/progava/triatlon/Triatlonista.java"
click node_adapter_app "https://github.com/paradigmas-de-programacion/workspace/blob/master/patrones-adapter/src/edu/unlam/paradigmas/adapter/App.java"
click node_music_player "https://github.com/paradigmas-de-programacion/workspace/blob/master/patrones-adapter/src/edu/unlam/paradigmas/adapter/ReproductorDeMusica.java"
click node_mp3_adapter "https://github.com/paradigmas-de-programacion/workspace/blob/master/patrones-adapter/src/edu/unlam/paradigmas/adapter/ArchivoMP3Adapter.java"
click node_mp3 "https://github.com/paradigmas-de-programacion/workspace/blob/master/patrones-adapter/src/edu/unlam/paradigmas/adapter/no_tocar/MP3File.java"
click node_composite_app "https://github.com/paradigmas-de-programacion/workspace/blob/master/patrones-composite/src/composite/App.java"
click node_platoon "https://github.com/paradigmas-de-programacion/workspace/blob/master/patrones-composite/src/composite/Peloton.java"
click node_chain "https://github.com/paradigmas-de-programacion/workspace/blob/master/patrones-chain-of-responsibility/src/edu/unlam/progava/chainofresponsibility/SumarYMultiplicar.java"
click node_operation "https://github.com/paradigmas-de-programacion/workspace/blob/master/patrones-chain-of-responsibility/src/edu/unlam/progava/chainofresponsibility/Operacion.java"
click node_iterator_demo "https://github.com/paradigmas-de-programacion/workspace/blob/master/patrones-iterator/src/edu/unlam/paradigmas/iterator/App.java"
click node_observer_demo "https://github.com/paradigmas-de-programacion/workspace/blob/master/patrones-observer/src/edu/unlam/taller/observer/App.java"
click node_state_demo "https://github.com/paradigmas-de-programacion/workspace/blob/master/patrones-state-2/src/main/java/edu/unlam/paradigmas/App.java"
click node_tank "https://github.com/paradigmas-de-programacion/workspace/blob/master/patrones-state-2/src/main/java/edu/unlam/paradigmas/Tanque.java"
click node_mario "https://github.com/paradigmas-de-programacion/workspace/blob/master/patrones-state/src/noState/Mario.java"

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_cards_app,node_card,node_expansion,node_collection,node_deck,node_file_demo,node_resolution,node_file_io toneBlue
class node_oop_counter,node_vehicles,node_coffee,node_triathlon toneAmber
class node_adapter_app,node_music_player,node_mp3_adapter,node_mp3,node_composite_app,node_platoon toneMint
class node_chain,node_operation toneRose
class node_iterator_demo,node_observer_demo,node_state_demo,node_tank,node_mario toneIndigo
```

## Components

### Programming basics

- [Card demo](https://github.com/paradigmas-de-programacion/workspace/blob/master/basicas-colecciones/src/main/Main.java): `basicas-colecciones/src/main/Main.java`
- [Card model](https://github.com/paradigmas-de-programacion/workspace/blob/master/basicas-colecciones/src/pokemon/Carta.java): `basicas-colecciones/src/pokemon/Carta.java`
- [Expansion](https://github.com/paradigmas-de-programacion/workspace/blob/master/basicas-colecciones/src/pokemon/Expansion.java): `basicas-colecciones/src/pokemon/Expansion.java`
- [Collection](https://github.com/paradigmas-de-programacion/workspace/blob/master/basicas-colecciones/src/pokemon/Coleccion.java): `basicas-colecciones/src/pokemon/Coleccion.java`
- [Tournament deck](https://github.com/paradigmas-de-programacion/workspace/blob/master/basicas-colecciones/src/pokemon/Mazo.java): `basicas-colecciones/src/pokemon/Mazo.java`
- [File exercise](https://github.com/paradigmas-de-programacion/workspace/blob/master/basicas-entrada-salida/src/main/Main.java): `basicas-entrada-salida/src/main/Main.java`
- [Resolution](https://github.com/paradigmas-de-programacion/workspace/blob/master/basicas-entrada-salida/src/ejercicio/Resolucion.java): `basicas-entrada-salida/src/ejercicio/Resolucion.java`
- [File handling](https://github.com/paradigmas-de-programacion/workspace/blob/master/basicas-entrada-salida/src/archivo/Archivo.java): `basicas-entrada-salida/src/archivo/Archivo.java`

### Object-oriented examples

- [Livestock counter](https://github.com/paradigmas-de-programacion/workspace/blob/master/oop-introduccion/src/contador/ContadorGanado.java): `oop-introduccion/src/contador/ContadorGanado.java`
- [Vehicle logistics](https://github.com/paradigmas-de-programacion/workspace/blob/master/oop-herencia-polimorfismo-vehiculos/src/edu/unlam/progava/vehiculos/Logistica.java): `oop-herencia-polimorfismo-vehiculos/src/edu/unlam/progava/vehiculos/Logistica.java`
- [Coffee machines](https://github.com/paradigmas-de-programacion/workspace/blob/master/oop-herencia-polimorfismo-maquinas-de-cafe/src/edu/unlam/progava/cafe/MaquinaDeCafe.java): `oop-herencia-polimorfismo-maquinas-de-cafe/src/edu/unlam/progava/cafe/MaquinaDeCafe.java`
- [Triathlon roles](https://github.com/paradigmas-de-programacion/workspace/blob/master/oop-herencia-polimorfismo/src/edu/unlam/progava/triatlon/Triatlonista.java): `oop-herencia-polimorfismo/src/edu/unlam/progava/triatlon/Triatlonista.java`

### Structural patterns

- [Music demo](https://github.com/paradigmas-de-programacion/workspace/blob/master/patrones-adapter/src/edu/unlam/paradigmas/adapter/App.java): `patrones-adapter/src/edu/unlam/paradigmas/adapter/App.java`
- [Music player](https://github.com/paradigmas-de-programacion/workspace/blob/master/patrones-adapter/src/edu/unlam/paradigmas/adapter/ReproductorDeMusica.java): `patrones-adapter/src/edu/unlam/paradigmas/adapter/ReproductorDeMusica.java`
- [MP3 adapter](https://github.com/paradigmas-de-programacion/workspace/blob/master/patrones-adapter/src/edu/unlam/paradigmas/adapter/ArchivoMP3Adapter.java): `patrones-adapter/src/edu/unlam/paradigmas/adapter/ArchivoMP3Adapter.java`
- [MP3 file](https://github.com/paradigmas-de-programacion/workspace/blob/master/patrones-adapter/src/edu/unlam/paradigmas/adapter/no_tocar/MP3File.java): `patrones-adapter/src/edu/unlam/paradigmas/adapter/no_tocar/MP3File.java`
- [Unit demo](https://github.com/paradigmas-de-programacion/workspace/blob/master/patrones-composite/src/composite/App.java): `patrones-composite/src/composite/App.java`
- [Platoon composite](https://github.com/paradigmas-de-programacion/workspace/blob/master/patrones-composite/src/composite/Peloton.java): `patrones-composite/src/composite/Peloton.java`

### Behavioral patterns

- [Operation chain](https://github.com/paradigmas-de-programacion/workspace/blob/master/patrones-chain-of-responsibility/src/edu/unlam/progava/chainofresponsibility/SumarYMultiplicar.java): `patrones-chain-of-responsibility/src/edu/unlam/progava/chainofresponsibility/SumarYMultiplicar.java`
- [Operation handler](https://github.com/paradigmas-de-programacion/workspace/blob/master/patrones-chain-of-responsibility/src/edu/unlam/progava/chainofresponsibility/Operacion.java): `patrones-chain-of-responsibility/src/edu/unlam/progava/chainofresponsibility/Operacion.java`

### Other pattern examples

- [Matrix iteration](https://github.com/paradigmas-de-programacion/workspace/blob/master/patrones-iterator/src/edu/unlam/paradigmas/iterator/App.java): `patrones-iterator/src/edu/unlam/paradigmas/iterator/App.java`
- [Observer demo](https://github.com/paradigmas-de-programacion/workspace/blob/master/patrones-observer/src/edu/unlam/taller/observer/App.java): `patrones-observer/src/edu/unlam/taller/observer/App.java`
- [Tank modes demo](https://github.com/paradigmas-de-programacion/workspace/blob/master/patrones-state-2/src/main/java/edu/unlam/paradigmas/App.java): `patrones-state-2/src/main/java/edu/unlam/paradigmas/App.java`
- [Tank state](https://github.com/paradigmas-de-programacion/workspace/blob/master/patrones-state-2/src/main/java/edu/unlam/paradigmas/Tanque.java): `patrones-state-2/src/main/java/edu/unlam/paradigmas/Tanque.java`
- [Mario state example](https://github.com/paradigmas-de-programacion/workspace/blob/master/patrones-state/src/noState/Mario.java): `patrones-state/src/noState/Mario.java`

## Connections

- Card demo → Card model: creates (evidence: `basicas-colecciones/src/main/Main.java`)
- Card demo → Expansion: populates (evidence: `basicas-colecciones/src/main/Main.java`)
- Card demo → Collection: populates (evidence: `basicas-colecciones/src/main/Main.java`)
- Card demo → Tournament deck: builds (evidence: `basicas-colecciones/src/main/Main.java`)
- Collection → Card model: stores (evidence: `basicas-colecciones/src/pokemon/Coleccion.java`)
- Collection → Expansion: checks completeness (evidence: `basicas-colecciones/src/pokemon/Coleccion.java`)
- Collection → Tournament deck: checks availability (evidence: `basicas-colecciones/src/pokemon/Coleccion.java`)
- Tournament deck → Card model: stores (evidence: `basicas-colecciones/src/pokemon/Mazo.java`)
- File exercise → Resolution: invokes (evidence: `basicas-entrada-salida/src/main/Main.java`)
- Resolution → File handling: uses (evidence: `basicas-entrada-salida/src/ejercicio/Resolucion.java`)
- Music demo → Music player: creates (evidence: `patrones-adapter/src/edu/unlam/paradigmas/adapter/App.java`)
- Music demo → MP3 adapter: uses (evidence: `patrones-adapter/src/edu/unlam/paradigmas/adapter/App.java`)
- MP3 adapter → MP3 file: adapts (evidence: `patrones-adapter/src/edu/unlam/paradigmas/adapter/ArchivoMP3Adapter.java`)
- Unit demo → Platoon composite: assembles (evidence: `patrones-composite/src/composite/App.java`)
- Operation chain → Operation handler: extends (evidence: `patrones-chain-of-responsibility/src/edu/unlam/progava/chainofresponsibility/SumarYMultiplicar.java`)
- Matrix iteration → Platoon composite: unused
- Tank modes demo → Tank state: invokes (evidence: `patrones-state-2/src/main/java/edu/unlam/paradigmas/App.java`)
