Introduction

This guide is dedicated to the web portal which serves for the companies to manage and monitor the process of alcohol testing. Web represents the central place which consists of various views of the current status or statistical information and delivers efficient configuration possibilities to setup future processes.

User roles overview

Admin

Can create/edit:

  • Main Group inside his own organization

  • Sub group inside his own organization

  • Admin in his own organization

  • Group Admin inside his own organization

  • Subject inside his own organization

Cannot use the mobile app to upload alcohol samples.

Group admin

Can create/edit:

  • Subject inside his own organization and his main group

Cannot use the mobile app to upload alcohol samples.

Subject

Subject can only use the mobile application and upload alcohol samples.

Login

image30

The iBac system provides the possibility to log in using the Authentication Portal (AUP). The AUP provides different “entry options” to login which are the following:

  • ID-Card

  • Mobile-ID

  • Smart-ID

  • Active Directory Username

image70

The AUP login can be initiated by click on the "AUP login" button on the iBac login screen. After successful authentication of the user, the page navigates inside the iBac system.

Ibacs

The iBac is the breathalyzer and physical device that connects to a smartphone or tablet over Bluetooth. Different versions of the iBac circulate the market why the mobile applications need to be compatible with all of them. To be able to use the iBac, it needs to be registered in the system for an organization. It needs to be registered with its MAC address and uppercase characters by a super admin, meaning only Alcosystems personnel.

Filter iBacs

It is possible to filter iBacs by following: actived, deactivated

  1. Login as "Admin" to https://estonia-test.web.ibacpro.com

  2. Click on "Ibac" on the left menu

  3. Apply one of the filters.

Activate/deactivate iBac

This functionality is available only for Admin and Superadmin accounts.

Each iBac device can be activated/deactivated. Deactivated iBac cannot be used for performing an alcohol test. Activation events are logged.

  1. Login as "Admin" to https://estonia-test.web.ibacpro.com

  2. Click on "Ibac" in the left menu.

  3. Select an iBac from the list.

  4. Click on the "ACTIVATE/DEACTIVATE" button.

image1

Set activation event for iBac

This functionality is available only for Admin accounts.

Admin can create a set of activation events for specific iBac device. These events are then automatically triggered at a specified time and will perform activation or deactivation of the device.

  1. Login as "Admin" to https://estonia-test.web.ibacpro.com

  2. Click on "Ibac" on the left menu.

  3. Select an iBac device from the list.

  4. On the iBac details page click on the "Edit iBac" button.

  5. Click on the "Add new event" button.

  6. Select event type (activation or deactivation).

  7. Set a date when the event should be triggered.

  8. Click on the "Save event" button.

  9. Click on the "Save iBac" button to save all changes.

image2 image3 image4

Display iBac info

This functionality is available only for Admin accounts.

iBac info page contains information about the ibac:

  1. device’s last known battery charge and estimation of remaining operating hours based on charge value. The current battery charge value is always obtained by the server together with the alcohol sample. Low battery charge values are marked by color.

  2. subject and organization to which the ibac is assigned

  3. date of last usage

  4. date of last calibration

  5. amount of usage cycles and how many are left to maintanance requirement

  6. iBac status (actived/deactivated)

  7. FW version

In order to see the ibac information:

  1. Login as "Admin" to https://estonia-test.web.ibacpro.com

  2. Click on "Ibac" on the left menu.

  3. You can see the last known battery charge value with estimated remaining operating hours displayed in the iBac device details.

image5 image6

Firmware version (FW) is version of software which is installed in iBac. This version is visible near bottom of a column.

Display tampered devices

This functionality is available only for Admin accounts.
image7

iBac devices have a tamper detection mechanism. Once someone tries to open the iBac it gets detected and then the device is not possible to use for making the alcohol test anymore. Upon tamper detection, the device sends this information to the mobile app during the pairing process. The application then stops the test with error and sends information about tampering to the backend.

  1. Login as "Admin" to https://estonia-test.web.ibacpro.com

  2. Click on "Ibac" on the left menu.

  3. Select "Tampered devices" from the options on top of the page.

  4. Only tampered devices are now displayed in the list.

Display last known location of iBac

This functionality is available only for Admin accounts.

