From 88a9bd23b8d8dc22c162fed1d89f0910c5c6c4d9 Mon Sep 17 00:00:00 2001 From: jonas Date: Fri, 27 Feb 2026 01:13:48 +0100 Subject: [PATCH] Dateien nach "/" hochladen --- BENUTZERHANDBUCH.md | 512 ++++++++++++++++++++++++++++++++++++++++++++ 1 file changed, 512 insertions(+) create mode 100644 BENUTZERHANDBUCH.md diff --git a/BENUTZERHANDBUCH.md b/BENUTZERHANDBUCH.md new file mode 100644 index 0000000..b73a533 --- /dev/null +++ b/BENUTZERHANDBUCH.md @@ -0,0 +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.*