# aweeeprogramations/grupo2cib architecture

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

- Interactive diagram: https://gitdiagram.com/aweeeprogramations/grupo2cib
- Repository: https://github.com/aweeeprogramations/grupo2cib

## Overview

HighLow is a console-based High/Low tournament: players register as Normal or Special, take turns guessing against cards from a shuffled deck, and finish with individual statistics and winner results. The graph separates tournament entry and stages from the card and player domain models. Source excerpts show the main calls; the console user is an external actor, and there is no persistent store or external integration.

Main entry points: [`HighLow.java`](https://github.com/aweeeprogramations/grupo2cib/blob/main/HighLow.java) (Player registration), [`Player.java`](https://github.com/aweeeprogramations/grupo2cib/blob/main/Player.java) (Player scores), [`Deck.java`](https://github.com/aweeeprogramations/grupo2cib/blob/main/Deck.java) (Shuffled deck), [`NormalPlayer.java`](https://github.com/aweeeprogramations/grupo2cib/blob/main/NormalPlayer.java) (Normal player)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_tournament["Tournament"]
  node_main["Program entry<br/>[Main.java]"]
  node_registration["Player registration<br/>[HighLow.java]"]
  node_rounds["Turn and round play<br/>[HighLow.java]"]
  node_report["Tournament report<br/>[HighLow.java]"]
end

subgraph group_cards["Card Game"]
  node_deck["Shuffled deck<br/>[Deck.java]"]
  node_card["Card model<br/>[Card.java]"]
end

subgraph group_players["Player Types"]
  node_player["Player scores<br/>[Player.java]"]
  node_normal["Normal player<br/>[NormalPlayer.java]"]
  node_special["Special player<br/>[SpecialPlayer.java]"]
end

node_user(("Console player"))

node_main -->|"starts tournament"| node_registration
node_user -->|"enters players"| node_registration
node_registration -->|"creates normal"| node_normal
node_registration -->|"creates special"| node_special
node_registration -->|"begins turns"| node_rounds
node_rounds -->|"shuffles and deals"| node_deck
node_deck -->|"creates cards"| node_card
node_rounds -->|"checks chances; records score"| node_player
node_normal -->|"extends"| node_player
node_special -->|"extends"| node_player
node_rounds -->|"finishes tournament"| node_report
node_report -->|"reads scores and history"| node_player
node_report -->|"displays results"| node_user

click node_main "https://github.com/aweeeprogramations/grupo2cib/blob/main/Main.java"
click node_registration "https://github.com/aweeeprogramations/grupo2cib/blob/main/HighLow.java"
click node_rounds "https://github.com/aweeeprogramations/grupo2cib/blob/main/HighLow.java"
click node_report "https://github.com/aweeeprogramations/grupo2cib/blob/main/HighLow.java"
click node_deck "https://github.com/aweeeprogramations/grupo2cib/blob/main/Deck.java"
click node_card "https://github.com/aweeeprogramations/grupo2cib/blob/main/Card.java"
click node_player "https://github.com/aweeeprogramations/grupo2cib/blob/main/Player.java"
click node_normal "https://github.com/aweeeprogramations/grupo2cib/blob/main/NormalPlayer.java"
click node_special "https://github.com/aweeeprogramations/grupo2cib/blob/main/SpecialPlayer.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_main,node_registration,node_rounds,node_report toneBlue
class node_deck,node_card toneAmber
class node_player,node_normal,node_special toneMint
class node_user toneIndigo
```

## Components

### Tournament

- [Program entry](https://github.com/aweeeprogramations/grupo2cib/blob/main/Main.java): `Main.java`
- [Player registration](https://github.com/aweeeprogramations/grupo2cib/blob/main/HighLow.java): `HighLow.java`
- [Turn and round play](https://github.com/aweeeprogramations/grupo2cib/blob/main/HighLow.java): `HighLow.java`
- [Tournament report](https://github.com/aweeeprogramations/grupo2cib/blob/main/HighLow.java): `HighLow.java`

### Card Game

- [Shuffled deck](https://github.com/aweeeprogramations/grupo2cib/blob/main/Deck.java): `Deck.java`
- [Card model](https://github.com/aweeeprogramations/grupo2cib/blob/main/Card.java): `Card.java`

### Player Types

- [Player scores](https://github.com/aweeeprogramations/grupo2cib/blob/main/Player.java): `Player.java`
- [Normal player](https://github.com/aweeeprogramations/grupo2cib/blob/main/NormalPlayer.java): `NormalPlayer.java`
- [Special player](https://github.com/aweeeprogramations/grupo2cib/blob/main/SpecialPlayer.java): `SpecialPlayer.java`

### Other components

- **Console player**

## Connections

- Program entry → Player registration: starts tournament (evidence: `Main.java`)
- Console player → Player registration: enters players (evidence: `HighLow.java`)
- Player registration → Normal player: creates normal (evidence: `HighLow.java`)
- Player registration → Special player: creates special (evidence: `HighLow.java`)
- Player registration → Turn and round play: begins turns (evidence: `HighLow.java`)
- Turn and round play → Shuffled deck: shuffles and deals (evidence: `HighLow.java`)
- Shuffled deck → Card model: creates cards (evidence: `Deck.java`)
- Turn and round play → Player scores: checks chances; records score (evidence: `HighLow.java`)
- Normal player → Player scores: extends (evidence: `NormalPlayer.java`)
- Special player → Player scores: extends (evidence: `SpecialPlayer.java`)
- Turn and round play → Tournament report: finishes tournament (evidence: `HighLow.java`)
- Tournament report → Player scores: reads scores and history (evidence: `HighLow.java`)
- Tournament report → Console player: displays results (evidence: `HighLow.java`)