iBac info page contains information about the last known location of the device. This record is taken from the last uploaded alcohol sample created by this iBac device. This record is available only if the Subject which is using this device has set the record of GPS location as mandatory.

  1. Login as "Admin" to https://estonia-test.web.ibacpro.com

  2. Click on "Ibac" on the left menu.

  3. Select an iBac device from the list.

  4. If location is available you will see the location marked on the map.

image8

Mobile devices

Mobile device is represented by a smartphone or tablet which connects to iBac breathanalyzer over Bluetooth. It is loaded with the mobile application which is compatible with iBac device firmware and serves as a controller with the graphical user interface.

To be able to use the mobile device together with iBac, it needs to be registered in the system for an organization. It needs to be registered with its serial number by a super admin.

Display mobile device info

This functionality is available only for Admin and Superadmin accounts.

Mobile device info page contains information about mobile device which is used together with iBac device - battery level, SIM information, device serial and software, cell signal strength.

  1. Login as "Admin" to https://estonia-test.web.ibacpro.com

  2. Click on "Mobile device" on the left menu.

  3. Select the mobile device from the list.

image64

Mobile device heart beat

This functionality is available only for Admin and Superadmin accounts.

Mobile device info is sent regularly as a heart beat. The interval of heart beat can be configured from minimum of 15 minutes.

  1. Login as "Admin" to https://estonia-test.web.ibacpro.com

  2. Click on "Mobile device" on the left menu.

  3. Select the mobile device from the list.

  4. Change the herat beat interval.

  5. Click on "Save mobile device" button.

image65

Filter mobile devices

It is possible to filter mobile devices by following filters: actived, deactivated

  1. Click on "Mobile" on the left menu

  2. Apply one of the following filters: active, inactive.

Instant heartbeat update

By clicking on button "Request data upload" instant heartbeat update will be performed.

Heartbeat event log

Each heartbeat event is being logged and the history is possible to see in the mobile phone details.

image76 image77

History of equipment use

In case of iBac or mobile device it is possible to see the history of its assignment.

  1. Login as "Admin" to https://estonia-test.web.ibacpro.com

  2. Click "iBac" or "Mobile" on the left menu.

  3. Look at the section "Assignment history"

image57

Groups

They consist of main groups and sub groups. The focus of the main group is to organize a number of sub groups. A sub group holds a number of subjects and monitors. The focus of the sub group is to organize a number of subjects and link them to specific monitors. Depending on their role, monitors can just access data that is available through their sub groups.

Create groups

  1. Login as "Admin" to https://estonia-test.web.ibacpro.com

  2. Click "Add" on the left menu.

  3. Click on "Group".

  4. Select the name of your "Main Group" and click "Save main group".

  5. Select the correct "Main Group" from the list.

  6. Enter the name of "Sub group" and click "Save sup group".

image9 image10

Agents

An agent (admin) is a person that has administrative access to the system and not undercare or supervision himself. The agent manages subjects, groups and other domains depending on his / her role. An agent that’s a member of a sub group is called a “monitor” in that group. The monitor receives updates about the progress of each subject. Depending on each subject’s notification setting stored in the rule set, Test events and even violations made with optional Alcohol Samples are broadcasted out to monitors.

Agent can have either admin or group admin role. An admin is the highest rank of “ordinary” users within an organization. They can unfiltered see all data between groups and create new admins. The group admin just has access to their groups. Therefore no information from other groups can be leaked to these admins.

All Agent accounts are being identified by the AUP ID, which needs to be unique.

Create agent

  1. Login as "Admin" to https://estonia-test.web.ibacpro.com

  2. Click "Add" on the left menu.

  3. Click on "Agent".

  4. Fill in all fields with person and contact information (IMPORTANT: phone number must be entered in the correct format with country code: +37253641858).

  5. Select role between admin and group admin.

  6. The agents can set a type of preferred notification types for a given agent.

  7. The agents can set whether the given agent should receive notifications about iBac device calibration.

Newly created agent receives an invitation email upon successful creation of agent on the server. This email contains an activation link, where the agent will create his password. After this, he can use the account to log in to the Web UI.

image11

