Aller au contenu

PT1CE - Pricing Tier 1 Client Engine

Vue d'ensemble

PT1CE est une application Python qui optimise les corridors de prix calculés par PT0CE en appliquant de nouveaux PAS/PRB et en détectant les corridors nécessitant des ajustements.

L'application suit un workflow en 3 étapes permettant d'appliquer les nouveaux prix, corriger manuellement si nécessaire, puis exporter au format SAP.

Concepts fondamentaux

Corridors sous-optimaux

Un corridor est considéré sous-optimal dans deux cas :
1. Problème de palier : La borne PL6 = PAS (contrainte minimale atteinte)
2. Combiné avec forte dispersion : Écart-type > 10% ET PL6 = PAS

Note : Un corridor avec seulement un écart-type élevé reste optimal mais est signalé pour analyse.

Application des nouveaux prix

PT1CE recalcule les bornes en appliquant les écarts historiques :

Nouvelle borne = Nouveau PAS + Écart historique

Avec les contraintes :
- Minimum : Nouvelle borne ≥ Nouveau PAS
- Maximum : Nouvelle borne ≤ PRB approprié (RC ou COLL)

Types de tables

Tables permanentes (sans horodatage)

  • PT1CE_CORRIDORS_ZOOM[1/2/3] : Corridors avec nouveaux prix
  • PT1CE_OPTIMAL_ZOOM[1/2/3] : Corridors après détection et corrections

⚠️ Important : Ces tables sont écrasées à chaque nouveau run. Pour conserver un historique, effectuer une sauvegarde manuelle.

Table conservée pour PT1CE

  • PT0CE_DIMENSION_MAPPING : Nécessaire pour l'export SAP (codes sources)

Workflow principal

Étape 1 : Application des nouveaux prix

1_appliquer_nouveaux_prix.bat
- Charge le fichier inputs/new_pas_prb.csv
- Applique les nouveaux PAS/PRB sur tous les corridors
- Détecte les corridors sous-optimaux
- Génère les rapports d'analyse

Étape 2 : Corrections manuelles (optionnel)

2_appliquer_corrections.bat
- Lit les fichiers corrections/corrections_ZOOM[1/2/3].csv
- Applique les corrections sur les bornes spécifiées
- Relance la détection des sous-optimaux
- Génère de nouveaux rapports

Étape 3 : Export SAP

3_exporter_format_sap.bat
- Génère 4 extracts séparés (NATIONAL/MASTER × PRB_TO_USE)
- Crée des fichiers Excel au format SAP
- Gère automatiquement la division en fichiers de 400k lignes max

Structure des données

Fichier d'entrée : new_pas_prb.csv

ID_ART;PAS;PRB_RC;PRB_COLL
075130;12,456;15,820;14,935
075131;8,750;11,245;10,500

Fichiers de sortie principaux

Corridors sous-optimaux

  • corridors_sous_optimaux.csv : Corridors à corriger (PL6 = PAS)
  • corridors_ecart_type_eleve.csv : Corridors avec écart-type > 10%
  • corridors_optimaux.csv : Corridors valides

Analyses

  • evolution_par_type_client.csv : Impact des changements par segment
  • quality_metrics.csv : Métriques de qualité globales
  • distribution_ecart_type.csv : Répartition des écarts-types

Points clés de l'implémentation

Détection des sous-optimaux

# Sous-optimal si PL6 = PAS (avec ou sans écart-type élevé)
WHEN s.NEW_BORNE_PL6_PLX = s.NEW_PAS THEN 'SUBOPTIMAL'
# Optimal mais signalé si seulement écart-type élevé
WHEN s.ECART_TYPE > 0.10 THEN 'OPTIMAL'

Export SAP différencié

Cubes MASTER

  • Jointure avec PT0CE_DIMENSION_MAPPING pour obtenir les codes sources
  • Export avec codes typo/gira/région remplis

Cubes NATIONAL

  • Pas de jointure avec la table de mapping
  • Export avec codes sources vides

Format SAP

  • Type tarif : '01' (PRB RC) ou '02' (PRB COLL)
  • Paliers : Codes SAP (ZRPL, ZP05, ZP04, ZP03, ZP02, ZPP1)
  • Montant : Taux de remise = (PRB - Borne) / PRB
  • Date début : Prochain trimestre fiscal
  • Date fin : 31.12.9999

Un menu principal est disponible :

PT1CE_Menu.bat

Permet de :
- Choisir l'étape à exécuter
- Modifier le niveau de log (silencieux/normal/détaillé)
- Vérifier les prérequis
- Consulter l'aide

Configuration

Le fichier config/pt1ce_config.json permet d'ajuster :
- Seuil de détection écart-type (défaut : 10%)
- Nombre max de lignes par Excel (défaut : 400 000)
- Paramètres d'export SAP
- Format des fichiers CSV

Dépendances avec PT0CE

PT1CE utilise :
- Les tables PT0CE_CORRIDOR_HISTORY_* comme source
- La table PT0CE_DIMENSION_MAPPING pour l'export SAP
- Les colonnes d'écarts calculées par PT0CE

Points d'attention

  1. Tables écrasées : Les tables PT1CE sont recréées à chaque run
  2. Export SAP volumineux : Peut générer plusieurs fichiers Excel
  3. Dépendance PT0CE : Nécessite que PT0CE ait été exécuté
  4. Corrections partielles : Possibilité de ne corriger que certaines bornes

Résultats attendus

Après exécution complète :
- Corridors optimisés dans les tables PT1CE_OPTIMAL_*
- Exports SAP dans outputs/export_sap_*/sap_export/
- Rapports CSV d'analyse dans outputs/run_*/
- Log d'exécution avec statistiques détaillées