From 7e4e5549541fd0a5bacd574b98812f19142cc9b5 Mon Sep 17 00:00:00 2001 From: Sebastian Date: Fri, 19 Mar 2021 19:21:00 -0300 Subject: inventory management design document --- .../016-backoffice-order-managment.rst | 24 +++--- .../017-backoffice-inventory-managment.rst | 96 +++++++++++++++++++++- 2 files changed, 104 insertions(+), 16 deletions(-) (limited to 'design-documents') diff --git a/design-documents/016-backoffice-order-managment.rst b/design-documents/016-backoffice-order-managment.rst index 6716c24f..1fba8f33 100644 --- a/design-documents/016-backoffice-order-managment.rst +++ b/design-documents/016-backoffice-order-managment.rst @@ -17,7 +17,7 @@ Requirements ============ Access all information provided from the Merchant Backend API in a -understandable and accesible way +understandable and accessible way User should use the backoffice to manage orders by: @@ -32,7 +32,7 @@ Proposed Solution Listing orders -------------- -.. image:: ../backoffice-order-list.v2.svg +.. image:: ../backoffice-order-list.svg :width: 800 Will show the SearchBar component that allow multiple filter. @@ -67,10 +67,10 @@ An export button will allow the user to download the result page in CSV format. An infinity scroll is propose instead of a pagination, reasons: -* users usually does not jump from one page to anoter using random access +* users usually does not jump from one page to another using random access * if the user want to search, is going to limit the result using filters * no need to go back after loading more result -* it could be triggered by scrollin, with buttons (or both) +* it could be triggered by scrolling, with buttons (or both) Create orders ------------- @@ -102,7 +102,7 @@ action buttons that allow the following: Order details ------------- -Status text should be set with a backgournd color for easier recognition when +Status text should be set with a background color for easier recognition when indicated: * paid: green @@ -172,7 +172,7 @@ collapsed as default. show disabled if unpaid * total tax * sum at the bottom -* horizontal timeline of importants dates in the contract +* horizontal timeline of important dates in the contract * start at contract creation time * show current date @@ -199,7 +199,7 @@ If there is any refund: * show total refund from ``refund_amount`` * a + sign to show more information -* if exapanded show a timeline vertically showing amount a reason +* if expanded show a timeline vertically showing amount a reason ``refund_details`` Show a small notice telling that the refund is going to take ``refund_delay`` time. @@ -212,13 +212,13 @@ Ask for: * reason: concatenation of the next values * drop down options: duplicated, fraudulent, requested by customer, other - * aflter selecting, free text for aditional information + * after selecting, free text for additional information Alternatives ============ -order list was originaly thought with pagination footer +order list was originally thought with pagination footer .. image:: ../backoffice-order-list.v2-pagination.svg :width: 800 @@ -227,12 +227,12 @@ ascending boolean flag cloud be eliminated using the load before and load after and a design without random access to pages was proposed -Q&A -=== +Discussion / Q&A +================ * Shall we show merchant information from the ContractTerm in the order detail? -* Order creation was first thouth as out of scope but should be useful for +* Order creation was first thought as out of scope but should be useful for testing purpose or when frontend is not yet integrated with taler merchant backend. Shall we skip it? diff --git a/design-documents/017-backoffice-inventory-managment.rst b/design-documents/017-backoffice-inventory-managment.rst index f896c449..e8c1a333 100644 --- a/design-documents/017-backoffice-inventory-managment.rst +++ b/design-documents/017-backoffice-inventory-managment.rst @@ -4,18 +4,19 @@ Design Doc 017: Backoffice Inventory Management Summary ======= -This document describe the complete list features for inventory management and how -will be shown. +This document describe the complete list features for inventory management and +how will be shown. Motivation ========== +User will use the backoffice to manage their inventory, prices and update stock. Requirements ============ Access all information provided from the Merchant Backend API in a -understandable and accesible way +understandable and accessible way User should use the backoffice to manage inventory by: @@ -23,19 +24,106 @@ User should use the backoffice to manage inventory by: * updating the products information * inspecting inventory list * deleting products from the inventory list -* accesing detailed information of a product Proposed Solution ================= +Inspecting inventory +-------------------- +.. image:: ../backoffice-product-list.svg + :width: 800 +Listing the product will shown this columns: + +* image +* description +* sell price +* total taxes +* profit (price - taxes) +* stock left (with next_restock in days if present) +* stock sold + +Actions will be + +* modify +* delete: with a confirm popup, it may fail if have some locked + +Create and Update Product form +------------------------------ + +Creating without stock +********************** + +.. image:: ../backoffice-product-create.with-stock.svg + :width: 800 + +Creating with defined stock +*************************** + +.. image:: ../backoffice-product-create.without-stock.svg + :width: 800 + +Updating +*************************** + +.. image:: ../backoffice-product-update.svg + :width: 800 + +Update product will use the same form except for the ``product_id`` + +* product_id: BACKOFFICE_URL + id +* description: split in two fields, concatenated with a line separator + + * name: required, one line + * extra: optional, free text area + +* description localized: list with + + * lang: dropdown list with supported lang + custom + * description: text area + +* unit: string +* price: amount +* image: image box that allows upload when clicked +* taxes: list with + + * name: string + * value: amount + +* Stock: button that opens more fields for stock control + + * initial stock: number + * address: first collapsed, then field for Location + * next_restock: date + * cancel: button to set the stock to infinity, closing the section + + Alternatives ============ +* price and stock columns in the list can be merged into a more complex column + with the same information +* rows in the table can be expandable when clicked to get access to some common + actions like increase stock or change price +.. image:: ../backoffice-product-list.actions.svg + :width: 800 + +* detail page was intentionally left out since all information can be access + from the update page Q&A === +* can we add the quantity locked in the product description? so we can add it + to the inventory list to reflect the current activity. + +* can we allow add extra data like order has in contractTerm?, this could be + useful for frontend apps. example of usage: country/state to where the product + is sold since taxes may vary + + + + -- cgit v1.2.3