User Manual

advertisement
Search4Yummy
User Manual
Version 1.0
Search4Yummy
User Manual
Version:
1.0
Date: 2011-01-12
Revision History
Date
Version
Description
Author
2011-12-10
0.1
Initial Version
Yehui Wang
2011-12-30
0.2
Mobile application manual
Lovro Maričić
2011-01-03
0.3
Web application manual
Yehui Wang
2011-01-05
0.4
Add 3.1.8, 3.1.9
Yehui Wang
2011-01-12
1.0
Review
Muhammad Sulyman
Page 2
Search4Yummy
User Manual
Version:
1.0
Date: 2011-01-12
1.
Introduction ........................................................................................................................ 4
1.1 Purpose of this document ............................................................................................ 4
1.2 Document organization ............................................................................................... 4
1.3 Intended Audience ....................................................................................................... 4
1.4 Scope ........................................................................................................................... 4
1.5 References ................................................................................................................... 4
2. General overview ............................................................................................................... 5
3. Web Application ................................................................................................................. 6
3.1 Web application for Customer..................................................................................... 6
3.1.1 Customer Registration ......................................................................................... 6
3.1.2 Customer Login/Logout ....................................................................................... 6
3.1.3 Customer Modify Personal Information .............................................................. 7
3.1.4 Restaurant Search and View ................................................................................ 8
3.1.5 Restaurant Grade and Comment .......................................................................... 9
3.1.6 Menu View and Grade ....................................................................................... 10
3.1.7
Dish View, Comment and Grade........................................................................ 11
3.1.8 Save Dish and View Dish Wish List .................................................................. 14
3.1.9 News Registration/Unsubscribe for Restaurant Type ........................................ 14
3.2 Web application for Restaurant Staff ........................................................................ 15
3.2.1 Restaurant Staff Login/Logout........................................................................... 15
3.2.2 Setup a New Restaurant ..................................................................................... 15
3.2.3 Modify/Delete a Restaurant ............................................................................... 17
3.2.4 Add/Delete/Modify Menu for a Restaurant ....................................................... 18
3.2.5 Add/Delete/Modify Dish for a Restaurant ......................................................... 20
3.2.6 Add/Delete/Modify News for a Restaurant ....................................................... 22
3.3 Web application for Admin ....................................................................................... 23
3.3.1 Administrator Login/Logout .............................................................................. 23
3.3.2 Add/Delete/Modify Customer ........................................................................... 24
3.3.3 Add/Delete/Modify Restaurant Staff ................................................................. 26
3.3.4 Add/Modify Restaurant Types ........................................................................... 27
4. Mobile Application .......................................................................................................... 30
4.1 Home screen (Guest) ................................................................................................. 30
4.2 User registration ........................................................................................................ 30
4.3 User login .................................................................................................................. 31
4.4 Search 4 restaurant .................................................................................................... 32
4.5 Restaurant details ...................................................................................................... 33
4.6 Search 4 dish ............................................................................................................. 35
4.7 Dish details ................................................................................................................ 36
4.8 My Stuff page ............................................................................................................ 37
4.9 My Profile page ......................................................................................................... 38
4.10
Uploading a picture ............................................................................................... 38
4.11 Log out ...................................................................................................................... 38
Page 3
Search4Yummy
User Manual
Version:
1.0
Date: 2011-01-12
1.
Introduction
1.1
Purpose of this document
The purpose of this document is to explain functionalities of the Search4Yummy application to the
customers.
1.2
Document organization
The document is organized as follows:
 Section 1, Introduction of the system, describes contents of this guide, used documentation during
developing process etc.
 Section 2, General Overview, describes the general application purpose and intended usage scenarios
 Section 3, Web Application, describes the functionalities and the usages of the users.
 Section 4, Mobile Application, describes the functionalities and the usages of the users
1.3
Intended Audience
The intended audience is:

end users of the system

Project team members

Supervisors
1.4
Scope
This document covers the functionalities of Search4Yummy system: How to use this system both from
Web application side and Mobile application side.
1.5
References
For additional information the following documents can be used as reference:

Requirement Requirements Document

Design Description Documents

Development Environment Document

