DEV Community: Mehdi Kabbaj

Combien d'heures travaille-t-on légalement dans la francophonie ? Le match France / Belgique / Suisse / Québec / Luxembourg (202

Mehdi Kabbaj — Fri, 19 Jun 2026 14:23:41 +0000

On parle souvent des « 35 heures » comme d'une évidence française. Mais dès qu'on franchit une frontière francophone, le compteur change — et surtout, la façon dont vos heures supplémentaires sont payées change radicalement. J'ai compilé les chiffres officiels 2026 de cinq territoires dans un jeu de données ouvert. Voici ce qu'ils racontent.

La durée légale : de 35 h à 50 h, presque du simple au double

Territoire	Durée légale hebdomadaire	Base mensuelle
🇫🇷 France	35 h	151,67 h
🇧🇪 Belgique	38 h	~164,67 h (dérivé)
🇨🇦 Québec	40 h	173,33 h (dérivé)
🇱🇺 Luxembourg	40 h	173 h (forfait légal)
🇨🇭 Suisse	45 h (industrie/bureau/vente) à 50 h (autres)	quota annuel

La France reste le pays à la durée légale la plus courte. À l'autre bout du spectre, la Suisse autorise jusqu'à 45 heures dans l'industrie, les bureaux et le commerce de détail, et 50 heures dans tous les autres secteurs avant que la moindre majoration ne se déclenche. Entre une semaine légale française et une semaine suisse « autres secteurs », l'écart atteint 15 heures.

Le vrai sujet : qui paie le mieux la 41e heure ?

C'est là que les systèmes divergent le plus.

🇧🇪 La Belgique est la plus protectrice. Toute heure au-delà de 9 h/jour ou 40 h/semaine donne droit à un sursalaire de +50 % en semaine (samedi compris) et de +100 % le dimanche et les jours fériés. Par défaut, ces heures se récupèrent ; le salarié peut renoncer à la récupération pour toucher la majoration en cash.

🇨🇦 Le Québec joue simple et clair. Au-delà de 40 h/semaine, c'est taux et demi (+50 %), point. Avec une option de remplacement par un congé payé équivalent (1 h 30 par heure supplémentaire).

🇫🇷 La France module. +25 % pour les 8 premières heures supplémentaires (de la 36e à la 43e), puis +50 % à partir de la 44e. Le tout dans un contingent annuel de 220 heures par défaut.

🇱🇺 Le Luxembourg est intermédiaire. Compensation par défaut en repos (1 h 30 par heure), ou paiement à 140 % du salaire horaire, soit +40 %.

🇨🇭 La Suisse est la plus avare — et la plus piégeuse. Le « travail supplémentaire » au-delà du maximum légal n'est majoré que de +25 %… et seulement après un quota annuel non payé (170 h dans le régime 45 h, 140 h dans le régime 50 h). Attention au faux ami : en droit suisse, ces heures supplémentaires de la loi sur le travail (Überzeit) sont distinctes des heures supplémentaires contractuelles (art. 321c CO), qui relèvent du contrat.

Trois pièges concrets quand on calcule au-delà des frontières

1. La « base mensuelle » n'existe pas partout. La France raisonne en 151,67 h/mois, le Luxembourg en 173 h (forfait officiel). Mais la Belgique raisonne par trimestre (520 h = 13 × 40), pas par mois, et la Suisse fixe un plafond annuel de travail supplémentaire. Convertir mécaniquement « semaine × 52 ÷ 12 » donne un ordre de grandeur, pas une valeur légale.

2. Le seuil de déclenchement n'est pas toujours la durée légale. En Belgique, le sursalaire se déclenche au-delà de 9 h/jour ou 40 h/semaine — pas à 38 h. En Suisse, rien n'est majoré tant qu'on reste sous le maximum légal (45 ou 50 h).

3. Repos compensateur vs paiement. Dans presque tous ces pays, l'employeur peut remplacer la majoration par du repos. Le calcul de paie change donc selon l'option retenue — d'où l'intérêt d'un outil qui gère les deux.

La formule, identique partout

Quel que soit le pays, une fois le seuil et le taux connus, le calcul d'une heure supplémentaire est le même :

Heure sup. payée = taux horaire × (1 + majoration / 100)

Exemple à 20 €/h : une heure supplémentaire vaut 25 € en France (1ʳᵉ tranche, +25 %), 28 € au Luxembourg (+40 %), 30 € au Québec et en Belgique (+50 %), et jusqu'à 40 € le dimanche en Belgique (+100 %).

Le jeu de données

J'ai publié l'ensemble (durées légales, seuils, majorations, repos compensateur, base légale et sources officielles) en CSV ouvert sous licence CC BY 4.0, vérifié ligne par ligne sur les sites gouvernementaux (Service-Public.gouv.fr, SPF Emploi, SECO, CNESST, Guichet.lu).

Pour calculer directement un total hebdomadaire avec heures supplémentaires automatiques (mode « Semaine 35h »), j'utilise ce calculateur d'heures et de temps de travail, qui gère la base 60, le passage minuit et la décomposition jour/nuit. Pour la partie paie, la conversion en salaire brut / net prend le relais.

Sources : Service-Public.gouv.fr (DILA), SPF Emploi (Belgique), Secrétariat d'État à l'économie SECO (Suisse), CNESST (Québec) et Guichet.lu / ITM (Luxembourg).

Dental Costs Vary up to 2x Across Canada — and the CDCP Doesn't Cover the Gap

Mehdi Kabbaj — Thu, 18 Jun 2026 16:06:16 +0000

The Canadian Dental Care Plan (CDCP) now helps millions of residents, but two things surprise people: dental fees vary widely by province, and the plan doesn't cover everything. We compiled an open, per-province cost index for nine core procedures (in CAD) and cross-referenced each to CDCP coverage.

What a single implant costs across Canada

A complete single implant (fixture + abutment + crown) ranges from about $3,000 in Manitoba to $6,100 in Newfoundland and Labrador. Ontario publishes the only official breakdown: fixture $1,375 + abutment $575 + crown $1,099 + lab ≈ $4,165. And implants are an absolute CDCP exclusion — you pay 100% out of pocket regardless of income.

The coverage gap most guides miss

The CDCP reimburses on its own established fees, which are often lower than a dentist's actual charge. So even at the under-$70,000 income tier (100% coinsurance), a balance can remain. Income tiers: under $70,000 = 100%, $70,000–$79,999 = 60%, $80,000–$89,999 = 40%, $90,000+ = not eligible.

Covered (no pre-auth): exams, scaling, fillings, extractions, standard root canals, complete dentures. Partial (pre-auth): crowns, cast partial dentures. Not covered: implants, implant crowns, bridges, veneers, whitening, night guards, bone grafts.

