Merge pull request #1061 from Avaiga/doc/add-commodity-trading-3-echelon

Add supply chain 3 echelon

docs/gallery/decision_support/2_supply_chain_3_echelons/index.md

@@ -0,0 +1,120 @@
+---
+title: Supply Chain - 3 Echelons
+category: decision_support
+data-keywords: optimization scenario cycle comparison enterprise
+short-description: An application that optimizes warehouse selection, production, and routes in a multi-echelon supply chain.
+img: 2_supply_chain_3_echelons/images/comparison_page.png
+---
+
+This application is an extension of the 
+[2-Echelon application](../3_supply_chain/index.md). It demonstrates a more comprehensive 
+use case for optimizing multi-echelon supply chains. 
+
+!!! note "Taipy Enterprise edition"
+
+    Taipy provides robust, business-focused applications tailored for enterprise
+    environments. To maintain standards of security and customization, these
+    applications are proprietary like this application. If you're looking for solutions
+    that are immediately deployable and customizable to your business needs, we invite
+    you to try them out and contact us for more detailed information.
+
+    [Try it live](https://supply-chain-3.taipy.cloud){: .tp-btn target='blank' }
+    [Contact us](https://taipy.io/book-a-call){: .tp-btn .tp-btn--accent target='blank' }
+
+
+![Supply Chain](images/comparison_page.png){width=90% : .tp-image-border }
+
+
+Here the supply chain network includes the following:
+
+- 4 plants, 
+- 25 potential warehouse sites,
+- 100 different customer locations, 
+- 4 different products are considered. 
+
+Each plant can only produce a single product (this can easily be modified). Each customer 
+demands one or more products. Warehouses can handle all products.
+
+The objective is to decide on the best warehouse location to minimize the overall costs 
+consisting of:
+
+- Transportation costs (from plant to warehouse, from warehouse to customer locations).
+- Warehouse costs (variable and fixed) costs.
+
+This application can be easily tailored to suit various supply chain configurations and 
+constraints, including changes in demand, fixed costs, and transportation costs.
+
+# Understanding the Application
+
+In this application, you can:
+
+- Navigate to explore the input data.
+- Execute various scenarios and visualize/analyze the optimal solutions generated.
+- Compare your scenarios to evaluate the best option.
+
+## Data page
+
+This first page presents the input data using:
+
+- a Table format (open the collapsible Panel "Data in Table Format").
+- a map displaying the various site locations.
+
+The input Tables contain:
+
+- The list of all the customer sites (with their associated demand).
+- The list of the plants and which products they can produce.
+- The list of all the potential sites for the warehouses.
+
+![Data page](images/data_page.png){width=90% : .tp-image-border }
+
+## Scenario Management
+
+This page allows you to create and modify scenarios. For each scenario, you can adjust 
+parameters such as:
+
+- The number of warehouses to be used. You will have the option to pre-select some 
+specific warehouses. Conversely, you will also be able to remove some warehouses as 
+possible choices..
+- Adjust demand, fixed costs, and transportation costs as input percentages.
+- After setting the parameters, you can submit the scenario to launch the optimization 
+engine and get the optimal solution.
+
+![Scenario Creation](images/scenario_creation_page.png){width=90% : .tp-image-border }
+
+The results include a solution map showing the selected warehouses and the routes used 
+(from plants to warehouses to customers). 
+
+![Scenario Map](images/scenario_map.png){width=90% : .tp-image-border }
+
+Important KPI  metrics are also displayed:
+
+- total carbon footprint,
+- total cost, and
+- average cost per unit shipped. 
+
+The chart at the bottom displays the volume of demand handled by each warehouse and plant 
+and the number of clients assigned to them.
+
+![Scenario Sankey](images/scenario_sankey.png){width=90% : .tp-image-border }
+
+## Comparison
+
+This page lets you compare two scenarios by displaying their solution maps and metrics 
+side by side.
+
+![Comparison](images/comparison_page.png){width=90% : .tp-image-border }
+
+## Global Comparison
+
+Here, you can compare all or selected scenarios using charts representing various 
+metrics, providing a comprehensive overview of the optimization results.
+
+![Total Comparison](images/total_comparison_page.png){width=90% : .tp-image-border }
+
+## Admin page
+
+The Admin page allows you to visualize all the data nodes, executed jobs, and scenarios 
+within the application, giving you complete control over managing and monitoring your 
+supply chain optimization processes.
+
+![Admin page](images/admin_page.png){width=90% : .tp-image-border }

docs/gallery/decision_support/2_supply_chain/index.md → docs/gallery/decision_support/3_supply_chain/index.md

@@ -1,23 +1,21 @@
 ---
-title: Supply Chain Optimization
+title: Supply Chain - 2 Echelons
 category: decision_support
 data-keywords: optimization scenario cycle comparison enterprise
 short-description: An application that optimizes warehouse selection and routes in a supply chain.
-img: 2_supply_chain/images/comparison_page.png
+img: 3_supply_chain/images/scenario_results.png
 ---
 
 
-This application demonstrates a typical use case for optimizing supply chains. This is particularly suited for Manufacturers or 
-distribution companies interested in minimizing their transportation costs from their warehouses to their customers. It
-uses a mathematical model to find the optimal selection of warehouses to cover customer demand.
-
-
-This application can be easily tailored to suit different supply chain configurations and constraints
+This application demonstrates a typical use case for optimizing supply chains. This is 
+particularly suited for manufacturers or distribution companies interested in minimizing 
+their transportation costs from their warehouses to their customers. It uses a 
+mathematical model to find the optimal selection of warehouses to cover customer demand.
 
+This application can be easily tailored to suit various supply chain configurations and constraints.
 
 !!! note "Taipy Enterprise edition"
 
-
     Taipy provides robust, business-focused applications tailored for enterprise
     environments. To maintain standards of security and customization, these
     applications are proprietary like this application. If you're looking for solutions
@@ -28,38 +26,30 @@ This application can be easily tailored to suit different supply chain configura
     [Try it live](https://supply-chain.taipy.cloud){: .tp-btn target='blank' }
     [Contact us](https://taipy.io/book-a-call){: .tp-btn .tp-btn--accent target='blank' }
 
-
 ![Supply Chain](images/comparison_page.png){width=90% : .tp-image-border }
 
-
 # Understanding the Application
 
-
 In this application, you can navigate to explore the input data and the optimal solutions generated.
 
-
 ## Data page
 
-
-The first screen is the "Data" page. Here, you can view all the input data for the
+The first screen is the 'Data' page. Here, you can view all the input data for the
 supply chain problem, including a list of 60 potential warehouses and 197 customers
 and their related information. You can also view a map showing the locations of
 potential warehouse sites as well as all the customer locations.
 
-
 ![Data page](images/data_page.png){width=90% : .tp-image-border }
 
-
 ## Scenario Management
 
-
 This page allows you to create and modify scenarios. You can adjust parameters such as:
 
-
-the number of warehouses to be used
-Select specific warehouses to be used in the
+- The number of warehouses to be used.
+- Select specific warehouses to be used in the
 solution. 
-After setting the parameters, you can submit the scenario to launch the optimization engine and then get the "optimal" solution.
+- After setting the parameters, you can submit the scenario to launch the 
+optimization engine and then get the 'optimal' solution.
 
 ![Scenario Creation](images/scenario_creation.png){width=90% : .tp-image-border }
 
@@ -78,23 +68,17 @@ metrics side by side.
 
 ![Comparison](images/comparison_page.png){width=90% : .tp-image-border }
 
-
 ## Global Comparison
 
-
 Here, you can compare all scenarios or selected scenarios using charts that represent
 various metrics, providing a comprehensive overview of the optimization results.
 
-
 ![Total Comparison](images/total_comparison_page.png){width=90% : .tp-image-border }
 
-
 ## Admin page
 
-
-The Admin page allows to visualize all the data nodes, executed jobs, and scenarios within
+The Admin page allows you to visualize all the data nodes, executed jobs, and scenarios within
 the application, giving you complete control over the management and monitoring of your
 supply chain optimization processes.
 
-
 ![Admin page](images/admin_page.png){width=90% : .tp-image-border }

mkdocs.yml_template

@@ -223,9 +223,10 @@ nav:
       - "Fraud Detection": gallery/finance/fraud_detection/index.md
     - "Decision Support":
       - "Decision Support": gallery/decision_support/index.md
-      - "Supply Chain": gallery/decision_support/2_supply_chain/index.md
+      - "Supply Chain - 3 Echelons": gallery/decision_support/2_supply_chain_3_echelons/index.md
       - "Production Planning": gallery/decision_support/3_production_planning/index.md
       - "QSR Sales Forecasting": gallery/decision_support/3_qsr_sales_forecasting/index.md
+      - "Supply Chain - 2 Echelons": gallery/decision_support/3_supply_chain/index.md
       - "Optimize Bar Cut Sizes": gallery/decision_support/bar_cutting/index.md
       - "Churn Classification": gallery/decision_support/churn_classification/index.md
       - "Drift Detection": gallery/decision_support/drift_detection/index.md