Difference between revisions of "IS480 Team wiki: 2014T1 Team Epsilon Scope Admin User Flow"
(→Login) |
|||
Line 198: | Line 198: | ||
− | <center> [[Image: | + | <center> [[Image:Scope_Web_Display_My_Feedback.png|900px]] </center> |
This view is similar to display all feedback function, and allows the user to get to the feedback that they care about the most quickly. | This view is similar to display all feedback function, and allows the user to get to the feedback that they care about the most quickly. |
Revision as of 23:30, 21 November 2014
Home | Project Overview | Project Management | Documentation | Team |
Description | Motivation | Stakeholders | Scope | X-Factor |
[ Priority Scope ] | [ iOS User Flow ] | [ Admin User Flow ] | [ Agency User Flow ] |
The Public Feedback & Enquiry Platform iOS Web Application is intended for public and admin users.
You can find the admin functions below.
Contents
Display All Feedback
Overview
When the user first launches the website, they will be able to see a listing of all the feedback posted by other users in the system here, even if they have not login.
In this view, the user will be able to see the following feedback details
- 1. Time which feedback was submitted
- 2. Location of feedback
- 3. Feedback title
- 4. Image of feedback (if user has submitted one or more images)
- 5. Number of votes
- 6. Number of comments
The app has a fixed navigation bar at the bottom of the screen. This navigation bar is omnipresent throughout the app, and allows the user to get to the core functionalities of the app no matter where they are.
Feedback List Sorting
The feedback listing will be displayed according to feedback with the latest updated activity (posted, commented, voted or approved as non-abusive).
Feedback Sorting
User can sort the feedback by:
- Last Updated
- Most Active
- Most Commented
- Most Voted
- Last Created
Feedback Search
User can search feedback by title, description or location from the search bar.
Registration
Overview
If the user wants to submit a feedback they will need to have a user account.
The user will be able to register for an account here.
The following screen will be what the user will see when they are not logged in to the system.
The user will be able to:
- 1. Login with Email & Password
- 2. Register New account
Register New Account
Users will only be able to sign up as a normal public user.
After entering the above information, the user clicks Register to continue with the registration process.
Verify Mobile
The verification code will be sent to the user’s mobile number.
This code will be time-sensitive for security purposes, and will become invalid after five minutes.
Upon confirmation of the verification code, the user will be logged in with credentials saved for convenience of using the app next time.
If the verification code has expired or the user input the wrong verification code, the user will be able to click on Resend Verification Code to get a second code.
Login
Overview
In order to submit a feedback, as well as vote and comment on other feedback, the user will need to login to the system which they will be able to do here.
The following screen is what the user will see when they are not logged in to the system.
The user will be able to:
- 1. Login with Email & Password
- 2. Register new account
Successful Login
Upon successful login, the system will show all the feedback to the user.
The user can go into th eaccount page which will show the user’s email and mobile number, as well as provide the user the option to change their password and log out of the system.
A successful login also allows the user to vote and comment on feedback.
Password Change
The user will be prompted to enter the details in the screen to change their password.
Display My Feedback
Overview
After the user logins to the system, the user will be able to see a listing of all the feedback that is submitted by the user in the system here.
In this view, the user will be able to see the following feedback details:
- 1. Time which feedback was submitted
- 2. Location of feedback
- 3. Feedback title
- 4. Image of feedback (if user has submitted one or more images)
- 5. Number of votes
- 6. Number of comments
This view is similar to display all feedback function, and allows the user to get to the feedback that they care about the most quickly.
Feedback List Sorting
The feedback listing will be displayed according to feedback with the latest updated activity (posted, commented, voted or approved as non-abusive).
Display Feedback Details
Overview
The user will be able to see the details of the selected feedback in the system here.
In this view, the user will be able to see the following feedback details:
- 1. Feedback owner (user who submitted feedback)
- 2. Time which feedback was submitted
- 3. Location of feedback
- 4. Feedback title
- 5. Images of feedback (if user has submitted one or more images)
- 6. Annotation of feedback (if user has annotated one or more images)
- 7. Number of votes
- 8. Number of comments
- 9. Description of feedback
- 10. Comments made by other users
- 11. Map of feedback (by clicking on the location details)
Vote on Feedback
When the user votes for a feedback, the total number of votes will be highlighted to signify and tell the user that he/she has voted for the current feedback listed.
The user can also comment on a feedback by clicking on the Write Comment button.
The user will be able to swipe horizontally to see all the images uploaded for the feedback.
Comment on Feedback
When the user clicks on Write Comment, this will be shown to the user, along with an invoked keyboard for the user to input the comment.
All input fields that require user’s input will show the keyboard like the screen above.
View Image & Annotations
When the user clicks on the image of the feedback on the detailed feedback page, the image gallery view will be invoked.
Here, the user will be able to see the enlarged image more clearly, along with one of the default/primary annotation description.
The user will be able to tap on the image outside of the annotation boxes to show/hide annotations, which are highlighted on the image by enclosing indicators.
Clicking one of these indicators will show the annotation details for that particular annotation.
The user will be able to dismiss the image gallery view and return to the display feedback details view by tapping on the black area outside of the image.
View Location Map
When the user clicks on the location details of the feedback on the feedback detail page, the map view will be invoked.
Here, the user will be able to see a map with the location of the feedback highlighted.
This location will be determined by the mobile’s GPS (if the user gives access), and can be edited by the feedback owner.
Report Abuse
When viewing any feedback, a user will be able to report a feedback as abusive by clicking on the “Report Abuse” button to flag the feedback to the admin.
Feedback that is reported for abuse will be temporarily removed/hidden from the display feedback listing in the app.
The admin will be notified of the abuse report, to approve or reject the report.
If the admin approves the report abuse, the feedback will stay removed/hidden from users.
If the admin rejects the report abuse, the feedback will be available for user’s access again.
Once a feedback has been deemed safe (report abuse rejected) by the admin, it can no longer be reported for abuse again (the button will be disabled or not shown to the user).
When the user chooses to report a feedback as abusive, the app will show the above screen to allow the user to input the reason of why the feedback is abusive.
Create Feedback
Overview
The user will be able to create and submit a new feedback in the system here.
When the user creates a feedback for the first time, the app will prompt the user to give access rights to its GPS unit, so that the app can determine the rough location of the user using the GPS chip as shown.
If the user does not give the app access rights to the GPS unit, the user will need to enter the location information on their own.
They will still be able to use the app normally.
Basic Information (Step 1 of 3)
If GPS is enabled, the app will auto-populate the location when user presses the icon. If not, the user will need to input this field. This field is user-editable even if GPS is enabled.
If the user selects to change the location selected by the GPS due to various reasons like inaccuracy of the location, the user will be able to drag a pin on the map to pinpoint the desired location.
This is also useful when the user is reporting a feedback but is not currently at the location of the feedback/issue.
Image Upload (Step 2 of 3)
The user will be able to upload images with annotations here.
Take a Photo (Step 2 of 3)
The user will be able take a photo to upload here.
To ensure a consistent and better viewing experience throughout the platform, the photo will be fixed to a certain resolution (to be determined).
To facilitate the image uploading process, the camera will fix the image resolution when the user is taking the photo. This eliminates the need for the user to crop the image after this step.
Upload from Camera Roll (Step 2 of 3)
Besides taking a photo to upload, the other alternative to upload image is for the user to upload an image from their iPhone’s camera roll.
The camera roll with be invoked, and the user will be able to choose an image to from an image gallery viewer.
Crop Image (Step 2 of 3)
The user will be able to crop an image before annotating here.
This step is not required and will be skipped if the user takes a photo to upload. If the user uploads an image from the camera roll, the user will be required to crop the image before continuing.
This is to ensure a consistent and better viewing experience throughout the platform. Therefore, the photo will be fixed to a certain resolution (to be determined).
Annotate Image (Step 2 of 3)
The user will be able to annotate an image here.
This step is not required and can be skipped at the user’s discretion. This allows the user to label the uploaded image to give more details or clarity about the image.
Finalize Image Upload (Step 2 of 3)
The user will be able to review the images and annotations chosen before finalizing the images here.
Review Feedback (Step 3 of 3)
The user will be able to review all the feedback details input and the images and annotations uploaded before finalizing the feedback submission here.
After reviewing all the information (scrolling down to see all the images), the user will be able to submit the feedback.
This ends the process for create feedback.
Notifications
Overview
The user will be able to see all the notifications here.
User will be alerted to notifications when:
- 1. Other users vote on their submitted feedback
- 2. Other users comment on their submitted feedback
- 3. Other users reported abuse on their submitted feedback
The notification icon at the bottom of the omnipresent navigation bar will also display a number to let the user know at a glance the number of outstanding notifications the user has.
Close Feedback
Overview
The user will be able to close a feedback they have submitted here.
When viewing a feedback they have created, a user will be able to see an additional button to close the feedback.
When the user chooses to close the feedback, the app will prompt to let the user confirm before closing the feedback.
Feedback owners are able to close the feedback at any time.
Admin Functions
The Public Feedback & Enquiry Platform Admin Web Portal is only intended for admin users.
Login
Overview
This is the page that the admin will see when the admin first accesses the web portal. The admin will be required to login to access the admin web portal.
User Management
Overview
The admin will be able to manage the users in the system in this module.
In this module, the admin will be able to:
- 1. View a user’s record
- 2. Search & filter for users
- a. By name
- b. By email address
- c. By mobile number
- 3. Suspend a user
- 4. Delete user record
- 5. Export user record as report
- 6. Sort column’s data by ascending or descending
Under the action column of the list, the user will be able to suspend the user and delete the user record. A multiple delete function is also in place as a batch action.
Agency Management
Overview
The admin will be able to manage the agencies in the system in this module.
In this module, the admin will be able to:
- 1. View an agency’s information (Figure 5.3.2)
- 2. Search & filter for agencies (Figure 5.3.1)
- a. By agency name
- b. By email address
- c. By contact
- 3. View agency record
- 4. Add agency record
- 5. Edit agency record
- 6. Delete agency record
- 7. Export agency record as report
- 8. Sort column’s data by ascending or descending
Under the action column of the list, the user will be able to view the agency details and delete the agency record. A multiple delete function is also in place as a batch action.
Add Agency Record
In the agency record detail page, the admin will be able to add an agency record details here.
View & Edit Agency Record
In the agency record detail page, the admin will be able to view, edit and delete the agency record details here. This will help the admin to determine which agency to tag a feedback to when public users submit a feedback.
Feedback Management
Overview
The vendor will be able to manage the feedback in the system in this module.
In this module, the admin will be able to:
- 1. View a feedback information
- 2. Search & filter for feedback
- a. By feedback title
- b. By agency tagged
- c. By start date
- d. By end date
- e. By tagged status
- 3. View feedback record
- 4. Close feedback record
- 5. Delete feedback record
- 6. Export feedback record as report
- 7. Sort column’s data by ascending or descending
Under the action column of the list, the user will be able to view the feedback details and delete the feedback record. A multiple delete function is also in place as a batch action.
When a feedback is flagged as abusive, there will be two more action buttons under the action column: Approve Report and Reject Report. Approved feedback will hide the feedback from users and the status remains Rejected feedback will revert to the previous status and be available for users to view, vote, and comment.
Feedback Record
The following feedback status describes the trigger states of feedback.
Feedback Status:
- New: Newly-created feedback defaults to this.
- In Progress: Tagged feedback defaults to this.
- Marked as Resolved: Agencies can set status to this and inform user about it once issue is resolved for verification and closure.
- Flagged as Abusive: Feedback that has been reported for abuse defaults to this.
- Resolved: Feedback that has been closed by either the feedback owner or admin.
When an agency requests for a feedback to be closed, the user who submitted the feedback will be notified to verify and close it. If the user does not respond within 3 days, the agency request will be forwarded to the admin for further actions.
If feedback owner closes a feedback before an agency requests it to be closed, the agency and admin will be notified on the feedback status update.
If the feedback has been flagged for abuse, the admin will be able to reject or approve the report of the feedback here.
Feedback Image Gallery
When the admin clicks on an image in the detailed feedback record view, the image will be displayed in an overlay gallery view, where the admin can view the image more clearly, as well as show and hide the annotations for the images.
The admin can view more images by navigating with the arrow buttons and close the image by clicking the cross or anywhere outside the main content area of the overlay.
Notifications
Overview
The admin will be able to see all the notifications here.
Admin will be alerted to notifications when:
- 1. Other users submit a new feedback
- 2. Feedback owners close a feedback before an agency mark it as resolved
- 3. Other users report a feedback as abusive