BOSpark - Parking Management System

BOSpark is a comprehensive parking management system designed to streamline the process of finding, booking, and managing parking spaces. The platform connects drivers looking for convenient parking with parking facility owners.

Features

For Drivers

• User-friendly map interface to find nearby parking spots
• Real-time availability of parking spaces
• Easy booking and payment process
• Navigation to the selected parking facility
• History of previous bookings
• Vehicle information management

For Parking Owners

• Dashboard to manage parking facilities
• Real-time monitoring of parking spot occupancy
• Revenue tracking and analytics
• Terminal management for parking facilities
• Moderation system for new parking facilities

For Administrators

• User management
• Parking facility approval process
• System monitoring and reporting

Tech Stack

• Frontend: React.js with Material-UI
• Backend: Node.js with Express
• Database: PostgreSQL
• Maps: OpenStreetMap / OpenLayers
• Authentication: JWT
• Internationalization: i18next (supports multiple languages)

Getting Started

Prerequisites

• Node.js (v14 or higher)
• PostgreSQL (v12 or higher)
• npm or yarn

Installation

1. Clone the repository:

git clone https://github.com/yourusername/BOSpark.git
cd BOSpark

2. Install frontend dependencies:

cd frontend
npm install

3. Install backend dependencies:

cd ../backend
npm install

4. Database setup:

cd database
chmod +x reset-db.sh
./reset-db.sh

Note: You may need to modify the database connection details in reset-db.sh to match your PostgreSQL configuration.

5. Start the backend server:

cd ..
npm run dev

6. Start the frontend development server:

cd ../frontend
npm start

7. Open your browser and navigate to http://localhost:3000

User Roles

Driver

• Can register with vehicle details
• Can search for and book parking spots
• Can navigate to parking locations
• Can view booking history

Parking Owner

• Can register and add parking facilities
• Must wait for admin approval before their parking becomes visible
• Can manage their parking spots and view analytics
• Can set pricing and availability

Administrator

• Can approve or reject new parking facilities
• Can manage all users and parking facilities
• Has access to system-wide analytics

Default Admin Account

• Email: admin@bospark.kz
• Password: admin123

License

This project is licensed under the MIT License - see the LICENSE file for details.

Acknowledgments

• OpenStreetMap for the mapping data
• Material-UI for the component library
• All the contributors who have helped shape BOSpark