fy59
d65f9559e6
Preserve the local graph-first investigation stack through macro V1. Include reviewed source, tests, contracts, documentation and synthetic assets. Retain the standalone financial V21 test foundation without runtime migration. Runtime remains V20; operational JobStore remains V3. Local experimental checkpoint, not a stable release.
95 lines
3.4 KiB
C
95 lines
3.4 KiB
C
/******************************************************************************
|
|
* @file osint_execution_dao.h
|
|
* @brief Persistance de la provenance des exécutions OSINT.
|
|
******************************************************************************/
|
|
|
|
#ifndef LABFY_INVESTIGATION_OSINT_EXECUTION_DAO_H
|
|
#define LABFY_INVESTIGATION_OSINT_EXECUTION_DAO_H
|
|
|
|
#include "database/database.h"
|
|
#include "models/osint_execution_record.h"
|
|
|
|
G_BEGIN_DECLS
|
|
|
|
/** @brief DAO opaque empruntant une connexion Database. */
|
|
typedef struct OsintExecutionDao OsintExecutionDao;
|
|
|
|
/**
|
|
* @brief Lien typé et possédé entre une exécution et un objet persistant.
|
|
*
|
|
* Les trois chaînes appartiennent à la structure. object_kind vaut entity ou
|
|
* relation et disposition conserve created/reused sans traduction d'affichage.
|
|
*/
|
|
typedef struct
|
|
{
|
|
char *object_kind;
|
|
char *object_identifier;
|
|
char *disposition;
|
|
} OsintExecutionLink;
|
|
|
|
/** @brief Libère un lien typé, ou accepte NULL. */
|
|
void osint_execution_link_free(OsintExecutionLink *link);
|
|
|
|
/** @brief Crée un DAO sur une connexion existante. */
|
|
OsintExecutionDao *osint_execution_dao_new(Database *database, GError **error);
|
|
/** @brief Libère le DAO sans fermer la connexion. */
|
|
void osint_execution_dao_free(OsintExecutionDao *dao);
|
|
/** @brief Insère une exécution sans remplacer une ligne existante. */
|
|
gboolean osint_execution_dao_insert(
|
|
OsintExecutionDao *dao, const OsintExecutionRecord *record, GError **error
|
|
);
|
|
/** @brief Recherche une exécution par UUID et retourne un modèle possédé. */
|
|
OsintExecutionRecord *osint_execution_dao_find_by_identifier(
|
|
OsintExecutionDao *dao, const char *identifier, GError **error
|
|
);
|
|
/**
|
|
* @brief Liste les exécutions d'une sélection, de la plus récente à l'ancienne.
|
|
*
|
|
* @return Tableau possédé de OsintExecutionRecord, ou NULL en cas d'erreur.
|
|
*/
|
|
GPtrArray *osint_execution_dao_list_by_selection(
|
|
OsintExecutionDao *dao, const char *selection_kind,
|
|
const char *selection_identifier, GError **error
|
|
);
|
|
/**
|
|
* @brief Liste toutes les exécutions dans un ordre déterministe.
|
|
*
|
|
* @return Tableau possédé de OsintExecutionRecord trié par date puis UUID.
|
|
*/
|
|
GPtrArray *osint_execution_dao_list_all(
|
|
OsintExecutionDao *dao,
|
|
GError **error
|
|
);
|
|
/**
|
|
* @brief Liste les objets liés à une exécution sous forme de libellés possédés.
|
|
*
|
|
* Chaque libellé indique la nature, l'UUID et la disposition created/reused.
|
|
*
|
|
* @return Tableau possédé de chaînes, ou NULL en cas d'erreur.
|
|
*/
|
|
GPtrArray *osint_execution_dao_list_linked_objects(
|
|
OsintExecutionDao *dao, const char *execution_identifier, GError **error
|
|
);
|
|
/**
|
|
* @brief Liste les liens structurés sans reparcourir les libellés historiques.
|
|
*
|
|
* @return Tableau possédé de OsintExecutionLink, ou NULL en cas d'erreur.
|
|
*/
|
|
GPtrArray *osint_execution_dao_list_links(
|
|
OsintExecutionDao *dao,
|
|
const char *execution_identifier,
|
|
GError **error
|
|
);
|
|
/** @brief Lie une entité créée ou réutilisée à une exécution. */
|
|
gboolean osint_execution_dao_link_entity(
|
|
OsintExecutionDao *dao, const char *execution_identifier,
|
|
const char *entity_identifier, const char *disposition, GError **error
|
|
);
|
|
/** @brief Lie une relation créée ou réutilisée à une exécution. */
|
|
gboolean osint_execution_dao_link_relation(
|
|
OsintExecutionDao *dao, const char *execution_identifier,
|
|
const char *relation_identifier, const char *disposition, GError **error
|
|
);
|
|
|
|
G_END_DECLS
|
|
#endif
|