It is possible to set idle timeout during agent creation process. Idle timeout is period of inactivity after which agent is automatically logged out. If an admin or group admin is created, the timeout is set to 30 minutes.

Create "Admin"

  1. Select the role "Admin".

  2. Click on save settings.

Create "Group admin"

If group admin option was chosen, continue with following steps:

  1. Select the "Group admin" role.

  2. Click on save settings.

  3. Go to "Home".

  4. Search for created "Group admin" and select in the search result.

  5. Click "Edit agent".

  6. Select those groups that "Group admin" should see.

  7. Click on "Save settings".

Newly created admin (group admin) receives an invitation email upon successful creation of admin (group admin) on the server. This email contains an activation link, where the admin (group admin) will create his password. After this, he can use the account to log in to the Web UI.

image12 image13

Activate/deactivate agent

Each agent account can be activated/deactivated. A deactivated agent cannot use the iBac system anymore. Activation events are logged.

  1. Login as "Admin" to https://estonia-test.web.ibacpro.com

  2. Search for admin by his name or email on the main page.

  3. Click on the admin’s name in the result list.

  4. Click on the "ACTIVATE/DEACTIVATE" button.

Send message to agent

Agents can send messages to other agents.

  1. Login as "Admin" to https://estonia-test.web.ibacpro.com

  2. Search for admin by his name or email on the main page.

  3. Click on the admin’s name in the result list.

  4. Click on the "New message" button on the admin details page.

  5. Window will appear.

  6. Choose type of delivery channel from the dropdown menu:

    1. SMS

    2. Email

    3. SMS and Email

  7. Enter a message for the message.

  8. Click on the "Send" button.

image55
image56

Subjects

A subject is a physical person, under supervision or not, and the individual that takes Alcohol samples with the breathalyzer and mobile apps. A subject always has a rule set, describing the rules to conform to, and (usually) one or more schedules that define when new required tests are opened and need a response. Each schedule is saved together with a start and end date describing the schedule period. This information about when and how to leave Alcohol samples with the iBac is considered the Treatment plan. If an organization has the demand to just do soberness tracking without the need to use scheduling of Tests, they can just onboard each subject and make them leave optional Alcohol Samples.

A subject needs to be on-boarded in the system being able to get invitations to new Tests and leave alcohol samples using the mobile apps. He/she is not considered active before the subject has launched the mobile app for the first time.

Administrators can create, edit or activate/deactivate subject account.

Create a subject

  1. Login as "Admin" or "Group admin" to https://estonia-test.web.ibacpro.com

  2. Click "Add" on the left menu.

  3. Click on "Subject".

  4. Set subject photo - not mandatory (see Set subject photo)

  5. Fill in all fields with person and contact information (IMPORTANT: phone number must be entered in the correct format with country code: +37253641858).

  6. Set end of program period (informational purpose)

  7. Select "Main group".

  8. Select "Sub group".

  9. Set iBac settings (see Set iBac settings).

  10. Create a subject’s schedule - not mandatory (see Set subject’s "Schedule")

  11. Click "Save subject" and if all values were entered correctly you should see the new "Subject" listed under "Added subjects".

  12. Now you can add another "Subject" or finish by navigates to another page.

An activation email is sent to the Admin who created the subject account upon successful creation of the subject on the server. This email contains an activation link, where the Admin will set a password. After this, the account can be used to log in to the app.

image16 image17

It is possible to add 2 more phone numbers. These are only used as additional information. The notifications will be send on main phone number.

image42

Assign iBac device to the Subject

Every subject can have assigned one iBac device. The subject can then use only this device to take alcohol samples. One iBac can be assigned to only one Subject.

  1. Login as "Admin" to https://estonia-test.web.ibacpro.com

  2. Search for the subject by his name or email on the main page.

  3. Click on the subject’s name in the result list.

  4. Click on the "Edit subject" button on the subject details page.

  5. Select the MAC address of the iBac device to assign.

  6. Save changes by click on the "Save subject" button at the bottom of the page.

It is also possible to assign iBac to the subject during subject creation.

image43

Assign mobile device to the Subject

