MadsBalslev / P3

A web interface for managing information screens at Nordkraft in Aalborg, and add / remove posters from the screens

Semesterprojekt 3. Semester - NordkraftPMS

This repository has been developed in cooperation with Nordkraft.

NordkraftPMS

The goal of this webapplication was to create a system for Nordkraft, to manage, upload, display and schedule different posters. To ensure the different institutions do not interfere with each other, a user- and institution system has been implemented. Therefore an authentication system is also in place.
Explore the docs »

Table of Contents

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

About The Project

The goal of this webapplication was to create a system for Nordkraft, to manage, upload, display and schedule different posters. To ensure the different institutions do not interfere with each other, a user- and institution system has been implemented. Therefore an authentication system is also in place.

(back to top)

Built With

• MariaDB 10.1.19
• ASP.NET CORE 5.0
• Blazor

(back to top)

Getting Started

This is an example of how you may give instructions on setting up your project locally. To get a local copy up and running follow these simple example steps.

Prerequisites

The project is divided into a frontend and server folder. To install the neccesary packages cd into each folder and run:

dotnet restore

Installation

1. Clone the repo:

   git clone https://github.com/MadsBalslev/P3.git

2. Install prequisites mentioned above.

(back to top)

Usage

Start by running the .sql file from P3/database/db.sql in MariaDB. The default login is host:localhost, user:root and password:123. (You can change these yourself later) and update them in the connection string in server/appsettings.json.

After installing ALL the prequisites, open two(2) terminals, one in P3/frontend and the other in P3/server. Proceed to write, in both terminals:

dotnet run

Now that the frontend and backend are up and running, you can go to localhost:8080 and login with the default sys-admin user, admin/admin.

You can now proceed to use the system.

Changing ports

The ports on which the server and frontend is run can be changed in each folders properties/launchsettings.json-file. This can also be changed to be 0.0.0.0:PORT to open up for incomming requests not comming from the localhost.

For the frontend the ApiBaseAddress in appsettings.json to the IP and Port of the server.

The changes to the server PORT must also be applied to the frontend/wwwroot/js/SlideGenerator.js-file, which handles the API call to the server.

(back to top)

License

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

(back to top)

Contact

Project Link: https://github.com/MadsBalslev/P3

(back to top)

Acknowledgments

Guidance

• Christian Hove from Nordkraft
• Florian Echtler

Development

• Simon M. P. Andersen
• Nicolai Bruun Nielsen
• Casper Ståhl
• Patrick Bertelsen
• Frederik Møller
• Mads P. Balslev

(back to top)