Wiki-Designprinzipien

Zusammenfassung

Dieses Wiki dokumentiert die Methodik hinter jedem Rechner auf everycalc. Jeder Artikel erklaert, welche Formel verwendet wird, woher sie stammt, welche Annahmen getroffen werden und wie wir die Genauigkeit anhand offizieller Quellen verifizieren.

Warum es dieses Wiki gibt

Jeder Rechner auf everycalc basiert auf autoritativen Quellen — gov.uk fuer britische Steuern, HMRC fuer National-Insurance-Schwellenwerte, WHO fuer Gesundheitskennzahlen und begutachtete Forschungsarbeiten fuer Fitnessformeln. Ohne Dokumentation haben Nutzer jedoch keine Moeglichkeit, unsere Berechnungen nachzupruefen oder unsere Annahmen zu verstehen.

Dieses Wiki loest drei Probleme:

1. Vertrauen — Nutzer koennen genau sehen, wie Ergebnisse berechnet werden, und unsere Quellen ueberpruefen
2. Genauigkeit — die Dokumentation der Methodik zwingt uns, jede Konstante und Formel zu verifizieren
3. Wartbarkeit — wenn sich Steuersaetze jeden April aendern, wissen wir genau, welche Artikel und Konstanten aktualisiert werden muessen

Artikelstruktur

Jeder Wiki-Eintrag folgt derselben Vorlage:

1. Zusammenfassung — was der Rechner tut, in 50 Woertern
2. Wie es funktioniert — die Methodik in verstaendlicher Sprache
3. Die Formel — die mathematische Formel mit Variablenlegende
4. Rechenbeispiel — schrittweise Berechnung mit realen Zahlen
5. Eingaben erklaert — was jede Eingabe bedeutet, wo man den tatsaechlichen Wert findet
6. Ausgaben erklaert — was jedes Ergebnis im Kontext bedeutet
7. Annahmen und Einschraenkungen — was der Rechner NICHT abdeckt
8. Verifizierung — Testfaelle, die gegen offizielle Tools geprueft wurden, mit Datum

Quellentypen

Jeder Artikel muss mindestens eine autoritative Quelle zitieren. Quellen werden nach Typ klassifiziert:

Verifizierungsstandards

• Finanzrechner muessen gegen den offiziellen Regierungsrechner verifiziert werden (z. B. gov.uk SDLT-Rechner, HMRC-Steuerrechner)
• Gesundheitsrechner muessen die urspruengliche Forschungsarbeit oder klinische Leitlinie zitieren, die die Formel definiert
• Alle Rechner muessen einen Identitaetstest in ihrer Unit-Test-Suite enthalten (z. B. gross = net + tax + NI + pension)
• Verifizierungsdaten werden erfasst — Artikel, die aelter als 6 Monate sind, zeigen ein bernsteinfarbenes Warnbadge an

Qualitaetskontrolle

Ein Build-Time-Skript prueft, ob jeder Rechner in nav.ts einen entsprechenden Wiki-Eintrag hat. Fehlende Eintraege erzeugen Warnungen (spaeter: Build-Fehler).

Wie man einen neuen Artikel beitraegt

1. Erstelle eine neue .mdx-Datei in src/content/wiki/
2. Fuege die erforderlichen Frontmatter-Felder hinzu (title, description, sources etc.)
3. Folge der oben beschriebenen Artikelvorlage
4. Fuege die Zuordnung Rechner-Pfad zu Wiki-Slug in src/data/wikiSlugs.ts hinzu
5. Fuehre npm run build aus, um das Frontmatter-Schema zu validieren
6. Der Artikel erscheint automatisch auf der Wiki-Uebersichtsseite