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)

p3's Issues

On the User Management page edit button is missing in the table.

Discard Changes button missing form Screen Creation page.

3.3 Problem Definition

Reviewed by

• Casper
• Frederik
• Holm
• Mads
• Nicolai
• Patrick
• Simon
• Supervisor

Specifications of components 1 (Component design)

• A class diagram of the model component.
• A class diagram with operations and specifications of complex operations.
• A class diagram of the involved components.

On the User Management page there is a mix of danish and english, please fix this.

When creating a Screen, zone/zone name should be a drop down.

3.x 1st System Definition

Reviewed by

• Casper
• Frederik
• Holm
• Mads
• Nicolai
• Patrick
• Simon
• Supervisor

On the Screen Management page we should consider only having zones, as screens in the same zone have the same behaviour.

Images not scaling correctly

Images will not scale correctly and therefore a little bit of the image is cropped of. This is due to the Info-bar at the top. A fix is needed

4.x Problem Domain Analysis

Subsections

• Classes
• Events
• Structures
• Behavior
• Review all content

3.2 Problem Context

Reviewed by

• Casper
• Frederik
• Holm
• Mads
• Nicolai
• Patrick
• Simon
• Supervisor

Sprint 1 review

Blazor prototype for simulating the user interface and user interactions with it, without interacting with a backend.

4.x Interface Sketch

Reviewed by

• Casper
• Frederik
• Holm
• Mads
• Nicolai
• Patrick
• Simon
• Supervisor

3.1 Problem Description

Reviewed by

• Casper
• Frederik
• Holm
• Mads
• Nicolai
• Patrick
• Simon
• Supervisor

Requirements for use 1 (Application-domain analysis)

• Descriptions of all use cases and actors.
• A complete list of functions with specification of complex functions.

Screen zone dropdown needs functionality.

On the User Management page the Create User button could be labeled Register User.

4 Sprint 1

Reviewed by

• Casper
• Frederik
• Holm
• Mads
• Nicolai
• Patrick
• Simon
• Supervisor

Creating a user does not update the site correctly.

Procedure of formal code inspections document finished and approved by the group.

Screen Management Page

On the User Management page the discard changes button is missing. Add this

On the Poster Management page the Create poster does not function at all.

Login Page

Poster Management Page

Restructure report

Sprint 1 retrospective

Klargøring til statusseminar

4.x Sprint Review

3.4 Method

Reviewed by

• Casper
• Frederik
• Holm
• Mads
• Nicolai
• Patrick
• Simon
• Supervisor

Specifications of architecture 1 (Architectural design)

• A collection of prioritized criteria.
• A class diagram with specifications of the complex components.
• A deployment diagram showing processors with assigned program components and active objects.

Model document 1 (Problem domain analysis)

• An event table with classes and related events.
• A class diagram with classes and structures.
• A behavioral pattern with attributes for every class in a class diagram.

Login screen placeholder text should be written the same way.

On the Institution Management page the Create Institution button could be called Register Institution.

Usability test af prototype.

Problem definition 1

User Management Page

Styregruppemøde

Punkter på dagsordenen:
1: Semesterstart (herunder studiestartsdage, semesterstart og gruppedannelse)
2: Kurser (hvad går godt - hvad kunne blive bedre)
3: Projekt
4: Studiemiljø (fysisk, psykisk, æstetisk)
5: Evt.

Wireframe

Complete a wireframe prototype

Decide on which wireframe software to use?

• Balsamiq
• The other one I can't remember the name of

Creating a screen does not update the site correctly,

User Settings Page

On the Institution Management page the submit button should be called Create Institution or Register Instituion.

On the User Management page the submit button should be labeled Create User or register user.

Creating a screen zone does not update the site correctly.

On the Institution Management page the Discard Changes is missing.

On the Screen Management page submit button should be labeled create instead of submit.

Blazor prototype for displaying posters on info screens.

Institution Management Page

Lav systemspecifikation

Udarbejd:

• FACTOR-analyse
• PACT-analyse (måske?)
• Class-diagram
• Event table