CALCU­LATEU­R ET ­CONVE­RTISS­EUR D­'ÉCRI­TURES­ COMP­TABLE­S (TV­A)

/**
 * class="" FinancialEngine
 * @description Moteur d'automatisation comptable et de gestion des arrondis bancaires.
 * Conforme aux exigences du Plan Comptable Général (PCG) et de la norme IEEE 754.
 */
class FinancialEngine {
    constructor(currency = 'EUR', locale = 'fr-FR') {
        this.currency = currency;
        this.locale = locale;
        this.precision = 2;
        this.journalCodes = { ACHAT: 'HA', VENTE: 'VT', BANQUE: 'BQ' };
    }

    /**
     * Sécurise les calculs décimaux contre les dérives binaires de l'arithmétique floating-point
     * @param {number} value - Le montant brut à arrondir
     * @returns {number} Montant corrigé à 2 décimales
     */
    static safeRound(value) {
        return Math.round((value + Number.EPSILON) * 100) / 100;
    }

    /**
     * Calcule l'intégralité d'une ligne de facturation à partir du montant HT
     * @param {number} rawHT - Base Hors Taxes
     * @param {number} taxRatePercentage - Taux nominal (ex: 20)
     * @returns {Object} Structure financière normalisée
     */
    computeFromHT(rawHT, taxRatePercentage) {
        const ht = FinancialEngine.safeRound(parseFloat(rawHT));
        const rate = parseFloat(taxRatePercentage) / 100;
        const tva = FinancialEngine.safeRound(ht * rate);
        const ttc = FinancialEngine.safeRound(ht + tva);

        return { ht, tva, ttc, rate: taxRatePercentage };
    }

    /**
     * Rétro-calcule la base HT et la TVA collectée depuis une valeur TTC
     * @param {number} rawTTC - Montant global Toutes Taxes Comprises
     * @param {number} taxRatePercentage - Taux nominal (ex: 20)
     * @returns {Object} Structure financière normalisée
     */
    computeFromTTC(rawTTC, taxRatePercentage) {
        const ttc = FinancialEngine.safeRound(parseFloat(rawTTC));
        const rate = parseFloat(taxRatePercentage) / 100;
        const ht = FinancialEngine.safeRound(ttc / (1 + rate));
        const tva = FinancialEngine.safeRound(ttc - ht);

        return { ht, tva, ttc, rate: taxRatePercentage };
    }

    /**
     * Génère un livre d'écritures comptables équilibré en partie double
     * @param {Object} financialData - Objet issu des méthodes compute
     * @param {string} allocationCode - Compte de classe 6 (Charges) ou classe 7 (Produits)
     * @param {string} label - Libellé de la pièce comptable
     * @returns {Array<Object>} Suite d'écritures Débit / Crédit
     */
    generateLedgerEntries(financialData, allocationCode = '606300', label = 'Achat Fournisseur') {
        const { ht, tva, ttc } = financialData;
        const timestamp = new Date().toISOString().split('T')[0];
        const batchId = `TX-${Math.random().toString(36).substr(2, 9).toUpperCase()}`;

        const entries = [
            { date: timestamp, id: batchId, journal: this.journalCodes.ACHAT, compte: allocationCode, libelle: `${label} (HT)`, debit: ht, credit: 0 },
            { date: timestamp, id: batchId, journal: this.journalCodes.ACHAT, compte: '445660', libelle: 'TVA déductible sur biens et services', debit: tva, credit: 0 },
            { date: timestamp, id: batchId, journal: this.journalCodes.ACHAT, compte: '401000', libelle: 'Dette Tiers Fournisseur (TTC)', debit: 0, credit: ttc }
        ];

        // Audit de cohérence interne : Validation de l'équilibre Débit / Crédit
        const totalDebit = FinancialEngine.safeRound(entries.reduce((sum, entry) => sum + entry.debit, 0));
        const totalCredit = FinancialEngine.safeRound(entries.reduce((sum, entry) => sum + entry.credit, 0));

        if (totalDebit !== totalCredit) {
            throw new Error(`Erreur critique d'asymétrie comptable : Débit (${totalDebit}) !== Crédit (${totalCredit})`);
        }

        return entries;
    }
}

// Instance d'exécution témoin pour validation d'intégration
try {
    const engine = new FinancialEngine();
    const invoiceLine = engine.computeFromTTC(120.00, 20);
    console.log('Calcul d\'assiette fiscale :', invoiceLine);
    const ledger = engine.generateLedgerEntries(invoiceLine, '606400', 'Fournitures administratives');
    console.table(ledger);
} catch (e) {
    console.error('Échec de la validation de pièce comptable :', e.message);
}