# tk-codes/uno architecture

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

- Interactive diagram: https://gitdiagram.com/tk-codes/uno
- Repository: https://github.com/tk-codes/uno

## Overview

1. **Repository purpose and shape**
   - This is a **Java/Gradle desktop application** implementing the UNO card game.
   - The code is split into a **UI layer**, a small **application service layer**, and a **domain-driven core**. The README explicitly says the GUI exists mainly to exercise the domain logic, not as a production-grade client.

2. **Runtime entry point**
   - `UnoApp` is the main entry point.
   - It boots the desktop application, which then drives the UI and indirectly the game domain. There is no sign of a server, database, or network boundary.

3. **UI subsystem**
   - `ui.AppFrame` is the top-level window/container.
   - `ui.view.*` contains the visual components for the game table, players, status, cards, and color selection:
     - `TableView`, `PlayerView`, `GameStatusView`, `CardView`, `ColorPicker`
   - `ui.common.StyleUtil` centralizes appearance/styling.
   - The UI is a consumer of application-facing objects, not the source of game rules.

4. **Application layer boundary**
   - `application.IGameAppService` defines the use-case API for the UI.
   - `application.GameAppService` is the concrete orchestrator between UI actions and the domain model.
   - `application.dto.PlayerInfoDTO` is a UI-facing transfer object, suggesting the application layer shields the UI from direct domain entity exposure.

5. **Domain core: game aggregate**
   - `domain.game.Game` is the central **aggregate root** and owns the game state.
   - It maintains the active game flow, including:
     - players
     - draw pile
     - discard pile / played cards
   - `GameBuilder` sets up the initial game state and likely enforces valid startup configuration.
   - `DealerService` and `DrawPile` encapsulate card distribution and drawing mechanics.

6. **Game rules and turn logic**
   - `domain.game.CardRules` contains the rule checks for whether a card can be played and what effects it has.
   - `domain.player.PlayerRoundIterator` and `domain.player.Direction` manage turn order and direction changes, which is important for reverse/skip behavior.
   - These pieces form the game-flow engine beneath the UI.

7. **Cards as immutable value objects**
   - The card model is a dedicated subsystem under `domain.card`.
   - `Card` is the base abstraction, with specialized types:
     - `NumberCard`
     - `ActionCard`
     - `WildCard`
   - Supporting types include `CardColor`, `CardType`, `CardDeck`, and `CardUtil`.
   - The README notes cards are immutable value objects; wild cards become colored by creating a new value object with the chosen color.

8. **Player model**
   - `domain.player.Player` is an entity that owns a mutable hand of cards.
   - `HandCardList` models the player’s hand.
   - `ImmutablePlayer` appears to provide a read-only view for consumers such as UI or iteration logic.
   - This keeps player identity/entity concerns separate from card-value semantics.

9. **Domain events and reactive hooks**
   - The domain has a lightweight event mechanism under `domain.common`:
     - `DomainEvent`
     - `DomainEventPublisher`
     - `DomainEventSubscriber`
   - The `Game` aggregate emits events in `domain.game.events`:
     - `CardDrawn`
     - `CardPlayed`
     - `GameOver`
   - This lets side effects be handled outside the aggregate while keeping core rules isolated.

10. **Main data flow**
    - User interaction starts in the **UI**.
    - The UI calls the **application service** (`GameAppService` via `IGameAppService`).
    - The application service invokes the **domain aggregate** (`Game`) and supporting domain services.
    - The domain updates state and publishes **domain events**.
    - UI-facing components then reflect the updated state, likely using DTOs/read-only views rather than mutating the domain directly.

11. **Architectural boundaries**
    - The important boundaries are:
      - **UI vs application**: presentation does not contain rules
      - **application vs domain**: orchestration is separated from business logic
      - **entity/value object split**: players are entities; cards are immutable values
      - **aggregate/event boundary**: `Game` owns consistency and publishes events for external reactions
    - This is a clean DDD-style boundary structure, with the game aggregate as the main consistency boundary.

12. **Testing and quality tooling**
    - Tests are organized to mirror the domain structure under `src/test/java/domain/...`.
    - There are focused tests for cards, rules, deck, draw pile, builder, gameplay, iterator behavior, and event publishing.
    - The repo uses **Gradle** with a wrapper, plus **GitHub Actions** workflows for tests and Sonar analysis.
    - `log4j2.xml` indicates logging is configured, but logging is not a major architectural component.

