Use Cases

---

Login

Actor(s): Registered and Moderator users.

Goal: To successfully login into the system

Preconditions

• User should be registered

Steps

• 1. From the navigation bar, user clicks to "Login/Signup" link.
• 2. If user wants to login via Facebook
  • 2.1. User clicks "Login with Facebook" button.
  • 2.2. In the openned pop-up, user allows the access for his/her Facebook account.
• 3. If user wants to login via e-mail
  • 3.1. In "Login" box, user enters his/her e-mail and password and clicks login.

Postconditions

• User is logged in and can also perform actions that is allowed only for authenticated users.

---

Register

Actor(s): Guest users.

Goal: To successfully register to the system.

Preconditions

• User should be non-registered (ie. his/her e-mail does not exists in the system database)

Steps

• 1. From the navigation bar, user clicks to "Login/Signup" link.
• 2. If user wants to register via Facebook
  • 2.1. User clicks "Register with Facebook" button.
  • 2.2. In the openned pop-up, user allows the access for his/her Facebook account.
• 3. If user wants to login via e-mail
  • 3.1. In "Login" box, user enters his/her e-mail and password and clicks login.
• 4. User gets in the application right away. S/he is redirected into homepage after successful register

Postconditions

• User gets an e-mail asking for her/his email for account validation. (?)

---

Edit Profile

Actor(s): Registered and Moderator users.

Goal: To edit profile info.

Preconditions

• User must be registered.

Steps

• 1. User clicks to his/her name from the navigation bar and selects "Profile" link.
• 2. If user wants to modify his/her password
  • 2.1. S/he fills the "New password" and "Confirmation" fields, and click "Update" button.
• 3. If user wants to modify his/her another than password information
  • 3.1. User chooses the info s/he wants to update, modifies the text and clicks "Update Profile".

Postconditions

• Page will be refreshed and user's info will be updated.

---

Search

Actor(s): Guest, Registered and Moderator users

Goal: To successfully perform search and find the content you are looking for

Preconditions

• [Registered and Moderator users only] If user wants to get personal recommendations while searching, s/he should be logged in.

Description

Search is the most fundamental feature in the system. It basically lets user perform search and get results of cultural heritage items based on the query. Matching is done via both cultural heritage item's text and media.

Steps

• 1. Users enters a text on the search bar.
• 2. User clicks the "Search" button or "Enter" key.
• 3. User is directed into search page, which contains several culture heritage items and their sample media.

Post Conditions

• If user clicks to one of the media items (thumbnails) of culture heritage item, s/he won't be redirected, instead, there will be a popup describing that media item.
• If user clicks to any part culture heritage item that is not a media item, s/he will be directed to show page of that item.

---

Create a Cultural Heritage Entry

Actor(s): Registered and Moderator users.

Goal: To create a cultural heritage entry.

Preconditions

• User should be registered
• User should have her/his e-mails verified

Steps

• 1. From the navigation bar, user clicks to "Explore" link
• 2. User clicks to "Add New" button in "Explore" page
• 3. User enters title of the cultural heritage
• 4. User enters description of the cultural heritage
• 5. [Optional] User clicks the upload button and uploads one or more media items
• 6. User clicks "Create" button to create cultural heritage

Postconditions

• A new cultural heritage entry is added to system
• Newly added cultural heritage item is in unverified status, meaning only moderators can see it
• Newly added cultural heritage item needs verification before being publicly available

---

Add Comment on a Cultural Heritage Entry

Actor(s): Registered and Moderator users

Goal: To put a comment on a cultural heritage item

Preconditions

• User should be registered

Steps

• 1. In the show page of any cultural heritage item, user clicks the "Comment" textbox.
• 2. User writes her/his comment to the textbox, and clicks "Create Comment" button.

Postcondition

• A comment is added and associated with the specific culture heritage item user commented on

---

Add an Annotation

Actor(s): Registered and Moderator users

Goal: To add an annotation to a cultural heritage item

Preconditions

• User should be registered

Description

• Users can add annotations to any part of a cultural heritage item, including its description and media items.

Steps

• 1. From the navigation bar, user clicks to "Explore" link
• 2. User selects a cultural heritage item s/he wants to add annotation to
• 3. If user wants to add annotation to the description:
  • 3.1. There is a small pen icon at the top right of the description, user clicks it
  • 3.2. A popup is shown asking user to enter annotation text
  • 3.3. After filling the popup textbox, user clicks "Add Annotation" button
• 4. If user wants to add annotation to any of the media items
  • 4.1. There is a small pen icon at the top of any media item, user clicks it
  • 4.2. Every part of the screen gets dark, except that media item; user clicks desired part of the media item
  • 4.2. A popup is shown asking user to enter annotation text
  • 4.3. After filling the popup textbox, user clicks "Add Annotation" button

Postconditions

• A new annotation is added to description or any of the media items of the cultural heritage item.
• If annotation is added to a media item, it's associated with the specific region of that media item.
• If annotation is added to the description, it's associated with a specific string inside this description.

---

Android Download Heritage Item

Actor(s): Guest, registered or moderator users.

Goal: Save heritage items for offline viewing.

Preconditions

• User device is connected to the internet.

Steps

• 1. From the navigation bar, user clicks to "Explore" button.
• 2. User selects a cultural heritage item s/he wants to save for later.
• 3. User clicks "Download" button to save the item for offline viewing.

Postconditions

• Cultural heritage item is saved to user's device.

---

Android View Downloaded Heritage Item

Actor(s): Guest, registered or moderator users.

Goal: View previously downloaded heritage item offline.

Preconditions

• User device is not connected to the internet.

Steps

• 1. From the navigation bar, user clicks to "Downloaded Items" button.
• 2. User selects a cultural heritage item s/he wants to view.

Postconditions

• Cultural heritage item is shown to the user.