Basket Management¶

operational commerce

Customers can build, modify and calculate a basket of intended purchases before checkout.

Manages the customer's pre-purchase selection across all channels. Handles basket creation, item addition and removal, quantity adjustment, real-time price and promotion recalculation, and basket persistence (saved, abandoned, merged). Provides the consistent basket state that checkout, promotions, and inventory reservation capabilities consume.

Overview¶


ID	`basket-management`
Domain	commerce
Classification	`operational`
Actors	`customer`, `store-associate`, `system`
Services	5
Events	6
Processes	6
Applications	3

Services¶

ID	Name	Description
`create-basket`	Create Basket	Creates a new empty basket session for a customer on a given channel, returning the basket ID for subsequent item additions.
`add-basket-item`	Add Basket Item	Adds a product variant and quantity to an existing basket, triggering real-time price resolution and availability check.
`remove-basket-item`	Remove Basket Item	Removes a specific line from the basket and recalculates basket totals.
`calculate-basket`	Calculate Basket	Recalculates basket totals applying current prices, active promotions, and tax rules, returning the updated basket summary.
`checkout-basket`	Checkout Basket	Marks the basket as checked out and initiates the checkout flow, locking the basket from further modification.

Events Emitted¶

Event	Subject	Description
`basket-created`	``	A new shopping basket was created for a customer or anonymous session.
`basket-updated`	``	One or more items or quantities in the basket were modified.
`basket-calculated`	``	Prices, promotions, and totals were recalculated for the basket.
`basket-abandoned`	``	The basket was marked as abandoned after a period of inactivity.
`basket-merged`	``	Two baskets (e.g. anonymous and authenticated) were merged into a single basket.
`basket-line-added`	``	A product line was added to an active basket, updating the basket total and triggering promotion evaluation.

Processes¶

Process	Name	Classification
`checkout`	Checkout	transactional
`endless-aisle`	Endless Aisle	transactional
`clienteling-sale`	Clienteling Sale	transactional
`voucher-redemption`	Voucher Redemption	transactional
`self-checkout`	Self-Checkout	transactional
`scan-and-go`	Scan and Go	transactional

Applications¶

Application	Name	Tier
`pos`	POS
`ecommerce-platform`	eCommerce Platform
`clienteling-app`	Clienteling App

Lifecycle¶

Lifecycle	States	ID
Basket Lifecycle	5 states	basket-lifecycle
Basket Line Lifecycle	5 states	basket-line-lifecycle

Metrics & KPIs¶

Metric	Alias	Unit	Direction
Average Order Value	AOV	currency	↑
Conversion Rate	CR	percentage	↑
Cart Abandonment Rate	CAR	percentage	↓
Units Per Transaction	UPT	count	↑

Touchpoints¶

Touchpoint	Type
💻 Web Store	Digital
💻 Mobile App	Digital
🏪 Physical Store	Physical
🏪 Self-Service Kiosk	Physical
🏪 Clienteling Tablet	Physical
💻 Partner / B2B API	Digital
🏪 Associate Mobile Workspace	Physical
🏪 SoftPOS Device	Physical

Validation Rules¶

Rule	Type	Applies To	Severity
`checkout-requires-active-basket`	`pre-condition`	`checkout`	invariant
`checkout-requires-active-product`	`pre-condition`	`checkout`	invariant
`voucher-redemption-requires-valid-voucher`	`pre-condition`	`voucher-redemption`	invariant
`endless-aisle-requires-active-channel`	`pre-condition`	`endless-aisle`	invariant
`self-checkout-requires-active-terminal`	`pre-condition`	`self-checkout`	invariant
`checkout-creates-order`	`post-condition`	`checkout`	invariant
`checkout-clears-basket`	`post-condition`	`checkout`	invariant