Product — User Stories¶
User stories related to the Product domain: wishlist, product comparison, availability, and pricing.
| ID | Story | Role |
|---|---|---|
| US-C01 | Add a product variant to my wishlist | Customer |
| US-C02 | Remove a product variant from my wishlist | Customer |
| US-C03 | View my wishlist | Customer |
| US-C04 | Add a product to compare | Customer |
| US-C05 | Remove a product from compare | Customer |
| US-C06 | View product comparison | Customer |
| US-C07 | View product availability | Customer |
| US-C08 | View product price breakdown | Customer |
Wishlist¶
US-C01 · Add a Product (Variant) to my Wishlist¶
User Story
As a customer, I want to add a product (variant) to my wishlist, so that I can save products I am interested in and revisit them later.
Acceptance Criteria
- I can add a product variant to my wishlist from the product detail page.
- If I am not logged in, I am prompted to log in or register before the item is saved.
- A product variant can appear in my wishlist only once. Adding a duplicate has no effect (or shows a notification).
- After adding, I receive a visual confirmation (e.g. toast notification or button state change).
- The wishlist item count in the navigation header updates immediately.
Notes
- Wishlist is tied to an authenticated customer account.
- Guest wishlist (session-based) is out of scope for the initial release.
US-C02 · Remove a Product (Variant) from my Wishlist¶
User Story
As a customer, I want to remove a product (variant) from my wishlist, so that I can keep my wishlist relevant and organised.
Acceptance Criteria
- I can remove a product variant from my wishlist from the wishlist overview page.
- I can also remove a product from the product detail page when it is already in my wishlist.
- After removal, I receive a visual confirmation.
- The wishlist item count in the navigation header updates immediately.
US-C03 · View my Wishlist¶
User Story
As a customer, I want to view all products in my wishlist, so that I can review my saved items and decide which ones to add to my cart.
Acceptance Criteria
- I can navigate to an overview of all products in my wishlist.
- Each item displays the product image, name, current price and availability.
- I can add a wishlist item directly to my cart from the wishlist overview.
- If my wishlist is empty, an appropriate message is shown.
Compare¶
US-C04 · Add a Product to Compare¶
User Story
As a customer, I want to add a product to my comparison, so that I can compare multiple products side by side before making a purchase decision.
Acceptance Criteria
- I can add a product to the compare selection from the product listing page or the product detail page.
- A maximum of 4 products can be compared at once. When the limit is reached, I am informed.
- A product can appear in the comparison only once.
- A persistent comparison bar or indicator shows the number of products selected for comparison.
US-C05 · Remove a Product from Compare¶
User Story
As a customer, I want to remove a product from my comparison, so that I can adjust my selection.
Acceptance Criteria
- I can remove a product from the comparison bar or from the comparison overview page.
- After removal, the comparison overview updates immediately.
US-C06 · View Product Comparison¶
User Story
As a customer, I want to compare selected products side by side, so that I can evaluate differences in attributes, price, and availability.
Acceptance Criteria
- I can open the comparison overview showing all selected products in a table layout.
- The table shows key attributes, price, and availability for each product.
- Differences between products are visually highlighted.
- I can add a product directly to my cart from the comparison overview.
- If fewer than 2 products are selected, a message prompts me to add more products.
Availability¶
US-C07 · View Product (Variant) Availability¶
User Story
As a customer, I want to see whether a product (variant) is available, so that I know if I can order it and when I can expect delivery.
Acceptance Criteria
- The product detail page clearly shows the current availability status (e.g. In stock, Limited stock, Out of stock, Pre-order).
- Availability is loaded from Microsoft Dynamics (ERP) in (near) real-time.
- When a product is out of stock, the add-to-cart button is disabled or replaced with a notification option.
- Availability is shown per variant (e.g. size, colour) where applicable.
Notes
- Availability data originates from Microsoft Dynamics via the Zwerfkei Backend.
- For the full list of K3 and webshop statuses, orderable conditions, and stock display logic, see Stock Statuses & Orderability.
Pricing¶
US-C08 · View Product (Variant) Price, Discount, Tax and Uplift¶
User Story
As a customer, I want to see the full price breakdown of a product (variant) — including any discount, applicable tax, and shipping uplift — so that I know exactly what I will pay before adding it to my cart.
Acceptance Criteria
- The product detail page shows the base selling price.
- When a discount applies, both the original price (struck through) and the discounted price are shown.
- The applicable tax (BTW/VAT) is shown or included as configured per customer segment.
- When a shipping uplift applies (e.g. for oversized or heavy products), this is indicated.
- Prices are loaded from Microsoft Dynamics (ERP) and may be customer- or segment-specific.
Notes
- Price components: base price (from supplier/ERP), discount, tax (VAT), shipping uplift.
- Customer-specific pricing (B2C) may differ from the default public price.