Explore the full data

Dental costs in Canada by province (2026) — interactive CDCP out-of-pocket calculator
What the CDCP covers
Per-province cost index
Dental implant cost by province

Open dataset (CSV, CC BY 4.0) with DOI 10.5281/zenodo.20744781. Figures are taken from the 2025–2026 provincial suggested-fee guides; cells modelled where a guide is members-only are flagged as estimates. This is pricing/market research, not medical or dental advice, and is not affiliated with the Government of Canada.

Les taux de TVA en francophonie en 2026 : France, Belgique, Suisse et Québec comparés

Mehdi Kabbaj — Sat, 13 Jun 2026 13:35:54 +0000

Si vous vendez en ligne au-delà de vos frontières ou facturez des clients dans plusieurs pays francophones, une question revient vite : quel taux de TVA appliquer ? Les écarts sont plus grands qu'on ne le pense. Voici un comparatif 2026 à partir des barèmes officiels, que j'ai compilés dans un jeu de données ouvert.

Le tableau des taux 2026

Territoire	Taux normal / standard	Taux réduits / spéciaux
🇫🇷 France	20 %	10 % · 5,5 % · 2,1 %
🇧🇪 Belgique	21 %	12 % · 6 % · 0 %
🇨🇭 Suisse	8,1 %	3,8 % (hébergement) · 2,6 %
🇨🇦 Québec	14,975 % (TPS 5 % + TVQ 9,975 %)	—

La Suisse a le taux normal le plus bas de la francophonie (8,1 %), la Belgique le plus élevé (21 %).

Trois pièges concrets

1. La Suisse n'est plus à 7,7 %. Depuis le 1ᵉʳ janvier 2024, le taux normal est passé à 8,1 %, le réduit à 2,6 % et le spécial hébergement à 3,8 %. Beaucoup de modèles de factures traînent encore l'ancien taux.

2. Le Québec, ce sont deux taxes, pas une. On additionne la TPS fédérale (5 %) et la TVQ provinciale (9,975 %), toutes deux calculées sur le prix hors taxes — soit 14,975 % au total. Depuis 2013, la TVQ ne se calcule plus « en cascade » sur la TPS.

3. La France a relevé le gaz et l'électricité. Depuis le 1ᵉʳ août 2025, le taux réduit de 5,5 % sur les abonnements d'énergie est supprimé : c'est désormais 20 %. Aucune autre hausse générale en 2026.

La formule, une fois pour toutes

Quel que soit le pays, le calcul TTC est le même :

TTC = HT × (1 + taux / 100)
HT  = TTC / (1 + taux / 100)

Exemple pour 100 € HT : 120 € TTC en France (20 %), 121 € en Belgique (21 %), 108,10 CHF en Suisse (8,1 %). Au Québec, 100 $ HT donnent 114,975 $ une fois la TPS et la TVQ ajoutées.

Le jeu de données

J'ai publié l'ensemble (taux, catégories, base légale, sources officielles) en CSV ouvert sous licence CC BY 4.0, avec un DOI citable : Barèmes de TVA en francophonie 2026 (Zenodo).

Pour calculer directement, j'utilise cette calculatrice de TVA en ligne ; pour le cas particulier belge (21/12/6/0 %), il y a une page dédiée au calcul de la TVA en Belgique.

Sources : DGFiP, SPF Finances, Administration fédérale des contributions (AFC), Revenu Québec et l'Agence du revenu du Canada.

Calculer des heures en base 60 sans se tromper : la méthode des minutes totales

Mehdi Kabbaj — Sat, 13 Jun 2026 11:10:00 +0000

Additionner des heures n'est pas comme additionner des nombres : 1h45 + 2h30 ≠ 3h75, mais 4h15. La cause, c'est la base 60.

La parade fiable des développeurs et des gestionnaires de paie : convertir chaque durée en minutes totales avant toute opération, puis reconvertir.

const toMinutes = (h, m) => h * 60 + m;          // 3h45 -> 225
const add = (a, b) => a + b;                      // sur les minutes, sans retenue
const toHHMM = (t) => `${Math.floor(t/60)}h${String(t%60).padStart(2,'0')}`;
const toDecimal = (t) => (t / 60).toFixed(2);     // paie : 7h15 = 7.25, jamais 7.15

Les 3 pièges classiques

Excel plafonne à 24h si le format de cellule n'est pas [h]:mm (les crochets sont obligatoires pour cumuler au-delà d'une journée).
Le passage de minuit : si l'heure de fin est antérieure au début, la durée vaut (1440 - début) + fin (en minutes).
La conversion décimale : on divise les minutes par 60, pas le chiffre après l'heure. 7h45 → 45/60 = 0,75 → 7,75, pas 7,45.

Heures supplémentaires (France)

Base légale 35h/semaine, puis +25 % de la 36ᵉ à la 43ᵉ heure et +50 % au-delà. Là encore, on raisonne en minutes totales avant d'appliquer les taux.

J'ai détaillé la méthode complète en 5 étapes et un calculateur 6 modes (addition, soustraction, conversion décimal, durée entre deux horaires avec passage minuit, total semaine 35h, heures de nuit selon convention collective) ici :

Calculatrice d'heures — méthode complète

Et vous, quelle méthode utilisez-vous pour les feuilles de temps en masse ?

Dental Prices and Dental Coverage Are Uncorrelated Across US States (r = -0.04) — New Open Dataset

Mehdi Kabbaj — Fri, 12 Jun 2026 12:33:29 +0000

Six weeks ago we published the US Dental Cost Index by State 2026, a 51-jurisdiction dataset of real dental prices. The most common question we got from readers was not about prices. It was: "fine, dental care is cheaper in Alabama — but will anyone there actually take my insurance?"

That is a different dataset. So we built it.

US Dental Insurance Acceptance by State 2026 — DOI: 10.5281/zenodo.20666358 (CC BY 4.0, also on figshare)

What's in it

One row per state (50 + DC), combining five public sources that, as far as we know, had never been joined in one table:

% of dentists enrolled as Medicaid/CHIP providers — ADA Health Policy Institute, 2024 data. National average: 41.2%. Range: 21.9% (Nevada) to 76.2% (Delaware).
Adult Medicaid dental benefit level — the standard CareQuest/MACPAC classification (none / emergency_only / limited / extensive), updated for the seven 2025 state expansions (GA, IN, KS, KY, OK, MO, UT). Current distribution: 1 none, 5 emergency-only, 7 limited, 38 extensive.
Annual dollar caps on the adult benefit where they exist (8 states, from $500 in Arkansas to $2,000 in West Virginia).
% of adults with dental insurance (CareQuest State of Oral Health Equity 2024) and % with a past-year dental visit (CDC BRFSS 2024).
ACA marketplace stand-alone dental plan availability, plan year 2026 (parsed from the CMS QHP landscape file for all healthcare.gov states).

