rephrasing Mon Nov 27 12:19:56 CET 2023

content/en/storage-providers/manage/pricing-models/index.md

@@ -14,20 +14,12 @@ toc: true
 
 Access `Storage` > `Pricing`.
 
-A pricing model is a group of rules where each rules associate a price to certains types of deals.
+A pricing model is a group of rules where each rule associates a price to certains types of deals.
+There is no limit on the number of rules per pricing model. 
 
-When a new deal proposal is reaching the pricing engine, the rules engine look for the first matching pricing rules.
+When a new deal proposal is reaching the pricing engine, the rules engine look for the first matching pricing rule, verify the price and exit with a decision.
 Rules are processed top to bottom.
 
-Once a rule match : 
-- The rule engine stop processing the rule set.
-- the price is verified, and one of the folowing decision is taken :
-	- If the price within the client proposal is below the price : the deal is definitely rejected with a message informing the client of the correct price.
-	- If the price is equal or above the rule price. The deal successfully passed the pricing engine and the deal is proceseds by the next CIDgravity modules (Maintenance Mode / Acceptance logic / etc ...)
-
-If no rules match but the "Fallback on default is set": The deal is processed against the default pricing
-If no rules match and the "Fallback on default is unset": The deal is rejected
-
 ```goat
                      +-----------------+
                      |                 |
@@ -103,68 +95,59 @@ test
 
 ```
 
-## Manage existing models
-
-{{< img src="models-list.png" alt="Manage pricing models using the pricing models management page" >}}
+## Default pricing model
 
-Each pricing model listed offers several options:
+Is a special pricing applying to :
+	- Deals from Filecoin address not attached to any registered clients.
+	- Any client with no specific pricing model set.
 
-- **View**: Allows you to review all the rules constituting the pricing model
-- **Edit**: Permits modification of one or more rules within the model
-- **Remove**: Enables deletion of the selected pricing model
-- **Set as default**: Establishes the chosen pricing model as the default configuration
-
-{{< alert icon="tip" >}}
-The removal of the default pricing model is restricted. 
-To delete it, first, designate another model as the default and then proceed with the removal of the desired default model.
-{{< /alert >}}
-
-{{< alert icon="warning" >}}
-The removal of a pricing model linked to a client is constrained. 
-Prior to attempting removal, edit the associated client details and ensure that it is not currently in use.
-{{< /alert >}}
+The default pricing model cannot be removed. Set another pricing model as default first to enable deletion.
+The "Fallback to default pricing model" setting is ignored when a pricing is set as the default pricing model.
 
 ## Create new model
 
-You can use sidebar by selecting the `Storage` tab and further navigating to the `Pricing` section.
+Click on the `Create a new model` button at the top.
 
-At the apex, you have the option to initiate the creation of a new model by clicking on the `Create a new model` button at the top.
-
-#### 1. Define a name
+#### 1. Pricing name
 
 For a more granular understanding of the pricing model, you have to set the desired name. 
 As an illustration, you can specify a name such as `All 16 GiB verified deals at 0`
 
 {{< img src="set-name-and-fallback.png" alt="Set the pricing model name and the fallback behavior" >}}
 
-#### 2. Define the fallback behavior
+#### 2. Fallback behavior
 
-If the rules of the pricing model fail to align with the incoming deal, there exists the capability to automatically use the default model.
+This feature is interesting, when a specific client, have a specific pricing or specific type of deals on top of what you offer by default.
+The incoming deal is first evaluated against the client pricing model, if no rules match, it's evaluated against the default pricing model. 
 
-{{< alert icon="warning" >}}
-In the scenario where this option is deactivated, the deal undergoes direct rejection when this pricing model has been applied. 
-With this option enabled, the default model is invoked to facilitate the decision-making process.
-{{< /alert >}}
+#### 3. Rules creation
 
-#### 3. Create the rules
+To match a rule, a deal needs first to fill all conditions except the price, then the price is compared. 
 
-For a model to achieve completeness, you need to create one or more rules designed to be applicable to incoming proposals.
+- **Type**: Deal TransferType : graphSync, HTTP, libP2P, etc, offline ...
+- **Verified**: Verified(Fil+) or unverified deals
+- **Size**: Padded Deal size range (PieceSize)
+- **Duration**: Deal duration(EndEpoch-StartEpoch)
+- **Price**: Minimum price in FIL/GiB/Epoch.
 
-{{< alert icon="warning" >}}
-The rules will be applied from top to bottom, so careful attention should be paid to their respective order.
+{{< alert icon="tip" >}}
+Rules order matter, they can be easily reorganised with drag and drop.
 {{< /alert >}}
 
-In the rule creation process, multiple elements can be use, and their collective evaluation determines whether the rule is a match :
+{{< img src="rule-example.png" alt="Example of one rule that compose a pricing model" >}}
 
-- **Type**: Enables filtering based on the allowed values in the TransferType field.
-- **Verified**: Specifies whether this rule accepts verified, unverified, or both types of deals.
-- **Size**: Establishes the permissible size range for applying this rule, with the flexibility to define units in various formats.
-- **Duration**: Sets the acceptable duration range for applying this rule, providing the option to express it in different units.
-- **Price**: Establishes the minimum price prerequisite for a deal that satisfies all the criteria outlined in this rule, with the specification in FIL/GiB/Epoch.
+## Manage existing models
+
+{{< img src="models-list.png" alt="Manage pricing models using the pricing models management page" >}}
+
+Each pricing model listed offers several options:
+
+- **View**: Quick access to the pricing rules.
+- **Edit**
+- **Remove**
+- **Set as default**: Establishes the chosen pricing model as default. 
 
 {{< alert icon="tip" >}}
-In the evaluation process of a rule, if any single criterion is not met, subsequent criteria will be assessed sequentially.
-This sequential evaluation continues until all specified criteria have been examined.
+A pricing set as default or attached to client cannot be deleted.
 {{< /alert >}}
 
-{{< img src="rule-example.png" alt="Example of one rule that compose a pricing model" >}}