From dce44d962b5635f05d8ce86beb2c97ffcd821a5c Mon Sep 17 00:00:00 2001
From: piotr-symonowicz <49191214+piotr-symonowicz@users.noreply.github.com>
Date: Tue, 13 Jun 2023 23:44:42 +0200
Subject: [PATCH 01/11] Add hybrid FE design draft

---
 .../14.best-practices/19.hybrid-fe-design/docs.md     | 11 +++++++++++
 1 file changed, 11 insertions(+)
 create mode 100644 pages/03.fe-development/14.best-practices/19.hybrid-fe-design/docs.md

diff --git a/pages/03.fe-development/14.best-practices/19.hybrid-fe-design/docs.md b/pages/03.fe-development/14.best-practices/19.hybrid-fe-design/docs.md
new file mode 100644
index 00000000..76cd68f3
--- /dev/null
+++ b/pages/03.fe-development/14.best-practices/19.hybrid-fe-design/docs.md
@@ -0,0 +1,11 @@
+---
+title: Hybrid FE design using Webhooks, Checkout and Shop APIs
+altTitle: Hybrid FE design
+excerpt: If you're building a larger website, you might want to use both Checkout and Shop APIs to build all your FE functions
+taxonomy:
+  category: docs
+---
+
+## Lorem ipsum
+
+asd

From 05514b1ce5c3edcb61aaee5cd26e91a02b7dd110 Mon Sep 17 00:00:00 2001
From: piotr-symonowicz <49191214+piotr-symonowicz@users.noreply.github.com>
Date: Wed, 14 Jun 2023 00:04:56 +0200
Subject: [PATCH 02/11] Proper docs

---
 .../19.hybrid-fe-design/docs.md               | 52 ++++++++++++++++++-
 1 file changed, 50 insertions(+), 2 deletions(-)

diff --git a/pages/03.fe-development/14.best-practices/19.hybrid-fe-design/docs.md b/pages/03.fe-development/14.best-practices/19.hybrid-fe-design/docs.md
index 76cd68f3..58f08e50 100644
--- a/pages/03.fe-development/14.best-practices/19.hybrid-fe-design/docs.md
+++ b/pages/03.fe-development/14.best-practices/19.hybrid-fe-design/docs.md
@@ -6,6 +6,54 @@ taxonomy:
   category: docs
 ---
 
-## Lorem ipsum
+## Why does Centra provide two different webshop APIs
 
