Skip to content

Sazidul0/IIUC_Bazaar

Folders and files

NameName
Last commit message
Last commit date

Latest commit

Β 

History

16 Commits
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 

Repository files navigation

IIUC Bazaar πŸ“±πŸŽ―

A university-based e-commerce application designed exclusively for IIUC students. IIUC Bazaar simplifies the buying and selling of products within the university ecosystem, featuring secure authentication, role-based functionalities, and reliable payment methods.


πŸ“– Table of Contents

  1. Features
  2. Architecture
  3. Technology Stack
  4. Installation
  5. Usage
  6. Notification System
  7. Demo Video
  8. Challenges and Solutions
  9. Future Enhancements
  10. License

🎯 Features

Authentication

  • University Email Restriction: Only emails ending with @ugrad.iiuc.ac.bd can sign up.
  • Secure Login: Users can securely log in, and a "Forgot Password" option is available.

User Roles

  1. Buyer:
    • Add items to the cart.
    • Place orders with payment options.
    • View pending orders.
    • Give and manage reviews.
  2. Seller:
    • Add, edit, and delete products.
    • Manage orders and view sales performance.
    • View and manage product reviews.

Smart Chatbot (NEW)

  • Replies in Bangla and English.
  • Analyzes app data such as:
    • Most sold products
    • Trending items
    • Buyer preferences
  • Suggests sellers what products to add (based on demand & trends).
  • Suggests buyers what products to buy (based on popular items & behavior).
  • Helps with navigation, order queries, FAQs, and app guidance.

Payment Options

  • Card Payment: Securely integrated using Stripe API.
  • Cash on Delivery: Available for users who prefer to pay on delivery.

Delivery Location

  • Predefined university locations, such as FAZ, C Building, CXB, etc., ensure efficient delivery.

πŸ— Architecture

The application follows the Model-View-ViewModel (MVVM) pattern:

  • Model: Manages data and business logic.
  • View: Displays the UI and interacts with users.
  • ViewModel: Connects the Model and View, handling user input and updating the UI.

πŸ’» Technology Stack

  1. Frontend: Flutter
  2. State Management: GetX
  3. Backend: Firebase (Authentication, Realtime Database, Storage)
  4. Payment Integration: Stripe API
  5. UI Enhancements: Google Fonts, HexColor

πŸš€ Installation

Prerequisites

  • Flutter SDK
  • Android Studio or VS Code
  • Firebase account
  • Stripe account for payment integration

Steps

  1. Clone the Repository:

    git clone https://github.com/Sazidul0/IIUC_Bazaar.git
    cd IIUC_Bazaar
    
  2. Install Dependencies:

    flutter pub get
    
  3. Set Up Firebase:

    • Add your google-services.json (Android) and GoogleService-Info.plist (iOS) files.
    • Enable Authentication and Realtime Database in Firebase Console.
  4. Configure Stripe API:

    • Replace the placeholder API keys in payment_service.dart with your Stripe credentials.
  5. Run the App:

    flutter run
    
    

πŸ“š Usage

Buyer Workflow

  1. Signup: Register with your university email (@ugrad.iiuc.ac.bd).
  2. Browse Products: Explore and purchase items.
  3. Place Orders: Select a payment method and choose a delivery location.
  4. Manage Orders: Track your orders and provide product ratings.
  5. AI Recommendations: Get smart AI-based suggestions on products you may like.

Seller Workflow

  1. Signup/Login: Register or login using your university email.
  2. Manage Products: Add, update, or delete products.
  3. View Sales: View both monthly and total sales directly from the homepage.
  4. Manage Orders: Process and update order statuses.
  5. AI Product Suggestions: Receive AI-driven insights on what products to add based on demand and trends.

πŸ”” Notification System

Buyer Notifications:

  • Card Payment: Payment success notification.
  • Cash on Delivery: Order confirmation notification.

Seller Notifications:

  • New order alerts with delivery details.

Notifications ensure a seamless buying and selling experience.

πŸ›  Challenges and Solutions

  • Challenge: Restricting Access
    Solution: Validate email domain for @ugrad.iiuc.ac.bd.

  • Challenge: Role-Specific Functionalities
    Solution: Designed separate UIs and backend logic for buyers and sellers.

  • Challenge: Secure Payment Integration
    Solution: Integrated Stripe API for safe card payments.

  • Challenge: Smart Recommendations Solution: Implemented data-driven chatbot suggestion system.

🌟 Future Enhancements

  • Add real-time chat between buyers and sellers.
  • Expand delivery location options.
  • Integrate advanced analytics for seller performance.
  • Introduce AI-based product recommendations.

πŸ“œ License

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

🀝 Contributing

Contributions are welcome!

  1. Fork the repository.
  2. Create a new branch.
  3. Commit your changes.
  4. Open a pull request.

πŸ‘©β€πŸ’» Contact

Developer: [Sazidul Islam]
GitHub: [https://github.com/Sazidul0]

About

IIUC Bazaar - University-based E-Commerce App

Resources

License

Stars

Watchers

Forks

Packages

No packages published