ITI Final Project

An e‑commerce web application built as the final group project for the Information Technology Institute (ITI).

---

Table of Contents

• Overview
• Features
• Tech Stack
• Demo / Screenshots
• Getting Started
  • Prerequisites
  • Installation
• Usage
• Testing
• Project Structure
• Contributors
• License

---

Overview

This project is a full‑stack e‑commerce platform designed for the ITI final project requirement. It allows users to browse and search for products, add them to a cart, make orders, and gives administrators tools to manage products, users, and orders.

The goal is to demonstrate the team’s skills in:

• Backend API / database design
• Frontend user interface & UX
• Authentication & Authorization
• CRUD operations
• Responsive design

---

Features

Here are some of the main features:

• User Authentication: Signup and login functionality
• Product Catalog: Viewing products by categories; search and filter
• Product Details: View individual product pages with full info
• Shopping Cart & Orders: Add/remove items, view cart, checkout
• Admin Dashboard: Manage products, view/manage orders, user management
• Responsive UI: Works on desktop and mobile devices

(Optional/planned features: order tracking, payment gateway, user reviews, etc.)

---

Tech Stack

Layer	Technology
Backend	PHP + Laravel framework
Frontend	Blade templating, JavaScript, HTML/CSS
Database	MySQL (or equivalent relational DB)
Build Tools	Node.js, npm, Vite (for asset bundling & frontend assets)
Testing	PHPUnit (backend), [frontend testing tool if used]

Getting Started

Prerequisites

Make sure you have installed:

• PHP (version 8.x or above is recommended)
• Composer
• Node.js & npm
• MySQL (or another relational database)
• Git

Installation

1. Clone the repository:

   git clone https://github.com/BeboXKiller/iti.final.project.git
   cd iti.final.project
   
   

2. Copy .env file and configure environment:

   cp .env.example .env

   Then edit .env and set your database credentials, app URL, etc.

3. Install backend dependencies:

   composer install

4. Install frontend / asset dependencies:

   npm install

5. Generate application key:

   php artisan key:generate

6. Run migrations (and seeders if included):

   php artisan migrate
   php artisan db:seed

7. Build frontend assets (development mode):

   npm run dev

8. Serve the application:

   php artisan serve

   By default, you're likely to access it at http://localhost:8000.

---

Usage

• Register as a user → browse products → view details → add to cart → checkout
• If you have an admin role: access admin panel/dashboard → manage users, products, orders
• Use search, filtering, pagination as applicable

---

Testing

• Backend tests:

  php artisan test

• Frontend / integration tests (if present):

  npm test

---

Project Structure

Here’s a high‑level breakdown of folder structure:

├── app/               # Controllers, Models, Business Logic
├── bootstrap/
├── config/
├── database/          # Migrations, Seeders, Factories
├── public/            # Public assets, entry point
├── resources/         # Views (Blade templates), frontend assets (JS, CSS)
├── routes/            # Web and API routes
├── storage/           # Logs, compiled views, uploads
├── tests/             # Automated tests
├── .env.example
├── package.json
├── composer.json
└── ... other files

---

Contributors

Thanks to the team members who worked on this project:

• BeboXKiller
• NourElden‑20 (Nour)
• D9pro88o
• OmarWabbo (Omar Mohamed)

---

License

This project is released under the CC0‑1.0 (Public Domain) license. See the LICENSE file for details.

---