🚲 Bike Sharing Management System

This is a bike sharing management system. The project allows user registration and authentication, management of bicycles and docking stations, operation monitoring, and smart card handling. It includes a user interface for guests, clients, and administrators, as well as an admin panel for system maintenance and control.

🛠️ Setup & Configuration

⚙️ Requirements

• PHP >= 8.0

• Python >= 3.9

• PostgreSQL (for the database)

• Local web server (e.g., Apache or Nginx)

• Composer (optional, for managing PHP dependencies)

• Virtualenv (optional, for managing Python environments)

📦 Installation

1. Clone this repository:

2. (Optional) Create a virtual environment for Python:

3. Install the required Python libraries (e.g., Flask, psycopg2):

4. Run the Python web services:

5. Start the PHP server from the project root:

🧠 Database

🔒 The SQL file for the database has been intentionally hidden.

🧾 However, the entire schema can be easily reconstructed using the provided Entity-Relationship (ER) diagram, which outlines all entities and their relationships, including:

• 👥 Users

• 💳 Credit Cards

• 📇 Smart Cards

• 🚲 Bicycles

• 🛠️ Operations

• 📍 Docking Stations

📌 All primary and foreign keys are clearly defined for easy replication.

You can use tools such as:

• pgModeler

• DBeaver

• DBDiagram.io

to design and recreate the database schema visually.

🔐 Features

Here’s a quick overview of the system’s key features:

• ✅ User registration and authentication

• 🚴 Bike rental and return via RFID smart card

• 🗺️ Real-time map of available bikes and stations

• 💳 Payment processing via credit card

• 👤 Personal dashboard with usage history

• 🛠️ Admin panel for service operations and maintenance

• 🔁 Python-powered RESTful web services

🧪 Manual Testing

To test the project manually, follow these steps:

1. 🧩 Recreate the database based on the ER diagram

2. 🐍 Run the Python web services (app.py)

3. 🌐 Start the PHP server and access the app through your browser

🧪 Manual testing is enough to explore most of the core features and flows.

📜 License

📄 This project is released under the MIT License.
Please refer to the LICENSE file for full details.

🧑‍💻✨ Happy coding