75 lines
3.2 KiB
C
75 lines
3.2 KiB
C
/******************************************************************************
|
|
* @file bank_proposal.h
|
|
* @brief Détection, normalisation et modèle de proposition bancaire (IBAN, RIB, BIC).
|
|
******************************************************************************/
|
|
#ifndef LABFY_INVESTIGATION_BANK_PROPOSAL_H
|
|
#define LABFY_INVESTIGATION_BANK_PROPOSAL_H
|
|
|
|
#include "core/controlled_vocab.h"
|
|
#include <glib.h>
|
|
|
|
G_BEGIN_DECLS
|
|
|
|
/** @brief Objet métier représentant une proposition bancaire complète. */
|
|
typedef struct BankProposal
|
|
{
|
|
char *id; /**< UUID de la proposition */
|
|
char *raw_iban; /**< Graphie IBAN brute lue/OCR */
|
|
char *normalized_iban; /**< IBAN nettoyé et majuscule */
|
|
char *raw_bic; /**< Graphie BIC brute observée */
|
|
char *bic; /**< BIC / SWIFT (8 ou 11 car) */
|
|
char *holder_name; /**< Titulaire du compte */
|
|
char *bank_name; /**< Nom de la banque */
|
|
char *bank_address; /**< Adresse de la banque */
|
|
char *country_code; /**< Code pays (ex: "FR") */
|
|
char *bank_code; /**< Code banque (5 ch pour RIB FR) */
|
|
char *branch_code; /**< Code guichet (5 ch pour RIB FR) */
|
|
char *account_number; /**< Numéro de compte (11 car) */
|
|
char *rib_key; /**< Clé RIB (2 ch) */
|
|
gboolean is_iban_valid; /**< VRAI si MOD-97 et format valides */
|
|
char *iban_validation; /**< Résultat : valid, invalid ou indeterminate */
|
|
gboolean is_derived_bban; /**< VRAI si composants dérivés de l'IBAN */
|
|
char *suggested_ocr_fix; /**< Proposition de correction OCR (ex: "O->0") */
|
|
char *verification_status; /**< Code contrôlé: proposed, confirmed, rejected, etc. */
|
|
char *provenance_kind; /**< Code contrôlé: ocr, observed, derived, etc. */
|
|
char *evidence_id; /**< UUID de la preuve source */
|
|
char *extraction_id; /**< UUID de l'extraction source */
|
|
char *created_at; /**< Horodatage ISO 8601 UTC */
|
|
char *updated_at; /**< Horodatage ISO 8601 UTC */
|
|
} BankProposal;
|
|
|
|
/** @brief Libère une structure BankProposal. */
|
|
void bank_proposal_free(BankProposal *proposal);
|
|
|
|
/**
|
|
* @brief Crée une proposition bancaire depuis une chaîne IBAN ou un texte OCR.
|
|
* @param raw_text Texte brut observé / OCR.
|
|
* @param evidence_id UUID de la preuve source (facultatif).
|
|
* @return Nouvelle BankProposal, ou NULL.
|
|
*/
|
|
BankProposal *bank_proposal_analyze_text(const char *raw_text, const char *evidence_id);
|
|
|
|
/**
|
|
* @brief Valide la structure MOD-97 d'un IBAN.
|
|
* @param iban IBAN nettoyé (sans espaces).
|
|
* @return VRAI si valide, FALSE sinon.
|
|
*/
|
|
gboolean bank_proposal_validate_iban(const char *iban);
|
|
|
|
/**
|
|
* @brief Tente de dériver les composants BBAN (RIB) pour un IBAN français valide.
|
|
* @param proposal Proposition bancaire à enrichir.
|
|
* @return VRAI si dérivation réussie, FALSE sinon.
|
|
*/
|
|
gboolean bank_proposal_derive_french_rib(BankProposal *proposal);
|
|
|
|
/**
|
|
* @brief Valide la structure d'un code BIC/SWIFT (8 ou 11 caractères).
|
|
* @param bic Code BIC à vérifier.
|
|
* @return VRAI si valide, FALSE sinon.
|
|
*/
|
|
gboolean bank_proposal_validate_bic(const char *bic);
|
|
|
|
G_END_DECLS
|
|
|
|
#endif /* LABFY_INVESTIGATION_BANK_PROPOSAL_H */
|