Actualiser README.md

README.md

@@ -76,15 +76,57 @@ Pour automatiser le lancement, il est intégré dans systemd :
 
 ### fabnum.py
 
-Le cœur du fonctionnement. C'est ce script qui permet de proposer l'interface de navigation, les analyses, les visualisations graphiques et l'accès aux fiches.
+Le cœur de l’application. Ce script gère :
 
-Il se connecte au backend Gitea pour récupérer le fichier schema.txt contenant tous les nœuds et toutes les relations entre eux pour décrire la chaîne complète.
+    l’interface utilisateur avec Streamlit,
 
-Il s'y connecte aussi pour récupérer les fiches et les présenter.
+    le chargement des données depuis le backend Gitea (schéma, instructions, fiches),
+
+    l’analyse des chaînes de dépendances critiques (par Sankey interactif),
+
+    les visualisations statistiques (IHH, IVC, ISG),
+
+    la navigation hiérarchique dans les fiches,
+
+    et la personnalisation de produits finaux.
+
+Il orchestre tous les composants de l’application, notamment :
+
+    connexion.py pour l’authentification via Gitea,
+
+    utils/ pour les fonctions métiers (import graph, traitement, visualisation),
+
+    components/ pour l’affichage modulaire (sidebar, header, footer, fiches),
+
+    et tickets_fiche.py pour la consultation et la création de tickets Gitea liés aux fiches.
+
+Le fichier récupère automatiquement les données du dépôt Gitea configuré, et permet aux utilisateurs d’interagir avec les graphes, les métadonnées et les visualisations en toute autonomie
 
 ### tickets_fiche.py
 
-Ce script est invoqué par fabnum.py pour assurer la coopération avec les internautes. Il permet de se connecter au backend Gitea pour récupérer les tickets associés à une fiche, les présenter ou en créée un nouveau.
+tickets_fiche.py
+
+Ce module assure la liaison entre les fiches documentaires et le système de tickets Gitea. Il permet :
+
+    de rechercher automatiquement les tickets ouverts liés à une fiche (via les labels définis dans fiches_labels.csv),
+
+    de les afficher classés par statut (En cours, Terminés, etc.),
+
+    de consulter les commentaires associés à chaque ticket,
+
+    de proposer un formulaire complet pour créer un nouveau ticket structuré à partir d’un modèle Markdown,
+
+    de prévisualiser et publier ce ticket directement via l’API Gitea.
+
+Il gère également :
+
+    la détection de conflits ou erreurs lors des appels réseau,
+
+    l’automatisation du remplissage des champs (fiche concernée, type de contribution, etc.),
+
+    et la prise en compte des environnements (ENV) et des permissions via token.
+
+Ce fichier est essentiel pour assurer la participation collaborative autour des fiches de la chaîne numérique.
 
 ### Organisation du code