Principes de conception du wiki

Résumé

Ce wiki documente la méthodologie derrière chaque calculateur d’everycalc. Chaque article explique quelle formule est utilisée, d’où elle provient, quelles hypothèses sont faites, et comment nous vérifions la précision par rapport aux sources officielles.

Pourquoi ce wiki existe

Chaque calculateur d’everycalc est construit à partir de sources faisant autorité : gov.uk pour la fiscalité britannique, HMRC pour les seuils d’assurance nationale (National Insurance), l’OMS pour les indicateurs de santé, et la recherche évaluée par des pairs pour les formules de fitness. Mais sans documentation, les utilisateurs n’ont aucun moyen de vérifier nos calculs ou de comprendre nos hypothèses.

Ce wiki résout trois problèmes :

1. Confiance — les utilisateurs peuvent voir exactement comment les résultats sont calculés et vérifier nos sources
2. Précision — documenter la méthodologie nous oblige à vérifier chaque constante et chaque formule
3. Maintenance — lorsque les taux d’imposition changent chaque avril, nous savons exactement quels articles et quelles constantes mettre à jour

Structure des articles

Chaque entrée du wiki suit le même modèle :

1. Résumé — ce que fait le calculateur, en 50 mots
2. Comment ça marche — la méthodologie en langage courant
3. La formule — la formule mathématique avec une légende des variables
4. Exemple détaillé — calcul pas à pas avec des chiffres réels
5. Entrées expliquées — ce que signifie chaque entrée, où trouver la valeur réelle
6. Résultats expliqués — ce que signifie chaque résultat en contexte
7. Hypothèses et limites — ce que le calculateur ne couvre PAS
8. Vérification — cas de test vérifiés par rapport aux outils officiels, avec dates

Types de sources

Chaque article doit citer au moins une source faisant autorité. Les sources sont classées par type :

Normes de vérification

• Les calculateurs financiers doivent être vérifiés par rapport au calculateur officiel du gouvernement (par exemple, le calculateur SDLT de gov.uk, le calculateur fiscal du HMRC)
• Les calculateurs de santé doivent citer l’article de recherche original ou la directive clinique définissant la formule
• Tous les calculateurs doivent inclure un test d’identité comptable dans leur suite de tests unitaires (par exemple, gross = net + tax + NI + pension)
• Les dates de vérification sont suivies — les articles de plus de 6 mois affichent un badge d’avertissement ambre

Contrôle qualité

Un script de vérification au moment du build s’assure que chaque calculateur dans nav.ts possède une entrée wiki correspondante. Les entrées manquantes génèrent des avertissements (et à terme, des erreurs de build).

Comment contribuer un nouvel article

1. Créer un nouveau fichier .mdx dans src/content/wiki/
2. Ajouter les métadonnées requises (title, description, sources, etc.)
3. Suivre la structure de modèle d’article ci-dessus
4. Ajouter la correspondance chemin du calculateur → slug wiki dans src/data/wikiSlugs.ts
5. Exécuter npm run build pour valider le schéma des métadonnées
6. L’article apparaîtra automatiquement sur la page hub du wiki