diff --git a/BENUTZERHANDBUCH.md b/README.md similarity index 96% rename from BENUTZERHANDBUCH.md rename to README.md index b73a533..9de4d27 100644 --- a/BENUTZERHANDBUCH.md +++ b/README.md @@ -1,512 +1,512 @@ -# 📚 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.* +# 📚 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.*