[taler-docs] branch master updated: order creation

[gnunet]

This is an automated email from the git hooks/post-receive script.

sebasjm pushed a commit to branch master
in repository docs.

The following commit(s) were added to refs/heads/master by this push:
     new 0918154  order creation
0918154 is described below

commit 091815423d7a852000589911f543920297eb5c6f
Author: Sebastian <sebasjm@gmail.com>
AuthorDate: Mon Apr 5 15:21:35 2021 -0300

    order creation
---
 backoffice-order-create.svg                        | 16 ++++++
 .../016-backoffice-order-management.rst            | 67 ++++++++++++++++++++--
 2 files changed, 79 insertions(+), 4 deletions(-)

diff --git a/backoffice-order-create.svg b/backoffice-order-create.svg
new file mode 100644
index 0000000..0d8dedb
--- /dev/null
+++ b/backoffice-order-create.svg
@@ -0,0 +1,16 @@
+<svg version="1.1" xmlns="http://www.w3.org/2000/svg"; viewBox="0 0 812 
1626.1818181818185" width="812" height="1626.1818181818185">
+  <!-- svg-source:excalidraw -->
+  <!-- payload-type:application/vnd.excalidraw+json --><!-- payload-version:2 
--><!-- payload-start 
-->eyJ2ZXJzaW9uIjoiMSIsImVuY29kaW5nIjoiYnN0cmluZyIsImNvbXByZXNzZWQiOnRydWUsImVuY29kZWQiOiJ4nO19WXPiSrb1+/lcdTAwMTVcdTAwMTXV8b016pyHflx1MDAwM1x1MDAxYoPBmNFg+35cdTAwMWRcdTAwMDSzXHUwMDE5xTzd6P9+M3GVzaBcdTAwMTTCZpDrXHUwMDE4n1NRXHUwMDA1kixSa++99s6VO//3r1x1MDAxZj9+jlx1MDAxN/3az3//+FmbV0qdZnVYmv38p35/Wlx1MDAxYo6adk99hFb/XHUwMDFl2ZNhZXXky3jcXHUwMDFm/ftf/3o/w6rY3dezap1at9ZcdTAwMWKP1HH/o/7948f/rv5Un
 [...]
+  <defs>
+    <style>
+      @font-face {
+        font-family: "Virgil";
+        src: url("https://excalidraw.com/Virgil.woff2";);
+      }
+      @font-face {
+        font-family: "Cascadia";
+        src: url("https://excalidraw.com/Cascadia.woff2";);
+      }
+    </style>
+  </defs>
+  <rect x="0" y="0" width="812" height="1626.1818181818185" 
fill="#ffffff"></rect><g transform="translate(474.0504688819253 
520.1830765604968) rotate(0 82.5 20.5)"><path d="M0 0 C0 0, 0 0, 0 0 M0 0 C0 0, 
0 0, 0 0 M-0.2614568240614483 6.397784017075889 C1.8154457956847145 
4.008580858445354, 3.8923484154308774 1.6193776998148186, 4.98701540786261 
0.36010737529371317 M-0.2614568240614483 6.397784017075889 C1.5477970493397954 
4.316475520472858, 3.3570509227410392 2.2351670238698276, 4.987015 [...]
\ No newline at end of file
diff --git a/design-documents/016-backoffice-order-management.rst 
b/design-documents/016-backoffice-order-management.rst
index 61f17d1..d53a23a 100644
--- a/design-documents/016-backoffice-order-management.rst
+++ b/design-documents/016-backoffice-order-management.rst
@@ -67,10 +67,49 @@ An infinity scroll is propose instead of a pagination, 
reasons:
 Create orders
 -------------
 
-Form with 2 fields from MinimalOrderDetail:
 
-* amount
-* summary
+
+* ``product``: optional, collapsed by default
+
+  * ``name``: search box to select product by description field. if not found 
it
+    will be a 'create new' option leading to the create product without loosing
+    context
+  * ``quantity``: mandatory
+  * ``price``: taken from the product, but it can be overridden.
+  * ``add button``: will add the product to the list and calculate the total 
price
+
+
+* ``amount``: default to the total price of product, but can be overridden. If
+  overridden, show a message with the discount in %
+
+* ``summary``: order description
+
+* ``fulfillment url``: url where the user will land after buying the product
+
+* ``payment``: all values should have default from instance configuration
+
+  * ``exchanges``: default value from the instance, new exchanges will be added
+    using the url and public key will be taken from querying the url
+
+  * ``auditors``: default value from the instance, new auditors will be added 
using
+    the url and name/pub_key will be taken from querying the url
+
+  * ``wire method``: it should select one of supported from exchanges
+  * ``refund deadline``: calendar type of input
+  * ``pay deadline``: calendar type of input
+  * ``auto refund deadline``: calendar type of input
+  * ``max fee``: default value from the instance
+
+  * ``max wire fee``: default value from the instance
+
+  * ``wire_fee_amortization``: default value from the instance
+
+There were field not considered for this form, check Alternatives for more
+information.
+
+.. image:: ../backoffice-order-create.svg
+  :width: 800
+
 
 Creation order success
 **********************
@@ -142,7 +181,7 @@ This section is not going to be shown if there is no error
   in the list show hint and error code
 
 * Exchange Error: connection with exchange failed, info taking from exchange_ec
-  and exhange_hc
+  and exchange_hc
 
 Payment details
 ***************
@@ -276,3 +315,23 @@ Discussion / Q&A
   * claimed => paid (maybe last wire_details.execution_time with confirmed = 
true )
   * unpaid => claimed (maybe contractTerm.timestamp)
 
+* Refund button is being show if "not refunded" and "time < refund deadline".
+  should we consider partial refund?
+
+* Field left out in the order creation:
+ 
+  * contractTerm.summary_i18n: it makes the UI complex
+  * contractTerm.order_id: should be created by the backend
+  * contractTerm.timestamp: defined by backend
+  * contractTerm.merchant_pub: filled by the backend
+  * contractTerm.merchant_base_url: filled by the backend
+  * contractTerm.h_wire: defined by the backend
+  * contractTerm.delivery_location: not used
+  * contractTerm.delivery_date: not used
+  * contractTerm.nonce: not used
+  * contractTerm.products[].description: defined by product_id
+  * contractTerm.products[].description_i18n: defined by product_id
+  * contractTerm.products[].unit: defined by product_id
+  * contractTerm.products[].image: defined by product_id
+  * contractTerm.products[].delivery_date: not used
+  * contractTerm.products[].taxes: defined by product_id

-- 
To stop receiving notification emails like this one, please contact
gnunet@gnunet.org.