13. **What to draw in an architecture diagram**
    - Draw a three-layer flow: **UI → Application Service → Domain Aggregate/Services**.
    - Inside the domain, show three main clusters:
      - **Cards**
      - **Players**
      - **Game/Rules/Events**
    - Add arrows from `Game` to `DomainEventPublisher` and then to event subscribers.
    - Keep everything contained in a single desktop application boundary; there are no external data stores or backend services visible in this repository.

Main entry points: [`src/main/java/domain/game/Game.java`](https://github.com/tk-codes/uno/blob/master/src/main/java/domain/game/Game.java) (Game), [`src/main/java/domain/card/Card.java`](https://github.com/tk-codes/uno/blob/master/src/main/java/domain/card/Card.java) (Card), [`src/main/java/ui/AppFrame.java`](https://github.com/tk-codes/uno/blob/master/src/main/java/ui/AppFrame.java) (App Frame), [`src/main/java/application/GameAppService.java`](https://github.com/tk-codes/uno/blob/master/src/main/java/application/GameAppService.java) (Game App Service)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_grp_ui["UI"]
  node_n_appframe["App Frame<br/>ui-shell<br/>[AppFrame.java]"]
  node_n_tableview["Table View<br/>ui-view<br/>[TableView.java]"]
  node_n_playerview["Player View<br/>ui-view<br/>[PlayerView.java]"]
  node_n_statusview["Status View<br/>ui-view"]
  node_n_cardview["Card View<br/>ui-view<br/>[CardView.java]"]
  node_n_colorpicker["Color Picker<br/>ui-input<br/>[ColorPicker.java]"]
  node_n_styleutil["Style Util<br/>ui-style<br/>[StyleUtil.java]"]
end

subgraph group_grp_app["Application"]
  node_n_igameappservice["IGameAppService<br/>service-port"]
  node_n_gameappservice["Game App Service"]
  node_n_playerinfodto["Player Info<br/>dto<br/>[PlayerInfoDTO.java]"]
end

subgraph group_grp_domain["Domain"]
end

subgraph group_grp_cards["Cards"]
  node_n_card["Card<br/>value-object<br/>[Card.java]"]
  node_n_numbercard["Number Card<br/>card-value<br/>[NumberCard.java]"]
  node_n_actioncard["Action Card<br/>card-value<br/>[ActionCard.java]"]
  node_n_wildcard["Wild Card<br/>card-value<br/>[WildCard.java]"]
  node_n_carddeck[("Card Deck<br/>[CardDeck.java]")]
  node_n_cardutil["Card Util<br/>card-helper<br/>[CardUtil.java]"]
  node_n_cardcolor(("Card Color<br/>enum<br/>[CardColor.java]"))
  node_n_cardtype(("Card Type<br/>enum<br/>[CardType.java]"))
end

subgraph group_grp_players["Players"]
  node_n_player["Player<br/>entity<br/>[Player.java]"]
  node_n_handcards["Hand Cards<br/>collection<br/>[HandCardList.java]"]
  node_n_immutableplayer["Immutable Player<br/>read-model"]
  node_n_rounditerator["Round Iterator<br/>turn-flow"]
  node_n_direction(("Direction<br/>enum<br/>[Direction.java]"))
end

subgraph group_grp_game["Game"]
  node_n_game[("Game<br/>aggregate<br/>[Game.java]")]
  node_n_gamebuilder["Game Builder<br/>setup<br/>[GameBuilder.java]"]
  node_n_cardrules["Card Rules<br/>[CardRules.java]"]
  node_n_dealerservice["Dealer Service<br/>[DealerService.java]"]
  node_n_drawpile["Draw Pile<br/>[DrawPile.java]"]
  node_n_carddrawn["Card Drawn<br/>game-event<br/>[CardDrawn.java]"]
  node_n_cardplayed["Card Played<br/>game-event<br/>[CardPlayed.java]"]
end

subgraph group_grp_common["Common"]
  node_n_domainevent["Domain Event<br/>event-base<br/>[DomainEvent.java]"]
  node_n_eventpublisher["Event Publisher<br/>event-bus"]
  node_n_eventsubscriber["Event Subscriber<br/>event-listener"]
end

node_n_unoapp(("UnoApp<br/>entrypoint<br/>[UnoApp.java]"))

node_n_unoapp -->|"starts"| node_n_appframe
node_n_appframe -->|"uses"| node_n_igameappservice
node_n_igameappservice -->|"implemented by"| node_n_gameappservice
node_n_gameappservice -->|"initializes"| node_n_gamebuilder
node_n_gameappservice -->|"drives"| node_n_game
node_n_gameappservice -->|"returns"| node_n_playerinfodto
node_n_gameappservice -->|"reads"| node_n_immutableplayer
node_n_appframe -->|"contains"| node_n_tableview
node_n_appframe -->|"contains"| node_n_playerview
node_n_appframe -->|"contains"| node_n_statusview
node_n_tableview -->|"renders"| node_n_cardview
node_n_tableview -->|"prompts"| node_n_colorpicker
node_n_playerview -->|"renders"| node_n_cardview
node_n_appframe -.->|"styles"| node_n_styleutil
node_n_gamebuilder -->|"builds from"| node_n_carddeck
node_n_gamebuilder -->|"creates"| node_n_drawpile
node_n_gamebuilder -->|"creates"| node_n_player
node_n_game -->|"applies"| node_n_cardrules
node_n_game -->|"uses"| node_n_dealerservice
node_n_game -->|"owns"| node_n_drawpile
node_n_game -->|"owns"| node_n_player
node_n_game -->|"advances"| node_n_rounditerator
node_n_rounditerator -->|"tracks"| node_n_direction
node_n_player -->|"contains"| node_n_handcards
node_n_player -.->|"exposes"| node_n_immutableplayer
node_n_card -->|"specializes"| node_n_numbercard
node_n_card -->|"specializes"| node_n_actioncard
node_n_card -->|"specializes"| node_n_wildcard
node_n_carddeck -->|"composes"| node_n_card
node_n_card -->|"uses"| node_n_cardcolor
node_n_card -->|"uses"| node_n_cardtype
node_n_cardutil -.->|"helps"| node_n_card
node_n_game -->|"publishes via"| node_n_eventpublisher
node_n_eventpublisher -->|"publishes"| node_n_domainevent
node_n_eventpublisher -->|"notifies"| node_n_eventsubscriber
node_n_carddrawn -->|"implements"| node_n_domainevent
node_n_cardplayed -->|"implements"| node_n_domainevent
node_n_game -->|"emits"| node_n_carddrawn
node_n_game -->|"emits"| node_n_cardplayed

click node_n_unoapp "https://github.com/tk-codes/uno/blob/master/src/main/java/UnoApp.java"
click node_n_appframe "https://github.com/tk-codes/uno/blob/master/src/main/java/ui/AppFrame.java"
click node_n_tableview "https://github.com/tk-codes/uno/blob/master/src/main/java/ui/view/TableView.java"
click node_n_playerview "https://github.com/tk-codes/uno/blob/master/src/main/java/ui/view/PlayerView.java"
click node_n_statusview "https://github.com/tk-codes/uno/blob/master/src/main/java/ui/view/GameStatusView.java"
click node_n_cardview "https://github.com/tk-codes/uno/blob/master/src/main/java/ui/view/CardView.java"
click node_n_colorpicker "https://github.com/tk-codes/uno/blob/master/src/main/java/ui/view/ColorPicker.java"
click node_n_styleutil "https://github.com/tk-codes/uno/blob/master/src/main/java/ui/common/StyleUtil.java"
click node_n_igameappservice "https://github.com/tk-codes/uno/blob/master/src/main/java/application/IGameAppService.java"
click node_n_gameappservice "https://github.com/tk-codes/uno/blob/master/src/main/java/application/GameAppService.java"
click node_n_playerinfodto "https://github.com/tk-codes/uno/blob/master/src/main/java/application/dto/PlayerInfoDTO.java"
click node_n_game "https://github.com/tk-codes/uno/blob/master/src/main/java/domain/game/Game.java"
click node_n_gamebuilder "https://github.com/tk-codes/uno/blob/master/src/main/java/domain/game/GameBuilder.java"
click node_n_cardrules "https://github.com/tk-codes/uno/blob/master/src/main/java/domain/game/CardRules.java"
click node_n_dealerservice "https://github.com/tk-codes/uno/blob/master/src/main/java/domain/game/DealerService.java"
click node_n_drawpile "https://github.com/tk-codes/uno/blob/master/src/main/java/domain/game/DrawPile.java"
click node_n_card "https://github.com/tk-codes/uno/blob/master/src/main/java/domain/card/Card.java"
click node_n_numbercard "https://github.com/tk-codes/uno/blob/master/src/main/java/domain/card/NumberCard.java"
click node_n_actioncard "https://github.com/tk-codes/uno/blob/master/src/main/java/domain/card/ActionCard.java"
click node_n_wildcard "https://github.com/tk-codes/uno/blob/master/src/main/java/domain/card/WildCard.java"
click node_n_carddeck "https://github.com/tk-codes/uno/blob/master/src/main/java/domain/card/CardDeck.java"
click node_n_cardutil "https://github.com/tk-codes/uno/blob/master/src/main/java/domain/card/CardUtil.java"
click node_n_cardcolor "https://github.com/tk-codes/uno/blob/master/src/main/java/domain/card/CardColor.java"
click node_n_cardtype "https://github.com/tk-codes/uno/blob/master/src/main/java/domain/card/CardType.java"
click node_n_player "https://github.com/tk-codes/uno/blob/master/src/main/java/domain/player/Player.java"
click node_n_handcards "https://github.com/tk-codes/uno/blob/master/src/main/java/domain/player/HandCardList.java"
click node_n_immutableplayer "https://github.com/tk-codes/uno/blob/master/src/main/java/domain/player/ImmutablePlayer.java"
click node_n_rounditerator "https://github.com/tk-codes/uno/blob/master/src/main/java/domain/player/PlayerRoundIterator.java"
click node_n_direction "https://github.com/tk-codes/uno/blob/master/src/main/java/domain/player/Direction.java"
click node_n_domainevent "https://github.com/tk-codes/uno/blob/master/src/main/java/domain/common/DomainEvent.java"
click node_n_eventpublisher "https://github.com/tk-codes/uno/blob/master/src/main/java/domain/common/DomainEventPublisher.java"
click node_n_eventsubscriber "https://github.com/tk-codes/uno/blob/master/src/main/java/domain/common/DomainEventSubscriber.java"
click node_n_carddrawn "https://github.com/tk-codes/uno/blob/master/src/main/java/domain/game/events/CardDrawn.java"
click node_n_cardplayed "https://github.com/tk-codes/uno/blob/master/src/main/java/domain/game/events/CardPlayed.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_n_appframe,node_n_tableview,node_n_playerview,node_n_statusview,node_n_cardview,node_n_colorpicker,node_n_styleutil,node_n_domainevent,node_n_eventpublisher,node_n_eventsubscriber toneBlue
class node_n_igameappservice,node_n_gameappservice,node_n_playerinfodto toneAmber
class node_n_card,node_n_numbercard,node_n_actioncard,node_n_wildcard,node_n_carddeck,node_n_cardutil,node_n_cardcolor,node_n_cardtype toneRose
class node_n_player,node_n_handcards,node_n_immutableplayer,node_n_rounditerator,node_n_direction toneIndigo
class node_n_game,node_n_gamebuilder,node_n_cardrules,node_n_dealerservice,node_n_drawpile,node_n_carddrawn,node_n_cardplayed toneTeal
class node_n_unoapp toneNeutral
```

## Components

### UI

Desktop presentation layer

- [App Frame](https://github.com/tk-codes/uno/blob/master/src/main/java/ui/AppFrame.java): ui-shell · Top-level window and UI container · `src/main/java/ui/AppFrame.java`
- [Table View](https://github.com/tk-codes/uno/blob/master/src/main/java/ui/view/TableView.java): ui-view · Main game table presentation · `src/main/java/ui/view/TableView.java`
- [Player View](https://github.com/tk-codes/uno/blob/master/src/main/java/ui/view/PlayerView.java): ui-view · Player hand and identity view · `src/main/java/ui/view/PlayerView.java`
- [Status View](https://github.com/tk-codes/uno/blob/master/src/main/java/ui/view/GameStatusView.java): ui-view · Game state and turn status · `src/main/java/ui/view/GameStatusView.java`
- [Card View](https://github.com/tk-codes/uno/blob/master/src/main/java/ui/view/CardView.java): ui-view · Card rendering component · `src/main/java/ui/view/CardView.java`
- [Color Picker](https://github.com/tk-codes/uno/blob/master/src/main/java/ui/view/ColorPicker.java): ui-input · Wild card color selection · `src/main/java/ui/view/ColorPicker.java`
- [Style Util](https://github.com/tk-codes/uno/blob/master/src/main/java/ui/common/StyleUtil.java): ui-style · Shared presentation styling · `src/main/java/ui/common/StyleUtil.java`

### Application

Use-case orchestration layer

- [IGameAppService](https://github.com/tk-codes/uno/blob/master/src/main/java/application/IGameAppService.java): service-port · UI-facing game use-case contract · `src/main/java/application/IGameAppService.java`
- [Game App Service](https://github.com/tk-codes/uno/blob/master/src/main/java/application/GameAppService.java): service · Orchestrates UI actions into domain calls · `src/main/java/application/GameAppService.java`
- [Player Info](https://github.com/tk-codes/uno/blob/master/src/main/java/application/dto/PlayerInfoDTO.java): dto · UI-facing player transfer object · `src/main/java/application/dto/PlayerInfoDTO.java`

### Cards

Immutable card model subsystem

- [Card](https://github.com/tk-codes/uno/blob/master/src/main/java/domain/card/Card.java): value-object · Base immutable card abstraction · `src/main/java/domain/card/Card.java`
- [Number Card](https://github.com/tk-codes/uno/blob/master/src/main/java/domain/card/NumberCard.java): card-value · Numeric card variant · `src/main/java/domain/card/NumberCard.java`
- [Action Card](https://github.com/tk-codes/uno/blob/master/src/main/java/domain/card/ActionCard.java): card-value · Skip/reverse/draw action card · `src/main/java/domain/card/ActionCard.java`
- [Wild Card](https://github.com/tk-codes/uno/blob/master/src/main/java/domain/card/WildCard.java): card-value · Color-selectable wild card · `src/main/java/domain/card/WildCard.java`
- [Card Deck](https://github.com/tk-codes/uno/blob/master/src/main/java/domain/card/CardDeck.java): deck · Deck construction and composition · `src/main/java/domain/card/CardDeck.java`
- [Card Util](https://github.com/tk-codes/uno/blob/master/src/main/java/domain/card/CardUtil.java): card-helper · Card-related helpers and conversions · `src/main/java/domain/card/CardUtil.java`
- [Card Color](https://github.com/tk-codes/uno/blob/master/src/main/java/domain/card/CardColor.java): enum · Card color domain type · `src/main/java/domain/card/CardColor.java`
- [Card Type](https://github.com/tk-codes/uno/blob/master/src/main/java/domain/card/CardType.java): enum · Card kind domain type · `src/main/java/domain/card/CardType.java`

### Players

Player entity and turn mechanics

- [Player](https://github.com/tk-codes/uno/blob/master/src/main/java/domain/player/Player.java): entity · Player entity with mutable hand · `src/main/java/domain/player/Player.java`
- [Hand Cards](https://github.com/tk-codes/uno/blob/master/src/main/java/domain/player/HandCardList.java): collection · Player hand model · `src/main/java/domain/player/HandCardList.java`
- [Immutable Player](https://github.com/tk-codes/uno/blob/master/src/main/java/domain/player/ImmutablePlayer.java): read-model · Read-only player view · `src/main/java/domain/player/ImmutablePlayer.java`
- [Round Iterator](https://github.com/tk-codes/uno/blob/master/src/main/java/domain/player/PlayerRoundIterator.java): turn-flow · Turn sequencing and current player iteration · `src/main/java/domain/player/PlayerRoundIterator.java`
- [Direction](https://github.com/tk-codes/uno/blob/master/src/main/java/domain/player/Direction.java): enum · Forward and reverse turn direction · `src/main/java/domain/player/Direction.java`

### Game

Aggregate, setup, and rule flow

- [Game](https://github.com/tk-codes/uno/blob/master/src/main/java/domain/game/Game.java): aggregate · Central game state and consistency boundary · `src/main/java/domain/game/Game.java`
- [Game Builder](https://github.com/tk-codes/uno/blob/master/src/main/java/domain/game/GameBuilder.java): setup · Initial game construction and validation · `src/main/java/domain/game/GameBuilder.java`
- [Card Rules](https://github.com/tk-codes/uno/blob/master/src/main/java/domain/game/CardRules.java): rules · Playable-card and effect logic · `src/main/java/domain/game/CardRules.java`
- [Dealer Service](https://github.com/tk-codes/uno/blob/master/src/main/java/domain/game/DealerService.java): service · Card dealing mechanics · `src/main/java/domain/game/DealerService.java`
- [Draw Pile](https://github.com/tk-codes/uno/blob/master/src/main/java/domain/game/DrawPile.java): pile · Draw stack and replenishment source · `src/main/java/domain/game/DrawPile.java`
- [Card Drawn](https://github.com/tk-codes/uno/blob/master/src/main/java/domain/game/events/CardDrawn.java): game-event · Event emitted when a card is drawn · `src/main/java/domain/game/events/CardDrawn.java`
- [Card Played](https://github.com/tk-codes/uno/blob/master/src/main/java/domain/game/events/CardPlayed.java): game-event · Event emitted when a card is played · `src/main/java/domain/game/events/CardPlayed.java`

### Common

Shared domain event abstractions

- [Domain Event](https://github.com/tk-codes/uno/blob/master/src/main/java/domain/common/DomainEvent.java): event-base · Base domain event contract · `src/main/java/domain/common/DomainEvent.java`
- [Event Publisher](https://github.com/tk-codes/uno/blob/master/src/main/java/domain/common/DomainEventPublisher.java): event-bus · Publishes domain events · `src/main/java/domain/common/DomainEventPublisher.java`
- [Event Subscriber](https://github.com/tk-codes/uno/blob/master/src/main/java/domain/common/DomainEventSubscriber.java): event-listener · Consumes domain events · `src/main/java/domain/common/DomainEventSubscriber.java`

### Other components

- [UnoApp](https://github.com/tk-codes/uno/blob/master/src/main/java/UnoApp.java): entrypoint · Desktop application entry point · `src/main/java/UnoApp.java`

## Connections

- UnoApp → App Frame: starts · Bootstraps the desktop UI
- App Frame → IGameAppService: uses · UI delegates actions through the service port
- IGameAppService → Game App Service: implemented by · Concrete application orchestration
- Game App Service → Game Builder: initializes · Creates or configures a game session
- Game App Service → Game: drives · Invokes domain operations
- Game App Service → Player Info: returns · Exposes read-friendly player data to the UI
- Game App Service → Immutable Player: reads · Uses read-only player projections
- App Frame → Table View: contains · Composes the main table view
- App Frame → Player View: contains · Composes player panels
- App Frame → Status View: contains · Composes game status area
- Table View → Card View: renders · Displays cards in play
- Table View → Color Picker: prompts · Requests wild card color choice
- Player View → Card View: renders · Shows player hand cards
- App Frame → Style Util: styles · Shares UI appearance rules
- Game Builder → Card Deck: builds from · Assembles the starting deck
- Game Builder → Draw Pile: creates · Initializes draw pile state
- Game Builder → Player: creates · Creates players for the match
- Game → Card Rules: applies · Checks legality and card effects
- Game → Dealer Service: uses · Deals cards and manages distribution
- Game → Draw Pile: owns · Maintains draw pile consistency
- Game → Player: owns · Maintains player state
- Game → Round Iterator: advances · Coordinates turn order
- Round Iterator → Direction: tracks · Supports reverse and forward flow
- Player → Hand Cards: contains · Player hand aggregate part
- Player → Immutable Player: exposes · Provides read-only view for consumers
- Card → Number Card: specializes · Numeric card variant
- Card → Action Card: specializes · Action card variant
- Card → Wild Card: specializes · Wild card variant
- Card Deck → Card: composes · Deck is made of cards
- Card → Card Color: uses · Cards carry color state
- Card → Card Type: uses · Cards carry type state
- Card Util → Card: helps · Card creation and manipulation helpers
- Game → Event Publisher: publishes via · Emits state-change events
- Event Publisher → Domain Event: publishes · Dispatches domain events
- Event Publisher → Event Subscriber: notifies · Fan-out to subscribers
- Card Drawn → Domain Event: implements · Game-specific event type
- Card Played → Domain Event: implements · Game-specific event type
- Game → Card Drawn: emits · Signals draw actions
- Game → Card Played: emits · Signals play actions
