jiranMarket

jiranMarket is a collaborative e-commerce platform built with PHP and MySQL. It provides a robust foundation for online shopping experiences, featuring a shopping cart, admin dashboard, user authentication, and more. The project is open for contribution by a 12-member group.

• 🛒 Shopping Cart: Add, remove, and update products in the cart.
• 👤 User Authentication: Secure registration, login, logout, and role management.
• 🛠️ Admin Dashboard: Manage products, view orders, handle users, and generate reports.
• 🛍️ Product Catalog: Browse products with categories, images, and descriptions.
• 🔍 Search & Filter: Quickly find products with search and filter options.
• 🧾 Order Management: Place orders, track status, view order history.
• 💬 User Reviews: Leave ratings and reviews for products.
• 📦 Inventory Management: Keep track of stock levels (admin).
• 📈 Sales Analytics: Basic analytics for admins.
• 📧 Email Notifications: For order confirmations and updates.

• Backend: PHP
• Database: MySQL
• Frontend: HTML, CSS, JavaScript (optionally Bootstrap for UI)
• Other: Composer (for PHP package management), PHPMailer (for email)

• PHP 7.x or newer
• MySQL 5.x or newer
• Composer (optional, for dependencies)
• Web server (Apache, Nginx or XAMPP/LAMP/MAMP stack)

1. Clone the repository

   git clone https://github.com/<your-username>/jiranMarket.git
   cd jiranMarket

2. Install dependencies
   If using Composer:

   composer install

3. Database setup

   • Create a MySQL database, e.g., jiranmarket.
   • Import the provided SQL schema:

     mysql -u youruser -p jiranmarket < database/schema.sql

   • Update database credentials in config/database.php:

     // config/database.php
     define('DB_HOST', 'localhost');
     define('DB_USER', 'youruser');
     define('DB_PASS', 'yourpassword');
     define('DB_NAME', 'jiranmarket');

4. Configure environment

   • Set up your web server to serve the project directory.
   • Ensure required PHP extensions are enabled (mysqli, mbstring, etc).

5. Run the application

   • Open http://localhost/jiranMarket in your web browser.

Add screenshots or a link to a live demo here if available.

This project is open for contribution by its 12 group members.

• Fork this repository.
• Create your feature branch: git checkout -b feature/your-feature
• Commit your changes: git commit -am 'Add some feature'
• Push to the branch: git push origin feature/your-feature
• Open a Pull Request.

Please coordinate with the group to avoid merge conflicts!

• Payment gateway integration (PayPal, Stripe)
• Wishlist/favorites
• Multi-language support
• Responsive mobile-first design
• API for third-party integrations

For questions or collaboration, reach out via the project repository or your group communication platform.

No license is specified for this project.