Acceptance Test Plan Document
Page 4
Search4Yummy
User Manual
2.
Version:
1.0
Date: 2011-01-12
General overview
The project aims at creating a web site and a mobile application specializing at selecting the best
restaurant/coffee bar depending on user’s preferences. One of the main goals of building this kind of an
application is to help users in finding and/or managing restaurant/coffee bar and their services e.g.
insight in some basic restaurant/coffee bar information, its menu and gallery and so on. The basic
concept of using application in this project is that there will be two main profiles of users who will be
using the application.
User profile that includes restaurant/coffee bar staff including a restaurant owner will be changing
information of their restaurant in which they work or they are owner of, depending on which user of
this profile has privileges to change certain info. This information includes managing photos of their
restaurant/coffee bars, basic info about the restaurant/coffee bar such as location, name, contact info
and so on, managing offers of their dishes e.g. prices, adding a new dish and so on.
The mentioned information will be available to see to the common registered user which is the second
user profile. This profile of user will have an option to find a restaurant of their choice based on various
criteria which application will offer e.g by certain type of dish, by how far the restaurant/coffee bar is –
the app will have an option to search the restaurant/coffee bar based on the user's location, or
rating/popularity of that restaurant/coffee bar . If the user likes or dislikes particular restaurant/coffee
bar he can leave feedback for that restaurant/coffee bar in a form of comment, photo or recommend a
certain dish in form of leaving a grade or maybe even leaving a constructive review. Also there is an
option of subscribing to a newsletter for a certain restaurant/coffee bar which he favors.
Page 5
Search4Yummy
User Manual
3.
Version:
1.0
Date: 2011-01-12
Web Application
We divide the web application into three parts: one is for customers who could interact with the system.
Second one is for staff members who could mange their restaurant's information. The last one is for
administrator who could manage and configure the system.
3.1
Web application for Customer
3.1.1
Customer Registration
1. Guest fills a form for new user registration (username, password, e-mail, first and second
name, phone, address).
3.1.2
2.
System creates new user.
3.
System informs user about successfully created user account by registered e-mail.
4.
User needs to confirm registration information on email.
5.
Then user could login as a registered customer.
Customer Login/Logout
1.
User input username and password into login box;
a.
2.
If user wants system to remember his password, he could check “Don't ask for my
password for two weeks”.
Login.
Page 6
Search4Yummy
User Manual
3.
3.1.3
Version:
1.0
Date: 2011-01-12
Login users can also logout by click “LOGOUT”, then user exits successfully.
Customer Modify Personal Information
1. Login users can modify their profile by click “MY PROFILE”, and save it.
Page 7
Search4Yummy
User Manual
3.1.4
Version:
1.0
Date: 2011-01-12
Restaurant Search and View
1. User can input keywords for search restaurant, and system shows list of restaurants that have
met chosen keywords.
2.
Click selected restaurant and system shows its details (name, popularity, location, comments,
photos, menu, grade of restaurant, available seats, news)
Page 8
Search4Yummy
User Manual
3.1.5
Version:
1.0
Date: 2011-01-12
Restaurant Grade and Comment
1. User can clicks on “five starts” to grade the selected restaurant on the restaurant page. Then
system saves grade and displays the result after user grading.
2.
Login user can write a comment about restaurant, and then system saves comment and
displays user’s comment.
Page 9
Search4Yummy
User Manual
3.
3.1.6
Version:
1.0
Date: 2011-01-12
Also user can clicks on “five starts” to grade the comments of other users. System saves grade
and displays the result after user grading
Menu View and Grade
1. User could view menu from the “Top Menu” on the main page or from the “Most popular
menu”/“View all menus” on the selected restaurant page.
Page 10
Search4Yummy
User Manual
2.
3.1.7
Version:
1.0
Date: 2011-01-12
Then system shows list of dishes. And user can also click on “five starts” to grade the selected
menu. System saves grade and displays the result after user grading.
Dish View, Comment and Grade
1. User could view dish from the “Top Dishes” on the main page or from the “Most popular
Dishes”/“View all Dishes” on the selected restaurant page or from the selected menu.
Page 11
Search4Yummy
User Manual
2.
Version:
1.0
Date: 2011-01-12
Then system shows list of dishes. User can click any dish of them to see the details. And user
also can click on “five starts” to grade the selected dish. System saves grade and displays the
result after user grading
Page 12
Search4Yummy
User Manual
Version:
1.0
Date: 2011-01-12
3.
Login user can write a comment about dish, and then system saves comment and displays
user’s comment.
4.
Also user can clicks on “five starts” to grade the comments of other users. System saves grade
and displays the result after user grading
Page 13
Search4Yummy
User Manual
3.1.8
Save Dish and View Dish Wish List
1. User clicks on “Save dish” option for the selected dish, then System saves dish on wish list. If
you want to remove it from wish it, just click “Remove dish”
2.
3.1.9
Version:
1.0
Date: 2011-01-12
User click “My dishes” on the main page to view the list of user’s saved dishes.
News Registration/Unsubscribe for Restaurant Type
1.
User chooses type of restaurants on the main page and click “Subscribe” to register news.
Then, if news of this type of restaurant updated, user will receive its news by clicking
“SUBSCRIPTIONS” on the main page.
Page 14
Search4Yummy
User Manual
2.
Version:
1.0
Date: 2011-01-12
User chooses restaurant type that he wants unsubscribe. After that, if news of this type of
restaurant updated, user will not receive any of its news.
3.2
Web application for Restaurant Staff
3.2.1
Restaurant Staff Login/Logout
3.
3.2.2
It’s similar with User Login/Logout, just input related restaurant’s username and password.
Setup a New Restaurant
1. Click “EDIT RESTAURANT” on the main page, and then click “Create New”.
Page 15
Search4Yummy
User Manual
Version:
1.0
Date: 2011-01-12
2.
Naming this new restaurant by clicking “Click here to add text”.
3.
Click “+ More settings” Input Restaurant information, including Name, Address, City, Seat
Availability, Seat Capability, etc. Then “save”.
Page 16
Search4Yummy
User Manual
4.
3.2.3
Version:
1.0
Date: 2011-01-12
Restaurant staff can add images for this restaurant by clicking “Images”. And select images
then “Submit”
Modify/Delete a Restaurant
1. In the “EDIT RESTAURANT” page, restaurant staff can edit this restaurant information. Then
“Save” the modification.
Page 17
Search4Yummy
User Manual
2.
3.2.4
Version:
1.0
Date: 2011-01-12
Restaurant staff also could delete this restaurant information by clicking “Delete”, and click
“YES DELETE” to confirm deletion or click “Cancel” to cancel this action.
Add/Delete/Modify Menu for a Restaurant
1. Restaurant staff click “Menus” on the “EDIT RESTAURANT” page, And “Create new”
2.
Add related information, if this restaurant already setup dishes, you could move related dishes
in the “Dished to select” to the right blank “Dishes in menu”. And “Save”.
Page 18
Search4Yummy
User Manual
Version:
1.0
Date: 2011-01-12
3.
Restaurant staff can add image for this menu after setup by clicking “Images”.
4.
Restaurant staff can delete this menu by clicking “Delete”.
5.
Restaurant staff can edit this menu that is similar with setup a new one by clicking “Edit”.
Page 19
Search4Yummy
User Manual
3.2.5
Version:
1.0
Date: 2011-01-12
Add/Delete/Modify Dish for a Restaurant
1. Restaurant staff clicks “Dishes” on the “EDIT RESTAURANT” page, And “Create new”.
2.
Add the information and “Save”.
Page 20
Search4Yummy
User Manual
Version:
1.0
Date: 2011-01-12
3.
Restaurant staff can add image for this dish after setup by clicking “Images”.
4.
Restaurant staff can delete this dish by clicking “Delete”.
5.
Restaurant staff can edit this dish that is similar with setup a new one by clicking “Edit”.
Page 21
Search4Yummy
User Manual
3.2.6
Version:
1.0
Date: 2011-01-12
Add/Delete/Modify News for a Restaurant
1. Action to about “Add/Delete/Modify News for a Restaurant” is similar with
“Add/Delete/Modify Dish for a Restaurant”. Staff member enters new news about its
restaurant.
Page 22
Search4Yummy
User Manual
2.
Version:
1.0
Date: 2011-01-12
System confirms that news was successfully added.
3.3
Web application for Admin
3.3.1
Administrator Login/Logout
1.
It’s similar with User Login/Logout, just input Administrator’s username and password. Click
“Admin” on the main page.
Page 23
Search4Yummy
User Manual
3.3.2
Version:
1.0
Date: 2011-01-12
Add/Delete/Modify Customer
1. Administrator clicks “Customers” on the “Admin area” page, input customer’s information in
the right part of page. Make sure to check “Email confirmed”, Then “Save”. A new user will
be setup right away.
Page 24
Search4Yummy
User Manual
Version:
1.0
Date: 2011-01-12
2.
Administrator can delete this Customer by uncheck “Email confirmed”, and then this
customer couldn’t logon by this user name.
3.
Administrator can edit this Customer‘s information by selecting customer listed in the form of
“Customers users”. Then Administrator can modify and save his information in the below
“Update” part.
Page 25
Search4Yummy
User Manual
3.3.3
Version:
1.0
Date: 2011-01-12
Add/Delete/Modify Restaurant Staff
1. Administrator clicks “Staff” on the “Admin area” page, input customer’s information in the
right part of page. Make sure to check “Email confirmed”, Then “Save”. A new user will be
setup right away.
Page 26
Search4Yummy
User Manual
3.3.4
Version:
1.0
Date: 2011-01-12
2.
Administrator can delete this Staff by uncheck “Email confirmed”, and then this Staff couldn’t
logon by this user name.
3.
Administrator can edit this Staff‘s information by selecting Staff listed in the form of “Staff
users”. Then Administrator can modify and save his information in the below “Update” part.
Add/Modify Restaurant Types
1. Administrator clicks “Restaurant types” on the “Admin area” page, input restaurant type’s
information in the right part of page, then “Save”. Then the new restaurant type is listed in the
form of “Restaurant types” in right part of page.
Page 27
Search4Yummy
User Manual
2.
Version:
1.0
Date: 2011-01-12
Administrator can edit this Restaurant type’s information by selecting Staff listed in the form
of “Restaurant types”. Then Administrator can modify and save its information in the below
“Update” part.
Page 28
Search4Yummy
User Manual
Version:
1.0
Date: 2011-01-12
Page 29
Search4Yummy
User Manual
4.
Version:
1.0
Date: 2011-01-12
Mobile Application
The mobile application is designed only for customers. The functionalities are very similar to the
customer web application in that the user can log in, grade dishes and restaurants and comment.
4.1
Home screen (Guest)
This is the home screen the user sees if he is not logged in.
4.2
User registration
1.
User clicks on the Registration button
2.
User fills the required fields in the registration form
Page 30
Search4Yummy
User Manual
Version:
1.0
Date: 2011-01-12
3.
If the data that was input is correct the system reports that an activation mail has been sent to
the provided e-mail address.
4.3
User login
1.
User clicks on the Login button.
2.
User enters his username and password and has the option of checking the Remember me box
so he will be automatically logged in the next time he starts the application.
3.
If the login is successful the system will redirect to the user home screen where the
Registration button has been replaced with the My Profile button and the Login button is replaced for
the Logout button.
Page 31
Search4Yummy
User Manual
4.4
Version:
1.0
Date: 2011-01-12
Search 4 restaurant
1.
User clicks on the Restaurants button
2.
User inputs search parameters in the search form.
3.
4.
The system gives the user a list of restaurants that match the search criteria.
The user can select one of the restaurants for a more detailed description of the restaurant.
Page 32
Search4Yummy
User Manual
4.5
Version:
1.0
Date: 2011-01-12
Restaurant details
1.
The user is presented with basic information about the restaurant. He can check into the
restaurant, grade it and subscribe to it. To move to other pages the user needs to swipe his finger over
the screen.
2.
The Restaurant dishes page shows all dishes available in the selected restaurant and the
Restaurant menu shows all available menus.
Page 33
Search4Yummy
User Manual
Version:
1.0
Date: 2011-01-12
3.
Map shows the location of the restaurant on Google Maps.
4.
Gallery displays all pictures pertaining to the restaurant
Page 34
Search4Yummy
User Manual
Version:
1.0
Date: 2011-01-12
5.
Comments page gives the user all comments from other users and allows him to leave his own
comment as well as grade other comments.
4.6
Search 4 dish
1.
User clicks on the Dishes button.
2.
User enters the desired search parameters.
3.
The system displays a list of dishes matching the given criteria, similar to the one in the
restaurant details part.
Page 35
Search4Yummy
User Manual
4.7
Version:
1.0
Date: 2011-01-12
Dish details
1.
In the Dish details page the user can see additional information regarding the dish, can vote on
the dish, add it to his wish list and view the restaurant details that offers this dish. To view other pages
the user must swipe with his finger.
2.
Description gives a detailed description of the dish
3.
In the Comments page the user can see other comments as well as give his own comment and
grade other comments.
Page 36
Search4Yummy
User Manual
4.
4.8
Version:
1.0
Date: 2011-01-12
Gallery shows the user pictures of the selected dish.
My Stuff page
1.
The user clicks on the My Stuff button to go to the My Stuff page. There he can view his wish
list, subscriptions and news.
2.
Dish wish list is a list of dishes the user has added and he can view details or remove them
from the wish list.
3.
Subscription page shows all the restaurants that the user is subscribed to and the user can
unsubscribe from a restaurant on this page.
Page 37
Search4Yummy
User Manual
Version:
1.0
Date: 2011-01-12
4.
The News page shows a list of news from restaurants the user is subscribed to. By clicking on
a certain headline the user can view the news details.
4.9
My Profile page
1.
The user clicks on the My profile button.
2.
The user is given his profile details which he can edit.
3.
By clicking Save Changes the user saves any changes made to his profile.
4.10
Uploading a picture
To upload a picture the user must click on the button in the restaurant details page. Afterwards the user
will be redirected to the camera. When the user takes a picture the system will ask if he wishes to
upload the picture. For the picture to be added to the restaurant gallery a staff member must first add it.
4.11
Log out
To log out the user simply clicks on the Logout button and confirms he wants to log out.
Page 38
Download