User Story Testing Documentation: From Acceptance Criteria to Test Validation

Given I am a logged-in customer
When I click the "Add to Wishlist" button on a product page
Then the item should be added to my wishlist
And a confirmation message should appear
And the wishlist counter should increment by 1

- User can add items to wishlist from product detail page
- User can add items to wishlist from search results
- Wishlist icon displays current item count
- Maximum of 100 items allowed in wishlist
- Duplicate items are not added (warning shown instead)
- Wishlist persists across sessions

Business Rule: Wishlist Management
- IF user is not logged in THEN show login prompt when adding to wishlist
- IF item already in wishlist THEN show "Already in wishlist" message
- IF wishlist has 100 items THEN disable "Add to Wishlist" button
- IF item is out of stock THEN still allow adding to wishlist

Scenario 1: Add item to wishlist from product page
  Given I am logged in as a registered customer
  And I am viewing a product detail page
  And the product is not already in my wishlist
  When I click the "Add to Wishlist" button
  Then the product should be added to my wishlist
  And I should see a success message "Item added to your wishlist"
  And the wishlist icon counter should increase by 1

Scenario 2: Prevent duplicate items in wishlist
  Given I am logged in as a registered customer
  And I have product "ABC123" in my wishlist
  When I attempt to add product "ABC123" to my wishlist again
  Then the product should not be added
  And I should see a message "This item is already in your wishlist"

Scenario 3: Wishlist capacity limit
  Given I am logged in as a registered customer
  And my wishlist contains 100 items
  When I attempt to add another item to my wishlist
  Then the item should not be added
  And I should see a message "Wishlist is full. Maximum 100 items allowed."

Scenario 4: Unauthenticated user access
  Given I am not logged in
  When I click the "Add to Wishlist" button
  Then I should be redirected to the login page
  And after successful login, the item should be added to my wishlist

## Test Scenario TS-WISH-001: Add Product to Wishlist

**User Story:** US-2024-156 - Wishlist Feature
**Priority:** High
**Type:** Functional

### Preconditions
- User account exists (email: test.user@example.com, password: Test@123)
- User is logged in
- Product catalog contains test product (SKU: PROD-001)
- User's wishlist is empty

