<?php $pageTitle = 'Handbuch: Projektleiter'; ?>
<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: Projektleiter</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="#projekt-erstellen">Projekt erstellen</a></li>
            <li><a href="#mitglieder">Mitglieder & Externe verwalten</a></li>
            <li><a href="#statuses">Status und Labels</a></li>
            <li><a href="#aufgaben">Aufgaben anlegen und zuweisen</a></li>
            <li><a href="#abhaengigkeiten">Vorgänger & Abhängigkeiten</a></li>
            <li><a href="#ansichten">Kanban, Liste & Gantt</a></li>
            <li><a href="#benachrichtigungen">Benachrichtigungen konfigurieren</a></li>
            <li><a href="#archivieren">Projekt archivieren oder löschen</a></li>
        </ol>
    </div>
</div>

<section id="rolle">
    <h2>1. Ihre Rolle als Projektleiter</h2>
    <p>Als Projektleiter (<em>Owner</em> oder <em>Manager</em>) haben Sie die vollständige Kontrolle über ein Projekt: Sie planen Aufgaben, weisen sie zu, verfolgen den Fortschritt und koordinieren interne wie externe Mitglieder.</p>
    <div class="help-info">
        Ein Projekt kann <strong>mehrere Owner</strong> haben – mindestens einer ist immer erforderlich. Owner haben Vollzugriff inklusive Löschen und können andere Mitglieder zur Owner-Rolle befördern. Mehrere <strong>Manager</strong> können parallel Projekteinstellungen verwalten. Reguläre <strong>Mitglieder</strong> können Aufgaben erstellen und bearbeiten, aber keine Projekteinstellungen ändern. <strong>Gäste</strong> können nur lesen.
    </div>
</section>

<section id="projekt-erstellen">
    <h2>2. Projekt erstellen</h2>
    <ol>
        <li>Klicken Sie in der Navigation auf <strong>Projekte</strong> und dann auf <strong>Neues Projekt</strong>.</li>
        <li>Füllen Sie das Formular aus:
            <ul>
                <li><strong>Projektname</strong> – Pflichtfeld</li>
                <li><strong>Beschreibung</strong> – optional</li>
                <li><strong>Farbe</strong> – visuelle Kennzeichnung in der Übersicht</li>
                <li><strong>Standardansicht</strong> – Kanban, Liste oder Gantt (kann jederzeit geändert werden)</li>
            </ul>
        </li>
        <li>Klicken Sie auf <strong>Erstellen</strong>.</li>
    </ol>
    <p>Nach der Erstellung gelangen Sie direkt in die Projektansicht. Das Projekt wird mit vier Standard-Status angelegt: <em>Offen, In Arbeit, Überprüfung, Erledigt</em>.</p>
</section>

<section id="mitglieder">
    <h2>3. Mitglieder & Externe verwalten</h2>
    <h3>Interne Mitglieder hinzufügen</h3>
    <ol>
        <li>Öffnen Sie das Projekt und klicken Sie oben auf <strong>Mitglieder</strong> (oder navigieren Sie zu <em>Projekteinstellungen → Mitglieder</em>).</li>
        <li>Wählen Sie einen Benutzer aus der Liste und vergeben Sie eine Rolle:
            <table class="help-table" style="margin-top:.5rem">
                <tr><td><strong>Owner</strong></td><td>Vollzugriff inkl. Löschen</td></tr>
                <tr><td><strong>Manager</strong></td><td>Einstellungen, Mitglieder verwalten, alle Aufgaben</td></tr>
                <tr><td><strong>Mitglied</strong></td><td>Aufgaben erstellen und bearbeiten</td></tr>
                <tr><td><strong>Gast</strong></td><td>Nur lesen</td></tr>
            </table>
        </li>
        <li>Klicken Sie auf <strong>Hinzufügen</strong>.</li>
    </ol>

    <h3>Externe Teilnehmer einladen</h3>
    <p>Externe können ohne eigenes Konto Aufgaben einsehen und kommentieren – sie erhalten einen persönlichen Zugangslink.</p>
    <ol>
        <li>Gehen Sie zu <em>Mitglieder</em> und scrollen Sie zum Abschnitt <strong>Externe Teilnehmer</strong>.</li>
        <li>Geben Sie Name und optional die E-Mail-Adresse ein.</li>
        <li>Klicken Sie auf <strong>Hinzufügen</strong>.</li>
        <li>Das System generiert einen einzigartigen Link (<code>/ext/…</code>), der per E-Mail versendet wird (bei konfiguriertem SMTP) oder manuell kopiert werden kann.</li>
    </ol>
    <div class="help-info">
        Wenn Sie nur einen Platzhalternamen ohne E-Mail anlegen (<em>Dummy-Zuordnung</em>), können Aufgaben intern auf diesen Namen zugewiesen werden — ohne dass ein externer Zugang existiert.
    </div>
</section>

