Code/Instructions.md

# Bienvenue dans l'application Fabnum

## Présentation de l'application

Cet outil interactif vous permet d'explorer et d'analyser les vulnérabilités de la chaîne de fabrication du numérique. Grâce à une interface, espérons-le, intuitive, vous pourrez visualiser les différentes étapes de production, identifier les points critiques et comprendre les enjeux géopolitiques et plus liés à la fabrication des technologies numériques.

L'application vous offre diverses fonctionnalités :

* Visualisation des données et des graphiques
* Personnalisation des produits à analyser
* Exploration détaillée des indices de vulnérabilité et des opérations
* Possibilité d'exporter les résultats selon différents formats selon autorisation

## Comprendre la chaîne de fabrication numérique

### Structure de la chaîne
La chaîne de fabrication numérique se décompose en trois niveaux hiérarchiques :

* Produits finaux : appareils complets comme les smartphones, ordinateurs, serveurs, etc.
* Composants : éléments constitutifs comme les processeurs, écrans, capteurs, batteries, etc.
* Minerais et matériaux : ressources de base nécessaires à la fabrication des composants

### Opérations à chaque niveau
Chaque niveau de la chaîne implique des opérations spécifiques :

* Niveau Produit final : assemblage des composants pour créer le produit fini
* Niveau Composant : fabrication des pièces à partir des minerais et matériaux
* Niveau Minerai : extraction et traitement des ressources premières

### Dimension géopolitique
Pour chaque opération, l'application détaille :

* Les pays où l'opération est réalisée, avec leur part respective du marché mondial
* Les acteurs économiques impliqués dans chaque pays, avec leur part de marché
* Les liens entre les pays d'opération, les acteurs et leur contexte géopolitique

[Voir la vision détaillée du projet](https://fabnum-dev.peccini.fr/app/static/Description/Objectif%20final.pdf)

## Comprendre les indices de vulnérabilité

L'application utilise quatre indices clés pour évaluer les vulnérabilités dans la chaîne de fabrication numérique :

### Indice de Herfindahl-Hirschmann (IHH)

* Que mesure-t-il ? La concentration géographique ou industrielle d'une opération.
* Comment l'interpréter ? Plus l'indice est élevé, plus l'opération est concentrée dans un nombre limité de pays, ce qui augmente la vulnérabilité.
* Où le trouver ? Associé à chaque opération dans les graphiques d'analyse.

[Voir la fiche détaillée](https://fabnum-dev.peccini.fr/app/static/Fiches/Criticit%C3%A9s/Fiche%20technique%20IHH.pdf)

### Indice de Vulnérabilité Concurrentielle (IVC)

* Que mesure-t-il ? La pression exercée par d'autres secteurs industriels sur une même ressource minérale.
* Comment l'interpréter ? Un IVC élevé indique une forte compétition pour accéder à ce minerai, augmentant le risque de pénurie.
* Où le trouver ? Associé à chaque minerai dans les visualisations et fiches.

[Voir la fiche détaillée](https://fabnum-dev.peccini.fr/app/static/Fiches/Criticit%C3%A9s/Fiche%20technique%20IVC.pdf)

### Indice de Criticité de Substituabilité (ICS)

* Que mesure-t-il ? La possibilité de remplacer un minerai par un autre dans la fabrication d'un composant. Plus rarement, il matérialise la capacité de remplacer un procédé.
* Comment l'interpréter ? Un ICS élevé signifie qu'il est difficile de trouver une alternative à ce minerai.
* Où le trouver ? Associé à la relation entre composants et minerais.

[Voir la fiche détaillée](https://fabnum-dev.peccini.fr/app/static/Fiches/Criticit%C3%A9s/Fiche%20technique%20ICS.pdf)

### Indice de Stabilité Géopolitique (ISG)

* Que mesure-t-il ? La stabilité politique, économique et sociale d'un pays, basée sur trois sous-indicateurs.
* Comment l'interpréter ? Un ISG élevé indique un pays instable, ce qui augmente les risques d'approvisionnement.
* Où le trouver ? Utilisé pour pondérer les risques identifiés tout au long de la chaîne.

[Voir la fiche détaillée](https://fabnum-dev.peccini.fr/app/static/Fiches/Criticit%C3%A9s/Fiche%20technique%20ISG.pdf)

## Guide d'utilisation de l'application

L'application est organisée en quatre onglets principaux, chacun offrant une perspective différente sur la chaîne de fabrication numérique :

* Onglet Personnalisation : Créer et gérer des produits finaux personnalisés pour des analyses spécifiques.
    * À noter : Les produits personnalisés sont temporaires par défaut, mais peuvent être sauvegardés pour une utilisation ultérieure.
* Onglet Analyse : Explorer visuellement les relations entre les différents niveaux de la chaîne de fabrication.
    * Exemple d'utilisation : Pour comprendre les vulnérabilités liées aux composants d'un smartphone, sélectionnez « Produit final » comme niveau de départ, « Composant » comme niveau d'arrivée, puis spécifiez « Smartphone » comme item de produit final.
* Onglet IA'nalyse : Obtenez un rapport synthétique circonstancié d'une partie du schéma global.
    * Cet onglet n'est accessible qu'aux personnes diposant d'un compte.
* Onglet Plan d'action : Visualiser toutes les criticités d'une chaîne Produit final <-> Composant <-> Minerai.
    * À partir d'une sélection, toutes les chaînes critiques sont examinées à la loupe.
    * Des propositions d'actions et d'indicateurs sont fournies selon les opérations et leur niveau de criticité.
* Onglet Visualisations : Observer les corrélations entre les différents indices et comprendre les tendances globales.
    * Indicateurs clés : Portez attention aux points situés dans les zones de haute valeur pour les deux indices, car ils représentent les vulnérabilités les plus critiques.
* Onglet Fiches : Accéder à des informations détaillées sur chaque opération et minerai.
    * À explorer : Les fiches contiennent souvent des informations qui ne sont pas visibles directement dans les graphiques, comme des tendances historiques ou des prévisions futures ; n'hésitez pas à les consulter

En début de chacun des onglets, vous trouverez un mini-guide spécifique sur leur utilisation.