fy59/labfy-investigation
1
0
Fork 0
Code Issues 3 Pull requests Projects Releases Packages Wiki Activity Actions

Connecter le modèle d'arborescence à la Sidebar. #12

New issue
Closed
opened 2026-07-18 08:27:14 +02:00 by fy59 · 0 comments
fy59 commented 2026-07-18 08:27:14 +02:00
Owner
Copy link

Titre

Connecter le modèle d'arborescence à la Sidebar.

Objectif

Relier l'enquête sélectionnée au panneau latéral.

Après la sélection d'un dossier, l'application doit :

  1. créer l'objet Investigation ;
  2. construire son InvestigationTreeModel ;
  3. transmettre le modèle à la Sidebar ;
  4. afficher temporairement le nom du nœud racine dans le panneau latéral.

Ce ticket valide la communication entre le Core et l'interface graphique.

Architecture

FolderDialog
      │
      ▼
Application
      │
      ├── Investigation
      │
      └── InvestigationTreeModel
                    │
                    ▼
                 Sidebar

Le module Application reste responsable de la coordination.

La Sidebar ne parcourt jamais directement le système de fichiers.

Responsabilités

Application

Le module Application doit :

  • recevoir le dossier sélectionné ;
  • créer l'objet Investigation ;
  • construire le modèle avec InvestigationTreeBuilder ;
  • conserver le modèle pendant toute la durée de l'enquête ;
  • transmettre le modèle à MainWindow ;
  • libérer l'ancien modèle avant d'en ouvrir un nouveau ;
  • libérer le modèle à la fermeture de l'application.

MainWindow

Le module MainWindow doit :

  • recevoir un modèle d'arborescence ;
  • le transmettre au composant Sidebar.

Sidebar

Le module Sidebar doit :

  • recevoir un InvestigationTreeModel en lecture seule ;
  • lire le nœud racine ;
  • afficher temporairement son nom dans le titre du panneau ;
  • ne jamais détruire le modèle reçu.

Principe de propriété

Application est propriétaire de :

Investigation
InvestigationTreeModel
MainWindow

La Sidebar reçoit uniquement une référence non propriétaire vers le modèle.

Elle ne doit jamais appeler :

investigation_tree_model_free(tree_model);

Le modèle est libéré uniquement par Application.

Fichiers concernés

src/core/application.c

include/views/main_window.h
src/views/main_window.c

include/widgets/sidebar.h
src/widgets/sidebar.c

Aucun nouveau module n'est nécessaire.

Interfaces publiques à ajouter

MainWindow

void main_window_set_tree_model(
    MainWindow *main_window,
    const InvestigationTreeModel *tree_model
);

Sidebar

void sidebar_set_tree_model(
    Sidebar *sidebar,
    const InvestigationTreeModel *tree_model
);

Comportement attendu

Avant l'ouverture d'une enquête, la Sidebar affiche :

Dossier d'enquête

Après la sélection du dossier :

Template

ou le nom réel du dossier racine sélectionné.

À ce stade, les enfants ne sont pas encore affichés.

Hors périmètre

Ce ticket ne doit pas :

  • afficher les enfants du nœud racine ;
  • utiliser GtkTreeListModel ;
  • créer un explorateur de fichiers complet ;
  • permettre de sélectionner un nœud ;
  • ouvrir un fichier ;
  • rafraîchir automatiquement le modèle ;
  • modifier le système de fichiers ;
  • communiquer avec SQLite.

Gestion des erreurs

Si la construction du modèle échoue :

  • l'application ne doit pas planter ;
  • l'ancien modèle doit rester valide jusqu'à son remplacement explicite ;
  • un message d'erreur doit être affiché dans le terminal ;
  • la Sidebar ne doit recevoir aucun pointeur invalide.

Si une nouvelle enquête est ouverte avec succès :

  1. créer la nouvelle enquête ;
  2. construire le nouveau modèle ;
  3. seulement ensuite libérer l'ancienne enquête et l'ancien modèle ;
  4. installer les nouveaux objets.

Cette séquence évite de perdre l'enquête actuellement ouverte en cas d'échec.

Contraintes techniques

  • C17 ;
  • aucun état global ;
  • aucune lecture du système de fichiers dans Sidebar ;
  • aucun transfert de propriété vers Sidebar ;
  • documentation Doxygen ;
  • compilation sans warning ;
  • absence de Gtk-CRITICAL ;
  • respect des conventions de nommage.

Critères d'acceptation

  • Le projet compile sans warning.
  • make test reste valide.
  • La sélection d'un dossier construit un modèle.
  • Application conserve le modèle.
  • MainWindow transmet le modèle à Sidebar.
  • La Sidebar affiche le nom du nœud racine.
  • L'ouverture successive de deux dossiers fonctionne.
  • L'ancien modèle est correctement libéré.
  • Une erreur de construction ne provoque pas de crash.
  • La fermeture de l'application libère le modèle.
  • Aucun code de parcours du disque n'apparaît dans Sidebar.
  • Aucun enfant n'est encore affiché.

Tests manuels

  1. Lancer l'application.
  2. Sélectionner le dossier Template.
  3. Vérifier que la Sidebar affiche Template.
  4. Fermer l'application.
  5. Vérifier l'absence de warning critique.
  6. Ouvrir successivement deux dossiers différents.
  7. Vérifier que le titre de la Sidebar est mis à jour.
  8. Vérifier que make test reste entièrement valide.

Commit attendu

