# 📚 Benutzerhandbuch - Sponsorenprogramm Verwaltung

**Version:** 2.0  
**Datum:** Februar 2026  
**Zielgruppe:** Alle Benutzer des Sponsorenprogramm-Systems

---

## 📋 Inhaltsverzeichnis

1. [Erste Schritte](#erste-schritte)
2. [Login](#login)
3. [Dashboard & Navigation](#dashboard--navigation)
4. [Sponsoren verwalten](#sponsoren-verwalten)
5. [Verträge verwalten](#verträge-verwalten)
6. [Leistungen](#leistungen)
7. [Kommunikation](#kommunikation)
8. [Admin-Panel](#admin-panel)
9. [Benutzerrollen](#benutzerrollen)
10. [Häufig gestellte Fragen](#häufig-gestellte-fragen)
11. [Troubleshooting](#-troubleshooting)

---

## 🚀 Erste Schritte

### Systemanforderungen
- Moderner Webbrowser (Chrome, Firefox, Edge, Safari)
- Internetverbindung
- JavaScript aktiviert

### URL aufrufen
```
https://sponsoren.la-eracing.com
```

Nach dem Öffern werden Sie automatisch zur Login-Seite weitergeleitet.

---

## 🔐 Login

### Passwort-Login (Admin)

Falls kein Entra-Login konfiguriert ist, können Sie sich mit dem Admin-Passwort anmelden:

1. Gehen Sie zu `/login.html`
2. Geben Sie das **Admin-Passwort** in das Feld ein
3. Klicken Sie auf **"Anmelden"**
4. Sie werden zum Dashboard weitergeleitet

ℹ️ **Hinweis:** Das Admin-Passwort wird von Ihrem Administrator festgelegt.

### Microsoft Entra Login (SSO)

Falls **Entra aktiviert** ist:

1. Klicken Sie auf **"Mit Microsoft Entra anmelden"**
2. Sie werden zu Microsoft weitergeleitet
3. Melden Sie sich mit Ihrem Unternehmens-Konto an
4. Sie werden automatisch zurück geleitet
5. **Automatische Rollenvergabe:** Ihre Rolle wird basierend auf Ihren Gruppen in Azure AD bestimmt

✅ **Vorteil:** Sie müssen sich nur einmal anmelden und erhalten Zugriff auf alle Systeme.

### Logout

Sie können sich in der oberen rechten Ecke der Anwendung abmelden:
1. Klicken Sie auf Ihren **Benutzernamen / Profil-Symbol**
2. Klicken Sie auf **"Abmelden"**

---

## 📊 Dashboard & Navigation

### Hauptseite
Nach dem Login sehen Sie das **Dashboard** mit:
- 📈 **Statistik-Überblick** (Sponsoren, Verträge, Leistungen)
- 🔄 **Schnellzugriff** zu den wichtigsten Funktionen
- 📅 **Aktuelle Aktivitäten**

### Navigationsmenü (Sidebar)
Die linke Seite zeigt alle verfügbaren Module:

| Symbol | Modul | Beschreibung |
|--------|-------|-------------|
| 🏠 | Dashboard | Startseite mit Übersicht |
| 🤝 | Sponsoren | Alle Sponsorenkonten verwalten |
| 📜 | Verträge | Sponsorshipverträge verwalten |
| ✅ | Leistungen | Erbrachte Leistungen nachverfolgung |
| 💬 | Kommunikation | Nachrichtenhistorie und Tickets |
| 🏭 | Fertiger | Hersteller/Partner-Status |
| ⚙️ | Admin | Systemverwaltung (nur Admins) |

### Benutzermenü (oben rechts)
```
👤 Ihr Name | Admin Badge
  ├─ Logout
```

---

## 🤝 Sponsoren verwalten

### Liste anzeigen
1. Klicken Sie im Menü auf **"Sponsoren"**
2. Sie sehen eine **Tabelle aller Sponsoren** mit:
   - Name und Kategorie
   - Status (aktiv, verhandlung, abgesagt, etc.)
   - Kontaktinformationen
   - Logo-Vorschau

### Neuen Sponsor erstellen (Editor/Admin)

1. Klicken Sie auf **"+ Neuer Sponsor"** Button
2. Füllen Sie folgende Felder aus:
   - **Name** (erforderlich)
   - **E-Mail** (erforderlich)
   - **Kategorie** (Hauptsponsor, Gold, Silber, Bronze, Unterstützer)
   - **Status** (offen, angefragt, verhandlung, aktiv, abgesagt)
   - **Land**
   - **Website**
   - **Telefon**

3. Klicken Sie **"Speichern"**

### Sponsor bearbeiten (Editor/Admin)

1. Klicken Sie auf einen **Sponsor in der Liste**
2. Der Detailbereich öffnet sich auf der rechten Seite
3. Bearbeiten Sie die Felder
4. Klicken Sie **"Speichern"**

### Sponsor-Tabs

Wenn Sie einen Sponsor öffnen, sehen Sie mehrere Tabs:

#### 📋 Allgemein
- Grundinformationen bearbeiten
- Status ändern

#### 🖼️ Logo
- Mehrere Logos hochladen
- Datei-Typen: JPG, PNG, GIF, SVG, PSD, AI, EPS, PDF
- **Download**: Klick auf Logo
- **Löschen**: ❌ Button

#### 📄 Verträge
- Alle Verträge dieses Sponsors
- Neue Verträge erstellen

#### ✅ Leistungen
- Erhaltene Leistungen anzeigen
- Neue Leistungen hinzufügen

#### 💬 Kommunikation
- Nachrichten-Historie
- Neue Nachrichten senden

### Sponsor löschen (Admin)

1. Öffnen Sie den Sponsor
2. Klicken Sie oben auf **"🗑️ Sponsor löschen"**
3. Bestätigen Sie die Warnung
4. Der Sponsor wird gelöscht

⚠️ **Warnung:** Dies kann nicht rückgängig gemacht werden!

---

## 📜 Verträge verwalten

### Vertragstypen
- **Sponsoring-Verträge** - Vereinbarungen zwischen Verein und Sponsor
- **Leistungs-Verträge** - Spezifische Leistungsvereinbarungen

### Neuen Vertrag erstellen (Editor/Admin)

1. Gehen Sie zum **Sponsor** oder zu **"Verträge"** im Menü
2. Klicken Sie **"+ Neuer Vertrag"**
3. Füllen Sie aus:
   - **Sponsor** (wählen Sie aus Liste)
   - **Titel** (z.B. "Sponsoring 2025")
   - **Typ** (Sponsoring / Leistung)
   - **Startdatum**
   - **Enddatum**
   - **Betrag** (in Euro)
   - **Beschreibung**
   - **Status** (entwurf, aktiv, abgeschlossen, storniert)

4. Klicken Sie **"Speichern"**

### Vertrag bearbeiten (Editor/Admin)

1. Finden Sie den Vertrag in der Liste
2. Klicken Sie darauf
3. Bearbeiten Sie die Felder
4. Klicken Sie **"Speichern"**

### Vertrag hochladen/anhängen

Im Vertrag können Sie Dateien hochladen:
1. Klicken Sie auf **"Datei hochladen"**
2. Wählen Sie eine Datei (PDF, Word, Excel)
3. Die Datei wird gespeichert

### Verträge anzeigen nach Status

Verwenden Sie die **Filter-Tabs**:
- **Alle** - Alle Verträge
- **Aktiv** - Laufende Verträge
- **Entwurf** - Noch nicht aktiviert
- **Abgeschlossen** - Beendete Verträge

---

## ✅ Leistungen

### Was sind "Leistungen"?
**Leistungen** sind Gegenleistungen des Vereins an den Sponsor, z.B.:
- Logo auf Website
- Logo auf Fahrzeug
- VIP-Tickets zu Events
- Kontakt zum Rennteam
- etc.

### Leistungs-Kategorien

Folgende Kategorien sind vordefiniert:
- **Hauptsponsor** - Premium Leistungen
- **Gold** - Erweiterte Leistungen
- **Silber** - Standard Leistungen
- **Bronze** - Basis Leistungen
- **Unterstützer** - Minimale Leistungen

### Leistung hinzufügen (Editor/Admin)

1. Öffnen Sie einen **Sponsor**
2. Gehen Sie zum Tab **"✅ Leistungen"**
3. Klicken Sie **"+ Leistung hinzufügen"**
4. Wählen Sie aus der Liste:
   - "Kontakt zum Rennteam"
   - "Logo auf Vereinshomepage"
   - "Logo auf Fahrzeug"
   - etc.
5. Klicken Sie **"Speichern"**

### Leistungen 赤✓ Abhaken (Editor/Admin)

1. In der Leistungsliste sehen Sie: ☐ Nicht erledigt / ☑ Erledigt
2. Klicken Sie die Checkbox um den Status zu ändern
3. Das wird automatisch gespeichert

### Leistungs-Vorlagen

Im **Admin-Panel** können Sie Leistungs-Vorlagen pro Kategorie bearbeiten.

---

## 💬 Kommunikation

### Nachrichten-Historie

im **"Kommunikation"** Tab sehen Sie alle Nachrichten mit:
- Empfänger/Absender
- Datum
- Betreff
- Nachricht-Text
- Status (gelesen/ungelesen)

### Neue Nachricht senden (Editor/Admin)

1. Öffnen Sie den **Sponsor**
2. Gehen Sie zum Tab **"💬 Kommunikation"**
3. Klicken Sie **"+ Neue Nachricht"**
4. Füllen Sie aus:
   - **Betreff**
   - **Nachricht**
   - **Anlage** (optional)

5. Klicken Sie **"Senden"**

### Mails automatisch synchronisieren

Falls konfiguriert, werden Emails automatisch:
- Empfangen und der Kommunikation zugeordnet
- Archiviert
- Referenziert

---

## ⚙️ Admin-Panel

⚠️ **Nur für Admins zugänglich!**

### Admin-Panel öffnen
1. Klicken Sie im Menü auf **"⚙️ Admin"**
2. Sie sehen mehrere Konfigurationstabs

### Tabs im Admin-Panel

#### 🔒 Lokaler Admin
- **Funktion:** Bestimmen Sie welcher Benutzer als lokaler Admin gilt
- **Verwendung:** Für Passwort-Login ohne Benutzer-Eintrag
- Geben Sie den Benutzernamen ein (z.B. `admin@local`)

#### 🔗 Webhook
- **Funktion:** Externe Systeme können Events erhalten
- **URL:** Ziel-URL für Webhooks
- **Test:** Button zum Testen der Verbindung
- **Status:** An/Aus

#### ✔️ Leistungen
- **Bearbeiten:** Passen Sie Leistungs-Vorlagen an
- **Pro Kategorie:** Definieren Sie Leistungen pro Sponsor-Kategorle

#### 🏷️ Kategorien
- **Sponsorenklassen:** Hauptsponsor, Gold, Silber, Bronze, Unterstützer
- **Farbe:** Wählen Sie eine Farbe pro Kategorie
- **Bearbeiten/Löschen:** Verwalten Sie Kategorien

#### 👥 Benutzer
- **Liste:** Alle Benutzer des Systems
- **Rolle:** Viewer, Editor, Admin
- **Status:** Aktiv/Inaktiv
- **Löschen:** Benutzer entfernen (Achtung: nicht rückgängig!)

#### 🔵 Microsoft Entra
- **Tenant ID:** Ihre Azure AD Tenant ID
- **Client ID:** App ID aus Azure
- **Redirect URI:** Sollte `https://sponsoren.la-eracing.com/login.html` sein
- **Enabled:** An/Aus

---

## 👥 Benutzerrollen

### Viewer 👀
**Berechtigung:** Nur Anschauen
- ✅ Sponsoren anschauen
- ✅ Verträge anschauen
- ✅ Leistungen anschauen
- ❌ Nichts bearbeiten
- ❌ Admin-Panel nicht zugänglich

**Verwendung:** Externe Stakeholder, Berichts-Empfänger

### Editor ✏️
**Berechtigung:** Erstellen & Bearbeiten (aber nicht löschen)
- ✅ Sponsoren erstellen/bearbeiten
- ✅ Verträge erstellen/bearbeiten
- ✅ Leistungen öffnen/bearbeiten
- ✅ Nachrichten senden
- ❌ Sponsoren/Verträge löschen
- ❌ Benutzer verwalten
- ❌ Admin-Panel nicht vollständig zugänglich

**Verwendung:** Sponsoren-Manager, Team-Mitglieder

### Admin 🔐
**Berechtigung:** Vollständiger Zugriff
- ✅ Alles erstellen, bearbeiten, löschen
- ✅ Benutzer verwalten
- ✅ System-Einstellungen ändern
- ✅ Webhooks konfigurieren
- ✅ Admin-Panel alle Funktionen

**Verwendung:** Systemadministratoren, Projekt-Leiter

---

## ❓ Häufig gestellte Fragen

### F: Ich bin ausgesperrt - was kann ich tun?
**A:** 
- Versuchen Sie den Browser-Cache zu löschen (Strg+Shift+Entf)
- Versuchen Sie einen anderen Browser
- Wenden Sie sich an den Administrator

### F: Kann ich mehrere Logos hochladen?
**A:** Ja! Sie können bis zu mehrere Logos pro Sponsor hochladen.
- Formate: JPG, PNG, GIF, SVG, PSD, AI, EPS, PDF
- Maximal 10 MB pro Datei

### F: Können gelöschte Sponsoren wiederhergestellt werden?
**A:** Nein, gelöschte Sponsoren können nicht wiederhergestellt werden. Seien Sie vorsichtig beim Löschen!

### F: Wie kann ich meinen Namen/Passwort ändern?
**A:** Kontaktieren Sie Ihren Administrator - Benutzer-Management ist Admin-only.

### F: Was ist "Fertiger"?
**A:** Das sind Hersteller oder Partner mit speziellem Status. Sie haben einen separaten Bereich im Menü.

### F: Kann ich Berichte exportieren?
**A:** Derzeit nicht - geplant für zukünftige Versionen. Sie können mit der Druckfunktion (Strg+P) Seiten speichern.

### F: Wie funktioniert Entra Login?
**A:** 
1. Sie klicken "Mit Microsoft Entra anmelden"
2. Sie werden zu Microsoft weitergeleitet
3. Sie melden sich mit Ihrem Unternehmenskonto an
4. Ihre Rolle wird automatisch basierend auf Ihren Azure AD-Gruppen zugewiesen

### F: Ich sehe einen Fehler "Keine Berechtigung"
**A:** 
- Sie haben nicht die nötige Berechtigung für diese Aktion
- Fragen Sie einen Admin um mehr Rechte
- Überprüfen Sie Ihre Benutzer-Rolle

---

## 🔧 Troubleshooting

### Problem: Login funktioniert nicht

**Lösungen:**
1. ✅ Überprüfen Sie das Admin-Passwort
2. ✅ Versuchen Sie Browser-Cache zu löschen
3. ✅ Versuchen Sie einen anderen Browser
4. ✅ Überprüfen Sie Ihre Internetverbindung
5. ✅ Kontaktieren Sie den Administrator

### Problem: Seite lädt nicht

**Lösungen:**
1. ✅ Aktualisieren Sie die Seite (F5)
2. ✅ Warten Sie 30 Sekunden
3. ✅ Versuchen Sie einen anderen Browser
4. ✅ Deaktivieren Sie den Adblocker (z.B. uBlock)
5. ✅ Überprüfen Sie die Internetverbindung

### Problem: Änderungen werden nicht gespeichert

**Lösungen:**
1. ✅ Klicken Sie auf **"Speichern"** Button (nicht Enter!)
2. ✅ Warten Sie bis die Bestätigung erscheint
3. ✅ Aktualisieren Sie die Seite und überprüfen Sie
4. ✅ Überprüfen Sie Ihre Benutzer-Berechtigung

### Problem: Fehler 500 oder "Server Error"

**Lösungen:**
1. ✅ Aktualisieren Sie die Seite
2. ✅ Versuchen Sie es später erneut
3. ✅ Kontaktieren Sie den Administrator mit der Fehlermeldung

### Problem: Buttons/Funktionen sind grau/deaktiviert

**Lösungen:**
1. ✅ Überprüfen Sie Ihre Benutzer-Rolle
2. ✅ Viewer können nichts bearbeiten
3. ✅ Nur Admins können löschen
4. ✅ Fragen Sie einen Admin um erhöhte Rechte

### Problem: Logo wird nicht angezeigt

**Lösungen:**
1. ✅ Überprüfen Sie das Dateiformat (JPG, PNG, GIF, SVG, etc.)
2. ✅ Überprüfen Sie die Dateigröße (max. 10 MB)
3. ✅ Löschen Sie das Logo und laden Sie es erneut hoch
4. ✅ Versuchen Sie es mit einem anderen Browser

---

## 📞 Support & Hilfe

### Technischer Support
Wenden Sie sich bei Problemen an:
- **Email:** [Support E-Mail]
- **Telefon:** [Support Telefon]
- **Ticketing:** [Ticketing-System]

### Feedback & Verbesserungsvorschläge
Wir würden gerne von Ihnen hören! Senden Sie Feedback an:
- **Email:** feedback@sponsoren.example.com
- **Form:** Feedback-Seite im System

---

## 📝 Tipps & Best Practices

✅ **DO:**
- Speichern Sie regelmäßig Ihre Änderungen
- Überprüfen Sie Dateigrößen vor dem Hochladen
- Nutzen Sie aussagekräftige Beschreibungen
- Halten Sie Ihre Kontaktinformationen aktuell
- Sichern Sie wichtige Dokumente extern

❌ **DON'T:**
- Löschen Sie es nicht einfach "um zu sehen ob es funktioniert"
- (Das ist nicht rückgängig zu machen!)
- Verwenden Sie passwortfreie Konten
- Teilung Sie Ihr Passwort
- Verwenden Sie den Admin-Account für alltägliche Aufgaben

---

## 🔄 Versionsverlauf

| Version | Datum | Änderungen |
|---------|-------|-----------|
| 2.0 | Feb 2026 | Komplette Überarbeitung, Entra SSO, Admin-Panel |
| 1.0 | Dez 2025 | Erste Version |

---

**Zuletzt aktualisiert:** Februar 2026  
**Nächste Überprüfung:** Mai 2026

---

*Dieses Handbuch wird regelmäßig aktualisiert. Bei Fragen oder Unklarheiten wenden Sie sich an den Administrator.*