## Requirements Snapshot - Feature: save favorite products - User role: logged-in ecommerce customer - Business goal: let customers save products for later - Platform: ecommerce app - Main workflow: user marks/unmarks products as favorites and views saved items - Key risk: unclear login, persistence, and duplicate behavior - Output format: acceptance criteria + UAT tests - Recommended next step: confirm whether favorites require login ## Confirmed Facts - Users should be able to save favorite products. - The product is an ecommerce app. ## Assumptions - Favorites are available only to logged-in users. - Users can favorite/unfavorite from product cards and product detail pages. - Favorited products are stored and visible later. - A Favorites or Wishlist page exists or will be created. ## Open Questions - Can guest users save favorites? - Should favorites sync across devices? - Is there a maximum number of favorite products? - Should users receive a confirmation message? - What happens if a favorited product becomes unavailable? - Is this called Favorites, Wishlist, or Saved Items? ## Refined User Story As a logged-in customer, I want to save products as favorites, so that I can easily find and revisit products I may want to buy later. ## Acceptance Criteria ### Checklist Format - [ ] Logged-in user can add a product to favorites from the product listing page. - [ ] Logged-in user can add a product to favorites from the product detail page. - [ ] User can remove a product from favorites. - [ ] Favorited products appear in the Favorites page/list. - [ ] Favorite status persists after app restart or page refresh. - [ ] A product cannot appear twice in the Favorites list. - [ ] If a product is unavailable, the Favorites list shows an appropriate unavailable state. - [ ] If the user is not logged in, the app prompts them to log in before saving favorites. - [ ] If saving fails, the app shows an error message and does not show a false saved state. ### Given / When / Then Given a logged-in user is viewing a product When they tap the favorite icon Then the product is added to their Favorites list And the favorite icon shows the selected state. Given a product is already favorited When the user taps the favorite icon again Then the product is removed from Favorites And the icon shows the unselected state. Given a guest user is viewing a product When they tap the favorite icon Then the app prompts them to log in or create an account. ## Business Rules - A user can favorite each product only once. - Favorites are tied to the user account. - Removing a product from favorites does not delete the product. - Product availability changes should be reflected in the Favorites list. - Guest behavior requires product decision. ## Test Cases ### TC-001 — Add Product To Favorites - Preconditions: user is logged in - Test data: available product - Steps: 1. Open product detail page. 2. Tap favorite icon. 3. Open Favorites page. - Expected result: product appears in Favorites and favorite icon remains selected. - Priority: high - Type: functional ### TC-002 — Remove Product From Favorites - Preconditions: product is already favorited - Test data: favorited product - Steps: 1. Open Favorites page. 2. Remove product from favorites. - Expected result: product is removed from Favorites. - Priority: high - Type: functional ### TC-003 — Guest User Attempts To Favorite - Preconditions: user is not logged in - Test data: available product - Steps: 1. Open product detail page. 2. Tap favorite icon. - Expected result: app prompts user to log in or create an account. - Priority: high - Type: negative ### TC-004 — Duplicate Favorite Prevention - Preconditions: user is logged in - Test data: same product - Steps: 1. Favorite a product. 2. Tap favorite again or repeat favorite request. 3. Open Favorites page. - Expected result: product appears only once. - Priority: medium - Type: edge ## UAT Script ## UAT Scenario Customer saves and revisits favorite products. ## Business Goal Confirm customers can save products for later and return to them easily. ## Tester Role Business stakeholder or QA tester acting as a customer. ## Preconditions - Test customer account exists. - At least one product is available. - Favorites feature is enabled. ## Test Data - Test user account - Available product - Unavailable product, if possible ## Steps 1. Log in as a customer. 2. Open a product. 3. Add it to favorites. 4. Navigate away. 5. Open Favorites. 6. Confirm the product appears. 7. Remove the product from Favorites. 8. Confirm it is removed. ## Expected Result The customer can add, view, and remove favorite products without duplicate items or incorrect states. ## Pass / Fail [Pass / Fail] ## Notes [Tester notes] ## Edge Cases - Product is already favorited. - Product becomes unavailable. - User logs out and logs back in. - Network fails during favorite action. - Favorite request is submitted twice quickly. - Favorites page is empty. - User uses multiple devices. ## Negative Tests - Guest user tries to favorite product. - API returns error while saving. - User tries to favorite deleted product. - User removes favorite while offline. - User refreshes before save completes. ## Test Data Checklist - [ ] Logged-in user - [ ] Guest user - [ ] Available product - [ ] Unavailable product - [ ] Product already in Favorites - [ ] Empty Favorites list - [ ] Failed API response ## Defect Report Template ## Defect Title Favorite product does not persist after app restart ## Environment [Device / browser / app version] ## Test Case ID [TC-ID] ## Steps To Reproduce [Steps] ## Expected Result [Expected] ## Actual Result [Actual] ## Severity [Low / Medium / High / Critical] ## Evidence [Screenshot / video / logs] ## Notes [Notes] ## Owner / Status [Owner / Status] ## Release-Readiness Checklist - [ ] Acceptance criteria reviewed - [ ] Add favorite tested - [ ] Remove favorite tested - [ ] Guest behavior tested - [ ] Duplicate prevention tested - [ ] Empty Favorites state tested - [ ] Error state tested - [ ] Persistence tested after refresh/restart - [ ] Regression around product listing/detail page checked - [ ] UAT completed - [ ] Known issues documented - [ ] Stakeholder sign-off captured ## Recommended First Step Confirm whether guest users can save favorites or must log in first. Next step: convert this into Jira-ready tickets.