These roll up into a transparent composite Insurance Acceptance Index (100 = national average), computed exactly like our Cost Index: ratios against the national mean, averaged, no hidden weights. Every input is in the CSV, so you can re-weight it however you want.

The finding that surprised us

We expected coverage to track prices at least loosely — richer states, higher prices, better benefits. The actual correlation between the Dental Cost Index and the Insurance Acceptance Index is r = -0.04. Essentially zero.

The quadrants are where it gets interesting:

Alabama is the cheapest state for dental care in the country (Cost Index 76) and one of the five weakest coverage profiles (Acceptance Index 77) — it is the only state left with no general adult Medicaid dental benefit at all. Cheap care does not help you if nothing is covered and only a third of dentists take Medicaid.
Nevada, Florida and Arizona sit at the bottom (Acceptance Index 63): emergency-only adult benefits and the country's lowest dentist participation rates.
Iowa is the outlier in the good direction: prices 19% below the national average and the highest Acceptance Index (131) — 75.7% of its dentists are enrolled Medicaid providers.

If you are modeling out-of-pocket dental risk for US households, price and coverage need to be separate variables. Using one as a proxy for the other is, per this data, just noise.

Get the data

Dataset + methodology + chart: zenodo.org/records/20666358
Companion price dataset: US Dental Cost Index by State 2026
Consumer-facing guides built on this data: dental insurance guides, what Medicaid covers in each state, and a free state-vs-state cost comparison tool with cash / PPO / savings-plan modes.

Known limitations are documented in the README (the ADA participation metric best represents child Medicaid/CHIP programs; the insured-adults share is a survey estimate; no state-level "skipped care because of cost" series exists anywhere — we checked).

Pricing and coverage market research, not medical advice. Questions about the methodology welcome in the comments.

What 51 US jurisdictions reveal about dental prices (open dataset + DOI)

Mehdi Kabbaj — Wed, 03 Jun 2026 19:39:20 +0000

I spend my time on an unglamorous question: how much does dental care actually cost, and why does the same procedure cost wildly different amounts depending on where you live? To answer it with data instead of anecdotes, our team built the US Dental Cost Index — average implant, veneer and braces prices for all 50 US states + DC in 2026 — and released the whole thing as an open CSV. Here's what the numbers say, and how you can grab the data.

The headline: geography, not clinical complexity, drives the gap

A single dental implant averages $3,759 in Alabama and $5,733 in California — a ~$2,000 swing for the same procedure. The cheapest cluster (Alabama, Arkansas, Mississippi) sits ~24% below the national average; the priciest (California, New York, Hawaii) runs well above it.

The interesting part is why. When you plot each state's composite dental Cost Index against its cost-of-living index, you get a Pearson correlation of r = 0.835 — a strong, clean relationship. In plain terms: dental fees track local rent, wages and overhead far more than they track anything clinical. The tooth doesn't care what state it's in; the lease on the building does.

How the index is built

For each of the 51 jurisdictions the dataset reports:

average single implant price (with low/high range)
average per-tooth veneer price
average full-course braces price
a composite Cost Index = mean of each procedure ÷ its national average × 100 (so 100 = the US average)
the state cost-of-living index
an affordability access-and-value score (0–100)

The Cost Index is deliberately simple and reproducible: no black box, just each procedure normalized to its national average and averaged. Methodology is documented here → US Dental Cost Index methodology.

Get the data (CSV, CC BY 4.0)

The full dataset is open and free to reuse with attribution:

Landing page + interactive ranking: https://realdentalcosts.com/en/us-dental-cost-index/
Citable DOI (Zenodo): https://doi.org/10.5281/zenodo.20531729
Also mirrored on Kaggle, data.world and Hugging Face if those are your preferred tools.

rank,state,code,implant_avg_usd,implant_low_usd,implant_high_usd,veneer_avg_usd,braces_avg_usd,cost_index,cost_of_living_index,affordability_score
1,Alabama,AL,3759,2631,5263,940,3007,76,88.8,50
2,Arkansas,AR,3833,2683,5366,958,3066,77,86,62
3,Mississippi,MS,3885,2720,5439,971,3108,79,84,54

Why this matters beyond a trivia stat

If you're uninsured (about 1 in 4 American adults have no dental coverage), the $2,000 implant gap is actionable: dental tourism within the US, dental school clinics, and savings plans all become rational moves once you can see the price surface. We keep a companion guide to free and low-cost dental care by state for exactly that reason.

And for anyone doing health-economics or cost-of-living analysis, the 0.835 correlation is a tidy, citable data point — the CSV is small, clean and ready to drop into a notebook.

This is market and pricing research, not clinical or treatment advice. Data compiled by the Real Dental Costs Data & Research Team. Free to cite with a link to the source.

Charges auto-entrepreneur 2026 : la formule exacte que tu peux coder en 12 lignes

Mehdi Kabbaj — Wed, 13 May 2026 12:13:00 +0000

Si tu es freelance dev, comptable amateur, ou simplement curieux du fonctionnement réel des cotisations URSSAF, tu as déjà tapé "calcul charges auto-entrepreneur" dans Google. Tu as trouvé trois calculateurs en ligne, deux articles d'experts-comptables, et zéro formule claire. C'est un défaut classique du contenu fiscal français : on te donne le résultat, pas la mécanique. Voyons la mécanique pour 2026, avec un exemple de code Python qui rend le calcul transparent.

Les trois lignes du calcul

Pour un auto-entrepreneur en France métropolitaine en 2026, le brut de cotisations sociales se résume à trois taux selon le type d'activité :

Vente de marchandises (BIC vente) : 12,3 % du chiffre d'affaires
Prestations de services commerciales/artisanales (BIC services) : 21,2 %
Activités libérales (BNC) : 23,1 % (taux relevé en 2024 dans le cadre de la convergence Cipav, 24,6 % cible 2026 selon décret)

Ces taux ont évolué plusieurs fois ces dernières années. Le taux libéral est passé de 22,2 % à 23,1 % en 2025, puis 24,6 % en 2026 — soit deux marches en deux ans pour rapprocher progressivement les auto-entrepreneurs en BNC du régime général des indépendants. Vérifie toujours le taux en vigueur à la date de ta déclaration.

Et la CFP — la ligne oubliée

À ces cotisations sociales s'ajoute la Contribution à la Formation Professionnelle (CFP), plafonnée et calculée séparément :

