<?php $pageTitle = 'Handbuch: Gruppenadmin'; ?>
<div class="page-header">
    <div class="page-header-left">
        <a href="/help" class="btn btn-ghost btn-sm">
            <svg viewBox="0 0 24 24" fill="none" stroke="currentColor" stroke-width="2" width="16" height="16"><path d="M19 12H5M12 19l-7-7 7-7"/></svg>
            Handbuch
        </a>
        <h1 class="page-title">Handbuch: Gruppenadmin</h1>
    </div>
</div>

<div class="help-doc">

<div class="help-toc card">
    <div class="card-body">
        <p style="font-weight:600;margin-bottom:.5rem;font-size:.85rem;color:var(--text-muted);text-transform:uppercase;letter-spacing:.05em">Inhalt</p>
        <ol class="help-toc-list">
            <li><a href="#rolle">Ihre Rolle</a></li>
            <li><a href="#uebersicht">Gruppenübersicht</a></li>
            <li><a href="#einladen">Benutzer einladen</a></li>
            <li><a href="#erstellen">Benutzer direkt anlegen</a></li>
            <li><a href="#verwalten">Mitglieder verwalten</a></li>
            <li><a href="#einladungen">Einladungen verwalten</a></li>
            <li><a href="#passwort">Passwort zurücksetzen</a></li>
            <li><a href="#sicherheit">Eigene Sicherheitseinstellungen</a></li>
        </ol>
    </div>
</div>

<section id="rolle">
    <h2>1. Ihre Rolle als Gruppenadmin</h2>
    <p>Als Gruppenadmin verwalten Sie die Mitglieder Ihrer Gruppe. Sie können Benutzer einladen, anlegen, deren Rolle innerhalb der Gruppe ändern und sie bei Bedarf entfernen. Auf systemweite Einstellungen (z. B. SMTP, globale Benutzerverwaltung) haben Sie keinen Zugriff.</p>
    <div class="help-info">
        <strong>Ihre Verwaltungsseite</strong> erreichen Sie über den Menüpunkt <em>Gruppenadministration</em> in der Navigation oder direkt unter <code>/group/users</code>.
    </div>
</section>

<section id="uebersicht">
    <h2>2. Gruppenübersicht</h2>
    <p>Auf der Verwaltungsseite sehen Sie alle Mitglieder Ihrer Gruppe in einer Tabelle mit folgenden Spalten:</p>
    <ul>
        <li><strong>Name</strong> – Anzeigename des Benutzers</li>
        <li><strong>E-Mail</strong> – Mailadresse (Anmeldekennung)</li>
        <li><strong>Gruppenrolle</strong> – <em>Gruppenadmin</em> oder <em>Mitglied</em></li>
        <li><strong>Letzte Anmeldung</strong> – wann sich der Benutzer zuletzt eingeloggt hat</li>
        <li><strong>Aktionen</strong> – Bearbeiten, Passwort zurücksetzen, Aus Gruppe entfernen</li>
    </ul>
    <p>Verwalten Sie mehrere Gruppen, erscheint oben ein Dropdown zur Gruppenauswahl.</p>
</section>

<section id="einladen">
    <h2>3. Benutzer per E-Mail einladen</h2>
    <p>Die empfohlene Methode, um neue Mitglieder aufzunehmen. Der Eingeladene legt sein Passwort selbst fest.</p>
    <ol>
        <li>Scrollen Sie auf der Verwaltungsseite zum Bereich <strong>Einladen</strong>.</li>
        <li>Tragen Sie die E-Mail-Adresse der einzuladenden Person ein.</li>
        <li>Wählen Sie die gewünschte Rolle: <em>Mitglied</em> oder <em>Gruppenadmin</em>.</li>
        <li>Klicken Sie auf <strong>Einladen</strong>.</li>
    </ol>
    <p>Das System versendet automatisch eine E-Mail mit einem persönlichen Einladungslink. Dieser Link ist <strong>7 Tage gültig</strong>. Der Empfänger klickt darauf, gibt einen Namen und ein Passwort ein und ist sofort Mitglied.</p>
    <div class="help-info">
        Der E-Mail-Versand wird vom Administrator eingerichtet. Sollte keine E-Mail ankommen, erhalten Sie den Einladungslink direkt angezeigt und können ihn manuell weitergeben.
    </div>
</section>