Every subject can have assigned one mobile device. One mobile can be assigned to only one Subject.

  1. Login as "Admin" to https://estonia-test.web.ibacpro.com

  2. Search for the subject by his name or email on the main page.

  3. Click on the subject’s name in the result list.

  4. Click on the "Edit subject" button on the subject details page.

  5. Select the mobile device from the list.

  6. Save changes by click on the "Save subject" button at the bottom of the page.

It is also possible to assign mobile device to the subject during subject creation

image44

Display assigned iBac

If subject has an assigned iBac, clickable link to assigned iBac is displayed in subject details.

image45

Display assigned mobile device

If subject has an assigned mobile device, clickable link to assigned mobile device is displayed in subject details.

image46

Test/optional sample details in subject

Every alcohol sample comes with a photo to verify the person’s identity and that the subject is actually the one blowing in the Ibac. Device color is a part of the proof of test that Alcosystems use. Face recognition result has 2 states. State "passed" means that server algorithm decided that subject is on photo. State "failed" means that server algorithm decided that subject is not on photo.

image54

Set iBac settings

Use the "iBac settings" template.

  1. Click "Add new settings from template" on the edit subject page.

  2. Select the settings template from the list.

  3. Click "Use settings".

Create a new "iBac settings".

  1. Click "Add new settings" in the edit subject page.

  2. Enter the alcohol limit for the subject.

  3. Enter a time of test expiration (how long will be the created test opened) in minutes (IMPORTANT: minimal permitted value is 5 minutes).

  4. Set whether to display alcohol value in the mobile application to the user at the end of the test.

  5. Set when the agents assigned to this subject’s group should receive notifications.

  6. Set which notification should subject receive (SMS, Email, push notification).

  7. Set whether you want to save this setting as a template for future use. If you check this option you will be asked to set the name of the template.

  8. Click "Save settings".

image18

Set subject’s Schedule

The schedule configures the frequency of tests a subject will take. Scheduling can be done in three ways, by setting precise timestamps of a day and using a randomizer or using both of them combined. The idea is that the agent enables what days to test during the weeks, how many max random tests (if there are any) and on what fixed times. The schedule is individual to each subject.

Because each Schedule is individual to a specific Subject the agent can choose to store the schedule as a template for later use. Each schedule template needs to have a name and can be found under the Template area in the UI or as a quick add box on each Subject for next onboarding. See the Templates chapter for the creation process.

Use a schedule template.

  1. Click "Add a schedule from template" on the edit subject page.

  2. Select the schedule template from the list.

Create a new schedule.

  1. Click "Create a new schedule" on the edit subject page.

  2. Specify "Start date" and "End date" for specifying the period during which this schedule will be applied.

  3. Select days of the week for which the "Schedule" should be applied (for example you can choose to only create tests during the weekend).

  4. Set how many "Random tests" do you want to create for one day. Put 0 if you don’t want to create any "Random test".

  5. Specify the time period during which the random tests are supposed to be created.

  6. Specify the exact time of the scheduled test. For setting more than one "Scheduled test" click "Add time" and new time input will appear. You can then remove the time with the button "Remove".

  7. Set whether you want to save this "Schedule" as a template for future use. If you check this option you will be asked to set the name of the template.

image19

Activate/deactivate subject

Each subject account can be activated/deactivated. A deactivated subject cannot use the iBac system anymore. Activation events are logged.

  1. Login as "Admin" to https://estonia-test.web.ibacpro.com

  2. Search for the subject by his name or email on the main page.

  3. Click on the subject’s name in the result list.

  4. Click on the "ACTIVATE/DEACTIVATE" button.

Set subject’s "External monitors"

  1. Click on the "Add new external monitor" button on the edit subject page.

  2. Fill in info about external monitor:

    • Phone number - mandatory

    • Name - optional

  3. Click on the "Save external monitor" button.

  4. Repeat to add another one.

image20

Move subject between groups

All subjects can be moved between all main/sub groups inside their organization.

  1. Login as "Admin" to https://estonia-test.web.ibacpro.com

  2. Search for the subject by his name or email on the main page.

  3. Click on the subject’s name in the result list.

  4. Click on the "Edit subject" button on the subject details page.

  5. Select different main/sub group from the list.

  6. Save changes by click on the "Save subject" button at the bottom of the page.

image21
image22

Profile photo

