FabNum/Code
4
0
Fork 0
Code Issues 2 Pull Requests Actions Packages Projects 1 Releases Wiki Activity

Actualiser README.md

Browse Source
This commit is contained in:
Stéphan Peccini 2025-05-02 22:45:56 +02:00
parent adfb5d7d04
commit f1ec684606
1 changed files with 46 additions and 4 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

50
README.md
View File

@ -76,15 +76,57 @@ Pour automatiser le lancement, il est intégré dans systemd :
### fabnum.py ### 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 ### 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 ### Organisation du code