### Test Steps
1. Navigate to homepage (https://example.com)
2. Search for product with SKU "PROD-001"
3. Click on the product to open detail page
4. Locate the "Add to Wishlist" button (heart icon)
5. Click the "Add to Wishlist" button
6. Observe the confirmation message
7. Navigate to Wishlist page
8. Verify product appears in wishlist

### Expected Results
- Step 5: Button should be clickable and respond to click
- Step 6: Success message appears: "Item added to your wishlist"
- Step 6: Wishlist counter icon updates from "0" to "1"
- Step 8: Product "PROD-001" appears in wishlist with correct details (name, price, image)
- Step 8: Wishlist shows "1 item"

### Postconditions
- Wishlist contains exactly 1 item
- Database record created in `user_wishlists` table
- User remains logged in

### Test Data
| Field | Value |
|-------|-------|
| Username | test.user@example.com |
| Password | Test@123 |
| Product SKU | PROD-001 |
| Product Name | Premium Wireless Headphones |
| Product Price | $199.99 |

Feature: Wishlist Management
  As a registered customer
  I want to manage a wishlist of products
  So that I can save items for future purchase

  Background:
    Given the following users exist:
      | email                  | password  | status |
      | customer@example.com   | Pass@123  | active |
    And the following products exist:
      | sku      | name                    | price   | stock |
      | PROD-001 | Wireless Headphones     | 199.99  | 50    |
      | PROD-002 | Bluetooth Speaker       | 89.99   | 0     |
      | PROD-003 | USB-C Cable            | 12.99   | 200   |

  Scenario: Successfully add in-stock product to wishlist
    Given I am logged in as "customer@example.com"
    And I am on the product detail page for "PROD-001"
    And my wishlist is empty
    When I click the "Add to Wishlist" button
    Then the product "PROD-001" should be added to my wishlist
    And I should see a success notification "Item added to your wishlist"
    And the wishlist counter should display "1"
    And the "Add to Wishlist" button should change to "In Wishlist"

  Scenario: Add out-of-stock product to wishlist
    Given I am logged in as "customer@example.com"
    And I am on the product detail page for "PROD-002"
    And product "PROD-002" has 0 stock
    When I click the "Add to Wishlist" button
    Then the product "PROD-002" should be added to my wishlist
    And I should see a success notification "Item added to your wishlist"
    And I should see a badge "Out of Stock" on the wishlist item

  Scenario: Prevent duplicate items in wishlist
    Given I am logged in as "customer@example.com"
    And my wishlist contains the following products:
      | sku      |
      | PROD-001 |
    When I navigate to product detail page for "PROD-001"
    And I click the "Add to Wishlist" button
    Then I should see a warning notification "This item is already in your wishlist"
    And the wishlist should still contain 1 item
    And the wishlist counter should display "1"

  Scenario Outline: Wishlist capacity validation
    Given I am logged in as "customer@example.com"
    And my wishlist contains <current_items> items
    When I attempt to add a new product to my wishlist
    Then the operation should be <result>
    And I should see the message "<message>"

    Examples:
      | current_items | result  | message                                          |
      | 99            | success | Item added to your wishlist                      |
      | 100           | failure | Wishlist is full. Maximum 100 items allowed.    |
      | 50            | success | Item added to your wishlist                      |

  Scenario: Unauthenticated user attempts to add to wishlist
    Given I am not logged in
    And I am on the product detail page for "PROD-001"
    When I click the "Add to Wishlist" button
    Then I should be redirected to the login page
    And I should see the message "Please log in to add items to your wishlist"
    And the product detail page URL should be saved for redirect after login

  Scenario: Successfully redirected after login with wishlist action
    Given I am not logged in
    And I am on the product detail page for "PROD-001"
    And I have clicked the "Add to Wishlist" button
    And I have been redirected to the login page
    When I log in with email "customer@example.com" and password "Pass@123"
    Then I should be redirected back to the product detail page for "PROD-001"
    And the product "PROD-001" should be automatically added to my wishlist
    And I should see a success notification "Item added to your wishlist"

const { Given, When, Then } = require('@cucumber/cucumber');
const { expect } = require('chai');

Given('I am logged in as {string}', async function (email) {
  await this.loginPage.open();
  await this.loginPage.login(email, 'Pass@123');
  const isLoggedIn = await this.navigation.isUserLoggedIn();
  expect(isLoggedIn).to.be.true;
});

Given('I am on the product detail page for {string}', async function (sku) {
  await this.productPage.openProductBySKU(sku);
  const displayedSKU = await this.productPage.getProductSKU();
  expect(displayedSKU).to.equal(sku);
});

Given('my wishlist is empty', async function () {
  await this.wishlistAPI.clearWishlist(this.currentUser.id);
  const itemCount = await this.wishlistPage.getItemCount();
  expect(itemCount).to.equal(0);
});

When('I click the {string} button', async function (buttonText) {
  await this.productPage.clickButton(buttonText);
});

Then('the product {string} should be added to my wishlist', async function (sku) {
  const wishlistItems = await this.wishlistAPI.getWishlistItems(this.currentUser.id);
  const productInWishlist = wishlistItems.find(item => item.sku === sku);
  expect(productInWishlist).to.exist;
});

Then('I should see a success notification {string}', async function (message) {
  const notification = await this.notification.getMessage();
  expect(notification).to.equal(message);
});

@REQ-WISH-001 @US-2024-156 @priority:high @regression
Scenario: Successfully add in-stock product to wishlist
  Given I am logged in as "customer@example.com"
  When I click the "Add to Wishlist" button
  Then the product should be added to my wishlist

{
  "test_case_id": "TC-WISH-001-01",
  "title": "Add product to wishlist - Happy path",
  "requirement_id": "REQ-WISH-001",
  "user_story_id": "US-2024-156",
  "acceptance_criteria_id": "AC-WISH-001",
  "priority": "High",
  "automated": true,
  "automation_id": "wishlist.feature:15"
}

## Definition of Done - User Story US-2024-156

### Code Quality
- [ ] Code reviewed by at least 2 team members
- [ ] No critical or high-priority SonarQube violations
- [ ] Code coverage ≥ 80% for new code
- [ ] All compiler warnings resolved

### Testing
- [ ] All acceptance criteria have corresponding test cases
- [ ] Unit tests written and passing (12/12 passed)
- [ ] Integration tests written and passing (5/5 passed)
- [ ] Regression tests executed and passing (All passed)
- [ ] Exploratory testing completed (2 hours)
- [ ] No critical or high-priority defects open

### Documentation
- [ ] API documentation updated (if applicable)
- [ ] User documentation updated
- [ ] Test cases documented in TestRail
- [ ] Release notes entry created

### Non-Functional Requirements
- [ ] Performance requirements met (page load < 2s)
- [ ] Accessibility standards met (WCAG 2.1 Level AA)
- [ ] Security scan completed with no high-risk findings
- [ ] Cross-browser testing completed (Chrome, Firefox, Safari, Edge)
- [ ] Mobile responsive design verified

### Deployment
- [ ] Feature flag configured (if applicable)
- [ ] Database migrations tested
- [ ] Deployed to staging environment
- [ ] Smoke tests passed in staging
- [ ] Product Owner acceptance obtained

**Validated By:** Jane Smith, QA Lead
**Date:** 2025-10-08
**Status:** ✅ DONE

# DoD Validation Report

**User Story:** US-2024-156 - Wishlist Feature
**Sprint:** Sprint 24
**Validation Date:** 2025-10-08
**QA Engineer:** Jane Smith

## Summary
All Definition of Done criteria have been met. The user story is ready for production deployment.

## Detailed Validation Results

### 1. Functional Testing
| Criterion | Status | Evidence | Notes |
|-----------|--------|----------|-------|
| All acceptance criteria tested | ✅ Pass | TestRail Suite ID: 2456 | 15/15 test cases passed |
| Edge cases covered | ✅ Pass | Test scenarios: TS-WISH-001 to TS-WISH-008 | Including boundary conditions |
| Error handling validated | ✅ Pass | Negative test cases: 8/8 passed | All error messages verified |

### 2. Automation Coverage
| Criterion | Status | Evidence | Notes |
|-----------|--------|----------|-------|
| Automated tests created | ✅ Pass | Cucumber scenarios: 12 | All scenarios automated |
| CI/CD pipeline passing | ✅ Pass | Jenkins Build #456 | All stages green |
| Automated tests in regression suite | ✅ Pass | Added to regression-wishlist.feature | Tagged with @regression |

### 3. Performance Validation
| Metric | Target | Actual | Status |
|--------|--------|--------|--------|
| API response time | < 500ms | 234ms | ✅ Pass |
| Page load time | < 2s | 1.6s | ✅ Pass |
| Concurrent users supported | 1000 | 1200 | ✅ Pass |

### 4. Security Testing
- ✅ OWASP Top 10 checklist completed
- ✅ Input validation verified
- ✅ SQL injection testing passed
- ✅ XSS vulnerability testing passed
- ✅ Authentication/authorization verified

### 5. Documentation
- ✅ Test cases documented: TestRail Project WISH
- ✅ Test execution results recorded
- ✅ Defects logged and resolved: 3 defects found and fixed
- ✅ Traceability matrix updated

## Sign-Off
- QA Lead: Jane Smith - Approved ✅
- Product Owner: Mike Johnson - Accepted ✅
- Date: 2025-10-08