dombidav/hl5u4v-thesis

Webservice for Managed Access Control Systems

Dombi Tibor Dávid Thesis Work
Eszterházy Károly University, Hungary
Explore the docs »

Table of Contents

1. About The Project
   • Built With
2. Getting Started
   • Prerequisites
   • Installation
3. License
4. Acknowledgements

About The Project

This project is a base for a managed access control system webservice

Built With

• Laravel
• Fortify
• Angular

Getting Started

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

Prerequisites

With Docker

• Docker
• Node.js 14.0 or newer
• Yarn 1.x

Without Docker

Frontend:

• @angular/cli 13.x
• Node.js 14.0 or newer
• Yarn 1.x

Backend:

• PHP 8.1 or newer (this repository is PHP 8 compatible)
• Composer
• Database of your choice (MySQL, SQLite)
• Optional: XDebug for testing

Installation

With Wizard

1. Clone the repo

   git clone https://github.com/dombidav/hl5u4v-thesis.git

2. Install the dependencies

   yarn

3. Run the wizard

    yarn wizard

4. Configure the project guided by the wizard
5. Start the development server

   yarn serve

Manualy

1. Clone the repo

   git clone https://github.com/dombidav/hl5u4v-thesis.git

2. Install the dependencies

    yarn

3. Set up webservice

• Change directory to webservice

  cd webservice

• Install the dependencies

  cd webservice
  composer install

• Set up the environment

  cp .env.example .env

  Edit the .env file to match your database configuration
• Generate the application key

  php artisan key:generate

• Start the database of your choice
• Create a database for the project as specified in the .env file
• Migrate the database

  php artisan migrate:fresh --seed

• Start the development server

  php artisan serve

4. Set up the admin panel

• Change directory to admin

  cd admin

• Install the dependencies

  yarn

• Create configuration file at src/environments/environment.ts with the following content:

  export const environment = {
    production: false,
    APP_URL: 'http://localhost:8000', // URL of the webservice
  };

  Change the APP_URL to match the URL of the webservice
• Start the development server

  ng serve

License

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

Project Link: https://github.com/dombidav/hl5u4v-thesis