# lautarodquintana-jpg/puertodecontenedores architecture

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

- Interactive diagram: https://gitdiagram.com/lautarodquintana-jpg/puertodecontenedores
- Repository: https://github.com/lautarodquintana-jpg/puertodecontenedores

## Overview

PuertoDeContenedores is an incomplete C container-port simulator. Its implemented startup flow reads and displays configuration, then prompts for a menu choice; starting a shift and viewing rankings are explicitly marked as coming soon. The repository also provides generic queue and stack structures and port-domain data types. The README gives no further capability details, and the jornada and ranking implementation files are minimal, so their behavior and any connections to them are not inferred.

Main entry points: [`main.c`](https://github.com/lautarodquintana-jpg/puertodecontenedores/blob/main/main.c) (Startup and Menu), [`lib/configuracion.c`](https://github.com/lautarodquintana-jpg/puertodecontenedores/blob/main/lib/configuracion.c) (Configuration I/O), [`lib/estructuras.h`](https://github.com/lautarodquintana-jpg/puertodecontenedores/blob/main/lib/estructuras.h) (Port Data Types), [`TDA/cola.c`](https://github.com/lautarodquintana-jpg/puertodecontenedores/blob/main/TDA/cola.c) (Queue)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_app["Application"]
  node_main["Startup and Menu<br/>[main.c]"]
  node_validation["Menu Validation<br/>[validaciones.c]"]
  node_configuration["Configuration I/O<br/>[configuracion.c]"]
end

subgraph group_domain["Port Domain"]
  node_structures["Port Data Types<br/>[estructuras.h]"]
  node_shift["Shift Module<br/>[jornada.c]"]
  node_ranking["Ranking Module<br/>[ranking.c]"]
end

subgraph group_tdas["Data Structures"]
  node_queue["Queue<br/>[cola.c]"]
  node_stack["Stack<br/>[pila.c]"]
  node_node["Linked Node<br/>[nodo.h]"]
end

node_user(("User"))
node_configfile["Simulator Settings<br/>[config.txt]"]

node_user -.->|"starts"| node_main
node_main -->|"loads and displays"| node_configuration
node_main -->|"selects"| node_configfile
node_configuration -->|"reads"| node_configfile
node_main -->|"requests menu choice"| node_validation
node_configuration -->|"uses types"| node_structures
node_structures -->|"uses queue type"| node_queue
node_structures -->|"uses stack type"| node_stack
node_queue -->|"stores nodes"| node_node
node_stack -->|"stores nodes"| node_node

click node_main "https://github.com/lautarodquintana-jpg/puertodecontenedores/blob/main/main.c"
click node_validation "https://github.com/lautarodquintana-jpg/puertodecontenedores/blob/main/lib/validaciones.c"
click node_configuration "https://github.com/lautarodquintana-jpg/puertodecontenedores/blob/main/lib/configuracion.c"
click node_configfile "https://github.com/lautarodquintana-jpg/puertodecontenedores/blob/main/config.txt"
click node_structures "https://github.com/lautarodquintana-jpg/puertodecontenedores/blob/main/lib/estructuras.h"
click node_shift "https://github.com/lautarodquintana-jpg/puertodecontenedores/blob/main/lib/jornada.c"
click node_ranking "https://github.com/lautarodquintana-jpg/puertodecontenedores/blob/main/lib/ranking.c"
click node_queue "https://github.com/lautarodquintana-jpg/puertodecontenedores/blob/main/TDA/cola.c"
click node_stack "https://github.com/lautarodquintana-jpg/puertodecontenedores/blob/main/TDA/pila.c"
click node_node "https://github.com/lautarodquintana-jpg/puertodecontenedores/blob/main/TDA/nodo.h"

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_validation,node_configuration,node_user toneBlue
class node_structures,node_shift,node_ranking toneAmber
class node_queue,node_stack,node_node toneMint
class node_configfile toneTeal
```

## Components

### Application

- [Startup and Menu](https://github.com/lautarodquintana-jpg/puertodecontenedores/blob/main/main.c): `main.c`
- [Menu Validation](https://github.com/lautarodquintana-jpg/puertodecontenedores/blob/main/lib/validaciones.c): `lib/validaciones.c`
- [Configuration I/O](https://github.com/lautarodquintana-jpg/puertodecontenedores/blob/main/lib/configuracion.c): `lib/configuracion.c`

### Port Domain

- [Port Data Types](https://github.com/lautarodquintana-jpg/puertodecontenedores/blob/main/lib/estructuras.h): `lib/estructuras.h`
- [Shift Module](https://github.com/lautarodquintana-jpg/puertodecontenedores/blob/main/lib/jornada.c): `lib/jornada.c`
- [Ranking Module](https://github.com/lautarodquintana-jpg/puertodecontenedores/blob/main/lib/ranking.c): `lib/ranking.c`

### Data Structures

- [Queue](https://github.com/lautarodquintana-jpg/puertodecontenedores/blob/main/TDA/cola.c): `TDA/cola.c`
- [Stack](https://github.com/lautarodquintana-jpg/puertodecontenedores/blob/main/TDA/pila.c): `TDA/pila.c`
- [Linked Node](https://github.com/lautarodquintana-jpg/puertodecontenedores/blob/main/TDA/nodo.h): `TDA/nodo.h`

### Other components

- **User**
- [Simulator Settings](https://github.com/lautarodquintana-jpg/puertodecontenedores/blob/main/config.txt): `config.txt`

## Connections

- User → Startup and Menu: starts
- Startup and Menu → Configuration I/O: loads and displays (evidence: `main.c`)
- Startup and Menu → Simulator Settings: selects (evidence: `main.c`)
- Configuration I/O → Simulator Settings: reads
- Startup and Menu → Menu Validation: requests menu choice (evidence: `main.c`)
- Configuration I/O → Port Data Types: uses types
- Port Data Types → Queue: uses queue type (evidence: `lib/estructuras.h`)
- Port Data Types → Stack: uses stack type (evidence: `lib/estructuras.h`)
- Queue → Linked Node: stores nodes
- Stack → Linked Node: stores nodes
