Use Cases Demo 3 - COS301-SE-2026/Mealchemy GitHub Wiki
Please scroll down.
Use Cases
Acronyms
TUCBW - This use case begins with
TUCEW - This use case ends with
Profile and Preferences Use Case Diagram
1: Register
TUCBW the user opens the registration screen and enters their required account details.
TUCEW the user account is created and the user can proceed to set up their profile and preferences.
2: Log In
TUCBW the user enters their email address and password on the login screen and clicks "Log in."
TUCEW the user is authenticated and redirected to the application home screen.
3: Sign Out
TUCBW the logged-in user selects the sign out option from their account or profile area.
TUCEW the user session is ended and the user is returned to the login screen.
4: Manage User Profile
TUCBW the logged-in user opens the user profile section.
TUCEW the user has viewed or updated their profile details, including display name, profile picture, preferred units, and available cooking equipment.
5: Manage Preference Profile
TUCBW the logged-in user opens the preference profile section.
TUCEW the user has viewed or updated their saved food preferences.
6: Set Dietary Restrictions
TUCBW the user opens the dietary restrictions section in their preference profile.
TUCEW the user has selected and saved their dietary restrictions.
7: Set Allergies
TUCBW the user opens the allergies section in their preference profile.
TUCEW the user has selected and saved their allergy constraints.
8: Set Disliked Ingredients
TUCBW the user opens the disliked ingredients section in their preference profile.
TUCEW the user has added or removed disliked ingredients from their preference profile.
9: Set Flavour Profile
TUCBW the user opens the flavour profile section in their preference profile.
TUCEW the user has selected and saved their preferred flavour profile.
10: Set Nutritional Goals
TUCBW the user opens the nutritional goals section in their preference profile.
TUCEW the user has selected and saved their nutritional goals.
11: Set Cooking Equipment
TUCBW the user opens the cooking equipment section in their profile.
TUCEW the user has selected and saved the cooking equipment available to them.
12: Set Preferred Units
TUCBW the user opens the preferred units section in their profile.
TUCEW the user has selected and saved their preferred unit system, such as metric or imperial.
Vaults and Vault Folders Use Case Diagram
1: View Recipe Vault
TUCBW the logged-in user navigates to their recipe vault. TUCEW the user can see all saved recipes and folders in their personal vault.
2: Create Recipe Folder
TUCBW the logged-in user selects the option to create a new folder within their recipe vault and enters a folder name.
TUCEW the new folder is created and appears in the user's vault, ready to have recipes moved into it.
3: Browse Global Vault
TUCBW the logged-in user navigates to the global vault.
TUCEW the user can see all the recipes that have been published to the community repository.
4: Save Recipe from Global Vault
TUCBW the logged-in user browses the global vault and selects a recipe to save.
TUCEW a copy of the recipe is added to the user's personal vault and can be edited independently of the original.
5: Manage Shared Vault
TUCBW the logged-in user navigates to a shared vault they own.
TUCEW the user can view the vault's current members, recipes, and folders, and access member and content management options.
6: Add Member to Shared Vault
TUCBW the logged-in user opens the member management section of a shared vault they own and enters the details of the user to add.
TUCEW the specified user is added as a member of the shared vault and gains access to its contents.
7: Remove Member from Shared Vault
TUCBW the logged-in user opens the member management section of a shared vault they own and selects a member to remove.
TUCEW the selected user is removed from the shared vault and can no longer access its contents.
8: Upload Recipe to Shared Vault
TUCBW the logged-in user selects a recipe from their personal vault and chooses to upload it to a shared vault they belong to.
TUCEW the recipe is added to the shared vault and becomes accessible to all members of that vault.
9: Save External Links
TUCBW the logged-in user navigates to their External Links folder in their private vault.
TUCEW the external link (URL) is saved with a name to the user's folder and is immediately accessible.
Recipes Use Case Diagram
1: Upload Custom Recipe
TUCBW the logged-in user selects the option to add a custom recipe and enters the recipe title, ingredients, steps, prep time, cook time, and serving size.
TUCEW the recipe is saved to the user's personal vault and is immediately accessible.
2: Upload Optional Recipe Photo
TUCBW the logged-in user selects the option to add a photo to a selected recipe via their photo gallery or camera. TUCEW the recipe is saved with the photo and can be viewed by the user.
3: View Saved Recipe
TUCBW the logged-in user selects a recipe from their vault.
TUCEW the full recipe details including title, ingredients, steps, an optional photo and nutritional information are displayed.
4: Edit Recipe
TUCBW the logged-in user opens a saved recipe and selects the option to edit it.
TUCEW the user has updated one or more recipe fields and the changes are saved to their vault.
5: Edit Optional Recipe Photo
TUCBW the logged-in user opens a saved recipe and selects the option to edit it and replace the photo.
TUCEW the user has updated the photo and the changes are saved to their vault.
6: Delete Optional Photo
TUCBW the logged-in user opens a saved recipe and selects the option to edit it and deletes the photo.
TUCEW the user has removed the photo and the changes are saved to their vault.
7: Delete Recipe
TUCBW the logged-in user selects the option to delete a recipe from their vault and confirms the action.
TUCEW the recipe is permanently removed from the user's vault.
8: Publish Recipe to Global Vault
TUCBW the logged-in user opens a saved recipe and selects the option to publish it to the global vault.
TUCEW the recipe is marked as public and becomes visible to all users in the community repository.
Pantry Use Case Diagram
1: View Pantry Ingredients
TUCBW the logged-in user navigates to their personal pantry.
TUCEW the user can see all the ingredients with details like name, quantity and unit that are currently in their pantry.
2: Add Ingredient to Pantry
TUCBW the logged-in user selects the option to add a pantry ingredient, then searches the catalogue and selects the name and enters the quantity and unit of measure.
TUCEW the ingredient is saved to the user’s pantry and can be view under the corresponding ingredient category.
3: Edit Pantry Ingredient
TUCBW the logged-in user selects the option to edit a pantry ingredient.
TUCEW the user has updated one or more of the pantry ingredient fields and the changes are saved to their pantry.
4: Remove Ingredient from Pantry
TUCBW the logged-in user selects the option to remove a pantry ingredient.
TUCEW the pantry ingredient is permanently removed from their pantry.
Shopping List Use Case Diagram
1. View Shopping Lists
TUCBW the logged-in user navigates to their personal shopping lists.
TUCEW the user can see all their shopping lists with the respective names and number of items.
2. Create Shopping List
TUCBW the logged-in user selects the option to create a new shopping list and enters the new shopping list name.
TUCEW the new list is saved to the user’s shopping lists and is ready for items to be added to it.
3. Generate Shopping List From Recipe
TUCBW the logged-in user selects the option to generate a new shopping list from a recipe. TUCEW the recipe ingredients are added to the user's new or chosen shopping list.
4. Add Recipe Ingredients to a Shopping List
TUCBW the logged-in user selects the option to add ingredients from a selected recipe to an existing shopping list. TUCEW the recipe ingredients are added to the user's shopping list.
5. Delete Shopping List
TUCBW the logged-in user selects the option to delete an entire shopping list.
TUCEW the shopping list and all its items are permanently deleted from the user’s shopping lists.
6. Add Manual Shopping List Item
TUCBW the logged-in user navigates to a shopping list and selects the option to add a new item to the list, then enters the name, quantity and unit of measure of the item.
TUCEW the item is saved to the user’s selected shopping list and can be view under the corresponding category.
7. Remove Item from Shopping List
TUCBW the logged-in user navigates to a shopping list and selects the option to remove an item.
TUCEW the item is permanently removed from the shopping list.
8. Check off Purchased Item
TUCBW the logged-in user navigates to a shopping list and selects items.
TUCEW the items are marked as purchased.
9. Update Pantry from Shopping List
TUCBW the logged-in user navigates to a shopping list and selects the option to update pantry.
TUCEW all the items marked as purchased are automatically added to the user’s personal pantry and permanently removed from the shopping list.
Nutrition, Servings and Unit Conversion Use Case Diagram
1: View Nutritional Calculator
TUCBW the logged-in user navigates to the Nutrition tab in a recipe. TUCEW the user can see the total macro nutrients and other nutritional information calculated for that recipe based on its ingredients and quantities.
2: View Nutritional Calculator Per Serving
TUCBW the logged-in user navigates to the Nutrition tab in a recipe and selects the per serving option. TUCEW the user can see the macro nutrients and other nutritional information calculated per serving for the recipe.
3: View Ingredient Nutrients
TUCBW the logged-in user navigates to the Ingredients drop down section in the Nutrition tab in a recipe. TUCEW the user can see the individual nutrition values (calories, protein, carbs, fat, fibre and sodium) for each ingredient in the recipe.
4: Scale Recipe's Seriving Size
TUCBW the logged-in user navigates to a selected recipe's details and temporarily adjusts the serving size. TUCEW the user can see the recipe's ingredients adjusted accordingly.
5: View Quantities and Units
TUCBW the logged-in user navigates to a recipe, their pantry or shopping list.
TUCEW the user can see all quantites and units of ingredients and items in their preferred measurement system (Metric/Imperial).
Intelligence and Guided Discovery Use Case Diagram
1: View Recommended Recipes
TUCBW the logged-in user navigates to their swipe interface.
TUCEW the user can see a tinder-like swipe interface where recipes are recommended to them based on their preferences.
2: Swipe Right / Like a Recommended Recipe
TUCBW the logged-in user swipes right on the recommended recipe.
TUCEW the recipe is saved to the user's liked recipes folder in their private vault.
3: Swipe Left / Dislike a Recommended Recipe
TUCBW the logged-in user swipes left on the recommended recipe.
TUCEW the recipe is is marked as disliked and will not be rerecommended again for a certain period of time.
4: Preview Recipe details
TUCBW the logged-in user clicks on the recommended.
TUCEW the user can see the recipes details (overview, ingredients, steps and nutritional information).
5: View Liked Recipes
TUCBW the logged-in user navigates to the Liked folder in their private vault.
TUCEW the user can see all the recommended recipes they have liked (swiped right on).
Offline Functionality Use Case Diagram
1: View Cached Vault Offline
TUCBW the user's device loses connectivity while navigating to their recipe vault.
TUCEW the user sees their previously synchronized vaults, folders, and recipes, with a freshness label indicating when the data was last updated.
2: View Cached Recipe Offline
TUCBW the offline user opens a previously synchronized recipe.
TUCEW the full recipe (metadata, ingredients, steps, and image if previously cached) is displayed, or if the recipe was never fully cached, the user is informed it isn't available offline.
3: View Cached Pantry Offline
TUCBW the offline user navigates to their pantry.
TUCEW the user sees their most recently synchronized pantry ingredients, with editing controls disabled.
4: View Cached Shopping Lists Offline
TUCBW the offline user navigates to their shopping lists.
TUCEW the user sees their most recently synchronized lists and items in read-only form, with a freshness label shown.
5: Attempt Mutation While Offline
TUCBW the offline user attempts to create, edit, move, invite, or upload while viewing cached data.
TUCEW the relevant control is disabled and the user sees an explanation that the action requires connectivity.
6: Attempt to Access Global Vault or Discovery Offline
TUCBW the offline user selects the Discovery or Swipe feed.
TUCEW the user sees a message that the feature requires an internet connection and remains on their current screen.
Note: Will be added to throughout the next sprint