Ajouter le chemin complet à `InvestigationNode`.

## 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 ```text InvestigationTreeBuilder │ ▼ InvestigationNode ├── name ├── path ├── type ├── parent └── children ``` Le chemin appartient au Core. La couche graphique ne fait que le lire. --- ## Fichiers concernés ```text 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 : ```c InvestigationNode *investigation_node_new( const char *name, const char *path, InvestigationNodeType type ); ``` Un nouveau getter est ajouté : ```c 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 : ```c 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 ```c struct InvestigationNode { char *name; char *path; InvestigationNodeType type; InvestigationNode *parent; GPtrArray *children; }; ``` La structure reste opaque. --- ## Comportement attendu Pour le dossier racine : ```text Nom : Test Chemin : /home/fy59/Enquetes/Test ``` Pour un fichier enfant : ```text 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 : ```c 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 - [x] Le projet compile sans warning. - [x] `InvestigationNode` possède un chemin. - [x] Le chemin est copié. - [x] Le getter retourne le bon chemin. - [x] Les chemins racine et enfants sont corrects. - [x] Les noms invalides sont refusés. - [x] Les chemins invalides sont refusés. - [x] Le builder construit correctement tous les chemins. - [x] Tous les tests existants sont adaptés. - [x] `make test` reste entièrement valide. - [x] 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 ```text feat(core): add path to investigation nodes ```

fy59 commented

2026-07-18 08:37:05 +02:00

Owner

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

TICKET-017.md

4.1 KiB

fy59 closed this issue

2026-07-18 08:37:23 +02:00

Ajouter le chemin complet à InvestigationNode. #18