For each subject, it is possible to upload a profile photo. It is possible to select and upload more photos. All the photos are then used for the automatic face recognition to check the uploaded alcohol sample photos.

Photo requirements

To ensure that face recognition works most reliably, it is needed that uploaded photos fulfill following requirements:

  1. "Passport style" photo

  2. Background should be light and of single colour, without extraneous objects (including patterns)

  3. The person on the photograph should not wear headwear or headphones

  4. The eyes must be visible from behind the spectacle frames and glasses may not reflect light

  5. Slightly different angles on each photo are preferred, but both eyes must be visible on each photo

  6. Good light conditions

  7. 3-5 distinct photos uploaded

  8. The size of a photo must be between 1 MB and 5 MB. Pixel dimensions must be max 1300 x 1600 pixels

image73 image74

Set/change subject photo

  1. Click on the "Browse" button under the blank rectangle on the subject edit page.

  2. Select image file from your computer in the supported format: .png, jpg.

  3. The photo is uploaded together with all subject information upon click on the "Save subject" button at the end of the form.

image23

Remove subject photo

  1. Go to the subject edit page from the subject detail page.

  2. Place the cursor above the uploaded image and click on the "X" symbol in the top right corner of the subject photo.

  3. The photo will be removed from the system upon click on the "Save subject" button at the end of the form.

image25

Face recognition and liveness check requirements

For most reliable results of the automatic face recognition, the following is needed:

  1. The face must be fully visible on camera during whole blow test

  2. The face must be as close as possible to the camera, approx. 25-35cm from the face, without overlap or being cropped outside the picture

  3. The face shouldn’t be too much occluded by the hand which holds the iBac device

  4. It is suggested to hold the device from the bottom with fingers only to minimize the face occlusion

  5. There should be enough light on the picture

Set "Crisis agent"

Every subject can have set one "Crisis agent". The subject will then have the possibility to send a direct "crisis" SMS from the mobile application.

  1. Login as "Admin" to https://estonia-test.web.ibacpro.com

  2. Search for the subject by his name or email on the main page.

  3. Click on the subject’s name in the result list.

  4. Click on the "Edit subject" button on the subject details page.

  5. Select one agent from the list in "Crisis agent" selection.

  6. Save changes by click on the "Save subject" button at the bottom of the page.

Send message to subject

  1. Login as "Admin" to https://estonia-test.web.ibacpro.com

  2. Search for the subject by his name or email on the main page.

  3. Click on the subject’s name in the result list.

  4. Click on the "New message" button on the subject details page.

  5. Choose type of delivery channel from the dropdown menu:

    1. SMS

    2. Email

    3. SMS and Email

  6. Enter a message for the message.

  7. Click on the "Send" button.

image21 image26

image27

Display "Alcohol samples chart"

  1. Login as "Admin" to https://estonia-test.web.ibacpro.com

  2. Search for the subject by his name or email on the main page.

  3. Click on the subject’s name in the result list.

  4. Click on the "Show samples chart" button.

  5. Select the date period for the graph.

  6. The graph of the alcohol values for a given period will be displayed.

image21 image24

image28

Instant heartbeat update

By clicking on button "Request data upload" instant heartbeat update will be performed.

image40

Display subject-related events

For each subject you can display overview of all events (alerts, violations…​) in the subject overview page.

  1. Login as "Admin" to https://estonia-test.web.ibacpro.com

  2. Search for the subject by his name or email on the main page.

  3. Click on the subject’s name in the result list.

  4. Click on the "Events" tab in the subject overview.

  5. A table with all alerts raised with relation to the subject are displayed.

  6. Set further filtering options if needed.

image61
image62

Monitoring periods

Each subject have 1 or more "monitoring periods". One period is the time between subject’s activation and deactivation. It allows to separate a subject’s information for different periods. The “information” available for each period is as follows:

  • Settings

  • Schedules

  • Scheduled tests

  • Optional alcohol samples

  • Notes

  • Direct messages

image68

When subject is deactivated, the page displays only the basic informations (commont to all periods) and table with all past monitoring periods. Upon click on the row, all the informations from the given period are displayed in the standard form.

The displayed monitoring period can be changed using the "Monitoring period" selection.

image69

Change or reset password

