Skip to content

Hussein-Alayan/His-Hers

 
 

Repository files navigation

His & Hers

Build Status License Laravel React Last Commit Open Issues

Group Project | SE Factory Software Engineering Program


🚀 Project Overview

His & Hers is a full-stack e-commerce web application built as a collaborative group project for the SE Factory Software Engineering Program. The app features seamless user experiences, robust backend logic, modern frontend design, and an integrated AI-powered chatbot.


✨ Features

🛒 User Features

  • Register, login, and manage profile
  • Browse products with advanced filters (brand, gender, etc.)
  • View product details and variants
  • Add to cart and complete checkout
  • View order history and order details
  • Receive in-app notifications (order status, updates)
  • Interact with an AI-powered chatbot for assistance

🛠️ Admin Features

  • Manage products, brands, categories, and accords (CRUD)
  • View and manage all orders (status updates, soft delete, restore)
  • Access admin dashboard for product and order management

⚙️ General & Technical Features

  • Secure JWT authentication and protected routes
  • Automated invoice emails on order placement
  • Real-time stock tracking and updates
  • Event-driven architecture (order placed, analytics, webhooks)
  • Integrated OpenAI chatbot API
  • Unit and feature tests (TDD)
  • Continuous Integration with GitHub Actions

👥 Team & My Role

This project was developed by a team of passionate engineers. As Backend Lead, I contributed to multiple core aspects of the project:

🗄️ Database & Backend Logic

  • Designed and implemented database models, factories, and relationships (notably for immigration features)
  • Built clean, maintainable backend logic using Laravel Resources and Form Requests
  • Developed the Checkout API and ensured accurate stock availability tracking
  • Integrated an AI Chatbot with OpenAI, handling user interactions securely and preventing prompt injection
  • Implemented admin APIs for the frontend management page

💻 Frontend Contributions

  • Assisted with React components (factoring pages, footer, admin pages)
  • Ensured clean integration with backend APIs

🧪 Testing & CI

  • Wrote unit and feature tests following TDD principles
  • Set up CI workflows with GitHub Actions for backend branches

🧹 Code Quality

  • Maintained clean code architecture with thin controllers and separation of concerns
  • Used Laravel best practices (Requests, Resources, Events)

🛠️ Tech Stack

  • Backend: Laravel (PHP), MySQL
  • Frontend: React (JavaScript)
  • AI: OpenAI API
  • DevOps: Docker, GitHub Actions

🏁 Getting Started

  1. Clone the repository:
    git clone https://github.com/Hussein-Alayan/His-Hers.git
  2. Install dependencies for both backend and frontend:
    • Backend: composer install && npm install
    • Frontend: npm install
  3. Set up environment variables as described in the respective README.md files.
  4. Run the backend and frontend servers using Docker Compose or manually.

🤝 Acknowledgements

Special thanks to SE Factory and all team members for their collaboration and support throughout this project!


For more details, see the backend and frontend folders.

About

No description, website, or topics provided.

Resources

Stars

Watchers

Forks

Releases

No releases published

Packages

 
 
 

Contributors

Languages

  • PHP 54.1%
  • JavaScript 30.1%
  • CSS 15.2%
  • Other 0.6%