From f1ec684606cfd79b549869e586d100f553ead9d8 Mon Sep 17 00:00:00 2001 From: =?UTF-8?q?St=C3=A9phan=20Peccini?= Date: Fri, 2 May 2025 22:45:56 +0200 Subject: [PATCH] Actualiser README.md --- README.md | 50 ++++++++++++++++++++++++++++++++++++++++++++++---- 1 file changed, 46 insertions(+), 4 deletions(-) diff --git a/README.md b/README.md index 1423072..1aab1c8 100644 --- a/README.md +++ b/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