-asd
+Shop API is our original webshop API, designed in the times when the Internet was older. Stateless REST APIs were taking over, and no one really understood the need to go stateful, respecting the context of the webshop user.
+
+Few years later we realised that stateless is not great in the world where you try your best to save up on bandwidth, while you're also exposing too much unnecessary data to too many actors. We therefore wrote Checkout API, which was stateful and more byte-conservative, which gave us great options to optimise your API responses based on the context of your selection.
+
+Today we find ourselves in a new Internet, where static page generation and smart caching are very much desired, and we realised that stateful Checkout API is not always the best solution to feed the middle-ware servers with data, where the output of the API depends on the context of the shopper. Once again, we realise that an API that serves all available data, always, actually posesses a true value when it comes to fetching all required data, like when you're building your caches.
+
+## The high-level concept of a hybrid FE solution
+
+![](hybrid.png)
+
+In short:
+* Shop API builds the shop's backend, the backbone of your front end
+* Checkout API builds the shop's checkout experience, from entering the website to a successful checkout (or at least a Cart Abandonment email)
+
+## The one big thing in common
+
+Both Shop and Checkout APIs use the same `product` IDs (which are [display item IDs](/fe-development/fe-elements#why-do-i-see-different-product-ids-in-the-centra-backend-and-in-checkout-api), meaning the product variants activated on a store display. These are the same IDs that are returned by the [Centra Webhook plugin](/plugins/centra-webhook) activated in a `Checkout API` mode. Therefore, same webhook events can be used by both APIs, for both back-end (Shop API) and front-end (Checkout API) functions.
+
+Same `product` and `item` IDs are used by [/products](https://docs.centra.com/swagger-ui/?api=CheckoutAPI#/5.%20product%20catalog/post_products) and [/items](https://docs.centra.com/swagger-ui/?api=CheckoutAPI#/2.%20selection%20handling%2C%20cart/post_items__item_) endpoints in both Shop and Checkout APIs.
+
+## Characteristics of Checkout API
+
+    + Newer Centra REST webshop API  
+    + Stateful  
+    + Returns only data relevant for session  
+    + Small API response sizes  
+    + Includes all most recent webshop functions  
+
+    - Difficult to poll multiple markets / pricelists /
warehouses / languages at once  
+    - Building a cache / static page generation
requires multiple API calls per each product  
+
+## Characteristics of Shop API
+
+    - Older Centra REST webshop API  
+    - Stateless  
+    - Returns all data, always  
+    - Large API response sizes  
+    - Not all latest webshop functions available  
+
+    + By design returns products in all markets /
pricelists / warehouses / languages at once  
+    + Building a cache / static page generation
requires much fewer number of API calls  
+
+Basically, in Shop API each [GET /products/{productId}](https://docs.centra.com/swagger-ui/?urls.primaryName=ShopAPI#/default/get_products__product_) API call returns product data
in every market / pricelist / warehouse / language


+
+### Known limitations of Shop API
+
+Current known problems:  
+    - Minimal data returned for each `relatedProducts`, 
requiring one API call per each product ID  
+    - Unable to fetch multiple product IDs at once

From 5834b1c2f92eda9d0a5b66ef96199f0c4ea50688 Mon Sep 17 00:00:00 2001
From: piotr-symonowicz <49191214+piotr-symonowicz@users.noreply.github.com>
Date: Wed, 14 Jun 2023 00:05:26 +0200
Subject: [PATCH 03/11] Add files via upload

---
 .../19.hybrid-fe-design/fe-hybrid-design.png    | Bin 0 -> 47565 bytes
 1 file changed, 0 insertions(+), 0 deletions(-)
 create mode 100644 pages/03.fe-development/14.best-practices/19.hybrid-fe-design/fe-hybrid-design.png

diff --git a/pages/03.fe-development/14.best-practices/19.hybrid-fe-design/fe-hybrid-design.png b/pages/03.fe-development/14.best-practices/19.hybrid-fe-design/fe-hybrid-design.png
new file mode 100644
index 0000000000000000000000000000000000000000..ffb405a821d66858a49f9e9313dc81f178fabe83
GIT binary patch
literal 47565
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

literal 0
HcmV?d00001


From 97160d03954aeb14141f0671503e116ee52dafd6 Mon Sep 17 00:00:00 2001
From: piotr-symonowicz <49191214+piotr-symonowicz@users.noreply.github.com>
Date: Wed, 14 Jun 2023 00:06:06 +0200
Subject: [PATCH 04/11] Fix image

---
 .../14.best-practices/19.hybrid-fe-design/docs.md               | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/pages/03.fe-development/14.best-practices/19.hybrid-fe-design/docs.md b/pages/03.fe-development/14.best-practices/19.hybrid-fe-design/docs.md
index 58f08e50..b553699a 100644
--- a/pages/03.fe-development/14.best-practices/19.hybrid-fe-design/docs.md
+++ b/pages/03.fe-development/14.best-practices/19.hybrid-fe-design/docs.md
@@ -16,7 +16,7 @@ Today we find ourselves in a new Internet, where static page generation and smar
 
 ## The high-level concept of a hybrid FE solution
 
-![](hybrid.png)
+![](fe-hybrid-design.png)
 
 In short:
 * Shop API builds the shop's backend, the backbone of your front end

From 13972260e4ae66d45e60a840c45424e40454a679 Mon Sep 17 00:00:00 2001
From: piotr-symonowicz <49191214+piotr-symonowicz@users.noreply.github.com>
Date: Wed, 14 Jun 2023 00:09:55 +0200
Subject: [PATCH 05/11] Update docs.md

---
 .../14.best-practices/19.hybrid-fe-design/docs.md     | 11 ++++++++---
 1 file changed, 8 insertions(+), 3 deletions(-)

diff --git a/pages/03.fe-development/14.best-practices/19.hybrid-fe-design/docs.md b/pages/03.fe-development/14.best-practices/19.hybrid-fe-design/docs.md
index b553699a..41da104c 100644
--- a/pages/03.fe-development/14.best-practices/19.hybrid-fe-design/docs.md
+++ b/pages/03.fe-development/14.best-practices/19.hybrid-fe-design/docs.md
@@ -18,9 +18,14 @@ Today we find ourselves in a new Internet, where static page generation and smar
 
 ![](fe-hybrid-design.png)
 
-In short:
-* Shop API builds the shop's backend, the backbone of your front end
-* Checkout API builds the shop's checkout experience, from entering the website to a successful checkout (or at least a Cart Abandonment email)
+In short:  
+* Shop API builds the shop's backend, the backbone of your front end  
+* Checkout API builds the shop's checkout experience, from entering the website to a successful checkout (or at least a [Cart Abandonment](/plugins/cartabandonment) email)  
+* Centra Webhooks are used to only trigger updates of relevant data  
+
+[notice-box=info]
+In case of a network or application failure, remember to always include a mechanism to completely re-build your middle-ware cache from scratch. Use it as a failsafe after unplanned outages, where individual webhooks might have been lost.
+[/notice-box]
 
 ## The one big thing in common
 

From ff409232bb6e79f5746247ba80ab2bf8d05fec16 Mon Sep 17 00:00:00 2001
From: piotr-symonowicz <49191214+piotr-symonowicz@users.noreply.github.com>
Date: Wed, 14 Jun 2023 00:14:03 +0200
Subject: [PATCH 06/11] Update docs.md

---
 .../14.best-practices/19.hybrid-fe-design/docs.md      | 10 +++++-----
 1 file changed, 5 insertions(+), 5 deletions(-)

diff --git a/pages/03.fe-development/14.best-practices/19.hybrid-fe-design/docs.md b/pages/03.fe-development/14.best-practices/19.hybrid-fe-design/docs.md
index 41da104c..a814768b 100644
--- a/pages/03.fe-development/14.best-practices/19.hybrid-fe-design/docs.md
+++ b/pages/03.fe-development/14.best-practices/19.hybrid-fe-design/docs.md
@@ -12,16 +12,16 @@ Shop API is our original webshop API, designed in the times when the Internet wa
 
 Few years later we realised that stateless is not great in the world where you try your best to save up on bandwidth, while you're also exposing too much unnecessary data to too many actors. We therefore wrote Checkout API, which was stateful and more byte-conservative, which gave us great options to optimise your API responses based on the context of your selection.
 
-Today we find ourselves in a new Internet, where static page generation and smart caching are very much desired, and we realised that stateful Checkout API is not always the best solution to feed the middle-ware servers with data, where the output of the API depends on the context of the shopper. Once again, we realise that an API that serves all available data, always, actually posesses a true value when it comes to fetching all required data, like when you're building your caches.
+Today we find ourselves in a new Internet, where static page generation and smart caching are very much desired, and we realised that stateful Checkout API is not always the best solution to feed the middle-ware servers with data, where the output of the API depends on the context of the shopper. Once again, we realise that a stateless API that serves all available data, always, actually posesses a true value when it comes to fetching all required data, like when you're building your caches.
 
 ## The high-level concept of a hybrid FE solution
 
 ![](fe-hybrid-design.png)
 
 In short:  
-* Shop API builds the shop's backend, the backbone of your front end  
-* Checkout API builds the shop's checkout experience, from entering the website to a successful checkout (or at least a [Cart Abandonment](/plugins/cartabandonment) email)  
-* Centra Webhooks are used to only trigger updates of relevant data  
+* [Shop API](https://docs.centra.com/swagger-ui/?urls.primaryName=ShopAPI) builds the shop's backend, the backbone of your front end  
+* [Checkout API](/fe-development/fe-elements) builds the shop's checkout experience, from entering the website to a successful checkout (or at least a [Cart Abandonment](/plugins/cartabandonment) email)  
+* [Centra Webhooks](/plugins/centra-webhook) are used to only trigger updates of relevant data  
 
 [notice-box=info]
 In case of a network or application failure, remember to always include a mechanism to completely re-build your middle-ware cache from scratch. Use it as a failsafe after unplanned outages, where individual webhooks might have been lost.
@@ -31,7 +31,7 @@ In case of a network or application failure, remember to always include a mechan
 
 Both Shop and Checkout APIs use the same `product` IDs (which are [display item IDs](/fe-development/fe-elements#why-do-i-see-different-product-ids-in-the-centra-backend-and-in-checkout-api), meaning the product variants activated on a store display. These are the same IDs that are returned by the [Centra Webhook plugin](/plugins/centra-webhook) activated in a `Checkout API` mode. Therefore, same webhook events can be used by both APIs, for both back-end (Shop API) and front-end (Checkout API) functions.
 
-Same `product` and `item` IDs are used by [/products](https://docs.centra.com/swagger-ui/?api=CheckoutAPI#/5.%20product%20catalog/post_products) and [/items](https://docs.centra.com/swagger-ui/?api=CheckoutAPI#/2.%20selection%20handling%2C%20cart/post_items__item_) endpoints in both Shop and Checkout APIs.
+Same `product` and `item` IDs are used by [GET/POST /products](https://docs.centra.com/swagger-ui/?api=CheckoutAPI#/5.%20product%20catalog/post_products) and [POST /items](https://docs.centra.com/swagger-ui/?api=CheckoutAPI#/2.%20selection%20handling%2C%20cart/post_items__item_) endpoints in both Shop and Checkout APIs.
 
 ## Characteristics of Checkout API
 

From a1d4664792a753458479394df75d336a98738e9c Mon Sep 17 00:00:00 2001
From: piotr-symonowicz <49191214+piotr-symonowicz@users.noreply.github.com>
Date: Wed, 14 Jun 2023 08:48:00 +0200
Subject: [PATCH 07/11] Update docs.md

---
 .../14.best-practices/19.hybrid-fe-design/docs.md           | 6 +++---
 1 file changed, 3 insertions(+), 3 deletions(-)

diff --git a/pages/03.fe-development/14.best-practices/19.hybrid-fe-design/docs.md b/pages/03.fe-development/14.best-practices/19.hybrid-fe-design/docs.md
index a814768b..9e4a041b 100644
--- a/pages/03.fe-development/14.best-practices/19.hybrid-fe-design/docs.md
+++ b/pages/03.fe-development/14.best-practices/19.hybrid-fe-design/docs.md
@@ -8,9 +8,9 @@ taxonomy:
 
 ## Why does Centra provide two different webshop APIs
 
-Shop API is our original webshop API, designed in the times when the Internet was older. Stateless REST APIs were taking over, and no one really understood the need to go stateful, respecting the context of the webshop user.
+Shop API is our original webshop API, designed in the times when the Internet was older. Stateless REST APIs were taking over, and no one really cared about respecting the context of the webshop user. It was OK to serve all data to everybody.
 
-Few years later we realised that stateless is not great in the world where you try your best to save up on bandwidth, while you're also exposing too much unnecessary data to too many actors. We therefore wrote Checkout API, which was stateful and more byte-conservative, which gave us great options to optimise your API responses based on the context of your selection.
+Few years later we realised that stateless is not great in the world where you try your best to save up on bandwidth, while you're also exposing too much unnecessary data to too many actors. We therefore wrote Checkout API, which was stateful and more byte-conservative, which gave us great options to optimise your API responses based on location and language of your session.
 
 Today we find ourselves in a new Internet, where static page generation and smart caching are very much desired, and we realised that stateful Checkout API is not always the best solution to feed the middle-ware servers with data, where the output of the API depends on the context of the shopper. Once again, we realise that a stateless API that serves all available data, always, actually posesses a true value when it comes to fetching all required data, like when you're building your caches.
 
@@ -24,7 +24,7 @@ In short:
 * [Centra Webhooks](/plugins/centra-webhook) are used to only trigger updates of relevant data  
 
 [notice-box=info]
-In case of a network or application failure, remember to always include a mechanism to completely re-build your middle-ware cache from scratch. Use it as a failsafe after unplanned outages, where individual webhooks might have been lost.
+In case of a network or application issues, remember to always include a mechanism to completely re-build your middle-ware cache from scratch. Use it as a failsafe after unplanned outages, where individual webhooks might have been lost.
 [/notice-box]
 
 ## The one big thing in common

From ee48308bd2950a1590727e860db56d701578c442 Mon Sep 17 00:00:00 2001
From: piotr-symonowicz <49191214+piotr-symonowicz@users.noreply.github.com>
Date: Wed, 14 Jun 2023 08:48:19 +0200
Subject: [PATCH 08/11] Update docs.md

---
 .../14.best-practices/19.hybrid-fe-design/docs.md               | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/pages/03.fe-development/14.best-practices/19.hybrid-fe-design/docs.md b/pages/03.fe-development/14.best-practices/19.hybrid-fe-design/docs.md
index 9e4a041b..2e299bde 100644
--- a/pages/03.fe-development/14.best-practices/19.hybrid-fe-design/docs.md
+++ b/pages/03.fe-development/14.best-practices/19.hybrid-fe-design/docs.md
@@ -8,7 +8,7 @@ taxonomy:
 
 ## Why does Centra provide two different webshop APIs
 
-Shop API is our original webshop API, designed in the times when the Internet was older. Stateless REST APIs were taking over, and no one really cared about respecting the context of the webshop user. It was OK to serve all data to everybody.
+Shop API is our original webshop API, designed in the times when the Internet was older. Stateless REST APIs were taking over, and no one really cared about respecting the context of the webshop user. It was OK to serve the same data to everybody.
 
 Few years later we realised that stateless is not great in the world where you try your best to save up on bandwidth, while you're also exposing too much unnecessary data to too many actors. We therefore wrote Checkout API, which was stateful and more byte-conservative, which gave us great options to optimise your API responses based on location and language of your session.
 

From 4ce90d9d861b1406ca7173b6f4e99c21f3bf81cc Mon Sep 17 00:00:00 2001
From: piotr-symonowicz <49191214+piotr-symonowicz@users.noreply.github.com>
Date: Wed, 14 Jun 2023 08:50:50 +0200
Subject: [PATCH 09/11] Update docs.md

---
 .../14.best-practices/19.hybrid-fe-design/docs.md               | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/pages/03.fe-development/14.best-practices/19.hybrid-fe-design/docs.md b/pages/03.fe-development/14.best-practices/19.hybrid-fe-design/docs.md
index 2e299bde..bad4972a 100644
--- a/pages/03.fe-development/14.best-practices/19.hybrid-fe-design/docs.md
+++ b/pages/03.fe-development/14.best-practices/19.hybrid-fe-design/docs.md
@@ -29,7 +29,7 @@ In case of a network or application issues, remember to always include a mechani
 
 ## The one big thing in common
 
-Both Shop and Checkout APIs use the same `product` IDs (which are [display item IDs](/fe-development/fe-elements#why-do-i-see-different-product-ids-in-the-centra-backend-and-in-checkout-api), meaning the product variants activated on a store display. These are the same IDs that are returned by the [Centra Webhook plugin](/plugins/centra-webhook) activated in a `Checkout API` mode. Therefore, same webhook events can be used by both APIs, for both back-end (Shop API) and front-end (Checkout API) functions.
+Both Shop and Checkout APIs use the same `product` IDs (which are [display item IDs](/fe-development/fe-elements#why-do-i-see-different-product-ids-in-the-centra-backend-and-in-checkout-api), meaning the product variants activated on a store display). These are the same IDs that are returned by the [Centra Webhook plugin](/plugins/centra-webhook) activated in a `Checkout API` mode. Therefore, same webhook events can be used by both APIs, for both back-end (Shop API) and front-end (Checkout API) functions.
 
 Same `product` and `item` IDs are used by [GET/POST /products](https://docs.centra.com/swagger-ui/?api=CheckoutAPI#/5.%20product%20catalog/post_products) and [POST /items](https://docs.centra.com/swagger-ui/?api=CheckoutAPI#/2.%20selection%20handling%2C%20cart/post_items__item_) endpoints in both Shop and Checkout APIs.
 

From f70d82994e9d1a7b5152f2daa0c25ff248bd1bef Mon Sep 17 00:00:00 2001
From: piotr-symonowicz <49191214+piotr-symonowicz@users.noreply.github.com>
Date: Wed, 14 Jun 2023 08:52:13 +0200
Subject: [PATCH 10/11] Styling

---
 .../14.best-practices/19.hybrid-fe-design/docs.md             | 4 ++--
 1 file changed, 2 insertions(+), 2 deletions(-)

diff --git a/pages/03.fe-development/14.best-practices/19.hybrid-fe-design/docs.md b/pages/03.fe-development/14.best-practices/19.hybrid-fe-design/docs.md
index bad4972a..58c9bd8b 100644
--- a/pages/03.fe-development/14.best-practices/19.hybrid-fe-design/docs.md
+++ b/pages/03.fe-development/14.best-practices/19.hybrid-fe-design/docs.md
@@ -41,7 +41,7 @@ Same `product` and `item` IDs are used by [GET/POST /products](https://docs.cent
     + Small API response sizes  
     + Includes all most recent webshop functions  
 
-    - Difficult to poll multiple markets / pricelists /
warehouses / languages at once  
+    - Difficult to poll multiple markets / pricelists / warehouses / languages at once  
     - Building a cache / static page generation
requires multiple API calls per each product  
 
 ## Characteristics of Shop API
@@ -55,7 +55,7 @@ Same `product` and `item` IDs are used by [GET/POST /products](https://docs.cent
     + By design returns products in all markets /
pricelists / warehouses / languages at once  
     + Building a cache / static page generation
requires much fewer number of API calls  
 
-Basically, in Shop API each [GET /products/{productId}](https://docs.centra.com/swagger-ui/?urls.primaryName=ShopAPI#/default/get_products__product_) API call returns product data
in every market / pricelist / warehouse / language


+Basically, in Shop API each [GET /products/{productId}](https://docs.centra.com/swagger-ui/?urls.primaryName=ShopAPI#/default/get_products__product_) API call returns product information in every market / pricelist / warehouse / language


 
 ### Known limitations of Shop API
 

From 8fb9025e4c520cca2f77b9972f46affebe74d3ac Mon Sep 17 00:00:00 2001
From: piotr-symonowicz <49191214+piotr-symonowicz@users.noreply.github.com>
Date: Fri, 16 Jun 2023 08:42:40 +0200
Subject: [PATCH 11/11] Elin's rewrite

---
 .../14.best-practices/19.hybrid-fe-design/docs.md           | 6 +++---
 1 file changed, 3 insertions(+), 3 deletions(-)

diff --git a/pages/03.fe-development/14.best-practices/19.hybrid-fe-design/docs.md b/pages/03.fe-development/14.best-practices/19.hybrid-fe-design/docs.md
index 58c9bd8b..9c4e1363 100644
--- a/pages/03.fe-development/14.best-practices/19.hybrid-fe-design/docs.md
+++ b/pages/03.fe-development/14.best-practices/19.hybrid-fe-design/docs.md
@@ -8,11 +8,11 @@ taxonomy:
 
 ## Why does Centra provide two different webshop APIs
 
-Shop API is our original webshop API, designed in the times when the Internet was older. Stateless REST APIs were taking over, and no one really cared about respecting the context of the webshop user. It was OK to serve the same data to everybody.
+Shop API is our original webshop API, which was developed during a time when the Internet was in its earlier stages. Stateless REST APIs were becoming popular, and there wasn't much emphasis on considering the context of the webshop user, it was acceptable to serve the same data to everyone.
 
-Few years later we realised that stateless is not great in the world where you try your best to save up on bandwidth, while you're also exposing too much unnecessary data to too many actors. We therefore wrote Checkout API, which was stateful and more byte-conservative, which gave us great options to optimise your API responses based on location and language of your session.
+As time went on and Centra continued to progress, we recognized the limitations of stateless APIs where conserving bandwidth and minimizing unnecessary data exposure were becoming more important. To address this, we introduced the Checkout API, which was stateful and more byte-conservative to optimise the API responses based on the user's location and language.
 
-Today we find ourselves in a new Internet, where static page generation and smart caching are very much desired, and we realised that stateful Checkout API is not always the best solution to feed the middle-ware servers with data, where the output of the API depends on the context of the shopper. Once again, we realise that a stateless API that serves all available data, always, actually posesses a true value when it comes to fetching all required data, like when you're building your caches.
+In the present day we find that the demands have changed again, static page and smart caching are highly desired, stateful APIs such as Checkout API is not the best solution to feed middle-ware servers with data when that data depends on the context of the individual shopper. A stateless API that consistently serves all available data can prove valuable, particularly when building caches and retrieving all the necessary data.
 
 ## The high-level concept of a hybrid FE solution