It is possible to reset the password for the subject account.

  1. Login as "Admin" to https://estonia-test.web.ibacpro.com

  2. Search for the subject by his name or email on the main page.

  3. Click on the subject’s name in the result list.

  4. Click on the "Reset password" button.

  5. Check out your email inbox to find the email..

  6. From the email click on "here" link to go to reset password page.

  7. Enter "Password" and "Confirmation password" in the corresponding fields. Click on "Save".

image33 image34

Templates

Create schedule template

  1. Login as "Admin" to https://estonia-test.web.ibacpro.com

  2. Click on "Add" on the left menu.

  3. Click on "Schedule template".

  4. Specify "Start date" and "End date" for specifying the period during which this schedule will be applied.

  5. Select days of the week for which the "Schedule" should be applied (for example you can choose to only create tests during the weekend).

  6. Set how many "Random tests" do you want to create for one day. Put 0 if you don’t want to create any "Random test".

  7. Specify the time period during which the random tests are supposed to be created.

  8. Specify the exact time of the scheduled test. For setting more than one "Scheduled test" click "Add time" and new time input will appear. You can then remove the time with the button "Remove".

  9. Set whether you want to save this "Schedule" as a template for future use. If you check this option you will be asked to set the name of the template.

image19

Edit schedule template

  1. Login as "Admin" to https://estonia-test.web.ibacpro.com

  2. Click on "Templates" on the left menu.

  3. Click on "Schedule templates".

  4. Select template from the list.

  5. Click on "Edit schedule template" button.

  6. Edit schedule.

  7. Save changes by click on the "Save schedule" button.

image35 image36

Create settings template

  1. Login as "Admin" to https://estonia-test.web.ibacpro.com

  2. Click on "Add" on the left menu.

  3. Click on the "Settings template".

  4. Enter the alcohol limit for the subject.

  5. Enter a time of test expiration (how long will be the created test opened) in minutes (IMPORTANT: minimal permitted value is 5 minutes).

  6. Set whether to display alcohol value in the mobile application to the user at the end of the test.

  7. Set when the agents assigned to this subject’s group should receive notifications.

  8. Set which notification should subject receive (SMS, Email, push notification).

  9. Set whether you want to save this setting as a template for future use. If you check this option you will be asked to set the name of the template.

  10. Click "Save settings".

image18

Edit settings template

  1. Login as "Admin" to https://estonia-test.web.ibacpro.com

  2. Click on "Templates" on the left menu.

  3. Click on "Settings templates".

  4. Select the template from the list.

  5. Click on the "Edit settings template" button.

  6. Edit settings.

  7. Save changes by click on the "Save settings" button.

image35 image37

Alerts overview

The alerts overview page contains a complex view on all alerts and violations that occurred in the iBac system. Records are grouped to the two main categories:

  • Alerts

  • Violations

  • Connection errors

Display records

  1. Login as "Admin" to https://estonia-test.web.ibacpro.com

  2. Click on "Alerts" on the left menu. By default all categories are shown. By clicking on particular category it can be filtered accordingly e.g. by selecting the "Violations" option at the top of the page.

Sort results

Results in the table are sorted by date by default.

  1. Login as "Admin" to https://estonia-test.web.ibacpro.com

  2. Click on "Alerts" on the left menu.

  3. Click on the column header to sort records by its values.

image48

Filter results

All results can be filtered by the following options:

  • Date

  • Event type

  • Alert status

  • Subject name

  • Sub group name

  • Main group name

  • iBac device MAC address

  • Mobile device

  • Status

It is possible to combine all types of filters.

Filter by date

  1. Login as "Admin" to https://estonia-test.web.ibacpro.com

  2. Click on "Alerts" on the left menu.

  3. Set "date from" and/or "date to".

  4. Results are filtered to contain only records for a specified period.

image39

Filter by event type

  1. Login as "Admin" to https://estonia-test.web.ibacpro.com

  2. Click on "Alerts" on the left menu.

  3. Select event type from the list

  4. Results are filtered to contain only records of a specified event type.

image50

Filter by subject/sub group/main group/iBac MAC address

  1. Login as "Admin" to https://estonia-test.web.ibacpro.com

  2. Click on "Alerts" on the left menu.

  3. Insert the name of the subject/sub group/main group/iBac MAC address

  4. Results are filtered to contain only records that conform to the inserted values.

