{% extends "base.html" %}
{% from "ui/page_header.html" import page_header %}
{% from "ui/help_section.html" import help_section %}

{% block title %}Hilfe{% endblock %}
{% block page_class %}help-page{% endblock %}

{% block content %}
  {{ page_header("Hilfe", "Hier findest du alle wichtigen Funktionen des Stundenfuchs verständlich erklärt.") }}

  <section class="help-intro">
    <p>
      Stundenfuchs hilft dir dabei, Arbeitszeiten, Urlaub, Feiertage, Krankheitstage und Überstunden an einem Ort zu verwalten.
      Die App ist so aufgebaut, dass du im Alltag schnell arbeiten kannst, ohne jede Berechnung selbst im Kopf machen zu müssen.
    </p>
    <p>
      Wenn du neu startest, beginne am besten mit der Wochenansicht. Dort kannst du Tage eintragen, bearbeiten und direkt sehen,
      wie sich deine Stunden verändern.
    </p>
  </section>

  <section class="help-guides">
    <header class="help-guides__header">
      <h2>Schritt-für-Schritt-Anleitungen</h2>
      <p class="muted">Die wichtigsten Abläufe einmal komplett erklärt. Du kannst diese Anleitungen direkt nacheinander durchgehen.</p>
    </header>
    <div class="help-guides__grid">
      <article class="help-guide-card">
        <h3>Einen normalen Arbeitstag eintragen</h3>
        <ol class="help-steps">
          <li>Gehe in die Wochen- oder Monatsansicht.</li>
          <li>Klicke beim gewünschten Tag auf <strong>+</strong> oder auf <strong>Bearbeiten</strong>.</li>
          <li>Wähle <strong>Zeit</strong>, wenn du einen normalen Arbeitstag erfassen möchtest.</li>
          <li>Trage Arbeitsbeginn und Arbeitsende ein. Wenn du die automatische Pausenregel aktiviert hast, schlägt Stundenfuchs die gesetzliche Mindestpause automatisch vor.</li>
          <li>Du kannst die Pause trotzdem jederzeit manuell ändern. Dann bleibt dein eigener Wert maßgeblich.</li>
          <li>Speichere den Eintrag. Die App berechnet Nettozeit, Ist-Stunden und Delta automatisch.</li>
        </ol>
      </article>
      <article class="help-guide-card">
        <h3>Urlaub, Feiertag oder Krankheit eintragen</h3>
        <ol class="help-steps">
          <li>Klicke beim gewünschten Tag auf <strong>+</strong>.</li>
          <li>Wähle <strong>Urlaub</strong>, <strong>Feiertag</strong> oder <strong>Krankheit</strong>.</li>
          <li>Der Status wird sofort gesetzt. Danach erscheint der Tag direkt in der Liste mit dem passenden Kürzel.</li>
          <li>Wenn nötig, kannst du den Status später wieder ändern oder entfernen.</li>
        </ol>
      </article>
      <article class="help-guide-card">
        <h3>Stundenausgleich buchen</h3>
        <ol class="help-steps">
          <li>Klicke am gewünschten Tag auf <strong>+</strong> und wähle <strong>Stundenausgleich</strong>.</li>
          <li>Entscheide dich für eine der drei Varianten: <strong>Stunden</strong>, <strong>Von-Bis Uhrzeit</strong> oder <strong>Ganzer Tag</strong>.</li>
          <li>Wähle, ob der Ausgleich positiv oder negativ sein soll.</li>
          <li>Speichere den Eintrag. In der Liste erscheint der Tag danach mit dem <strong>S</strong>-Symbol.</li>
          <li>Der Ausgleich verändert direkt deinen Überstundenstand, ohne als normale Arbeitszeit zu zählen.</li>
        </ol>
      </article>
      <article class="help-guide-card">
        <h3>Arbeitsstunden-Counter einrichten</h3>
        <ol class="help-steps">
          <li>Öffne die <strong>Einstellungen</strong>.</li>
          <li>Gehe zum Bereich <strong>Arbeitsstunden-Counter</strong>.</li>
          <li>Aktiviere den Counter und trage Start- und Enddatum ein.</li>
          <li>Optional kannst du Zusatzstunden, ein Ziel und die Anzeige im Header aktivieren.</li>
          <li>Speichere die Einstellungen. Danach siehst du deinen Stand direkt im Einstellungsbereich und auf Wunsch oben im Header.</li>
        </ol>
      </article>
      <article class="help-guide-card">
        <h3>Backup importieren</h3>
        <ol class="help-steps">
          <li>Öffne die <strong>Einstellungen</strong> oder nutze den Backup-Upload direkt in der Registrierung.</li>
          <li>Wähle deine Backup-Datei aus.</li>
          <li>Entscheide, ob du deine Daten <strong>zusammenführen</strong> oder <strong>vollständig ersetzen</strong> möchtest.</li>
          <li>Prüfe die Vorschau mit Datensatzanzahl und Konflikten.</li>
          <li>Starte erst danach den eigentlichen Import.</li>
        </ol>
      </article>
    </div>
  </section>

  <section class="help-grid">
    {% call help_section("Schnellstart", "So kommst du am schnellsten zu einem sauberen Stundenstand.") %}
      <ol class="help-steps">
        <li>Lege in den Einstellungen deine Wochenstunden und relevanten Arbeitstage fest.</li>
        <li>Trage in der Wochenansicht deine regulären Arbeitstage ein oder markiere Urlaub, Feiertag oder Krankheit.</li>
        <li>Nutze den Stundenausgleich, wenn du Plus- oder Minusstunden ohne normale Arbeitszeit buchen möchtest.</li>
        <li>Kontrolliere oben in den Kacheln dein aktuelles Delta und den kumulierten Stand.</li>
      </ol>
    {% endcall %}

    {% call help_section("Die Kopfzeile", "Die Leiste oben zeigt dir jederzeit die wichtigsten Werte.") %}
      <ul class="help-list">
        <li><strong>Urlaub</strong>: zeigt den verbleibenden Urlaub im Verhältnis zum Gesamturlaub.</li>
        <li><strong>Arbeitsstunden</strong>: erscheint nur, wenn du den Arbeitsstunden-Counter aktiviert hast.</li>
        <li><strong>Kumuliert</strong>: zeigt deinen gesamten Überstundenstand bis heute.</li>
        <li><strong>Woche / Monat</strong>: wechselt zwischen den beiden Hauptansichten.</li>
        <li><strong>Einstellungen</strong>: hier legst du alle persönlichen Regeln fest.</li>
        <li><strong>Hilfe</strong>: öffnet diese Erklärung.</li>
      </ul>
    {% endcall %}

    {% call help_section("Wochenansicht", "Die Wochenansicht ist der schnellste Weg für den Alltag.") %}
      <ul class="help-list">
        <li>Oben siehst du die ausgewählte Kalenderwoche mit Datumsspanne.</li>
        <li>Die Kacheln <strong>IST</strong>, <strong>SOLL</strong>, <strong>DELTA</strong> und <strong>KUMULIERT</strong> werden automatisch berechnet.</li>
        <li>Jeder Tag erscheint als eigene Zeile. Dort kannst du direkt sehen, was eingetragen ist.</li>
        <li>Leere Tage erkennst du an <strong>Keinen Eintrag</strong> und dem <strong>+</strong>-Button rechts.</li>
      </ul>
    {% endcall %}

    {% call help_section("Monatsansicht", "Die Monatsansicht eignet sich gut für Rückblicke und längere Zeiträume.") %}
      <ul class="help-list">
        <li>Der Monat ist in Kalenderwochen gegliedert, damit du längere Zeiträume übersichtlich prüfen kannst.</li>
        <li>Jede Woche zeigt eine eigene Zusammenfassung mit Ist, Soll, Delta und Urlaubstagen.</li>
        <li>Du kannst Tage auch hier direkt bearbeiten, ohne in die Wochenansicht zu wechseln.</li>
      </ul>
    {% endcall %}

    {% call help_section("Arbeitszeit eintragen", "Für normale Arbeitstage nutzt du immer den Zeiteintrag.") %}
      <ul class="help-list">
        <li>Gib <strong>Arbeitsbeginn</strong> und <strong>Arbeitsende</strong> an. Die Pause kannst du direkt mitpflegen.</li>
        <li>Wenn du in den Einstellungen die automatische Pausenregel aktiviert hast, setzt Stundenfuchs nach deutschem Arbeitsrecht automatisch mindestens 30 oder 45 Minuten Pause, sobald die Arbeitszeit lang genug ist.</li>
        <li>Manuelle Änderungen an der Pause haben immer Vorrang vor dem automatisch vorgeschlagenen Wert.</li>
        <li>Die App berechnet daraus automatisch deine Netto-Arbeitszeit.</li>
        <li>Reguläre Arbeitszeit und Stundenausgleich schließen sich aus. Ein Tag ist entweder Arbeitszeit oder Ausgleich.</li>
      </ul>
    {% endcall %}

    {% call help_section("Urlaub, Feiertag und Krankheit", "Diese Tagesarten beeinflussen deine Berechnungen anders als normale Arbeitszeit.") %}
      <ul class="help-list">
        <li><strong>Urlaub</strong>: reduziert normalerweise dein Soll und zählt als Urlaubstag.</li>
        <li><strong>Feiertag</strong>: markiert einen arbeitsfreien Feiertag ohne Urlaub zu verbrauchen.</li>
        <li><strong>Krankheit</strong>: markiert einen Krankheitstag ohne Urlaub zu verbrauchen.</li>
        <li>In den Einstellungen kannst du festlegen, ob diese Tage stundenmäßig wie reguläre Arbeitstage behandelt werden sollen.</li>
      </ul>
    {% endcall %}

    {% call help_section("Stundenausgleich (S)", "Damit kannst du Überstunden oder Minusstunden direkt verändern, ohne normale Arbeitszeit einzutragen.") %}
      <ul class="help-list">
        <li>Du kannst den Wert manuell als <strong>+/- Stunden</strong> eintragen.</li>
        <li>Alternativ kannst du eine <strong>Von-Bis Uhrzeit</strong> wählen, wenn du die Dauer nicht selbst ausrechnen möchtest.</li>
        <li>Außerdem gibt es <strong>Ganzer Tag +</strong> und <strong>Ganzer Tag -</strong>. Die App nutzt dafür dein Wochenziel und deine relevanten Arbeitstage.</li>
        <li>Stundenausgleich darf mit Urlaub, Feiertag oder Krankheit kombiniert werden, aber nicht mit normaler Arbeitszeit.</li>
      </ul>
    {% endcall %}

    {% call help_section("Arbeitsstunden-Counter", "Dieser Bereich ist unabhängig von deinem Überstundenkonto.") %}
      <ul class="help-list">
        <li>Der Counter ist für längere Zeiträume gedacht, zum Beispiel für Praxisstunden oder ein Anerkennungsjahr.</li>
        <li>Du legst Startdatum, Enddatum und optional ein Stundenziel fest.</li>
        <li>Zusätzliche bereits geleistete Stunden kannst du separat eintragen, zum Beispiel aus früheren Praktika.</li>
        <li>Wenn du es aktivierst, kann der Counter auch im Header angezeigt werden.</li>
      </ul>
    {% endcall %}

    {% call help_section("Automatischer Modus", "Wenn du nicht jeden Standard-Arbeitstag einzeln eintragen möchtest.") %}
      <ul class="help-list">
        <li>Im automatischen Modus füllt die App fehlende reguläre Arbeitstage bis einschließlich heute nach deinen Einstellungen automatisch aus.</li>
        <li>Zukünftige Tage werden dabei bewusst nicht vorausgefüllt.</li>
        <li>Du passt dann nur noch Abweichungen an, zum Beispiel Urlaub, Krankheit oder andere Zeiten.</li>
        <li>Wenn du in den Modus wechselst oder später zurück auf manuell gehst, werden automatisch erzeugte zukünftige Einträge entfernt.</li>
        <li>Zusätzlich gibt es einen serverseitigen Tagesabgleich, damit fehlende Tage auch ohne deine Anmeldung nachgezogen werden können.</li>
      </ul>
    {% endcall %}

    {% call help_section("Einstellungen", "Hier steuerst du die Regeln, nach denen Stunden berechnet werden.") %}
      <ul class="help-list">
        <li><strong>Urlaub</strong>: Gesamturlaubstage, Resturlaub im Header und Urlaubszeiträume.</li>
        <li><strong>Wochenstunden</strong>: dein allgemeines Wochenziel, das für Soll-Berechnungen genutzt wird.</li>
        <li><strong>Relevante Arbeitstage</strong>: bestimmt, an welchen Wochentagen deine Sollstunden verteilt werden.</li>
        <li><strong>Überstunden-Regeln</strong>: Startdatum, Verfall und andere Regeln für dein Delta.</li>
        <li><strong>Arbeitsstunden-Counter</strong>: langer Zeitraum, Ziel und optionale Anzeige im Header.</li>
        <li><strong>Datenexport</strong>: kompletter Export aller erfassten Daten als Excel, PDF oder Backup-Datei.</li>
        <li><strong>Backup importieren</strong>: Sichere Daten aus einer Backup-Datei wieder einspielen, entweder ergänzend oder als vollständigen Ersatz deiner bisherigen Arbeitsdaten.</li>
        <li><strong>Konto löschen</strong>: entfernt dein Konto und alle zugehörigen Daten dauerhaft nach Sicherheitsbestätigung.</li>
        <li><strong>Footer</strong>: Über Kontakt, Impressum und Datenschutz erreichst du die öffentlichen Service- und Rechtstexte.</li>
      </ul>
    {% endcall %}

    {% call help_section("Backup und Wiederherstellung", "So sicherst du deine Daten und spielst sie später wieder ein.") %}
      <ul class="help-list">
        <li>Die Backup-Datei enthält nur arbeitsbezogene Daten und fachliche Einstellungen, aber keine Passwörter, MFA-Daten oder deine E-Mail-Adresse.</li>
        <li>Ein Backup kannst du direkt bei der Registrierung importieren oder später in den Einstellungen einspielen.</li>
        <li><strong>Zusammenführen</strong> ergänzt nur konfliktfreie Inhalte. Bereits vorhandene Tagesdaten bleiben erhalten.</li>
        <li><strong>Alle bisherigen Daten ersetzen</strong> löscht zuerst deine importierbaren Arbeitsdaten und übernimmt dann den Inhalt des Backups.</li>
      </ul>
    {% endcall %}

    {% call help_section("Praktische Tipps", "Diese Hinweise vermeiden typische Fehler im Alltag.") %}
      <ul class="help-list">
        <li>Trage Zeiten möglichst zeitnah ein, damit Wochen- und Monatswerte korrekt bleiben.</li>
        <li>Nutze Urlaub, Feiertag und Krankheit nur dann, wenn an dem Tag keine normale Arbeitszeit eingetragen wird.</li>
        <li>Verwende Stundenausgleich nur für direkte Saldo-Korrekturen, nicht für normale Arbeitstage.</li>
        <li>Wenn ein Wert unerwartet wirkt, prüfe zuerst Wochenstunden, relevante Arbeitstage und Sondertage in den Einstellungen.</li>
      </ul>
    {% endcall %}
  </section>

  <section class="help-callout">
    <h2>Wenn etwas nicht passt</h2>
    <p>
      Die meisten Abweichungen entstehen durch falsche Wochenstunden, unpassende relevante Arbeitstage oder einen gesetzten Sonderstatus.
      Prüfe in diesem Fall zuerst die Tageszeile und danach die Einstellungen. Wenn der Fehler bleibt, kannst du über den Footer die Kontaktseite nutzen.
    </p>
  </section>
{% endblock %}