🚤 Sharavati Backwater Boating Ticket Booking System

A JavaFX 17 desktop application for booking boat ride tickets for the Honnavar and Kasarkod tenants, 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 com.boatticket.config

---

💰 Fee Structure (all preset — edit in Ticket.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 = 40

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

mvn clean package
java -jar target/BoatTicketSystem-2.0-SNAPSHOT.jar

---

🚀 Building tenant-specific artifacts

Build each tenant explicitly. The packaged configuration, boat list, branding, local data directory, and update feed are selected by its Maven profile.

Build the distributable package:

mvn clean package -Phonnavar
mvn clean package -Pkasarkod

To build both artifacts in one command on Windows:

.\scripts\build-tenants.ps1

This creates either HonnavarBoatTicketSystem-<version>.jar or KasarkodBoatTicketSystem-<version>.jar. The release workflow creates the corresponding self-contained Windows MSI installer.

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

Windows release installer

The release workflow produces an MSI with a built-in Java runtime. The installer prompts for the installation directory and whether to create a desktop shortcut, and it also adds a Start Menu shortcut. Its icon is derived from src/main/resources/icons8-boat-48.png and stored as src/main/resources/BoatBookingSystem.ico for Windows packaging.

Unsigned MSI files may show an Unknown Publisher or Microsoft Defender SmartScreen warning. This cannot be suppressed safely by the build workflow; it requires a trusted code-signing certificate and publisher reputation.

Build only the fat JAR (without exe):

mvn clean package -DskipTests

Build only the executable (requires JAR to be built first):

mvn launch4j:launch4j

Build only the distribution zip:

mvn assembly:single

Run the application during development:

mvn javafx:run