Filter by status type

  1. Login as "Admin" to https://estonia-test.web.ibacpro.com

  2. Click on "Alerts" on the left menu.

  3. Select status type from the list

  4. Results are filtered to contain only records of specified status type.

image51

Event types

There are several event types available within particular categories and labeled with

  • <server> - generated automatically by server or

  • <client> - sent from client mobile phone to server, these alerts might be observed with delay if the client lacks connection for certain period.

Alerts

  1. Low iBac battery <client> - battery of iBac device is low and should be recharged soon

  2. Low mobile phone battery <client> - battery of mobile device is low and should be recharged soon

  3. iBac tampered <client> - there was an attempt of unauthorized alterations to the iBac device, thus device turned into tampered state and is not possible to be used anymore

  4. iBac calibration needed <server> - the iBac device needs to be re-calibrated

  5. Face recognition failed <server> - subject on the photo from sample was not recognized in comparison to the subject’s profile photos

  6. Installation complet <server> - First alcohol sample of the given subject with given iBac and mobile phone has been done

  7. Mobile phone time changed <client> - The date/time on the mobile phone has been changed

Violations

  1. Test expired <server> - test was not performed in the scheduled window

  2. Test failed <client> - detected alcohol was above the configured limit (within scheduled test)

  3. Optional sample failed <client> - detected alcohol was above the configured limit (within optional test)

  4. Alcohol sample error - insufficient blow <client> - test failed due to insufficient blowing into iBac device

  5. Alcohol sample error - unknown location <client> - test failed because it was not possible to acquire the location (e.g. user was offline and location could not be acquired neither from GPS neither from network)

  6. Alcohol sample error - mouth alcohol detected <client> - test failed due to high alcohol level and measurement could not be finished. User should wait cca 20 minutes to repeat the test.

  7. Alcohol sample error - iBac disconnected during test <client> - iBac device was disconnected during the test

  8. Alcohol sample error - unable to upload alcohol sample <client> - client failed to upload the alcohol sample to server

  9. Alcohol sample error - face detection error <client> - there was a problem with face detection during the test

  10. iBac - wrong usage <client> - there was attempt to use device which was assigned to different user or was locked by configuration

  11. iBac - unregistered device used <client> - there was attempt to use unregistered device

  12. iBac - locked device used <client> - there was attempt to use device which is locked by configuration

Connection errors

  1. Mobile phone - heart beat not received <server> - event is automatically produced by server when no heart beat is received from the client within configured heartbeat period (there is some tolerance of additional 10 minutes period)

  2. Mobile phone - heart beat received again <server> - event is automatically generated by server when heartbeat is received from client after it was lost (see previous heart beat not received event)

  3. Mobile phone - turned off <client> - mobile phone was turned off (might arrive immediately or after it is again turned ON and connection established again)

  4. Mobile phone - turned on <client> - mobile phone was turned on

  5. Mobile phone - heartbeat not uploaded <client> - it was not possible to upload heartbeat in desired interval (e.g. the connection was lost)

  6. Mobile phone - cellular network lost <client> - network provided by the cellular was lost (not related to wifi)

  7. Mobile phone - network out of service <client> - cellular provider is out of service

  8. Mobile phone - internet connection lost <client> - internet connection was lost (this covers any type of internet connection including wifi)

  9. Mobile phone - cellular signal poor <client> - the cellular signal is so poor that mobile might loose the cellular internet connection

  10. Mobile phone - cellular network restored <client> - network provided by the cellular was restored (not related to wifi)

  11. Mobile phone - internet connection restored <client> - internet connection was restored

  12. Mobile phone - sim card removed <client> - the SIM card has been removed from the phone

Alert details

Every alert or violation provides possibility to:

  1. Forward alert to another agent

  2. Add a note

  3. Send a message

  4. Label as resolved

  5. Label as invalid

In this way the violations and alerts can be practically handled by agents or admins and the processing is tracked so that it is possible to filter only the alerts/violations which are not label as resolved or filter those where no action was done at all (no note or message).

image52

Forward alert to another agent