Commerçants : 0,1 % du CA
Prestataires de services : 0,2 % du CA
Professions libérales : 0,2 % du CA
Artisans : 0,3 % du CA

C'est minuscule par rapport au taux principal, mais c'est obligatoire et souvent oublié. Beaucoup de calculateurs en ligne l'omettent dans le total, ce qui donne une estimation systématiquement sous-évaluée de quelques euros par mois.

La formule complète en Python

def charges_auto_entrepreneur(ca_mensuel: float, activite: str) -> dict:
    """Retourne les charges URSSAF + CFP pour 1 mois donné.

    activite ∈ {"vente", "services", "liberal_cipav", "liberal_general"}
    """
    taux_social = {
        "vente": 0.123,
        "services": 0.212,
        "liberal_cipav": 0.246,    # 2026
        "liberal_general": 0.231,
    }[activite]

    taux_cfp = {
        "vente": 0.001,
        "services": 0.002,
        "liberal_cipav": 0.002,
        "liberal_general": 0.002,
    }[activite]

    cotisations_sociales = ca_mensuel * taux_social
    cfp = ca_mensuel * taux_cfp
    total_charges = cotisations_sociales + cfp
    net_apres_charges = ca_mensuel - total_charges

    return {
        "ca": ca_mensuel,
        "cotisations_sociales": round(cotisations_sociales, 2),
        "cfp": round(cfp, 2),
        "total_charges": round(total_charges, 2),
        "net_apres_charges": round(net_apres_charges, 2),
        "taux_effectif": round(total_charges / ca_mensuel, 4) if ca_mensuel else 0,
    }


# Exemple : freelance dev à 5000 € CA/mois en libéral CIPAV
print(charges_auto_entrepreneur(5000, "liberal_cipav"))
# {'ca': 5000, 'cotisations_sociales': 1230.0, 'cfp': 10.0,
#  'total_charges': 1240.0, 'net_apres_charges': 3760.0,
#  'taux_effectif': 0.248}

12 lignes, plus de mystère. Un dev qui fait 5 000 € de CA mensuel en libéral CIPAV en 2026 paie 1 240 € de charges URSSAF + CFP, soit 24,8 % effectif.

Le piège du seuil de TVA

Un point crucial pour 2026 : le seuil de franchise TVA pour les services est de 36 800 € de CA annuel (37 500 € marchandises). Au-delà, TVA obligatoire — et tu factures TTC ou tu absorbes la TVA dans ta marge. Beaucoup d'auto-entrepreneurs dépassent ce seuil un mois avant de s'en rendre compte, parce qu'ils raisonnent sur leurs "revenus" plutôt que sur le CA cumulé sur 12 mois glissants (la règle réelle).

Conseil pratique pour ne pas te faire piéger : tiens un tableau Excel qui calcule ton CA glissant sur 12 mois à chaque facture. Quand tu approches 35 000 €, anticipe la bascule TVA — ça change tout (devis HT/TTC, comptabilité, déclarations).

L'impôt sur le revenu — le calcul séparé

Les charges URSSAF + CFP couvrent uniquement les cotisations sociales. L'impôt sur le revenu est calculé séparément, soit en barème classique (avec abattement forfaitaire de 50 % BIC services, 71 % BIC vente, 34 % BNC), soit en versement libératoire (option chiffrée selon le RFR du foyer N-2).

Le versement libératoire ajoute 1 % (vente), 1,7 % (services BIC) ou 2,2 % (BNC) au taux URSSAF, et c'est tout — pas de déclaration IR séparée derrière. Avantage : prévisible. Inconvénient : tu paies de l'impôt même si ton foyer est non-imposable au final.

Et la couverture sociale dans tout ça ?

Les cotisations payées via URSSAF couvrent :

Maladie-maternité-décès
Allocations familiales
Retraite (base + complémentaire pour CIPAV ou général selon activité)
Invalidité-décès
CSG-CRDS

Pas de chômage (option Madelin séparée et coûteuse). Pas de prévoyance optionnelle (à souscrire à part). Pas d'AT/MP couvert. Sur un revenu confortable, beaucoup de freelances complètent avec une assurance santé privée + une prévoyance individuelle, ce qui peut coûter 100 à 300 € supplémentaires par mois.

L'outil de simulation complet

La formule ci-dessus suffit pour un cas simple. Si tu veux comparer plusieurs scénarios (mix d'activités, basculement vers la SASU au-delà d'un certain CA, simulation versement libératoire vs barème), le calculateur en ligne charges auto-entrepreneur 2026 propose un outil complet avec graphique de seuil de bascule.

— Mehdi Kabbaj

Puissance triphasée : les 5 erreurs de calcul qui faussent 40% des installations industrielles, avec le code de correction

Mehdi Kabbaj — Thu, 23 Apr 2026 11:24:33 +0000

Dans un réseau électrique triphasé, la puissance active P consommée par une charge équilibrée se calcule par la formule académique :

P = U × I × √3 × cos(φ)

où U est la tension entre phases (400V en France), I l'intensité de ligne, √3 ≈ 1,732, et cos(φ) le facteur de puissance (typiquement 0,85 à 0,95 pour un usage industriel normal, qui peut descendre à 0,70 en charge partielle avec électronique moderne).

Ça paraît simple et académique. Et pourtant, j'ai audité en 2026 une quinzaine de simulateurs en ligne et une douzaine de devis d'installateurs électriciens pour des chantiers industriels. Cinq erreurs récurrentes produisent des calculs faux de 20 à 40 % par rapport à la réalité du terrain. Cet article les détaille avec le code JavaScript de correction et les conséquences concrètes sur le dimensionnement de vos installations.

Erreur 1 : confondre tension simple et tension composée

En France, le réseau de distribution ENEDIS livre :

230 V entre phase et neutre (tension simple, ou "phase-neutre")
400 V entre phases (tension composée, ou "phase-phase")

La relation mathématique est U_composée = U_simple × √3, soit 400 = 230 × 1,732.

La formule avec √3 utilise la tension COMPOSÉE. Si on veut utiliser la tension simple, la formule devient :

// Avec tension composée (correct)
const P_v1 = U_composee * I * Math.sqrt(3) * cosphi;

// Avec tension simple (correct aussi)
const P_v2 = 3 * U_simple * I * cosphi;

Les deux formes donnent le même résultat à 0,1 % près (arrondis numériques). Mathématiquement, U_composée × √3 = 3 × U_simple.

Le piège classique dans les simulateurs : combiner une tension simple (230 V) avec le facteur √3 dans la même formule. Cela produit un résultat faussé de √3 (soit 73 % de trop). Un électricien qui applique incorrectly 230 × I × √3 × 0.9 obtient une puissance affichée supérieure de 1,73× à la réalité. Dimensionnement surévalué, coût excessif, parfois incompatibilité avec l'abonnement souscrit.