<section id="statuses">
    <h2>4. Status und Labels konfigurieren</h2>
    <h3>Projektstatus</h3>
    <p>Jedes Projekt hat eigene Status, die die Spalten im Kanban-Board bilden. Standard: <em>Offen, In Arbeit, Überprüfung, Erledigt</em>.</p>
    <p>Unter <strong>Projekteinstellungen → Status</strong> können Sie:</p>
    <ul>
        <li>Neue Status anlegen (Name, Farbe, Position)</li>
        <li>Bestehende umbenennen oder umfärben</li>
        <li>Reihenfolge per Drag & Drop anpassen</li>
        <li>Den Status als <em>„erledigt"</em> markieren (löst Benachrichtigungen aus)</li>
        <li>Status löschen (Aufgaben werden dabei auf einen anderen Status verschoben)</li>
    </ul>

    <h3>Labels</h3>
    <p>Labels sind farbige Tags, mit denen Aufgaben kategorisiert werden (z. B. <em>Bug, Feature, Dringend</em>). Anlegen unter <strong>Projekteinstellungen → Labels</strong>.</p>
</section>

<section id="aufgaben">
    <h2>5. Aufgaben anlegen und zuweisen</h2>
    <h3>Aufgabe erstellen</h3>
    <ol>
        <li>Klicken Sie im Kanban auf <strong>+ Aufgabe</strong> in einer Spalte oder auf den Button <strong>Neue Aufgabe</strong>.</li>
        <li>Füllen Sie das Formular aus:
            <ul>
                <li><strong>Titel</strong> – kurze, aussagekräftige Bezeichnung</li>
                <li><strong>Beschreibung</strong> – detaillierte Informationen</li>
                <li><strong>Status</strong> – Startphase der Aufgabe</li>
                <li><strong>Priorität</strong> – Niedrig, Mittel, Hoch oder Dringend</li>
                <li><strong>Startdatum / Fälligkeitsdatum</strong> – für Gantt-Darstellung und Erinnerungen</li>
                <li><strong>Labels</strong> – ein oder mehrere Tags</li>
                <li><strong>Zuweisungen</strong> – interne Mitglieder oder externe Teilnehmer</li>
                <li><strong>Vorgänger</strong> – Aufgaben, die zuerst abgeschlossen sein müssen</li>
                <li><strong>Anhänge</strong> – Dateien bis 2 MB (JPG, PNG, GIF, WEBP)</li>
            </ul>
        </li>
        <li>Klicken Sie auf <strong>Erstellen</strong>.</li>
    </ol>
    <div class="help-info">
        Die Pflichtfelder einer Aufgabe können Sie unter <em>Projekteinstellungen → Pflichtfelder</em> individuell konfigurieren.
    </div>

    <h3>Aufgabe bearbeiten</h3>
    <p>Klicken Sie auf eine Aufgabenkarte, um die Detailansicht zu öffnen. Dort können Sie alle Felder bearbeiten, Kommentare lesen und schreiben sowie Anhänge verwalten.</p>
</section>

<section id="abhaengigkeiten">
    <h2>6. Vorgänger &amp; Abhängigkeiten</h2>
    <p>Aufgabenabhängigkeiten helfen, die richtige Reihenfolge abzubilden. Eine Aufgabe mit einem Vorgänger kann erst sinnvoll bearbeitet werden, wenn der Vorgänger abgeschlossen ist.</p>
    <ul>
        <li><strong>Vorgänger setzen:</strong> Im Aufgabenformular unter <em>Vorgänger</em> eine oder mehrere Aufgaben aus dem Projekt wählen.</li>
        <li><strong>Nachfolger:</strong> Wird automatisch beim Vorgänger als Nachfolger eingetragen.</li>
        <li><strong>Benachrichtigung:</strong> Wenn ein Vorgänger als erledigt markiert wird und die entsprechende Benachrichtigung aktiviert ist, werden die Bearbeiter des Nachfolgers automatisch informiert.</li>
        <li><strong>Gantt-Visualisierung:</strong> Im Gantt-Diagramm werden Abhängigkeiten als Verbindungslinien dargestellt.</li>
    </ul>

    <h3>Auto-Verknüpfung</h3>
    <p>Im Gantt-Diagramm können Abhängigkeiten automatisch aus dem Zeitplan abgeleitet werden. Klicken Sie dazu in der Werkzeugleiste auf <strong>Auto-Verknüpfung</strong>.</p>
    <p>Die Funktion analysiert die Start- und Enddaten aller Aufgaben und erstellt Verknüpfungen nach folgender Logik:</p>
    <ul>
        <li>Eine Aufgabe wird zum Vorgänger, wenn ihr Enddatum auf oder vor dem Startdatum einer anderen Aufgabe liegt.</li>
        <li>Es wird immer der <strong>nächstgelegene</strong> Vorgänger gewählt — nicht jede beliebige frühere Aufgabe.</li>
        <li>Laufen <strong>mehrere Aufgaben parallel</strong> und enden zum gleichen Zeitpunkt, werden alle als Vorgänger der Folgeaufgabe eingetragen.</li>
        <li>Bereits vorhandene Verknüpfungen werden nicht dupliziert.</li>
    </ul>
    <div class="help-info">
        Die Auto-Verknüpfung ergänzt bestehende Abhängigkeiten — sie löscht keine vorhandenen. Sie können danach einzelne Verbindungslinien im Gantt-Diagramm durch Klick darauf wieder entfernen.
    </div>
