Pricing matrix

modules/purchase_trade/docs_source/business/pricing.md

@@ -20,7 +20,7 @@ des lignes achat / vente.
 | --- | --- |
 | Composant | Un `pricing.component` appartient a une ligne achat ou vente. |
 | Courbe | La courbe principale est `price_index`. |
-| Matrix | La matrix existe dans le modele mais n'est pas encore le moteur principal du fixing automatique. |
+| Matrix | Une matrix peut alimenter un composant de fixing, avec ligne generique ou conditions. |
 | Pricing period | Definit les dates ou lire les prix sur la courbe. |
 | Application period | Definit les dates ou appliquer les tranches de fixing. |
 | AVG | Utilise la moyenne progressive des prix lus. |
@@ -105,6 +105,8 @@ Source: `BR-PT-016` et doublon historique `BR-PT-015`
 | Etape | Effet metier |
 | --- | --- |
 | Composant | L'utilisateur choisit une courbe, un calendrier et active `Auto`. |
+| Source curve | Le systeme lit les prix depuis `price_index`. |
+| Source matrix | Le systeme lit les prix depuis `price_matrix.line`. |
 | Trigger | L'utilisateur definit une periode de prix et une periode d'application. |
 | Lecture prix | Le systeme lit les prix de la courbe sur les dates de pricing. |
 | Application | Le systeme cree une ligne de pricing par date d'application. |
@@ -112,6 +114,7 @@ Source: `BR-PT-016` et doublon historique `BR-PT-015`
 | Moyenne | Si `AVG` est coche, le prix fixe utilise la moyenne progressive. |
 | Fallback prix | Si `LAST` est coche, la courbe peut reprendre le dernier prix disponible. |
 | Cut-off | `Pricing date max` arrete la generation apres cette date. |
+| Ratio negatif | Un ratio `-100%` soustrait le composant du prix basis. |
 
 ```text
 Prix lus:        P1   P2   P3   P4
@@ -137,6 +140,22 @@ Summary:         derniere ligne marquee last
 > 5 avril et cree les applications sur ces memes dates, sauf jours exclus par le
 > calendrier si un calendrier est renseigne.
 
+### BR-PT-PRI-006 - Matrix de premium ou spread
+
+| Cas | Regle |
+| --- | --- |
+| Matrix generique | Une ligne matrix sans origin, destination, product ni quality s'applique comme fallback global. |
+| Matrix conditionnelle | Une ligne avec origin, destination, product ou quality est prioritaire si elle correspond a la ligne trade. |
+| Prix | `price_value` est converti vers l'unite / devise de la ligne si la matrix les renseigne. |
+| Validite | `valid_from` et `valid_to` limitent la periode d'utilisation de la matrix. |
+| Calendrier | Si le composant n'a pas de calendrier, le calendrier de la matrix est utilise. |
+| Soustraction | Pour soustraire un premium, mettre le ratio du composant a `-100%`. |
+
+> **Usage premium simple**
+> Creer une matrix avec une ligne sans condition et `price_value = 45`, puis
+> ajouter un composant de type `Matrix` sur la ligne trade. Avec un ratio
+> `-100%`, ce composant diminue le prix basis de 45 dans le repere de la ligne.
+
 ## Section developpeur
 
 ### Modeles pivots
@@ -175,7 +194,7 @@ Summary:         derniere ligne marquee last
 | `fallback` composant | Champ present, logique metier encore portee par `trigger.last`. |
 | `last` trigger | Signifie dernier prix disponible sur la curve. |
 | `last` pricing | Signifie derniere ligne du groupe pour le summary. |
-| Matrix | Disponible dans le modele et le MTM, pas encore completement integree au fixing auto. |
+| Matrix | Disponible dans le fixing auto, avec fallback generique et priorite aux lignes conditionnelles. |
 | `prDate` / `apPrice` | Variables intermediaires historiques peu exploitees. |
 | AVG | Moyenne progressive calculee sur la liste des prix lus. |