Every alert can be manually forwarded to another agent.

  1. Cick on "Forward alert" in alert details or on forward icon in actions on alerts list screen.

  2. Window will appear.

  3. Click on "Select" to open dropdown with list of agents.

  4. Select one or more agents.

  5. Close the dropdown by click outside the dropdown area.

  6. Click on the "Forward alert" button.

image54

See Notifications history for alert

Every alert has connected history of all notifications that were sent by the system or manually forwarded by the agent.

  1. Go to the alert details page.

  2. See the "Notifications" section.

  3. Click to expand and see list of all sent notifications.

image60

Instalation process

A complete instalation process for a new subject contains of following steps:

  1. Register new iBac device (if it was not done before).

  2. Register new mobile phone (if it was not done before).

  3. Register of the subject profile with assign of iBac and mobile phone.

  4. Subject setting his own password using the activation link received by email.

  5. Subject log in to the application in the mobile that was assigned to him.

  6. Subject performing first alcohol test with the assigned iBac.

When all those steps are correctly performed and registered by the system, all agents that are set as monitors of the subject will get automatic notification about completed instalation.

The same instalation event is created also upon first alcohol test performed with any newly assigned iBac or mobile phone anytime later (change of device).

Reports

The "Reports" page allows the user to download a variety of reports. For each report is possible to specify various parameters like:

  • Date period

  • Groups

  • iBac

  • Mobile

image72

The generated reports are downloaded are saved in a file (*xls in case of windows, but can be opened with a wide range of applications).

Al report types are structured in following groups:

  • Subject

  • Alarm

  • iBac (not available for group admin)

  • Mobile (not available for group admin)

image71

Subject

  1. Subject alcohol samples - report contains all tests and optional alcohol samples performed by the subject during the specified period.

  2. Subject status - report of a status of the subjects during the specified period. It contains information, whether the subject had an active monitoring period or it was inactive.

  3. Active offenders - report contains information about all subjects that performed any alcohol test (scheduled or optional) during a specified period.

  4. Start of program - report of all subjects that had started the alcohol monitoring program during the specified period.

  5. End of program - report of all subjects that had ended the alcohol monitoring program during the specified period.

  6. Schedule changes - report of all changes of subject’s schedule that were done in the specified time period. It contains information about who, when and what change was done.

  7. Subject device assignment history - report of which devices (both iBac and mobile phones) and when were in the subject’s usage.

Alarm

  1. Alarms overview - report of all alarms raised during a specified period.

  2. Currently open alarms - report of all alarms that are currently open (non-resolved).

  3. Closed alarms - report of all alarms that were resolved (closed) during a specified period.

iBac

  1. iBac alcohol samples - report contains overview of alcohol tests performed with the given iBac in a specified period.

  2. Activated iBac units report - report of all iBac units that were activated during a specified period.

  3. Current iBac status - report of current status of the iBac devices. It contains information about current subject assignment, calibration info and when it was last used (date of last received alcohol sample).

  4. iBac assignment history - report of assignment of the iBac device to the subjects during a specified period. It contains information about when it was assigned to who.

Mobile

  1. Mobile phone alcohol samples - report contains overview of alcohol tests performed with the given mobile phone in a specified period.

  2. Current mobile phone status - report of current status of the mobile phones. It contains information about current subject assignment, information from last heartbeat update with date of last heartbeat.

  3. Mobile phone assignment history - report of assignment of the mobile phone to the subjects during a specified period. It contains information about when it was assigned to who.

Searching

The system provides fulltext search engine to quickly find and navigate to the desired information. The searching possibilities are following:

  1. Subjects

  2. Agents

  3. Main Groups

  4. Sub Groups

  5. iBacs (not available for Group Admins)

  6. Mobiles (not available for Group Admins)

  7. Everything (all above)

How to search:

  1. Login as "Admin" to https://estonia-test.web.ibacpro.com

  2. Click on "Search" on the left menu.

  3. Choose the filter option e.g. Subjects if you look for specific subject. Or choose "Everything" if you want to search through all categories.

  4. Insert the searched phrase e.g. name of the subject (IMPORTANT: minimum length of name is 3 characters).

  5. Confirm by "Search" button and check the results which are containing the hypertext links so you can navigate to the given entity details page.

image21
image53