Cart flow documented

ezecosystem · Feb 11, 2019 · 7faf166 · 7faf166
1 parent 7c0e68d
commit 7faf166
Show file tree

Hide file tree

Showing 3 changed files with 24 additions and 0 deletions.
diff --git a/docs/book/orders/cart-flow.rst b/docs/book/orders/cart-flow.rst
@@ -0,0 +1,22 @@
+.. index::
+   single: Cart flow
+
+Cart flow
+======
+
+**Cart** in Sylius is an **Order** in the state ``cart``.
+It represents an order that is in progress (not placed yet).
+
+.. note::
+    Each user has their own cart when logged into Sylius. It can be cleared either by placing an order or removing items manually.
+
+There are several cart flows, depending on the user being logged in or what items are currently placed in the cart.
+
+* Not logged in user adds some items to the cart and then logs in as a customer whose cart had not been empty. **It will result in dropping the cart created by an unknown user and load the cart previously created by the logged in customer.**
+* Not logged in user adds some items to the cart and then logs in as a customer whose cart had been empty. **It will result in setting the cart created by an unknown user as a cart that belongs to a logged in customer.**
+* Logged in user adds some items to the cart and then logs out. **Once customer logs out, their cart is not transferred to a session that belongs to an unknown user.**
+
+Learn more
+----------
+
+* :doc:`Carts API </api/carts>`
diff --git a/docs/book/orders/index.rst b/docs/book/orders/index.rst
@@ -19,5 +19,6 @@ with a few additional ones, like promotions, payments, shipments or checkout in
     shipments
     payments
     checkout
+    cart-flow
 
 .. include:: /book/orders/map.rst.inc
diff --git a/docs/book/orders/map.rst.inc b/docs/book/orders/map.rst.inc
@@ -6,3 +6,4 @@
 * :doc:`/book/orders/payments`
 * :doc:`/book/orders/shipments`
 * :doc:`/book/orders/checkout`
+* :doc:`/book/orders/cart-flow`