Skip to content

Latest commit

 

History

History
89 lines (59 loc) · 2.75 KB

README.md

File metadata and controls

89 lines (59 loc) · 2.75 KB
Raw

VEHICLE PARKING MANAGEMENT SYSTEM

Features

  • Create a new parking lot with given specifications
  • Park a vehicle nearest to the entry point
  • Free a given slot
  • Issue ticket to the client while parking
  • Facilitate following queries
    • Get overall status of all slots in parking lot
    • Get vehicle registration numbers with given color
    • Get slot numbers where vehicle of particular color are parked
    • Get slot number for a given registration number of vehicle

Assumptions

  • Slot Ids are positive from 1 to N. For two slots Ids i and j, nearest slot to entry point of parking lot is i (if i < j)
  • Create parking lot command can be issued any number of times -> This will erase all data for current parking lot if any
  • Vehicles cannot have empty registration numbers and color
  • Only one vehicle can be parked in a given slot

Edge cases handled

  • In case of any invalid command issued, user gets corresponding message
  • Duplicate vehicle registration numbers will not be allowed to park
  • Cannot issue a leave command on an empty slot

Directory Structure

  • enums folder - holds commands, vehicleType etc
  • models folder - all models are present in this folder (Cars, Vehicle etc)
  • service folder - this holds code responsible for interaction with the models and other services
  • exception folder - any custom exception created shall be put here
  • Application.java - Main entry point of the code is in this class

Class Modelling

Vehicle and Car

  • Vehicle is the base class for all vehicle types
  • Car class extends base vehicle class

Slots

  • holds vehicle
  • can be occupied or left

ParkingLot

  • Has list of Slots

Ticket

  • Holds information of vehicle reg number, slot id, time spent in parking
  • Issued and closed at time of park and unPark respectively

ParkingManager

  • Holds ParkingLot object
  • Facilitates actions to be taken like park/unpark etc
  • Interacts with Parking Lot, Ticketing Service and Parking lot service for the same

Data Flow

Following major steps are followed.

  • Application.java: user interacts with system by issuing command here
  • ClientService : command is catered here and output is also printed here
  • ParkingManager : takes corresponding action issued from ClientService. It interacts with the model and other services to cater the clientService
  • ParkingLotService : responsible for creating new parking lot, called by ParkingManager
  • SlotService : responsible for creation of new slots
  • TicketService : ParkingManager calls to issue/close a ticket

Project build and run steps

Requirements

  • jdk 1.8
  • gradle 4.8
  • linux machine

Run

  • ./bin/setup
  • ./bin/parking_lot (for interactive mode)
  • ./bin/parking_lot file_path (for file mode)