Skip to content

Wizards

Jump to bottom
Andrew Feely edited this page Aug 1, 2025 · 3 revisions

Overview

The wizards are the key element of this application, as they are the users. Each wizard is given a hand on the clock face. Once they log into the mobile application (Pocket Watch) and start the location reporting feature, if they enter a location that is linked to a position on the clock face, their hand is updated to point at that location.

Screenshot of Tab

full-wizards-tab

Wizard (User) Roles

There are three different roles that a user can be assigned:

  • Admin
    • Has access to every tab (clock, wizards. locations, and server settings).
    • Allowed to use the mobile app (Pocket Watch) used for user location reporting.
    • Methods of location reporting:
      • Can be assigned to an Admin or User as a "follower", allowing them to have the same location reported as the admin/user they are set to follow.
      • Can login to the mobile app (Pocket Watch) and use it for location reporting.
  • User
    • Has access only the clock, not including the "Clock Face Management" section.
    • Allowed to use the mobile app (Pocket Watch).
    • Methods of location reporting:
      • Can be assigned to an Admin or User as a "follower", allowing them to have the same location reported as the admin/user they are set to follow.
      • Can login to the mobile app (Pocket Watch) and use it for location reporting.
  • Child
    • Has access only the clock, not including the "Clock Face Management" section.
    • Not allowed to use the mobile app (Pocket Watch).
    • Methods of location reporting:
      • Can be assigned to an Admin or User as a "follower", allowing them to have the same location reported as the admin/user they are set to follow.
      • TO BE IMPLEMENTED: Location can be manually set in the web console.

Actions

Adding/Registering a Wizard (Add User)

The steps to adding a wizard is as follows.

  1. Navigate to the Wizards Tab.
  2. Select the "Add Wizard" Button.
  3. Fill out the "Add Wizard" Form.
    • All the fields except for the "Is Follower?" checkbox are required and validated before a successful submission is possible.
    • If the "Is Follower?" checkbox is selected, a new dropdown of all valid "Lead Wizard"s is displayed. A lead wizard must be selected in order for the user that is a follower to have their location updated.

Editing a Wizard (Edit)

The edit wizard form is the same visually as the "Add Wizard" form, but with the field pre-populated with the wizard selected to be edited. All field rules are are identical.

Deleting a Wizard (Delete)

When a wizard is selected to be deleted, a confirmation modal double checking the delete action. If confirmed, the wizard is deleted and subsequently removed from the clock face.

  • NOTE: The original admin included in the server is unable to be deleted.

View a User's Location History (View Path)

This displays the "Wizard's Path" Modal. This modal consists of a map with all the wizard's recorded locations plotted on a polyline, ordered by time recorded.

  • NOTE: All location history clears automatically every 24 hours and on a server restart, as this is not supposed to be a weird, keep tabs on someone application.

Manually Clear a Users Location History (Clear Path Log)

This is pretty self-explanatory, but it is just a manual flush of all of a user's location history. See note in the "View a User's Location History (View Path)" action about the automatic clears that happen.

Clone this wiki locally