<section id="erstellen">
    <h2>4. Benutzer direkt anlegen</h2>
    <p>Nutzen Sie diese Funktion, wenn Sie den Zugang sofort einrichten möchten, ohne auf eine Annahme zu warten.</p>
    <ol>
        <li>Klicken Sie oben rechts auf <strong>Neuer Benutzer</strong>.</li>
        <li>Füllen Sie das Formular aus:
            <ul>
                <li><strong>Vorname &amp; Nachname</strong> – mind. 3 Zeichen</li>
                <li><strong>E-Mail</strong> – muss eindeutig im System sein (Anmeldekennung)</li>
                <li><strong>Passwort</strong> – mind. 8 Zeichen (geben Sie es dem Benutzer sicher weiter)</li>
                <li><strong>Gruppenrolle</strong> – Mitglied oder Gruppenadmin</li>
            </ul>
        </li>
        <li>Klicken Sie auf <strong>Erstellen</strong>.</li>
    </ol>
    <div class="help-warn">
        Das Passwort wird nach dem Anlegen nicht mehr angezeigt. Teilen Sie es dem Benutzer unmittelbar mit und empfehlen Sie, es nach der ersten Anmeldung zu ändern.
    </div>
</section>

<section id="verwalten">
    <h2>5. Mitglieder verwalten</h2>
    <h3>Rolle ändern</h3>
    <ol>
        <li>Klicken Sie in der Tabellenzeile des Benutzers auf <strong>Bearbeiten</strong>.</li>
        <li>Wählen Sie im Dropdown die neue Rolle (<em>Mitglied</em> oder <em>Gruppenadmin</em>).</li>
        <li>Klicken Sie auf <strong>Speichern</strong>.</li>
    </ol>
    <div class="help-info">Sie können Ihre eigene Rolle nicht ändern.</div>

    <h3>Benutzer aus der Gruppe entfernen</h3>
    <p>Durch das Entfernen verlässt der Benutzer die Gruppe. Sein Konto bleibt im System erhalten — er verliert lediglich den Zugang zu gruppenbasierten Projekten.</p>
    <ol>
        <li>Klicken Sie in der Tabellenzeile auf <strong>Aus Gruppe entfernen</strong>.</li>
        <li>Bestätigen Sie den Sicherheitsdialog.</li>
    </ol>
</section>

<section id="einladungen">
    <h2>6. Einladungen verwalten</h2>
    <p>Unter dem Einladen-Formular sehen Sie alle <strong>ausstehenden Einladungen</strong> — also solche, die noch nicht angenommen wurden und nicht abgelaufen sind.</p>
    <ul>
        <li><strong>E-Mail</strong> – an wen die Einladung gesendet wurde</li>
        <li><strong>Rolle</strong> – zugewiesene Gruppenrolle nach Annahme</li>
        <li><strong>Läuft ab</strong> – Verfallsdatum (7 Tage nach Versand)</li>
        <li><strong>Widerrufen</strong> – löscht die Einladung sofort</li>
    </ul>
    <p>Nach Ablauf oder Widerruf kann erneut eingeladen werden.</p>
</section>

<section id="passwort">
    <h2>7. Passwort zurücksetzen</h2>
    <p>Falls ein Benutzer keinen Zugang mehr hat, können Sie sein Passwort direkt setzen.</p>
    <ol>
        <li>Klicken Sie in der Tabellenzeile auf <strong>PW Reset</strong>.</li>
        <li>Geben Sie ein neues Passwort ein (mind. 8 Zeichen).</li>
        <li>Klicken Sie auf <strong>Zurücksetzen</strong>.</li>
    </ol>
    <div class="help-warn">Teilen Sie das neue Passwort nur auf sicherem Weg mit.</div>
</section>

<section id="sicherheit">
    <h2>8. Eigene Sicherheitseinstellungen</h2>
    <p>Unter <strong>Einstellungen → Sicherheit</strong> (<code>/settings/totp</code>) können Sie Ihren Account mit Zwei-Faktor-Authentifizierung absichern:</p>
    <ul>
        <li><strong>Authenticator-App (TOTP)</strong> – QR-Code mit einer App scannen (z. B. Google Authenticator, Authy). Bei jeder Anmeldung wird ein 6-stelliger Code verlangt.</li>
        <li><strong>E-Mail-Code</strong> – Bei jeder Anmeldung wird ein Code an Ihre E-Mail-Adresse gesendet (10 Minuten gültig).</li>
    </ul>
    <p>Beide Methoden lassen sich gleichzeitig aktivieren. In diesem Fall wählen Sie beim Login die gewünschte Methode selbst.</p>
</section>

</div>

<?php include __DIR__ . '/partials/help-styles.php'; ?>