feat(gui): connect investigation model to sidebar
## Titre Connecter le modèle d'arborescence à la `Sidebar`. --- ## Objectif Relier l'enquête sélectionnée au panneau latéral. Après la sélection d'un dossier, l'application doit : 1. créer l'objet `Investigation` ; 2. construire son `InvestigationTreeModel` ; 3. transmettre le modèle à la `Sidebar` ; 4. afficher temporairement le nom du nœud racine dans le panneau latéral. Ce ticket valide la communication entre le Core et l'interface graphique. --- ## Architecture ```text FolderDialog │ ▼ Application │ ├── Investigation │ └── InvestigationTreeModel │ ▼ Sidebar ``` Le module `Application` reste responsable de la coordination. La `Sidebar` ne parcourt jamais directement le système de fichiers. --- ## Responsabilités ### Application Le module `Application` doit : - recevoir le dossier sélectionné ; - créer l'objet `Investigation` ; - construire le modèle avec `InvestigationTreeBuilder` ; - conserver le modèle pendant toute la durée de l'enquête ; - transmettre le modèle à `MainWindow` ; - libérer l'ancien modèle avant d'en ouvrir un nouveau ; - libérer le modèle à la fermeture de l'application. ### MainWindow Le module `MainWindow` doit : - recevoir un modèle d'arborescence ; - le transmettre au composant `Sidebar`. ### Sidebar Le module `Sidebar` doit : - recevoir un `InvestigationTreeModel` en lecture seule ; - lire le nœud racine ; - afficher temporairement son nom dans le titre du panneau ; - ne jamais détruire le modèle reçu. --- ## Principe de propriété `Application` est propriétaire de : ```text Investigation InvestigationTreeModel MainWindow ``` La `Sidebar` reçoit uniquement une référence non propriétaire vers le modèle. Elle ne doit jamais appeler : ```c investigation_tree_model_free(tree_model); ``` Le modèle est libéré uniquement par `Application`. --- ## Fichiers concernés ```text src/core/application.c include/views/main_window.h src/views/main_window.c include/widgets/sidebar.h src/widgets/sidebar.c ``` Aucun nouveau module n'est nécessaire. --- ## Interfaces publiques à ajouter ### MainWindow ```c void main_window_set_tree_model( MainWindow *main_window, const InvestigationTreeModel *tree_model ); ``` ### Sidebar ```c void sidebar_set_tree_model( Sidebar *sidebar, const InvestigationTreeModel *tree_model ); ``` --- ## Comportement attendu Avant l'ouverture d'une enquête, la `Sidebar` affiche : ```text Dossier d'enquête ``` Après la sélection du dossier : ```text Template ``` ou le nom réel du dossier racine sélectionné. À ce stade, les enfants ne sont pas encore affichés. --- ## Hors périmètre Ce ticket ne doit pas : - afficher les enfants du nœud racine ; - utiliser `GtkTreeListModel` ; - créer un explorateur de fichiers complet ; - permettre de sélectionner un nœud ; - ouvrir un fichier ; - rafraîchir automatiquement le modèle ; - modifier le système de fichiers ; - communiquer avec SQLite. --- ## Gestion des erreurs Si la construction du modèle échoue : - l'application ne doit pas planter ; - l'ancien modèle doit rester valide jusqu'à son remplacement explicite ; - un message d'erreur doit être affiché dans le terminal ; - la `Sidebar` ne doit recevoir aucun pointeur invalide. Si une nouvelle enquête est ouverte avec succès : 1. créer la nouvelle enquête ; 2. construire le nouveau modèle ; 3. seulement ensuite libérer l'ancienne enquête et l'ancien modèle ; 4. installer les nouveaux objets. Cette séquence évite de perdre l'enquête actuellement ouverte en cas d'échec. --- ## Contraintes techniques - C17 ; - aucun état global ; - aucune lecture du système de fichiers dans `Sidebar` ; - aucun transfert de propriété vers `Sidebar` ; - documentation Doxygen ; - compilation sans warning ; - absence de `Gtk-CRITICAL` ; - respect des conventions de nommage. --- ## Critères d'acceptation - [x] Le projet compile sans warning. - [x] `make test` reste valide. - [x] La sélection d'un dossier construit un modèle. - [x] `Application` conserve le modèle. - [x] `MainWindow` transmet le modèle à `Sidebar`. - [x] La `Sidebar` affiche le nom du nœud racine. - [x] L'ouverture successive de deux dossiers fonctionne. - [x] L'ancien modèle est correctement libéré. - [x] Une erreur de construction ne provoque pas de crash. - [x] La fermeture de l'application libère le modèle. - [x] Aucun code de parcours du disque n'apparaît dans `Sidebar`. - [x] Aucun enfant n'est encore affiché. --- ## Tests manuels 1. Lancer l'application. 2. Sélectionner le dossier `Template`. 3. Vérifier que la `Sidebar` affiche `Template`. 4. Fermer l'application. 5. Vérifier l'absence de warning critique. 6. Ouvrir successivement deux dossiers différents. 7. Vérifier que le titre de la `Sidebar` est mis à jour. 8. Vérifier que `make test` reste entièrement valide. --- ## Commit attendu ```text feat(gui): connect investigation model to sidebar ```
TICKET-011.md
5 KiB
fy59 closed this issue 2026-07-18 08:27:31 +02:00
Sign in to join this conversation.
No Branch/Tag specified
Branches Tags
main
No results found.
Labels
Clear labels
No items
No labels
Milestone
Clear milestone
No items
No milestone
Projects
Clear projects
No items
No project
Assignees
Clear assignees
No assignees
1 participant
Notifications
Due date
The due date is invalid or out of range. Please use the format "yyyy-mm-dd".

No due date set.

Dependencies

No dependencies set.

Reference: fy59/labfy-investigation#12
No description provided.
Delete branch "%!s()"

Deleting a branch is permanent. Although the deleted branch may continue to exist for a short time before it actually gets removed, it CANNOT be undone in most cases. Continue?