labfy-investigation/docs/tickets/closed/TICKET-017.md

Ticket #017

Titre

Ajouter le chemin complet à InvestigationNode.

---

Objectif

Faire évoluer InvestigationNode afin que chaque nœud connaisse le chemin complet qu'il représente sur le système de fichiers.

Cette information permettra ensuite au Workspace et aux futurs visualiseurs de savoir exactement quel fichier ou dossier est sélectionné.

---

Responsabilités

Le module InvestigationNode doit :

• mémoriser un chemin complet ;
• posséder sa propre copie de ce chemin ;
• exposer le chemin en lecture seule ;
• libérer correctement cette chaîne lors de sa destruction.

Le module InvestigationTreeBuilder doit :

• fournir le chemin complet lors de la création de chaque nœud ;
• construire correctement le chemin des enfants ;
• ne jamais reconstruire le chemin dans la GUI.

---

Architecture

InvestigationTreeBuilder
        │
        ▼
InvestigationNode
├── name
├── path
├── type
├── parent
└── children

Le chemin appartient au Core.

La couche graphique ne fait que le lire.

---

Fichiers concernés

include/core/investigation_node.h
src/core/investigation_node.c

src/core/investigation_tree_builder.c

tests/test_investigation_node.c
tests/test_investigation_tree_builder.c

Aucune modification graphique dans ce ticket.

---

API publique à faire évoluer

Le constructeur devient :

InvestigationNode *investigation_node_new(
    const char *name,
    const char *path,
    InvestigationNodeType type
);

Un nouveau getter est ajouté :

const char *investigation_node_get_path(
    const InvestigationNode *node
);

---

Principe de propriété

Le nœud copie le chemin reçu avec une allocation dédiée.

Après :

node = investigation_node_new(
    "Enquete.sqlite",
    "/home/fy59/Enquetes/Test/00_BaseDeDonnees/Enquete.sqlite",
    INVESTIGATION_NODE_FILE
);

le code appelant peut modifier ou libérer ses propres chaînes.

Le nœud reste propriétaire de ses copies internes.

---

Structure interne attendue

struct InvestigationNode
{
    char *name;
    char *path;
    InvestigationNodeType type;
    InvestigationNode *parent;
    GPtrArray *children;
};

La structure reste opaque.

---

Comportement attendu

Pour le dossier racine :

Nom :
Test

Chemin :
/home/fy59/Enquetes/Test

Pour un fichier enfant :

Nom :
Enquete.sqlite

Chemin :
/home/fy59/Enquetes/Test/00_BaseDeDonnees/Enquete.sqlite

---

Règles de validation

Le constructeur doit refuser :

• name == NULL ;
• un nom vide ;
• path == NULL ;
• un chemin vide.

Le getter doit retourner :

NULL

si le nœud vaut NULL.

---

Hors périmètre

Ce ticket ne doit pas :

• afficher le chemin dans le Workspace ;
• ouvrir un fichier ;
• normaliser les permissions ;
• résoudre les liens symboliques ;
• calculer un chemin relatif ;
• modifier le système de fichiers ;
• ajouter des métadonnées.

---

Contraintes techniques

• C17 ;
• GLib autorisée ;
• aucune dépendance GTK ;
• structure opaque ;
• aucun état global ;
• documentation Doxygen ;
• compilation sans warning ;
• aucune fuite mémoire.

---

Critères d'acceptation

• Le projet compile sans warning.
• InvestigationNode possède un chemin.
• Le chemin est copié.
• Le getter retourne le bon chemin.
• Les chemins racine et enfants sont corrects.
• Les noms invalides sont refusés.
• Les chemins invalides sont refusés.
• Le builder construit correctement tous les chemins.
• Tous les tests existants sont adaptés.
• make test reste entièrement valide.
• Aucun code GTK n'est modifié.

---

Tests

InvestigationNode

• créer un nœud avec un chemin valide ;
• lire le chemin ;
• tester path == NULL ;
• tester un chemin vide ;
• vérifier que la chaîne est copiée ;
• tester investigation_node_get_path(NULL).

InvestigationTreeBuilder

• vérifier le chemin de la racine ;
• vérifier le chemin de DirectoryA ;
• vérifier le chemin de FileA.txt ;
• vérifier le chemin de RootFile.md.

---

Commit attendu

feat(core): add path to investigation nodes