LibSoft

A web-based application for management and use of a university library. It uses the CoBAUI framework (https://www.npmjs.com/package/cobaui) to implement an adaptive user interface.

This project was generated with Angular CLI version 7.3.3.

Installation

NodeJS is needed as a development environment. See https://nodejs.org/en/download/package-manager/ for installation instructions. For Ubuntu:

curl -sL https://deb.nodesource.com/setup_11.x | sudo -E bash -
sudo apt-get install -y nodejs

After NodeJS is set up, follow these instructions:

1. Clone this repository git clone https://github.com/Ferhat67/LibSoft.git
2. Enter LibSoft directory and run npm install to install dependencies
3. Run npm start to run application
4. Access https://localhost:4200/ in your browser to use application

Alternatively, use npm build to generate application files (html,js,css) for productive use on a web server.

Device Setup

To inspect all adaptation features of the application, please use Google Chrome Mobile browser on a smartphone device. For enabling access to the Ambient Light Sensor, follow the steps below:

1. Visit chrome://flags URL in Google Chrome Mobile
2. Search for the flag Generic Sensor Extra Classes and set it to Enabled;

This enables access to the Ambient Light Sensor for the browser.

Once started, the application is accessible under the URL https://localhost:4200/.

Runtime Adaptation

Following adaptive behavior is observable:

1. Navigation menu position is adapted based on user's handedness to allow faster reachability. This feature uses the device's Gyroscope Sensor.

2. A "dark theme" is activated in low ambient light conditions to allow better readability and reduce eye strain. This feature needs access to the device's Ambient Light Sensor and requires the application to use https.

3. A compact navigation menu is displayed to more experienced users, while new users are shown a more detailed menu. The users experience is measured by the usage time in minutes. Users with a usage time below 5 minutes are considered new.

User Accounts

There are two user roles in LibSoft: Students and Staff Members.

• Student: Max Mustermann
  • Username: mmuster
  • Password: student123
• Staff Member: John Doe
  • Username: johndoe
  • Password: staff123