🌱 Ecobid

Ecobid is a full-stack e-commerce and auction platform built with Django. It features a real-time bidding system, direct purchases, cart management, seamless M-Pesa payment integration, and a dedicated logistics dashboard for delivery drivers.

🚀 Features

• Auction & Direct Sales: Users can bid on items or buy them instantly at a set price.
• Shopping Cart: Support for bulk checkout of won auctions and purchased items.
• M-Pesa Integration: Automated STK push for payments via the Safaricom API.
• Logistics & Delivery System: A dedicated interface for drivers to claim deliveries, view real delivery addresses, and mark items as delivered using secure PIN verification.
• User Authentication: Secure login and registration for buyers, sellers, and drivers.

🛠️ Tech Stack

• Backend: Python, Django
• Database: SQLite (Development)
• Frontend: HTML, CSS, Bootstrap
• Payments: Daraja API (M-Pesa)

💻 Local Setup Instructions

Since sensitive files and the virtual environment are ignored by Git, follow these steps to run the project locally on a fresh machine:

1. Clone the repository:

   git clone [https://github.com/psychesupreme/Ecobid.git](https://github.com/psychesupreme/Ecobid.git)
   cd Ecobid
   
   

2. Create and activate a virtual environment:

   python -m venv venv
   venv\Scripts\activate  # On Windows
   

3. Install dependencies:

   pip install -r requirements.txt
   

4. Add your M-Pesa Credentials: Create a mpesa_credentials.py file in the main app directory and add your Daraja API keys.

5. Run Migrations & Start Server:

   python manage.py migrate
   python manage.py runserver