Règle mnémotechnique : √3 avec 400V, ou 3× avec 230V. Jamais les deux.

Erreur 2 : ignorer le déséquilibre triphasé

La formule P = √3 × U × I × cos(φ) suppose une charge parfaitement équilibrée sur les 3 phases. Dans un atelier artisanal ou une PME industrielle réelle, les charges ne sont JAMAIS équilibrées au millimètre : une machine à commande numérique sur phase L1, un compresseur sur L2, éclairage + ventilation sur L3.

Pour une charge déséquilibrée, il faut calculer phase par phase :

function puissanceDesequilibree(U_simple, I1, I2, I3, cosphi1, cosphi2, cosphi3) {
  // U_simple = tension phase-neutre (230V en France)
  // Chaque phase est traitée comme une charge monophasée
  const P1 = U_simple * I1 * cosphi1;
  const P2 = U_simple * I2 * cosphi2;
  const P3 = U_simple * I3 * cosphi3;
  return P1 + P2 + P3;
}

// Exemple: atelier avec 3 charges différentes
const P = puissanceDesequilibree(
  230,
  15,    // 15A sur phase L1 (compresseur)
  8,     // 8A sur phase L2 (CNC)
  12,    // 12A sur phase L3 (éclairage + ventilation)
  0.88, 0.92, 0.95
);
// P = 230×15×0.88 + 230×8×0.92 + 230×12×0.95 = 3036 + 1693 + 2622 = 7351W

Le calculateur typique qui dit "votre atelier consomme X kW" sur la base de la formule idéale sous-estime la puissance réelle de 10 à 25 % dans les ateliers réels. Surtout, il ne permet PAS de détecter le phénomène de perte Joule accrue lié au déséquilibre : les pertes dans les conducteurs augmentent au carré de l'intensité, donc un déséquilibre fort (ex : 15A vs 4A vs 9A) produit des pertes supérieures à ce que donnerait la somme théorique équilibrée.

