# jFxKasse

Simple POS (Point of Sale) system for small to medium-sized events with receipt printer support.

## Requirements

- Java JDK 17+
- Maven 3.6+
- Display >= 1366x768

## Video Tutorials (German | Deutsch)
[YouTube Video: jFxKasse - Kassensystem - Kurzanleitung](https://www.youtube.com/watch?v=DV9DDESw40I)

[YouTube Video: jFxKasse - Kassensystem - Installieren](https://www.youtube.com/watch?v=IY1bqRjwh0Q)

## Setup (VSCode on openSUSE Tumbleweed)

### 1. Install dependencies

```bash
sudo zypper install java-17-openjdk-devel maven
```

### 2. Install VSCode extensions

Open the project in VSCode. You will be prompted to install the recommended extensions:

- **Extension Pack for Java** (`vscjava.vscode-java-pack`)
- **Maven for Java** (`vscjava.vscode-maven`)
- **Language Support for Java** (`redhat.java`)

### 3. Build & Run

```bash
# Compile
mvn compile

# Run via Maven
mvn javafx:run

# Package as fat JAR
mvn package
java -jar target/jFxKasse-shaded.jar
```

Or use the preconfigured VSCode tasks (`Ctrl+Shift+B`) and launch configurations (`F5`).

## Screenshots

| Main View | Jobs | Positions | Settings |
|-----------|------|-----------|----------|
| ![](screenshots/newjob) | ![](screenshots/jobs) | ![](screenshots/positions) | ![](screenshots/settings) |

## Hardware

Tested with: [Epson TM T20II](https://www.epson.de/products/sd/pos-printer/epson-tm-t20ii). Other receipt printers should work as well.

## License

GPL-3.0