Welcome to Souq 3okaz, your one-stop solution for a revolutionary e-commerce experience! 🚀

The Souq 3okaz app addresses the challenges of traditional retail, providing a convenient and accessible shopping platform for users worldwide. With a focus on diverse product selections, seamless transactions, and doorstep delivery, Souq 3okaz aims to transform the retail landscape.

• Buy Items: Explore and purchase a wide range of products effortlessly.
• Rate Products: Share your experiences and contribute to our community.
• Wishlist Management: Curate your favorite items and receive personalized recommendations.
• Efficient Product Search: Find what you need quickly and easily.
• Easy Returns: Hassle-free return process for a stress-free shopping experience.
• Balance Recharge: Keep your transactions swift with a balance recharge option.
• 24/7 Support: Chat with our technical support team anytime for assistance.
• Upgrade to Premium: Enjoy exclusive benefits as a premium member.

• Direct Seller Chat: Communicate directly with sellers for a personalized experience.
• Participate in Auctions: Bid on unique items and elevate your shopping experience.
• Access Pre-release Products: Be the first to get your hands on the latest products.

• Add/Remove Products: Easily manage your product listings.
• Manage Auctions: Control and monitor auction activities seamlessly.
• Chat with Customers: Engage directly with your customer base.
• Easy Withdrawal: Withdraw your earnings effortlessly.
• Bartering Options: Explore alternative trade options for flexibility.

• Swift Communication: Instantly address customer and seller inquiries.
• Platform Integrity: Maintain a secure and reliable shopping environment.
• Seamless Experience: Ensure a smooth and enjoyable user journey.
• Community Guidelines: Enforce fair play and positive interactions.

In the backend, we've employed normalization and functional dependencies principles to meticulously design our database structure, ensuring efficiency and data integrity. Our routing pipeline is fortified with robust route protection mechanisms. For user authentication and privilege management, we've implemented comprehensive authorization and authentication protocols. Real-time chatting capabilities are seamlessly facilitated through the integration of Socket.IO. Database password storage is fortified with encryption for heightened security. Our API is meticulously crafted using REST concepts, promoting scalability and interoperability. The backend architecture adheres to the MVC paradigm, fostering modularity and maintainability.

In our frontend project, we've embraced a robust architecture centered around state management, leveraging the power of components composition and a variety of React hooks. Our implementation includes essential hooks such as useState, useReducer, useLocation, useSearchParams, and useEffect. These hooks play a pivotal role in seamlessly managing and updating state, handling component lifecycles, and facilitating navigation.

Additionally, we've harnessed the versatility of the Context API to streamline the flow of data across our application, enabling efficient communication between components. This approach not only enhances code organization but also promotes reusability and maintainability.

Our commitment to employing these cutting-edge React features ensures a scalable and maintainable codebase, providing a solid foundation for the dynamic and responsive user interface of our project.

A special thanks to our amazing team for their dedication and hard work in making Souq 3okaz a reality!

To run Souq 3okaz locally, follow these simple steps:

Make sure you have Node.js and npm installed on your machine. You can download them from nodejs.org.

git clone https://github.com/your-username/souq-3okaz.git
cd souq-3okaz

npm install

npm run dev

npm install

node server.js

Eslam Wageh

Ashraf Bahy

Adham hussin

Bishoy Wadea