</section>

<section id="ansichten">
    <h2>7. Kanban, Liste &amp; Gantt</h2>

    <h3>Kanban-Board</h3>
    <p>Die interaktivste Ansicht. Jede Spalte entspricht einem Status.</p>
    <ul>
        <li>Aufgaben per <strong>Drag & Drop</strong> zwischen Spalten ziehen → Status ändert sich automatisch</li>
        <li>Innerhalb einer Spalte verschieben → Reihenfolge anpassen</li>
        <li>Klick auf Karte → Detailansicht</li>
        <li>Karten zeigen: Priorität, Fälligkeitsdatum, Bearbeiter-Avatare, Kommentar- und Anhang-Zähler</li>
    </ul>

    <h3>Listenansicht</h3>
    <p>Tabellarische Übersicht aller Aufgaben, ideal für Filterung und Sortierung.</p>
    <ul>
        <li>Filter nach: Status, Priorität, Bearbeiter, Label, Freitext</li>
        <li>Status direkt per Dropdown in der Zeile ändern</li>
        <li>Fälligkeitsdatum inline editierbar</li>
    </ul>

    <h3>Gantt-Diagramm</h3>
    <p>Zeitliche Darstellung aller Aufgaben auf einer Zeitachse.</p>
    <ul>
        <li>Zeigt Start- und Enddatum als Balken</li>
        <li>Abhängigkeiten als Verbindungslinien (manuell per Drag vom rechten Rand einer Aufgabe, oder automatisch über <strong>Auto-Verknüpfung</strong>)</li>
        <li>Balken verschieben oder skalieren → Datum wird sofort aktualisiert</li>
        <li>Aufgaben sind nach Startdatum sortiert; Aufgaben ohne Datum erscheinen alphabetisch am Ende</li>
        <li>Ideal für Deadline-Planung und Ressourcenübersicht</li>
    </ul>
</section>

<section id="benachrichtigungen">
    <h2>8. Benachrichtigungen konfigurieren</h2>
    <p>Unter <strong>Projekteinstellungen → E-Mail-Benachrichtigungen</strong> steuern Sie, wer wann informiert wird.</p>
    <table class="help-table">
        <tr>
            <th>Einstellung</th>
            <th>Wann wird E-Mail versendet?</th>
            <th>Empfänger</th>
        </tr>
        <tr>
            <td>Bei Zuweisung benachrichtigen</td>
            <td>Aufgabe wird einer Person zugewiesen</td>
            <td>Zugewiesene Person</td>
        </tr>
        <tr>
            <td>Erinnerung 3 Tage vor Fälligkeit</td>
            <td>3 Tage vor dem Fälligkeitsdatum</td>
            <td>Zugewiesene Person</td>
        </tr>
        <tr>
            <td>Wenn Vorgänger erledigt</td>
            <td>Vorgänger-Aufgabe auf „erledigt" gesetzt</td>
            <td>Bearbeiter der Nachfolger-Aufgabe</td>
        </tr>
        <tr>
            <td>Manager bei jeder Aktivität</td>
            <td>Beliebige Aktion im Projekt</td>
            <td>Projektleiter (Manager-Rolle)</td>
        </tr>
        <tr>
            <td>Manager wenn Aufgabe erledigt</td>
            <td>Aufgabe in „erledigt"-Status verschoben</td>
            <td>Projektleiter (Manager-Rolle)</td>
        </tr>
    </table>
    <div class="help-info">
        Der E-Mail-Versand wird vom Administrator eingerichtet und ist im Normalbetrieb aktiv.
    </div>
</section>

<section id="archivieren">
    <h2>9. Projekt archivieren oder löschen</h2>
    <h3>Archivieren</h3>
    <p>Ein archiviertes Projekt ist weiterhin lesbar, erscheint aber nicht mehr in der aktiven Projektliste. Unter <strong>Projekteinstellungen → Allgemein</strong> finden Sie den Button <strong>Archivieren</strong>. Archivierte Projekte können jederzeit wiederhergestellt werden.</p>

    <h3>Löschen</h3>
    <p>Das Löschen eines Projekts ist <strong>unwiderruflich</strong>. Alle Aufgaben, Kommentare, Anhänge und Aktivitäten werden dauerhaft gelöscht. Nur Administratoren können Projekte endgültig löschen.</p>
</section>

</div>

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