BuySafe User Manual
Contents
1. FES MALARDALENS HOGSKOLA BuySafe User Manual Version 1 0 BuySafe User Manual Date 2013 01 20 Revision History 2013 01 19 Initial Draft Zelimir Kompes 2013 01 20 Android user manual added Zelimir Kompes 2013 01 20 1 0 Final version Zelimir Kompes Xiaowei Ma Page 3 BuySafe User Manual Date 2013 01 20 Table of contents 1 Introduction 5 1 1 Purpose of this document 5 1 2 Document organization 5 1 3 Intended Audience 5 1 4 Scope 5 1 5 References 3 2 _ General overview 6 3 User manual 7 3 1 Android application 7 3 1 1 Profile 7 3 1 2 Search Product 10 3 1 3 Shopping list 16 3 1 4 Safe Products 16 3 1 5 Compare products 17 3 1 6 Exit 17 3 2 Server side management guide 18 Page 4 BuySafe User Manual Date 2013 01 20 1 Introduction 1 1 Purpose of this document The purpose of this document is to describe the functionalities of the BuySafe application to the end users After reading this document users should be able to understand how to use the application 1 2 Document organization The document is organized as follows e Section 1 Introduction describes purpose and contents of this guide e Section 2 General overview describes the general application purpose e Section 3 User manual describes functionalities of the application and usage scenarios 1 3 Intended Audience The intended audience is e End users e Project supervisor e Project Leader e T2. opens List is filled with products fetched from server and filtered according to product content and preconfigured allergens watch list in user profile Page 16 BuySafe User Manual Date 2013 01 20 3 1 5 Compare products After user selects Compare Products a new screen Figure 16 opens User can scan multiple products and compare their quality All scanned product barcodes will be displayed on screen After user selects Compare products button on screen on Figure 16 a new screen with list of scanned products opens Products are ordered by rating User can select each product from the list if he wants to see additional information about the product Figures 10 and 11 Compare Products Scan Compare products Scan Barcode Compare Products Buy Safe Figure 16 Compare products screen 3 1 6 Exit After user selects Exit application closes Page 17 BuySafe User Manual Date 2013 01 20 3 2 Server side management guide Use PuTTY to start a SSH connection to login Linux virtual server Input the IP address of the virtual machine and use port 22 CS PuTTY Configuration Category Basic options for your Pu I T Y session Specify the destination you want to connect to Host Name or IP address Port 161 53 67 219 72 i Features Connection type B Window Raw Telnet Rlogin SSH Serial nea Load save or delete a stored session Saved Sessions 2 i Co
3. 01 20 CG Profile User Profile sample test com Figure 2 User profile As shown on Figure 3 after user selects Conditions button a list of his allergies will be displayed on the next screen User can remove listed allergies by selecting checkboxes placed on the right side of the each allergy name and then selecting on Remove Selected button After that action allergies immediately removed from the list and will not be listed again After user selects Done button application returns to the previous screen Figure 2 If user wants to add new allergies to his list he can select Add Condition button which takes him to the next screen Figure 4 As shown on Figure 4 after user decides to add new allergies to his list application fetches list of most common allergens from server and displays it to the user Here user can choose several allergens by selecting checkboxes After selecting all wanted allergens in this case soybean and salt user can add them to personal list by selecting Add New Conditions button After that action screen closes and application displays previous screen but this time with newly added allergens Figure 5 Page 8 BuySafe Date 2013 01 20 Folic Acid Figure 3 User allergies 1 Folic Acid Soybean CA Cottonseed Leavening Baking Soda Sodim Alminm Phospha Monocalcim Phosphate Dextrose Salt ia Figure 4 List of all allergies fetc
4. ation for example create table insert and update data and so forth xiaoweillDmysgl Et A fa ape pe 2139 s password Turnkey Linux 12 System information as of Sun Backup and Migration NOT INITIALIZED To initialize TRLBAM run the tklbam init command to link thi system to your Turnkey Hub account For details see the man page or a ae http www turnkeylinuz org tklbam Last login Sun Jan 20 15 15 02 2013 from 180 111 106 350 xiaoweilbBmysgl mysql u root p Enter password Welcome to the MySQL monitor Commands end with Your MySQL connection id is 4171 Server version 5 1 66 0 squeezel 2012 Oracle and or its affiliates All rights trademark of Oracle Corporation and or its trademarks of their respective to clear the current input Figure 20 Database management Page 20
5. duct user reviews and rating To make the application practical it will run on Android smart phones with the ability to scan the barcode of the product that the customer is interested in Customers will also be allowed to search the products by name and compare different products to help them with making a better decision Additionally customers will be able to create their own personal shopping list Page 6 BuySafe User Manual Date 2013 01 20 3 User manual 3 1 Android application As shown in figure 1 main screen will consist of one central menu with several options Immediately after opening the application user will be able to create or edit profile search for the product view personal shopping list view all products which are safe for him compare quality of multiple products or simply exit application In following chapters all options and usage scenarios will be described OQ BuySafe Profile Search Product Shopping List Safe Products Compare Products Figure 1 BuySafe application main screen 3 1 1 Profile After user selects Profile a new screen Figure 2 opens On this screen user has an option to add his e mail address or change existing if it s already added At this stage user can immediately save his profile and he is automatically returned to the main screen or he can click on Conditions button which will take him to the next screen Figure 3 Page 7 BuySafe User Manual Date 2013
6. eam members 1 4 Scope This document describes the functionalities implemented in BuySafe application with detailed descriptions and screenshots of the application screens Additionally document also describes data management process which is performed on the server side by administrator 1 5 References 1 BuySafe Requirements Definition document 2 BuySafe Design Description document 3 BuySafe Acceptance Test Plan document Page 5 BuySafe User Manual Date 2013 01 20 2 General overview News and reports of companies recalling their products make customers cautious about their purchases They wish to avoid potential risks to themselves or their loved ones and select products which are safe The goal of this project is to create an application that protects the customers from harmful and potentially dangerous products by informing them about the product contents and the manufacturer that created the product BuySafe application focuses on food related products and will be able to inform customers about harmful contents that might cause health problems As an example to people that have certain conditions or allergic reactions to some substances the application will suggest not to buy products that might harm them according to product content and preconfigured ingredients watch list The application will also help the customers by giving them information about the quality of a product The quality will be based on contents of the pro
7. hed from server Page 9 BuySafe User Manual Date 2013 01 20 Folic Acid D Soybean Salt Figure 5 User allergies 2 3 1 2 Search Product After user selects Search Product a new screen Figure 6 with two tab buttons opens On this screen user has an option to search product by name Figure 6 or barcode Figure 7 User decides to search product by name enters product name in this case user searches for snickers and selects Search button After that action a list with all similar products will be displayed Figure 8 In case there are no products in the database which meet the search criteria a warning message is displayed Figure 9 and user is returned to the previous screen Figure 6 When user selects product from the list in this case Snickers Marathon Caramel next screen Figures 10 and 11 with available product info opens The same scenario occurs when user scans a product barcode On this screen user can see product barcode average product rating product ingredients nutrition facts product warnings and user warnings Product warnings are common warnings example of general warning may contain traces of soy of displayed product for general population User warnings are warnings written by user and warnings about ingredients which might harm them according to product content and preconfigured allergens watch list in user profile User can add displayed product to personal
8. lours EL Connection Data Default Setting Figure 17 PuTTY Configuration After login Linux prompt would be seen Use Linux prompt command to mange the folders and files The default editor is VI which could be used to edit all text related files Page 18 Date 2013 01 20 In order to deploy server side codes on Linux server FTP or similar transport tool installed on the server is a precondition Use eclipse to generate a WAR file and upload it to Apache TomCat server folder by FTP LJe s d WYN X Ap 161 53 67 219 Figure 18 File management Note WAR file is required to be put under webapps of the corresponding TomCat folder You can check the deployment status by following URL http 161 53 67 219 8080 Server Enter username and password If correct admin page is displayed D I BuySafe Administrator WebPages Mozilla Firefo a BuySafe Administrator WebPages KR 161 53 67 219 8080 Server G NI Google P A FEMA 2 Most Visited DataBase C amp JAVA Assignment SW Dep PN sit AHS Industrial System Deve BuySafe Administrator WebPages Please login Username Password Figure 19 BuySafe Administrator WebPages Page 19 BuySafe User Manual Date 2013 01 20 Manage database through command line and login as an administrator mysql u root p and input password After login the database use related MySQL command to perform corresponding oper
9. shopping list by selecting Add button on the bottom of the screen After that action new pop up window is displayed In displayed window user can enter guantity he plans to buy If the product is already in the shopping list warning message is displayed and product is not added again Page 10 BuySafe User Manual Date 2013 01 20 Q Search Products Search Product by Name Product Name Search Buy HA Figure 6 Search product by name CG Search Products Tap to Activate Barcode Scanner Figure 7 Search product by barcode Page 11 BuySafe User Manual Date 2013 01 20 CG Choose Product Miia 1 Snickers Marathon Caramel Nut Rush Protein Snack Bar 2 82 oz Rating 4 5 10 2 Snickers Marathon Crunch Multigrain Snack Bar 1 94 oz Rating 18 10 DU Y 3 Kudos Milk Chocolate Granola Bars With Snickers Chunks 8 3 oz Rating 3 10 4 Mars Mixed Mini Candy Snickers 40 oz Rating 5 10 Figure 8 List of products Product not found OK Figure 9 Product not found in the database Page 12 BuySafe User Manual Date 2013 01 20 CG Product Details Snickers Marathon Caramel Nut Rush Protein Snack Bar 2 82 02 Barcode 40000003335 Product Quality Ingredients Nutrition Facts NoneNutrition facts Total Calories 290 Total Fat 9 g Saturated Fat 5 g Trans Fat O g Cholesterol 5 mg Sodium 200 mg Total Carbohydrate O g Die
10. tary Fiber 11 g Figure 10 Product info 1 CG Product Details Total Fat 9 g Saturated Fat 5 g Trans Fat 0 g Cholesterol 5 mg Sodium 200 mg Total Carbohydrate O g Dietary Fiber 11 g Sugars 20g Protein 21 g Vitamin A 35 0 Vitamin C 100 0 Calcium 50 0 Iron 45 0 Warning s User Warning s Figure 11 Product Info 2 Page 13 BuySafe User Manual Date 2013 01 20 If user wants to come back to the application main screen he can select Home button which will take him to the main screen Also user can search for additional product info like ratings and reviews from other users After user selects Info button a new screen Figure 12 with all product reviews opens User can now see all ratings and comments for wanted product If user wants to write product review he can select Write Review tab and new screen Figure 13 with rating bar and input text field opens User can also write a warning Figure 14 if he considers that product contains some harmful ingredients Warning will be send to the data administrator who will consider it CG Product Reviews 1 Review Rating 3 10 Comment Weigh Watchers Points Plus 2 Review Rating 6 10 Comment This product is really good Figure 12 All product reviews Page 14 BuySafe User Manual Date 2013 01 20 CG Product Details Rate Product Write Review I like the taste This is one really gualit
11. y product Figure 13 Product review CG Product Details Write Warning Figure 14 Product warning Page 15 BuySafe User Manual Date 2013 01 20 3 1 3 Shopping list After user selects Shopping List a new screen Figure 15 opens On this screen user can see all products which he added to shopping list In last section user added Snickers Marathon Caramel and that product is now displayed in shopping list User can also see a quantity he plans to buy Quantity is displayed in the brackets before product name User can remove products from the shopping list by selecting checkboxes on the right side of the list and then selecting a Remove button Products are immediately removed from the shopping list User can also remove all products from the shopping list by selecting Clear List button User can add a new product to the shopping list by selecting Add button After that action a screen Figure 6 where user can search for a product is displayed From that step scenario is the same like described in section 3 1 2 User can also select a product from the shopping list if he wants to check info of the product After user selects a product from the list product info screen Figure 10 and 11 opens and user can make activities described in section 3 1 2 Shopping List Figure 15 Shopping list 3 1 4 Safe Products After user selects Safe Products a new screen with list of all safe products without allergens
Download Pdf Manuals
Related Search