# haydengentry/progressive_rummy architecture

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

- Interactive diagram: https://gitdiagram.com/haydengentry/progressive_rummy
- Repository: https://github.com/haydengentry/progressive_rummy

## Overview

Progressive Rummy is represented by two standalone Python game-logic scripts; the README describes the product but documents no interface or complete gameplay workflow. The sampled code shows card and hand analysis, including first-round contract possibilities, and one script’s shuffle-and-deal entry point. The scripts do not import or reference each other, so they are shown as separate implementations. Excerpts are partial, so unsampled gameplay stages and connections are not inferred.

Main entry points: [`first_round_logic.py`](https://github.com/haydengentry/progressive_rummy/blob/main/first_round_logic.py) (First-Round Logic), [`progressive_rummy.py`](https://github.com/haydengentry/progressive_rummy/blob/main/progressive_rummy.py) (Progressive Logic)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_setup["Game Setup"]
  node_deck_state["Deck and Hands"]
end

subgraph group_rules["Hand Rules"]
  node_card_sort["Card Sorting"]
  node_contract_check["Contract Analysis"]
  node_progressive_contract["Contract Analysis"]
end

subgraph group_variants["Logic Versions"]
  node_first_round["First-Round Logic"]
  node_progressive["Progressive Logic"]
end

node_player(("Player"))

node_player -.->|"plays"| node_first_round
node_first_round -->|"deals cards"| node_deck_state
node_first_round -->|"checks hands"| node_contract_check
node_contract_check -->|"sorts cards"| node_card_sort
node_progressive -.->|"checks contracts"| node_progressive_contract

click node_first_round "https://github.com/haydengentry/progressive_rummy/blob/main/first_round_logic.py"
click node_progressive "https://github.com/haydengentry/progressive_rummy/blob/main/progressive_rummy.py"
click node_deck_state "https://github.com/haydengentry/progressive_rummy/blob/main/first_round_logic.py"
click node_card_sort "https://github.com/haydengentry/progressive_rummy/blob/main/first_round_logic.py"
click node_contract_check "https://github.com/haydengentry/progressive_rummy/blob/main/first_round_logic.py"
click node_progressive_contract "https://github.com/haydengentry/progressive_rummy/blob/main/progressive_rummy.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_deck_state toneBlue
class node_card_sort,node_contract_check,node_progressive_contract toneAmber
class node_first_round,node_progressive toneMint
class node_player toneIndigo
```

## Components

### Game Setup

- [Deck and Hands](https://github.com/haydengentry/progressive_rummy/blob/main/first_round_logic.py): `first_round_logic.py`

### Hand Rules

- [Card Sorting](https://github.com/haydengentry/progressive_rummy/blob/main/first_round_logic.py): `first_round_logic.py`
- [Contract Analysis](https://github.com/haydengentry/progressive_rummy/blob/main/first_round_logic.py): `first_round_logic.py`
- [Contract Analysis](https://github.com/haydengentry/progressive_rummy/blob/main/progressive_rummy.py): `progressive_rummy.py`

### Logic Versions

- [First-Round Logic](https://github.com/haydengentry/progressive_rummy/blob/main/first_round_logic.py): `first_round_logic.py`
- [Progressive Logic](https://github.com/haydengentry/progressive_rummy/blob/main/progressive_rummy.py): `progressive_rummy.py`

### Other components

- **Player**

## Connections

- Player → First-Round Logic: plays
- First-Round Logic → Deck and Hands: deals cards (evidence: `first_round_logic.py`)
- First-Round Logic → Contract Analysis: checks hands (evidence: `first_round_logic.py`)
- Contract Analysis → Card Sorting: sorts cards (evidence: `first_round_logic.py`)
- Progressive Logic → Contract Analysis: checks contracts (evidence: `progressive_rummy.py`)