Music Shop

Awesome multi-user web app for managing and displaying the items of a music store.

View mockups · View report · Report Bug · Request Feature

Table of Contents

1. Introduction
2. About The Project
   • Built With
3. Getting Started
   • Prerequisites
   • Installation
4. Contributing
5. License
6. Contact

Introduction

Since 1991 the web has been revolutionized. The technologies and protocols underlying the web have been updated, but the winning idea that has made it stronger over the years is that of being able to expose services on multiple platforms (without changing a line of code).

In this regard we have decided to develop a project, carried out during the "Web technologies" course.

About the project

The purpose of the development of this project is to provide customers with a website that allows them to consult an online catalog of the products sold by "Music Shop" with the respective prices and characteristics of the respective products.

The site provides search functions based on product categories, their respective sub-categories, price or via a keyword.

You can read more about the project in the report.

(back to top)

Built With

• Laravel
• Laravel Mix
• Bootstrap
• JQuery
• PhpStorm IDE

(back to top)

Getting Started

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

Prerequisites

Software that you need to use to get the app built and running. Follow the links for the relative guide.

• npm: Install npm
• PHP Composer: Install composer
• Running MySql Server: Install MySql Server

Installation

1. Clone the repo

    git clone https://github.com/SamuPert/music-shop-app.git ProgettoTecnologieWeb
    cd ProgettoTecnologieWeb

2. Copy environment file

   cp .env.example .env

3. Edit .env file properties:
   • Edit DB_DATABASE value. It must match the database name you want to use.
   • Edit DB_USERNAME value. It must match the MySql user that you want to use.
   • Edit DB_PASSWORD value. It must match the MySql plaintext password that MySql user uses to connect to database.
   • Edit DB_HOST value. It must match the MySql instance address.
4. Initialize Laravel environment

   php artisan key:generate
   php artisan migrate

5. Compile scss and js files.

   npm run prod

5-bis. (Optional) Seed database with pre-defined content.

php artisan db:seed

Default users credentials are:

• Super Admin:
  • username: adminadmin
  • password: qbCltB0u
• Staff Admin:
  • username: staffstaff
  • password: qbCltB0u
• Staff Admin:
  • username: useruser
  • password: qbCltB0u

6. Serve the web application

   php artisan serve

7. Browse web application:

   http://localhost:8000/
   

(back to top)

Contributing

Contributions are what make the open source community such an amazing place to learn, inspire, and create. Any contributions you make are greatly appreciated.

If you have a suggestion that would make this better, please fork the repo and create a pull request. You can also simply open an issue with the tag "enhancement". Don't forget to give the project a star! Thanks again!

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

(back to top)

License

Distributed under the MIT License. See LICENSE.md for more information.

(back to top)

Contact

Samuele Perticarari - Telegram - samuele.perticarari@gmail.com - LinkedIn

Project Link: https://github.com/SamuPert/music-shop-app

(back to top)