User Stories

Basic End-To-End Use Case (Including Getting Started)

1. Create a list for a store (press +, then type the name, say Shoprite).
2. Click on the first list, Shoprite. Choose “Make list” from the dialog
3. The list will be blank the first time. Click + to add items. They will autocomplete from a long list of potential grocery items.
4. Click the “Buy n” buttons to add the number of each item you’d like to buy. In a given shopping trip, many will probably just stay 0.
5. Click the Shop action button when done.
6. The list will now contain only those items and quantities you chose in the previous screen.
7. Check them off as you shop. If you prefer them not to disappear, choose Menu/Show all.

Use Cases

Exploiting the Stock Quantity Feature

1. Click on a list.
2. Assume the list has items in it. Click on them one at a time to edit them, changing the list to add the number to stock for each item. These will update on the screen and be saved for later use.

Main Screen

1. When the app is launched, it displays a set of shopping lists.
2. If no shopping lists have been created yet, it says, "Click + to start".
3. If the user taps the +, it will bring up a dialog that will let her type the name of a shopping list. If she presses save, it then adds the shopping list. If she presses nothing, then it will ask again for the name of the list. Pressing the back button doesn’t add the list.
4. If the user taps a shopping list, it asks her whether she wants to make a list, go shopping, or to delete the list.
   • If the user wants to make the list, it will take her to the Make a List screen.
   • If the user wants to go shopping, to the Shopping screen.
   • In either of the two previous cases, it should take her to the appropriate screen immediately – no Sqlite delay.
   • If the user wants to delete the list, it should prompt for confirmation, and only delete it if confirmed.
5. TODO Pressing the Info button...
6. TODO Pressing the Settings button...
7. TODO Pressing the Help button...

Make a List

1. It displays the current list of items.
   • Each item has a name and some extra info, with the item name in a larger font size.
2. If the list currently has no items, then it says, “Tap + to add an item”
3. Clicking the Action bar/+ button launches a new dialog where the information for an item can be added.
   • This dialog allows the user to type the name of the item. It will autocomplete from a large list of items that grocery stores typically stock. Clicking the Android official “pencil” icon (edit) will bring up an edit dialog.
   • The edit dialog allows the user to edit the item or add extra information (price, size, unit, and number to stock). It also has buttons for save, cancel, and delete item.
     • If we are at this screen to edit an item, it will be loaded with that item’s info.
     • If we are at this screen to add an item, it will be loaded with defaults for size (1), unit (“unit”), and number to stock (1). If it was a new item and was saved, it should be added to the top of the list.
     • Deleting the item removes it from the screen and the DB.
     • Tapping save adds it to the screen and the DB.
     • Tapping cancel or the back button will leave the item unchanged.
4. Each list item has a "Buy n" button, a reset button, and the name and some info about the item.
5. Clicking the "Buy n" button increments it by 1.
6. Clicking the "reset" button resets the number to buy back to 0.
7. Clicking the name/info of the item launches a new dialog where that item can be edited or deleted.
8. Choosing Action/Reset quantities to 0 will reset all the item quantities to 0.
9. Choosing the Shopping action item moves directly to the "Go Shopping" screen with that list loaded.
10. TODO: ONLY FOR DEV Choosing Menu/Use basic list will remove all modifications to the list (by reloading the basic default list). (Currently adds the basic default list to the current one)
11. Pressing the back button (or Action/Up) brings the user back to the main screen.
12. Pressing the Sort action item brings up a screen where the items can be sorted.
13. When entering or leaving this screen, all items should be reset to “not bought”.
    • Better to reset when entering the screen?

Go Shopping

1. The screen displays a list of all items that have a non-zero quantity.
2. Each item has a large checkbox next to it that when pressed, signifies that the item has been bought.
   • In "hide bought" display mode, it hides them from the list altogether
   • In "show all" display mode, it just checks them off.
3. Choosing Action bar/Up brings the user back to the main screen.
4. Choosing Action bar/Show all (or Hide bought) toggles the display mode.
5. Choosing Action Bar/Uncheck all with this list unchecks all the items.
6. Clicking the Action bar/+ button launches a dialog where the information for an item can be added (see similar story in Make a List user stories).
7. Rotation is disabled so that the database doesn’t need to reload every time the phone is rotated accidentally.
8. Tapping an item brings up the edit dialog (see similar story in Make a List user stories)
9. Pressing the Sort action item brings up a screen where the items can be sorted.

Rearrange List

1. We can get to the screen from the Make a List screen or for the Go Shopping screen.
2. The screen displays the list of items, in the order currently used.
   • Each item has an icon next to it that can be dragged.
   • As the items are dragged, the order of the list is re-arranged.
3. Clicking the save button at the bottom of the screen stores the modified list in the DB.
4. Clicking the cancel button at the bottom of the screen discards all the changes.

Preferences

The settings/preferences screen will control font size and currency type (position and symbol).

About/Help

TODO