https://github.com/codenitros/boatbookingsystem
https://github.com/codenitros/boatbookingsystem
Last synced: 4 days ago
JSON representation
- Host: GitHub
- URL: https://github.com/codenitros/boatbookingsystem
- Owner: codenitros
- License: gpl-3.0
- Created: 2026-04-13T14:32:32.000Z (about 2 months ago)
- Default Branch: main
- Last Pushed: 2026-05-13T17:54:48.000Z (25 days ago)
- Last Synced: 2026-05-13T19:32:15.728Z (25 days ago)
- Language: Java
- Size: 96.7 KB
- Stars: 0
- Watchers: 0
- Forks: 0
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
README
# 🚤 Sharavati Backwater Boating Honnavar Ticket Booking System
A JavaFX 17 desktop application for booking boat ride tickets at Sharavati Backwater Boating Honnavar, with thermal printing, database storage, and Excel export.
---
## ✨ Features
| Feature | Details |
|---|---|
| User Authentication | Login with username/password and role-based access |
| Customer Details | Name + 10-digit Contact Number |
| Passenger Count | Spinner (1–50 people) |
| Ride Duration | Radio buttons: 1 Hour (₹1500) or 2 Hours (₹2500) |
| Life Jackets | Mandatory, ₹10 per person |
| Parking | Optional checkbox with vehicle types |
| Vehicle Types | Car ₹20 · Bus ₹50 · Tempo Traveller ₹35 |
| Boat Assignment | Search and select from registered boats/drivers |
| Live Fee Calc | Total, Driver Amount, Counter Amount update instantly |
| Thermal Printing | Direct print to thermal printer + console preview |
| Database Storage | SQLite for ticket and boat data |
| Excel Export | Backup tickets to Excel file |
| View Tickets | List today's issued tickets |
| Fee Split | Driver: Boat + Jackets; Counter: Parking |
---
## 🛠️ Prerequisites
- **Java 17** (JDK 17+)
- **Maven 3.8+**
- **IntelliJ IDEA** (Community or Ultimate)
---
## 🚀 Quick Start in IntelliJ
### 1. Open the Project
```
File → Open → select the BoatTicketSystem folder
```
IntelliJ will auto-detect the `pom.xml` and import dependencies.
### 2. Wait for Maven to download dependencies
The first run downloads JavaFX 17, SQLite JDBC, Apache POI, and other libraries (~10-15 MB total).
### 3. Run the app
- **Option A (Maven):** Right-click `pom.xml` → Run Maven → `javafx:run`
- **Option B (Main class):** Open `MainApp.java` → click the green ▶ Run button
- **Option C (Run Config):** The `.idea/runConfigurations/BoatTicketSystem.xml` is pre-configured
The app starts with a login screen. Default credentials are admin/admin (or check DatabaseManager for setup).
### If you see module errors, add VM options:
```
--add-opens javafx.graphics/com.sun.javafx.application=ALL-UNNAMED
```
Go to: **Run → Edit Configurations → VM Options**
---
## 📁 Project Structure
```
BoatTicketSystem/
├── pom.xml ← Maven dependencies
├── build-exe.bat ← Build script for creating executable
├── src/
│ ├── assembly/
│ │ └── distribution.xml ← Assembly descriptor for packaging
│ └── main/
│ ├── java/
│ │ ├── module-info.java ← Java module descriptor
│ │ └── com/boatticket/
│ │ ├── MainApp.java ← Entry point
│ │ ├── controller/
│ │ │ └── BookingController.java ← Booking UI logic
│ │ ├── db/
│ │ │ └── DatabaseManager.java ← SQLite database operations
│ │ ├── model/
│ │ │ ├── Ticket.java ← Ticket data model + fee constants
│ │ │ └── BoatOwner.java ← Boat owner data model
│ │ └── util/
│ │ └── ThermalPrinterManager.java ← Thermal printing utilities
│ └── resources/com/boatticket/
│ ├── login.fxml ← Login UI layout
│ ├── booking.fxml ← Booking UI layout
│ └── styles.css ← Styling
└── .idea/runConfigurations/ ← Pre-built IntelliJ run config
```
---
## 💰 Fee Structure (all preset — edit in `Ticket.java`)
```java
BOAT_RIDE_FEE_PER_HOUR = 1500 // per hour
BOAT_RIDE_FEE_2HOURS = 2500 // special rate for 2 hours
LIFE_JACKET_FEE = 10 // per jacket (mandatory)
PARKING_FEE_CAR = 20
PARKING_FEE_BUS = 50
PARKING_FEE_TEMPOTRAVELLER = 35
```
To change any fee, open `src/main/java/com/boatticket/model/Ticket.java` and edit the constants at the top.
---
## 🖨️ Generating a Ticket (Thermal Print)
1. Fill in the booking form (login required)
2. Select boat/driver, duration, parking if needed
3. Click **"Generate Ticket"**
4. The ticket is automatically printed to the default thermal printer
5. A preview is also shown in the console
The thermal ticket includes:
- Unique Ticket ID + booking timestamp
- Customer & ride details
- Boat/driver assignment
- Itemised fee breakdown (Boat, Jackets, Parking)
- Driver Amount + Counter Amount
- Total amount
---
## 🔧 Troubleshooting
**"JavaFX runtime components are missing"**
→ Make sure you're running via Maven (`mvn javafx:run`) or add `--module-path` to VM options.
**Dependencies not downloading**
→ Check internet connection, then: Right-click `pom.xml` → Maven → Reload Project.
**Build fails on module-info.java**
→ Ensure your IntelliJ is set to Java 17: File → Project Structure → SDK = 17.
---
## 📦 Building a runnable JAR
```bash
mvn clean package
java -jar target/BoatTicketSystem-2.0-SNAPSHOT.jar
```
---
## 🚀 Creating a Self-Contained Executable (Windows .exe)
This project is configured to create a self-contained executable that bundles all dependencies into a single JAR file and wraps it in a Windows executable.
### Build the distributable package:
**Option 1: Using the build script (recommended):**
```bash
# Double-click build-exe.bat or run:
build-exe.bat
```
**Option 2: Using Maven directly:**
```bash
mvn clean package
```
This will create:
- `target/BoatTicketSystem-2.0-SNAPSHOT.jar` - Fat JAR with all dependencies
- `target/BoatTicketSystem.exe` - Windows executable
- `target/BoatTicketSystem-2.0-SNAPSHOT-distribution.zip` - Complete distribution package
### What's included in the distribution:
- **Fat JAR** (created with Maven Shade) - Contains all dependencies (~25-35MB)
- **Windows executable** (`.exe`) launcher created with Launch4j
- **Batch file** launcher (`.bat`) as alternative
- **README** and documentation
### Running the application:
1. Extract the `BoatTicketSystem-2.0-SNAPSHOT-distribution.zip` file
2. Double-click `BoatTicketSystem.exe` or run `BoatTicketSystem.bat`
3. The application will start (requires Java 17+ on target machine)
### System Requirements for the executable:
- **Windows 7 SP1 or later** (64-bit recommended)
- **Java 17+** must be installed on the target machine
- **~30-40MB** free disk space for the extracted distribution
### How it works:
1. **Maven Shade Plugin** creates a fat JAR containing all dependencies
2. **Launch4j** wraps the JAR into a Windows executable with proper JRE detection
3. **Maven Assembly** packages everything into a distributable zip file
---
## 🔧 Advanced Build Options
### Build only the fat JAR (without exe):
```bash
mvn clean package -DskipTests
```
### Build only the executable (requires JAR to be built first):
```bash
mvn launch4j:launch4j
```
### Build only the distribution zip:
```bash
mvn assembly:single
```
### Run the application during development:
```bash
mvn javafx:run
```