# pcyganiuk/horseraceapp architecture

> Architecture diagram of the GitHub repository pcyganiuk/horseraceapp, 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/pcyganiuk/horseraceapp
- Repository: https://github.com/pcyganiuk/horseraceapp

## Overview

This is a JavaFX horse-racing application with user/admin screens and data models for horses, race schedules, race statistics and betting coupons. The likely user journey is login, browse/search racing information, then interact with betting controls; however, the UI controller implementations were not excerpted, so those links are shown as unverified. The sampled repository code does show horse records being queried and mapped through JDBC. The README is empty, so capabilities beyond the tree and sampled models are not independently documented.

Main entry points: [`src/main/java/dataAccess/HorsesRepository.java`](https://github.com/pcyganiuk/horseraceapp/blob/master/src/main/java/dataAccess/HorsesRepository.java) (Horse Repository), [`src/main/java/com/example/horseraceapp/UserMenuController.java`](https://github.com/pcyganiuk/horseraceapp/blob/master/src/main/java/com/example/horseraceapp/UserMenuController.java) (User Menu), [`src/main/java/com/example/horseraceapp/LoginController.java`](https://github.com/pcyganiuk/horseraceapp/blob/master/src/main/java/com/example/horseraceapp/LoginController.java) (Login), [`src/main/java/com/example/horseraceapp/SearchHorse.java`](https://github.com/pcyganiuk/horseraceapp/blob/master/src/main/java/com/example/horseraceapp/SearchHorse.java) (Horse Search)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_ui["Application UI"]
  node_app["JavaFX Application"]
  node_login["Login"]
  node_user_menu["User Menu"]
  node_admin_menu["Admin Menu"]
  node_new_user["User Registration"]
  node_horse_search["Horse Search<br/>[SearchHorse.java]"]
  node_bet_controls["Bet Controls<br/>[BetCell.java]"]
  node_bet_cell_factory["Bet Cell Factory"]
end

subgraph group_racing["Racing Domain"]
  node_schedule["Race Schedule<br/>[Harmonogram.java]"]
  node_horse["Horse Records<br/>[Horse.java]"]
  node_horse_stats["Horse Statistics"]
end

subgraph group_betting["Betting Domain"]
  node_coupon["Bet Coupon<br/>[Kupon.java]"]
end

subgraph group_data["Data Access"]
  node_entity["Entity Base<br/>[Entity.java]"]
  node_repository["Repository Base<br/>[Repository.java]"]
  node_horses_repo["Horse Repository"]
end

node_user(("User"))
node_postgres[("PostgreSQL")]

node_user -.->|"starts session"| node_login
node_login -.->|"enters application"| node_app
node_user_menu -.->|"offers search"| node_horse_search
node_user_menu -.->|"offers betting"| node_bet_controls
node_bet_cell_factory -.->|"creates cells"| node_bet_controls
node_horse -->|"extends"| node_entity
node_horses_repo -->|"extends"| node_repository
node_horses_repo -->|"maps records"| node_horse
node_horses_repo -->|"queries horses"| node_postgres
node_horse_search -.->|"searches records"| node_horses_repo
node_admin_menu -.->|"manages horses"| node_horses_repo

click node_app "https://github.com/pcyganiuk/horseraceapp/blob/master/src/main/java/com/example/horseraceapp/HorseBetApplication.java"
click node_login "https://github.com/pcyganiuk/horseraceapp/blob/master/src/main/java/com/example/horseraceapp/LoginController.java"
click node_user_menu "https://github.com/pcyganiuk/horseraceapp/blob/master/src/main/java/com/example/horseraceapp/UserMenuController.java"
click node_admin_menu "https://github.com/pcyganiuk/horseraceapp/blob/master/src/main/java/com/example/horseraceapp/AdminMenuController.java"
click node_new_user "https://github.com/pcyganiuk/horseraceapp/blob/master/src/main/java/com/example/horseraceapp/NewUserViewController.java"
click node_horse_search "https://github.com/pcyganiuk/horseraceapp/blob/master/src/main/java/com/example/horseraceapp/SearchHorse.java"
click node_bet_controls "https://github.com/pcyganiuk/horseraceapp/blob/master/src/main/java/com/example/horseraceapp/BetCell.java"
click node_bet_cell_factory "https://github.com/pcyganiuk/horseraceapp/blob/master/src/main/java/com/example/horseraceapp/BetCellFactory.java"
click node_schedule "https://github.com/pcyganiuk/horseraceapp/blob/master/src/main/java/dataAccess/Harmonogram.java"
click node_horse "https://github.com/pcyganiuk/horseraceapp/blob/master/src/main/java/dataAccess/Horse.java"
click node_horse_stats "https://github.com/pcyganiuk/horseraceapp/blob/master/src/main/java/dataAccess/StatystykiKonia.java"
click node_coupon "https://github.com/pcyganiuk/horseraceapp/blob/master/src/main/java/dataAccess/Kupon.java"
click node_entity "https://github.com/pcyganiuk/horseraceapp/blob/master/src/main/java/dataAccess/Entity.java"
click node_repository "https://github.com/pcyganiuk/horseraceapp/blob/master/src/main/java/dataAccess/Repository.java"
click node_horses_repo "https://github.com/pcyganiuk/horseraceapp/blob/master/src/main/java/dataAccess/HorsesRepository.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_app,node_login,node_user_menu,node_admin_menu,node_new_user,node_horse_search,node_bet_controls,node_bet_cell_factory,node_user toneBlue
class node_schedule,node_horse,node_horse_stats,node_postgres toneAmber
class node_coupon toneMint
class node_entity,node_repository,node_horses_repo toneRose
```

## Components

### Application UI

- [JavaFX Application](https://github.com/pcyganiuk/horseraceapp/blob/master/src/main/java/com/example/horseraceapp/HorseBetApplication.java): `src/main/java/com/example/horseraceapp/HorseBetApplication.java`
- [Login](https://github.com/pcyganiuk/horseraceapp/blob/master/src/main/java/com/example/horseraceapp/LoginController.java): `src/main/java/com/example/horseraceapp/LoginController.java`
- [User Menu](https://github.com/pcyganiuk/horseraceapp/blob/master/src/main/java/com/example/horseraceapp/UserMenuController.java): `src/main/java/com/example/horseraceapp/UserMenuController.java`
- [Admin Menu](https://github.com/pcyganiuk/horseraceapp/blob/master/src/main/java/com/example/horseraceapp/AdminMenuController.java): `src/main/java/com/example/horseraceapp/AdminMenuController.java`
- [User Registration](https://github.com/pcyganiuk/horseraceapp/blob/master/src/main/java/com/example/horseraceapp/NewUserViewController.java): `src/main/java/com/example/horseraceapp/NewUserViewController.java`
- [Horse Search](https://github.com/pcyganiuk/horseraceapp/blob/master/src/main/java/com/example/horseraceapp/SearchHorse.java): `src/main/java/com/example/horseraceapp/SearchHorse.java`
- [Bet Controls](https://github.com/pcyganiuk/horseraceapp/blob/master/src/main/java/com/example/horseraceapp/BetCell.java): `src/main/java/com/example/horseraceapp/BetCell.java`
- [Bet Cell Factory](https://github.com/pcyganiuk/horseraceapp/blob/master/src/main/java/com/example/horseraceapp/BetCellFactory.java): `src/main/java/com/example/horseraceapp/BetCellFactory.java`

### Racing Domain

- [Race Schedule](https://github.com/pcyganiuk/horseraceapp/blob/master/src/main/java/dataAccess/Harmonogram.java): `src/main/java/dataAccess/Harmonogram.java`
- [Horse Records](https://github.com/pcyganiuk/horseraceapp/blob/master/src/main/java/dataAccess/Horse.java): `src/main/java/dataAccess/Horse.java`
- [Horse Statistics](https://github.com/pcyganiuk/horseraceapp/blob/master/src/main/java/dataAccess/StatystykiKonia.java): `src/main/java/dataAccess/StatystykiKonia.java`

### Betting Domain

- [Bet Coupon](https://github.com/pcyganiuk/horseraceapp/blob/master/src/main/java/dataAccess/Kupon.java): `src/main/java/dataAccess/Kupon.java`

### Data Access

- [Entity Base](https://github.com/pcyganiuk/horseraceapp/blob/master/src/main/java/dataAccess/Entity.java): `src/main/java/dataAccess/Entity.java`
- [Repository Base](https://github.com/pcyganiuk/horseraceapp/blob/master/src/main/java/dataAccess/Repository.java): `src/main/java/dataAccess/Repository.java`
- [Horse Repository](https://github.com/pcyganiuk/horseraceapp/blob/master/src/main/java/dataAccess/HorsesRepository.java): `src/main/java/dataAccess/HorsesRepository.java`

### Other components

- **User**
- **PostgreSQL**

## Connections

- User → Login: starts session
- Login → JavaFX Application: enters application
- User Menu → Horse Search: offers search
- User Menu → Bet Controls: offers betting
- Bet Cell Factory → Bet Controls: creates cells
- Horse Records → Entity Base: extends (evidence: `src/main/java/dataAccess/Horse.java`)
- Horse Repository → Repository Base: extends (evidence: `src/main/java/dataAccess/HorsesRepository.java`)
- Horse Repository → Horse Records: maps records (evidence: `src/main/java/dataAccess/HorsesRepository.java`)
- Horse Repository → PostgreSQL: queries horses (evidence: `src/main/java/dataAccess/HorsesRepository.java`)
- Horse Search → Horse Repository: searches records
- Admin Menu → Horse Repository: manages horses
