Learning Management System

A Mini-Project for CS352

Table Of Contents

• About the Project
• Built With
• Getting Started
  • Prerequisites
  • Installation
• Usage
  • Locally
  • Via Container
• Contributing
• Authors

About The Project

A Simple LMS built as a mini-project for SWE-2 (CS352) under the supervision of Eng. Ahmed EL-Batanouni to apply concepts of Backend development and Containerization

Built With

Client: Blade, Bootstrap

Server: Apache, Laravel

Containerization Service: Docker

Miscellaneous: Github Actions, Build and push Docker images, Docker Login

Getting Started

To get a local copy up and running follow these simple example steps.

Prerequisites

• npm

npm install npm@latest -g

• laravel

composer global require laravel/installer

Make sure that either MySQL or MariaDB are installed either manually or via phpMyAdmin

Installation

Clone the project

  https://github.com/ZodicSlanser/Learning-Management-System

Go to the project directory

  cd Learning-Management-System

Install dependencies

  composer install

  npm install

Usage

Running Locally

Make the migrations to update the database

    php artisan migrate

Seed the Database

    php artisan db:seed

Start the server and run watch

    php artisan serve

    npx run watch

or alternatively run the .bat

    /autorun.bat

go to the following route

    http://127.0.0.1:8000/

Running via container

pull the image

docker pull zodicslanser/lms

run the container

docker run --name lms -p 8000:8000 -d zodicslanser/lms

connect to Container Terminal

docker exec -it lms /bin/sh

make the migrations to update the database

    php artisan migrate

go to the following page

<container-ip>:8000

Contributing

Any contributions you make are greatly appreciated.

• If you have suggestions for adding or removing projects, feel free to open an issue to discuss it, or directly create a pull request after you edit the README.md file with necessary changes.
• Please make sure you check your spelling and grammar.
• Create individual PR for each suggestion.
• Make sure to add a meaningful description

Creating A Pull Request

1. Fork the Project
2. Create your Feature Branch (git checkout -b feature/AmazingFeature)
3. Commit your Changes (git commit -m 'Add some AmazingFeature')
4. Push to the Branch (git push origin feature/AmazingFeature)
5. Open a Pull Request

Authors

• Saif Ad-Din Samir - Computer Science Student - ZodicSlanser
• Said Sharaf - Computer Science Student - Said Sharaf
• Salma Hamdy - Computer Science Student - Salma Hamdy
• Ziad Ezzat - Computer Science Student - Ziad Ezzat
• Ziad Shalaby - Computer Science Student - Ziad Shalaby