Cart — User Stories¶
User stories related to the Cart domain: adding products and selecting fulfillment methods.
| ID | Story | Role |
|---|---|---|
| US-CA01 | Add a product variant to my cart | Customer |
| US-CA02 | View available fulfillment methods for my cart | Customer |
| US-CA03 | Select an available fulfillment method for my cart | Customer |
| US-CA04 | Cannot select an unavailable fulfillment method | Customer |
Add to Cart¶
US-CA01 · Add a Product (Variant) to my Cart¶
User Story
As a customer, I want to add a product (variant) to my shopping cart, so that I can proceed to purchase it.
Acceptance Criteria
- I can add a product variant to my cart from the product detail page.
- I can add a product variant to my cart from the product listing page (quick add).
- The cart icon in the navigation header updates with the new item count immediately.
- I receive a visual confirmation (e.g. slide-in cart panel or toast notification).
- The selected quantity defaults to 1 and can be adjusted before adding.
- If the product is out of stock, the add-to-cart button is disabled.
- If the desired quantity exceeds available stock, I am informed of the maximum available quantity.
Notes
- For the full set of conditions that block ordering (K3 status, webshop status, orderable flag, stock thresholds), see Stock Statuses & Orderability.
Fulfillment Methods¶
US-CA02 · View Available Fulfillment Methods for my Cart¶
User Story
As a customer, I want to see all available fulfillment methods for my cart, so that I can choose how I want to receive my order.
Acceptance Criteria
- During checkout, all fulfillment methods applicable to my cart are displayed.
- Each fulfillment method shows its name, estimated delivery time, and any associated cost.
- Fulfillment methods are determined based on cart contents (e.g. weight, dimensions, product type) and delivery address.
- Methods that are not available are not shown (or shown as unavailable with an explanation).
Notes
- Fulfillment methods include PostNL shipment options and potentially click-and-collect.
- Availability of methods is evaluated by the Zwerfkei Backend based on the Fulfilment domain rules.
US-CA03 · Select an Available Fulfillment Method for my Cart¶
User Story
As a customer, I want to select a fulfillment method for my cart, so that I can specify how my order will be delivered.
Acceptance Criteria
- I can select one fulfillment method from the list of available options.
- After selecting a method, the order summary updates to reflect any associated shipping costs.
- My selection is retained if I navigate back to a previous checkout step.
- I cannot proceed to the payment step without selecting a fulfillment method.
US-CA04 · Cannot Select an Unavailable Fulfillment Method¶
User Story
As a customer, I want to be prevented from selecting a fulfillment method that is not available for my cart, so that I do not place an order that cannot be fulfilled.
Acceptance Criteria
- Fulfillment methods that are not applicable to my cart are either hidden or clearly marked as unavailable.
- Unavailable methods cannot be selected (disabled state).
- When a method becomes unavailable due to a cart change (e.g. adding a heavy item), I am notified and my previous selection is cleared.
Notes
- Unavailability reasons may include: delivery address restrictions, product dimensions/weight exceeding limits, or carrier-specific restrictions.