A full-featured, dual-role Smart Parking Management System built in Java with a polished JavaFX GUI.
Multi-vehicle support · EV charging · Real-time slot grid · Complete admin portal · File persistence
Features · Architecture · OOP Concepts · Getting Started · Team
This is not a basic console application.
SmartPark is a fully functional, dual-role parking management system built from the ground up in Java with a hand-crafted JavaFX + Scene Builder graphical interface. It supports four vehicle types including EVs with charging, real-time slot management, automated billing, and a complete admin portal — all through a dark-themed GUI.
The backend is architected using core OOP principles: abstract classes, polymorphism, interfaces, custom exceptions, and Java serialization for persistence. The GUI layer sits cleanly on top via the MVC pattern — zero business logic in the controller files.
Built as a collaborative team project for the Object Oriented Programming course at COMSATS University Islamabad, Lahore Campus, Spring 2026.
| Feature | Description |
|---|---|
| 🚗 Park Vehicle | Select type (Car / Bike / Truck / EV), enter plate and owner, get assigned slot and Entry ID |
| 🚪 Exit & Bill | Enter plate number, receive formatted receipt with duration and total charge |
| 🗺️ Real-time Slot Grid | Color-coded visual map — 🟢 Available · 🔴 Occupied · by slot type |
| 🔍 Find My Vehicle | Search any parked vehicle instantly by plate number |
| ⚡ EV Charging | Request charging on arrival, set battery level, choose per-minute or per-percent billing |
| Feature | Description |
|---|---|
| 🔑 Secure Login | Username + password authentication |
| 📊 Dashboard | Live stats — total slots, available, occupied, revenue overview |
| Add or remove slots, change slot types dynamically at runtime | |
| 💰 Parking Rates | Update rates per vehicle type (Car / Bike / Truck / EV) in real time |
| ⚡ EV Charging Rates | Set per-minute and per-percent EV charging prices independently |
| 🔋 Monitor EV | Track all active EV charging sessions across every EV slot |
| 🧾 Billing History | Complete searchable transaction log of every completed parking session |
| 📈 Generate Reports | Occupancy and revenue summaries with export |
| 🚘 Parked Vehicles | Full live table of all currently parked vehicles with entry times |
SmartPark
├── Presentation Layer → JavaFX + Scene Builder (FXML + CSS dark theme)
├── Controller Layer → 15 FXML Controllers (MVC pattern)
├── Business Logic Layer → Vehicles, ParkingLot, Billing, Admin
└── Persistence Layer → Java Serialization via FileManager
Class Hierarchy
Vehicle (abstract)
├── Car → getRate() = 2.0f (Compact slot)
├── Bike → getRate() = 1.0f (Motorcycle slot)
├── Truck → getRate() = 3.0f (Large slot)
└── EV → getRate() = 5.0f (EV slot + implements Chargeable)
ParkingLot → owns → ParkingSlot[]
Bill → uses → Vehicle
EVBill → extends → Bill, implements Chargeable
Admin → manages → ParkingLot
AppState → holds → ParkingLot + Admin + BillingHistory
FileManager → persists → everything via Serialization
src/main/java/
│
├── com/smartpark/ ← Core application
│ ├── MainApp.java Entry point (JavaFX Application)
│ ├── AppState.java Global state (singleton-style)
│ ├── SceneManager.java Screen navigation helper
│ ├── FileManager.java Load / save via Java serialization
│ └── controllers/ One controller per FXML screen (15 total)
│ ├── WelcomeController.java
│ ├── LoginController.java
│ ├── AdminDashboardController.java
│ ├── UserDashboardController.java
│ ├── ParkVehicleController.java
│ ├── ExitVehicleController.java
│ ├── FindVehicleController.java
│ ├── SlotGridController.java
│ ├── ManageSlotsController.java
│ ├── ParkingRatesController.java
│ ├── BillingHistoryController.java
│ ├── GenerateReportController.java
│ ├── EVChargingController.java
│ ├── EVChargingRatesController.java
│ └── MonitorEVController.java
│
├── vehicles/ ← Vehicle hierarchy
│ ├── Vehicle.java Abstract base class
│ ├── Car.java
│ ├── Bike.java
│ ├── Truck.java
│ └── EV.java
│
├── parking/ ← Parking domain
│ ├── ParkingLot.java Manages all slots + rates
│ └── ParkingSlot.java Individual slot state
│
├── billing/ ← Billing domain
│ ├── Bill.java Parking receipt model
│ └── EVBill.java EV-specific charging bill
│
├── users/
│ └── Admin.java Admin credentials + operations
│
├── interfaces/
│ └── Chargeable.java EV charging contract
│
├── exceptions/
│ └── ParkingException.java Custom runtime exception
│
└── filehandler/
└── FileHandler.java Low-level file I/O utilities
src/main/resources/fxml/
├── Main/ welcome · login · adminDashboard · userDashboard
├── Admin Features/ manageSlots · parkingRates · billingHistory · generateReport · monitor_ev · ev_charging_rates
└── User Features/ parkVehicle · exitVehicle · findVehicle · evCharging · slotGridView
| Screen | Description |
|---|---|
| Welcome | Landing screen with navigation to Admin or User portal |
| Login | Admin credential entry with error feedback |
| Admin Dashboard | Live stat cards + quick-access to all admin features |
| User Dashboard | User portal home with 5 quick-access cards |
| Park Vehicle | Type selector, plate + owner input, slot assignment receipt |
| Exit Vehicle | Plate lookup, full billing receipt with duration and amount |
| Slot Grid | Full color-coded visual map of all parking slots |
| Parked Vehicles | Live table of all currently occupied slots |
| Manage Slots | Add / remove slots and change slot types |
| Parking Rates | Per-vehicle-type rate editor |
| EV Charging Rates | Per-minute and per-percent rate configuration |
| Monitor EV | Live view of all active EV charging sessions |
| Billing History | Searchable complete transaction log |
| Generate Report | Occupancy and revenue report generation |
| Find Vehicle | Plate number search with full vehicle details |
| Concept | Where Applied |
|---|---|
| Abstract Class | Vehicle — abstract getRate() and getType() methods |
| Inheritance | Car, Bike, Truck, EV all extend Vehicle |
| Polymorphism | ArrayList<Vehicle> holds mixed types; each calls its own getRate() |
| Interface | Chargeable — implemented by EVBill for charging fee logic |
| Encapsulation | All fields private; accessed via getters/setters throughout |
| Comparable | Vehicle implements Comparable<Vehicle> — sorts by entry time |
| Comparator | Bill uses Comparator for sorting history by amount or date |
| Serialization | ParkingLot and Bill implement Serializable for file persistence |
| Custom Exception | ParkingException thrown for duplicate or invalid parking entries |
| Composition | ParkingLot is composed of ParkingSlot objects |
| MVC Pattern | Full separation — FXML (View), Controllers, Model classes |
| Collections | Extensive use of ArrayList and Collections.sort() |
| Static Methods | FileManager — load/save methods are static |
- Java JDK 17 or higher — Download
- JavaFX SDK 17 — Download
- IntelliJ IDEA — Download
- Scene Builder 17+ (optional, for editing FXML) — Download
- Go to File → Project Structure → Libraries → click + → Java
- Navigate to your JavaFX SDK folder → select the
lib/subfolder → OK - Go to Run → Edit Configurations → add VM options:
--module-path "C:\path\to\javafx-sdk-17\lib" --add-modules javafx.controls,javafx.fxml
- Set Main class to
com.smartpark.MainApp
git clone https://github.com/YOUR_USERNAME/SmartPark.gitOpen SmartPark in IntelliJ → configure JavaFX (above) → press ▶ Run
Username : Sir Aksam
Password : siraksamisgreat
Team SmartPark · COMSATS University Islamabad, Lahore Campus · OOP · Spring 2026
| Name | Role |
|---|---|
| Saad | Backend Developer & Initiator |
| Taha | Frontend Developer & Debugger |
This project was built for academic purposes as part of the Object Oriented Programming course at COMSATS University Islamabad, Lahore Campus, Spring 2026.
SmartPark · COMSATS Lahore · OOP · Spring 2026