woms 3.0

LOGIN_TROUBLESHOOTING.md

@@ -0,0 +1,117 @@
+# Login-Problembehebung
+
+Wenn du dich nicht einloggen kannst, folge diesen Schritten:
+
+## 1. Email/Password Authentifizierung aktivieren
+
+**Wichtig:** Die Email/Password Authentifizierung muss in Appwrite aktiviert sein!
+
+1. Gehe zu deinem Appwrite Dashboard: [https://cloud.appwrite.io](https://cloud.appwrite.io)
+2. Wähle dein Projekt **woms** aus
+3. Gehe zu **Auth** im linken Menü
+4. Klicke auf **Providers** oder **Settings**
+5. Suche nach **Email/Password** und aktiviere es
+6. Stelle sicher, dass **Email/Password** aktiviert ist (grüner Schalter)
+
+## 2. Ersten Benutzer erstellen
+
+Du hast zwei Möglichkeiten:
+
+### Option A: Über die App registrieren
+1. Öffne die Login-Seite
+2. Klicke auf **"Noch kein Account? Hier registrieren"**
+3. Gib deine Email und ein Passwort (mindestens 8 Zeichen) ein
+4. Klicke auf **Registrieren**
+
+### Option B: Über Appwrite Dashboard erstellen
+1. Gehe zu **Auth** → **Users** im Appwrite Dashboard
+2. Klicke auf **Create User**
+3. Wähle **Email/Password** als Methode
+4. Gib Email und Passwort ein
+5. Klicke auf **Create**
+6. Logge dich dann in der App ein
+
+## 3. Häufige Fehlermeldungen
+
+### "Ungültige Email oder Passwort"
+- Überprüfe, ob die Email korrekt eingegeben wurde
+- Überprüfe, ob das Passwort korrekt ist
+- Stelle sicher, dass der Benutzer in Appwrite existiert
+
+### "Benutzer nicht gefunden"
+- Der Benutzer existiert noch nicht → Registriere dich zuerst
+- Oder erstelle den Benutzer im Appwrite Dashboard
+
+### "Email/Password Authentifizierung ist nicht aktiviert"
+- Gehe zu **Auth** → **Providers** in Appwrite
+- Aktiviere **Email/Password**
+
+### "Ein Benutzer mit dieser Email existiert bereits"
+- Der Benutzer existiert bereits → Logge dich ein statt zu registrieren
+- Oder verwende eine andere Email-Adresse
+
+## 4. Überprüfe die .env Datei
+
+Stelle sicher, dass deine `.env` Datei korrekt ist:
+
+```env
+VITE_APPWRITE_ENDPOINT=https://cloud.appwrite.io/v1
+VITE_APPWRITE_PROJECT_ID=693d9f37000b35267f1b
+VITE_APPWRITE_DATABASE_ID=6943bf0e0003291f8c35
+```
+
+**Wichtig:** Nach Änderungen an der `.env` Datei musst du den Dev-Server neu starten!
+
+## 5. Browser-Konsole überprüfen
+
+1. Öffne die Browser-Entwicklertools (F12)
+2. Gehe zum Tab **Console**
+3. Versuche dich einzuloggen
+4. Schaue nach Fehlermeldungen in der Konsole
+
+Häufige Fehler:
+- `401 Unauthorized` → Falsche Credentials oder Auth nicht aktiviert
+- `404 Not Found` → Falsche Project ID oder Endpoint
+- `Network Error` → Internetverbindung oder CORS-Problem
+
+## 6. Dev-Server neu starten
+
+Wenn du die `.env` Datei geändert hast:
+
+```bash
+# Stoppe den Server (Ctrl+C)
+# Starte ihn neu:
+npm run dev
+```
+
+## 7. Cache leeren
+
+Manchmal hilft es, den Browser-Cache zu leeren:
+- Chrome/Edge: Ctrl+Shift+Delete (Windows) oder Cmd+Shift+Delete (Mac)
+- Firefox: Ctrl+Shift+Delete (Windows) oder Cmd+Shift+Delete (Mac)
+
+## 8. Test mit Demo-Modus
+
+Um zu testen, ob die App grundsätzlich funktioniert, kannst du temporär die `.env` Datei umbenennen:
+
+```bash
+mv .env .env.backup
+```
+
+Dann läuft die App im Demo-Modus und du kannst dich mit beliebigen Credentials einloggen.
+
+**Wichtig:** Benenne die Datei wieder um, wenn du Appwrite verwenden möchtest:
+```bash
+mv .env.backup .env
+```
+
+## Noch Probleme?
+
+Wenn nichts hilft:
+1. Überprüfe, ob dein Appwrite-Projekt aktiv ist
+2. Überprüfe, ob die Project ID korrekt ist
+3. Versuche, einen neuen Benutzer im Appwrite Dashboard zu erstellen
+4. Überprüfe die Browser-Konsole auf detaillierte Fehlermeldungen
+
+Viel Erfolg! 🚀
+