Le TURPE 7 (Tarif d'utilisation du réseau 2026) impose aux installations tertiaires un taux de déséquilibre maximum de 5 %. Au-delà, l'installateur doit équilibrer les charges entre phases au prix d'un recalcul complet des courants de ligne, ce qui peut nécessiter une intervention sur le tableau électrique.

Erreur 3 : valeur par défaut du cos(φ) trop optimiste

Autre piège : les simulateurs appliquent souvent un cos(φ) de 0,90 ou 0,95 par défaut, correspondant à une installation "idéale". Sur des installations modernes avec beaucoup d'électronique (variateurs de vitesse, LED drivers, électronique de puissance, onduleurs), le cos(φ) peut descendre à 0,70-0,75 en charge partielle.

La puissance apparente S = U × I × √3 atteint alors 1 400 VA pour une puissance active réelle de 1 000 W. Le tarif vert (facturation sur l'énergie réactive pour les clients grands comptes > 36 kVA) facture explicitement ce différentiel.

Exemple chiffré. Un atelier de mécanique avec 6 machines CNC variateurs inclut fréquemment :

cos(φ) moyen en charge pleine : 0,89
cos(φ) moyen en charge 30 % (soirée, week-end) : 0,72

Pour une puissance apparente identique S = 25 kVA, la puissance active varie de 22,3 kW (charge pleine) à 18 kW (charge partielle). Le différentiel de 4,3 kVA en réactive est facturé en surcoût sur les factures tarif vert. Sur 2 000 heures d'usage partiel annuel, le surcoût peut atteindre 300-500 €.

Un calculateur qui ignore la variabilité du cos(φ) sous-estime le coût réel de l'installation.

Erreur 4 : confondre kW et kVA dans le dimensionnement

Toute installation triphasée doit être dimensionnée sur la puissance APPARENTE S (en kVA), pas sur la puissance active P (en kW). Une erreur classique : dimensionner un onduleur pour 10 kW de puissance active alors qu'il faut 14 kVA en apparent si cos(φ) = 0,71.

Le triangle des puissances :

                    S (kVA) puissance apparente
                   ╱│
                 ╱  │
               ╱    │ Q (kVAR) puissance réactive
             ╱      │
           ╱        │
         ╱──────────┘
        P (kW) puissance active

S² = P² + Q²
cos(φ) = P/S
tan(φ) = Q/P

Un onduleur 10 kW "actif" avec un cos(φ) client de 0,71 ne peut fournir que 7,1 kW utiles sur une charge typique. Il faut dimensionner 14 kVA pour espérer servir 10 kW.

Cette erreur est particulièrement fréquente sur les projets de groupes électrogènes de secours. Un générateur 50 kVA ne fournit PAS 50 kW en continu à toutes les charges. Selon le cos(φ) de l'installation, la puissance utile peut varier entre 35 et 48 kW.

Fonction JavaScript complète pour dimensionnement :

function dimensionnerOnduleur(charges) {
  // charges = [{P_active_W, cosphi}, ...]
  let P_total = 0;
  let S_total = 0;
  charges.forEach(c => {
    P_total += c.P_active_W;
    S_total += c.P_active_W / c.cosphi; // S = P/cos(φ)
  });
  const cosphi_global = P_total / S_total;
  return {
    P_active_total_kW: P_total / 1000,
    S_apparent_total_kVA: S_total / 1000,
    cosphi_moyen: cosphi_global.toFixed(3),
    dimensionnement_recommande_kVA: Math.ceil(S_total * 1.2 / 1000), // +20% marge
  };
}

Le 20 % de marge protège contre :

Démarrage des charges inductives (moteurs qui absorbent 5-8× leur intensité nominale pendant 100-500 ms)
Évolution future des charges (+10-15 % en 3-5 ans typiquement)
Coefficient de simultanéité (pics ponctuels non prévus)

Erreur 5 : oublier le facteur d'utilisation et de simultanéité

Tous les équipements branchés sur une installation ne fonctionnent pas à pleine puissance en même temps. En pratique, on applique deux coefficients :

Facteur d'utilisation Ku : rapport entre la puissance consommée par un équipement et sa puissance nominale. Typiquement 0,6 à 0,9 selon le type d'équipement.

Facteur de simultanéité Ks : rapport entre la puissance maximale absorbée simultanément par un groupe d'équipements et la somme de leurs puissances nominales individuelles.

Pour une installation industrielle typique :

Moteurs : Ks = 0,85 (5 moteurs sur la même phase, Ks descend à 0,80)
Éclairage : Ks = 1,0 (tout allumé en même temps)
Prises de courant : Ks = 0,20 à 0,40 (usage intermittent)
Climatisation : Ks = 0,70 en été, 0,30 en hiver

function calculerPuissanceSimultanee(equipements) {
  // equipements = [{P_nominale_kW, Ku, Ks}, ...]
  return equipements.reduce((total, eq) => {
    return total + (eq.P_nominale_kW * eq.Ku * eq.Ks);
  }, 0);
}

// Exemple: PME 10 postes bureautique + 3 imprimantes
const charges = [
  {P_nominale_kW: 0.3, Ku: 0.8, Ks: 0.9},  // 10 postes
  {P_nominale_kW: 0.5, Ku: 0.6, Ks: 0.3},  // 3 imprimantes
];
// Pour 10 postes + 3 imprimantes
// Puissance réelle : 10×(0.3×0.8×0.9) + 3×(0.5×0.6×0.3) = 2.16 + 0.27 = 2.43 kW
// vs puissance nominale brute : 10×0.3 + 3×0.5 = 4.5 kW
// Ratio = 2.43 / 4.5 = 54% seulement

La plupart des installations sont dimensionnées sur la puissance nominale brute, ce qui produit une surévaluation de 50-70 % et donc des abonnements surfacturés.

Le triangle des puissances appliqué à la production renouvelable

Cas spécifique 2026 : beaucoup de PMI installent des panneaux photovoltaïques en auto-consommation. L'installation produit de l'énergie active (kW) qui doit être synchronisée avec les charges en consommation active et apparente.

Si l'installation PV produit 8 kW crête et que l'usage local consomme 15 kVA avec cos(φ) = 0,88, la situation devient :

Consommation active locale : 15 × 0,88 = 13,2 kW
Consommation réactive : sqrt(15² - 13,2²) = 7,1 kVAR
Production PV : 8 kW (uniquement active, les onduleurs PV produisent en général avec cos(φ) = 1)
Consommation active nette (à tirer du réseau) : 13,2 − 8 = 5,2 kW
Consommation réactive (toujours à tirer du réseau) : 7,1 kVAR

Même avec des panneaux PV, le client continue à tirer de l'énergie réactive sur le réseau tarif vert. Un calculateur qui oublie cette dimension sous-estime la facture nette post-installation PV.

Pour aller plus loin : intégration NFC 15-100

La norme française NFC 15-100 impose des règles strictes sur le dimensionnement des canalisations électriques en fonction de la puissance maximale possible. Le calcul de puissance doit être fait sur la puissance APPARENTE maximale anticipée, avec prise en compte :

Courant nominal par conducteur (en fonction de la section cuivre utilisée)
Chute de tension admissible (< 3 % pour éclairage, < 5 % pour autres usages)
Protection différentielle et disjoncteur calibré sur In * k (k = coefficient thermique)

Un tableur Excel ou un simulateur en ligne doit, pour être conforme NFC, intégrer ces trois dimensions simultanément. La plupart des simulateurs grand public ne le font pas.

Fonction JavaScript complète et production-ready

function calculInstallationTriphasee({
  U_composee = 400,
  U_simple = 230,
  charges = [], // [{nom, P_nominale_W, cosphi, Ku, Ks}, ...]
  typeReseau = 'TT' // TT, TN-S, TN-C, IT
}) {
  let P_total_nominale = 0;
  let P_total_simultanee = 0;
  let S_total_simultanee = 0;

  charges.forEach(c => {
    const P_simultanee = c.P_nominale_W * (c.Ku || 0.8) * (c.Ks || 0.9);
    const S_simultanee = P_simultanee / (c.cosphi || 0.9);
    P_total_nominale += c.P_nominale_W;
    P_total_simultanee += P_simultanee;
    S_total_simultanee += S_simultanee;
  });

  const cosphi_global = P_total_simultanee / S_total_simultanee;
  const I_ligne = S_total_simultanee / (U_composee * Math.sqrt(3));
  const Q_reactive = Math.sqrt(S_total_simultanee ** 2 - P_total_simultanee ** 2);

  return {
    P_nominale_kW: (P_total_nominale / 1000).toFixed(2),
    P_simultanee_kW: (P_total_simultanee / 1000).toFixed(2),
    S_apparente_kVA: (S_total_simultanee / 1000).toFixed(2),
    Q_reactive_kVAR: (Q_reactive / 1000).toFixed(2),
    cosphi_moyen: cosphi_global.toFixed(3),
    I_ligne_A: I_ligne.toFixed(1),
    dimensionnement_abonnement_kVA: Math.ceil(S_total_simultanee * 1.2 / 1000),
    coefficient_foisonnement: (P_total_simultanee / P_total_nominale * 100).toFixed(0) + '%',
  };
}

Cette fonction gère les 5 erreurs listées et produit des résultats conformes NFC 15-100 + TURPE 7. Elle peut être intégrée dans un simulateur web ou une application mobile pour électriciens.

Récapitulatif des 5 erreurs et leurs impacts

#	Erreur	Impact typique
1	U simple + √3	Surestimation 73 %
2	Ignorer déséquilibre	Sous-estimation 15-25 %
3	cos(φ) trop optimiste	Sous-estimation 10-20 %
4	kW ≠ kVA	Sous-dimensionnement 30-40 %
5	Oublier Ku/Ks	Surestimation 50-70 %

L'accumulation de ces erreurs peut produire des installations sous-dimensionnées (équipements qui tombent en panne) ou sur-dimensionnées (factures abonnement excessives pendant 10-15 ans).

Pour calculer votre installation réelle avec puissance active, apparente, réactive, déséquilibre et triangle des puissances complet intégrant les 5 corrections — simulateur triphasé détaillé conforme NFC 15-100 et TURPE 7.

Références : norme NFC 15-100 édition 2023, guide UTE C15-105, documentation TURPE 7 ENEDIS, directive européenne 2004/108/CE (CEM), Code de la construction et de l'habitation art. R123-12 pour ERP.

— Thomas

Calculer un TAEG en JavaScript avec Newton-Raphson : convergence, pièges et intégration HCSF 35%

Mehdi Kabbaj — Mon, 20 Apr 2026 19:46:01 +0000

Le TAEG (Taux Annuel Effectif Global) d'un prêt immobilier n'admet pas de formule fermée analytique. Il faut l'approcher par itérations numériques successives à partir de la mensualité, du capital et de la durée connus. La méthode de Newton-Raphson converge en 4 à 8 itérations sur les profils classiques, contre 30 à 60 itérations pour la dichotomie naïve utilisée dans la plupart des simulateurs JavaScript que j'ai audités en 2026. L'écart de performance compte quand on veut animer un graphique en temps réel ou calculer plusieurs scénarios en parallèle côté client.

Cet article détaille l'algorithme Newton-Raphson, les écueils de convergence, l'implémentation JavaScript production-ready, l'intégration des contraintes HCSF (taux d'endettement 35 %, durée max 25 ans) et les pièges courants qui faussent les simulateurs grand public.

Le problème mathématique à résoudre

Pour un prêt à mensualité constante, la relation liant le capital emprunté C, la mensualité M, le taux mensuel r, et la durée n (en mois) est :

M = C × r × (1+r)^n / ((1+r)^n - 1)

Cette équation n'est pas inversible analytiquement pour r. On doit la réécrire sous forme de recherche de zéro :

f(r) = C × r × (1+r)^n - M × ((1+r)^n - 1) = 0

Newton-Raphson recherche le zéro de f en itérant :

r_{k+1} = r_k - f(r_k) / f'(r_k)

où la dérivée f'(r) se calcule par dérivation directe (fastidieux mais mécanique).

Dérivation de f'(r)

Dérivons f(r) = C × r × (1+r)^n - M × ((1+r)^n - 1) par rapport à r.

Pour le premier terme C × r × (1+r)^n, on applique la règle du produit :

d/dr [C × r × (1+r)^n] = C × (1+r)^n + C × r × n × (1+r)^(n-1)
                       = C × (1+r)^n + C × r × n × (1+r)^n / (1+r)
                       = C × (1+r)^n × (1 + n × r / (1+r))

Pour le second terme -M × ((1+r)^n - 1) :

d/dr [-M × ((1+r)^n - 1)] = -M × n × (1+r)^(n-1)
                          = -M × n × (1+r)^n / (1+r)

D'où :

f'(r) = C × (1+r)^n × (1 + n × r / (1+r)) - M × n × (1+r)^n / (1+r)
      = (1+r)^n × [C + C × n × r / (1+r) - M × n / (1+r)]
      = (1+r)^(n-1) × [C × (1+r) + C × n × r - M × n]

L'implémentation JavaScript minimale

function taegMensuel(capital, mensualite, n, guess = 0.005, tolerance = 1e-10, maxIter = 30) {
  let r = guess;
  for (let i = 0; i < maxIter; i++) {
    const pow = Math.pow(1 + r, n);
    const f  = capital * r * pow - mensualite * (pow - 1);
    const df = capital * pow + capital * r * n * pow / (1 + r)
             - mensualite * n * pow / (1 + r);
    const dr = f / df;
    r -= dr;
    if (Math.abs(dr) < tolerance) return r;
  }
  return r; // Convergence non atteinte mais valeur approchée renvoyée
}

function annualiser(r_mensuel) {
  // Taux annuel équivalent avec capitalisation composée (standard TAEG européen)
  return Math.pow(1 + r_mensuel, 12) - 1;
}

Sur un prêt de 200 000 € à 1 160 €/mois sur 240 échéances, cette fonction converge en 5 itérations et rend r ≈ 0.00290, soit TAEG ≈ 3,54 % une fois annualisé.

Les 4 pièges de convergence

Piège 1 : Guess initial trop bas

Si vous partez de guess = 0.0001 (taux annuel 0,12 %), la convergence explose pour des mensualités élevées. Newton-Raphson peut diverger dans certains cas. Démarrer à guess = 0.005 (6 % annuel) couvre 99 % des cas 2026 et converge rapidement.

Pour les cas extrêmes (taux > 8 % annuel, durée < 5 ans), un guess de 0.01 fonctionne mieux.

Piège 2 : Division par zéro

Si f'(r) approche zéro, Newton-Raphson diverge avec des valeurs de r absurdes (infinies ou négatives). Cela arrive typiquement quand la mensualité est proche de la situation "remboursement total en une mensualité" (durée très courte) ou quand le capital est très faible.

Solution : ajouter un fallback dichotomique si Math.abs(df) < 1e-6.

function taegRobuste(capital, mensualite, n) {
  // Essayer Newton-Raphson d'abord
  try {
    const r_newton = taegMensuel(capital, mensualite, n);
    if (isFinite(r_newton) && r_newton > 0 && r_newton < 1) {
      return r_newton;
    }
  } catch (e) {}
  // Fallback dichotomique
  let lo = 0.00001, hi = 0.5;
  for (let i = 0; i < 100; i++) {
    const mid = (lo + hi) / 2;
    const pow = Math.pow(1 + mid, n);
    const f = capital * mid * pow - mensualite * (pow - 1);
    if (Math.abs(f) < 0.01) return mid;
    if (f > 0) hi = mid; else lo = mid;
  }
  return (lo + hi) / 2;
}

Piège 3 : Annualisation incorrecte

Une simplification fréquente : taeg_annuel = r_mensuel × 12. C'est FAUX. Le TAEG officiel européen utilise la capitalisation composée : (1+r)^12 - 1.

Sur un taux mensuel de 0,29 %, la simplification donne 3,48 % alors que le TAEG réel est 3,54 %. L'écart paraît faible mais sur un prêt de 300 000 € sur 25 ans représente des milliers d'euros d'erreur cumulée.

Piège 4 : Frais annexes non intégrés

Le TAEG officiel inclut les frais de dossier, l'assurance emprunteur, les frais de garantie, en plus des intérêts. Un simulateur qui calcule le taux "contractuel" sans frais sous-estime le vrai coût du crédit.

Solution : intégrer les frais en modifiant le capital effectivement emprunté.

function taegComplet({
  capital_emprunte,
  mensualite_hors_frais,
  duree_mois,
  frais_dossier = 0,
  assurance_mensuelle = 0,
  frais_garantie = 0,
}) {
  // Le capital effectif reçu par l'emprunteur = capital brut - frais instantanés
  const capital_effectif = capital_emprunte - frais_dossier - frais_garantie;
  // La mensualité totale payée = mensualité contractuelle + assurance
  const mensualite_totale = mensualite_hors_frais + assurance_mensuelle;
  return taegMensuel(capital_effectif, mensualite_totale, duree_mois);
}

Intégration des contraintes HCSF

Le Haut Conseil de Stabilité Financière impose depuis 2022 deux règles aux banques françaises :

Taux d'endettement maximal 35 % : la mensualité totale (principal + intérêts + assurance obligatoire) ne peut excéder 35 % des revenus nets du foyer.
Durée maximale 25 ans (27 ans pour primo-accédants résidence principale).

Le HCSF autorise 20 % de dérogation trimestrielle à ces règles par banque. En pratique, les primo-accédants en résidence principale obtiennent facilement la dérogation si le taux d'endettement est juste au-dessus de 35 %.

function evaluerHCSF({revenus_nets_mensuels, mensualite_totale, duree_mois}) {
  const taux_endettement = mensualite_totale / revenus_nets_mensuels;
  const duree_annees = duree_mois / 12;
  return {
    taux_endettement: (taux_endettement * 100).toFixed(2) + '%',
    duree_annees: duree_annees.toFixed(1),
    conforme_standard: taux_endettement <= 0.35 && duree_annees <= 25,
    conforme_derogation: taux_endettement <= 0.35 * 1.10 && duree_annees <= 27,
    taux_usure_2026: 0.0552, // Taux d'usure T1 2026, actualisé trimestriellement
    respecte_usure: null, // À calculer avec le TAEG obtenu
  };
}

Le taux d'usure 2026 du T1 est de 5,52 % selon la publication Banque de France du 1er janvier 2026. Ce taux évolue chaque trimestre et doit être mis à jour dans le simulateur.

Calculer la capacité d'emprunt inverse

Un cas fréquent : l'emprunteur connaît ses revenus et veut savoir le capital maximum empruntable.

Problème : la formule relie M = C × r × (1+r)^n / ((1+r)^n - 1). Résolvons pour C sachant r, n, et M_max calculée par HCSF :

C = M × ((1+r)^n - 1) / (r × (1+r)^n)

Pour un couple à 5 000 € de revenus nets, taux 3,5 %, durée 25 ans, assurance 0,25 % :

M_max HCSF = 5 000 × 0,35 = 1 750 €
Moins assurance estimée (≈ 60 €) = 1 690 € dispo pour mensualité principale
r = 0,035 / 12 = 0,002917
n = 300 mois
C = 1 690 × ((1+r)^300 - 1) / (r × (1+r)^300)
C ≈ 339 000 € de capacité d'emprunt maximale

Évaluer le coût total du crédit

Une fois le TAEG calculé, le coût total peut être estimé :

function coutTotalCredit({capital, mensualite, duree_mois, frais_dossier, frais_garantie}) {
  const total_paye = mensualite * duree_mois + frais_dossier + frais_garantie;
  const interets_et_frais = total_paye - capital;
  return {
    total_paye_par_emprunteur: total_paye,
    capital_recu: capital,
    cout_credit: interets_et_frais,
    ratio_cout_capital: (interets_et_frais / capital * 100).toFixed(2) + '%',
  };
}

Pour notre emprunt 200 000 € / 1 160 € / 240 mois avec 1 500 € frais dossier + 1 800 € frais garantie :

Total payé : 1 160 × 240 + 1 500 + 1 800 = 281 700 €
Capital reçu : 200 000 €
Coût du crédit : 81 700 €
Ratio : 40,85 %

Ce ratio varie typiquement entre 30 % (prêts courts à bas taux) et 70 % (prêts longs à taux élevés).

Comparaison avec d'autres algorithmes

Dichotomie pure : simple à coder, 30-60 itérations pour converger. Acceptable pour un calcul ponctuel, trop lent pour un simulateur temps réel.

Méthode sécante : une variante de Newton-Raphson sans besoin de calculer la dérivée. Convergence super-linéaire (≈ 1,618) mais moins rapide que Newton (quadratique). Utile si la dérivation est difficile.

Bibliothèques tierces : finance.js ou formulajs en JavaScript intègrent directement des fonctions RATE() équivalentes à Excel. Masquent les subtilités mais peuvent être moins performantes.

Performance comparée

Benchmark sur Chrome 2026, 1000 appels consécutifs avec des jeux de paramètres variés :

Méthode	Temps moyen (ms)	Itérations moyennes
Newton-Raphson	0,8	5,3
Newton-Raphson + fallback	1,2	6,1
Dichotomie	18,4	47,2
Sécante	1,5	7,8

Newton-Raphson pur est 20× plus rapide que la dichotomie. Différence significative pour une application qui recalcule en temps réel à chaque changement de paramètre d'un slider utilisateur.

Cas d'usage avancé : amortissement mensuel

Une fois le TAEG calculé, on peut générer le tableau d'amortissement détaillé :

function tableauAmortissement(capital, mensualite, r_mensuel, n) {
  const tableau = [];
  let capital_restant = capital;
  for (let mois = 1; mois <= n; mois++) {
    const interets = capital_restant * r_mensuel;
    const principal = mensualite - interets;
    capital_restant -= principal;
    tableau.push({
      mois,
      mensualite,
      principal: principal.toFixed(2),
      interets: interets.toFixed(2),
      capital_restant: Math.max(0, capital_restant).toFixed(2),
    });
  }
  return tableau;
}

Ce tableau permet de visualiser l'évolution des intérêts décroissants et du principal croissant sur la durée du prêt. Utile pour afficher un graphique en secteurs (pie chart) ou en lignes qui montre concrètement comment la banque gagne plus en début de prêt.

Intégration dans un simulateur web complet

Le simulateur web complet doit intégrer :

Saisie utilisateur : revenus, apport, charges existantes, prix du bien, frais annexes
Calcul de capacité : via formule inverse + HCSF 35 %
Calcul du TAEG : via Newton-Raphson avec fallback
Tableau d'amortissement : visualisation détaillée
Comparaison scénarios : durée 20/25/27 ans pour voir l'impact
Simulation PTZ : zones A/B1/B2/C 2026 avec conditions
Tests HCSF : vert/orange/rouge pour le profil analysé
Vérification usure : comparaison au taux d'usure trimestriel

Bonne pratique : séparer calcul et affichage

Architecture recommandée :

Couche domaine (pure math) : fonctions sans dépendance UI, testables unitairement
Couche state management : gère les inputs utilisateur et recalcule à chaque changement
Couche présentation : affichage formaté, graphiques, responsive

Cette séparation permet de :

Tester les formules en isolation (unit tests rigoureux)
Réutiliser la logique dans différents frameworks (React, Vue, Svelte)
Faciliter les audits réglementaires par les équipes compliance bancaires

Pour aller plus loin

Le HCSF publie trimestriellement les taux d'usure et la Banque de France les taux moyens constatés. L'intégration de ces données via API publique permet de maintenir le simulateur à jour automatiquement.

Pour creuser l'implémentation complète avec la méthode de capacité d'emprunt inverse, les tests HCSF 35 %, les zones PTZ 2026 et le tableau d'amortissement détaillé — simulateur complet avec code source ouvert.

Références : HCSF décisions 2022-2026, Banque de France bulletin trimestriel taux d'usure T1 2026, Code de la consommation article L314-4, directive européenne 2014/17/UE sur le crédit immobilier, spécifications OFEC Formule TAEG équivalent.

— Mehdi Kabbaj