Skip to content

phismith91/dFFA-Rechner

Repository files navigation

dFFA Rechner — Deutsches Feuerwehr‑Fitnessabzeichen (dFFA)

Ein leichtgewichtiges, clientseitiges Web‑Tool zur Berechnung und Auswertung des dFFA. Ziel ist es, Prüfern und Sportler:innen eine schnelle Übersicht über Anforderungen, Einzelauswertungen und Gruppenabnahmen zu bieten.

License: MIT


🚀 Kurz & Knapp

  • Offline‑fähig: Läuft komplett im Browser (keinen Backend‑Server nötig)
  • Einzel- und Gruppenabnahme mit CSV‑Export
  • Offizielle Leistungstabellen eingebunden (DFS)
  • Speicherung der Gruppen über LocalStorage
  • Einfach anpassbar: Disziplinen und Tabellen in data/dffa-data.js

🧩 Features

  • Anforderungs‑Ansicht: Alle Leistungen nach Altersklasse und Disziplin
  • Einzelrechner: Berechnung des erreichten Abzeichens (Bronze / Silber / Gold)
  • Gruppenabnahme: Mehrere Personen verwalten, Ergebnisse exportieren
  • dFFA (ab 18) und dJFFA (Jugend, 10–17 Jahre) als wählbare Varianten
  • Responsive UI: Mobil‑ und Desktop‑optimiert
  • Barrierefreiheit: Semantisches HTML und a11y‑Hinweise

💻 Schnellstart (lokal)

  1. Repo klonen
git clone https://github.com/phismith91/dFFA-Rechner.git
cd dFFA-Rechner
  1. Einfach lokal öffnen (kein Build notwendig):
# Lokalen Webserver starten (empfohlen)
python -m http.server 8000
# oder mit Node.js
npx serve
  1. Im Browser öffnen: http://localhost:8000

📦 Deployment

Die App ist statisch und kann via GitHub Pages oder GitLab Pages gehostet werden.

GitHub Pages: Settings → Pages → Source: main branch → Domain optional

GitLab Pages: Beispiel .gitlab-ci.yml (kopieren aus Projekt‑README)

Tipp: Wenn du eine eigene Subdomain (z. B. dffa.example.de) verwendest, setze in Cloudflare den DNS‑Eintrag als CNAME auf USERNAME.github.io bzw. die entsprechenden GitLab‑Ziele — und achte darauf, die Cloudflare‑Proxy‑Option (orange cloud) zu deaktivieren (nur DNS‑only).


📋 Nutzung

Anforderungen anzeigen

  1. Tab „Anforderungen“ öffnen
  2. Geburtsjahr & Abnahmejahr eingeben
  3. Disziplinen filtern oder alle anzeigen

Einzelabzeichen berechnen

  1. Tab „Einzelrechner“ öffnen
  2. Geburtsjahr & Abnahmejahr eingeben
  3. Disziplin auswählen & Leistung eingeben
  4. „Abzeichen berechnen“ klicken

Gruppenabnahme

  1. Tab „Gruppenabnahme“ öffnen
  2. Jahr der Abnahme wählen
  3. Personen hinzufügen (Name, Geburtsjahr, Leistungen)
  4. Ergebnisse bearbeiten/exportieren (CSV)

🔗 Offizielle Quellen

⚠️ Diese App ist ein inoffizielles Hilfsmittel. Maßgeblich sind die offiziellen Regelungen der Deutschen Feuerwehr‑Sportföderation e.V.


🛠 Entwicklung & Anpassung

  • Code‑Organisation: js/ (Logik), data/ (Tabellen), css/ (Styles)
  • Neue Disziplinen: data/dffa-data.js erweitern (siehe bestehende Struktur)
  • Styles anpassen: css/styles.css (CSS‑Variablen im :root)

Tests

  • js/tests.js enthält die Test‑Suite zur Validierung der Berechnungen, ausführbar per Node (run-tests.js) oder im Browser (test.html)
  • Bitte Tests ausführen nach Änderungen an calculator.js oder dffa-data.js

Versionsnummer

  • Footer in index.html zeigt „Version X.Y | Stand: Monat Jahr“ — bei jedem nennenswerten Release (nicht bei jedem Commit) Versionsnummer und Monat dort von Hand hochzählen

🤝 Mitmachen

  1. Fork → Branch → PR
  2. Schreibe aussagekräftige Commit‑Nachrichten
  3. Tests hinzufügen/aktualisieren

Gern gesehen: Bugfixes, Tests, Verbesserungen der Barrierefreiheit und Übersetzungen.


📝 Lizenz

MIT — siehe LICENSE


📬 Kontakt

Issues auf GitHub: https://github.com/phismith91/dFFA-Rechner/issues


🙏 Danksagung

Danke an die Deutsche Feuerwehr‑Sportföderation e.V. für die Bereitstellung der offiziellen Tabellen und an alle Mitwirkenden.


Hinweis: Die Abnahme des dFFA darf nur durch autorisierte dFFA‑Prüfer:innen erfolgen. Diese Anwendung dient der Vorbereitung und Auswertung, ersetzt aber keine offizielle Prüfung.

About

A calculator web app for dFFA scoring and results.

Topics

Resources

Stars

Watchers

Forks

Releases

Packages

Contributors

Languages