chore: Docs umstrukturiert, Client-Updates, Scripts nach scripts/

This commit is contained in:
2026-01-28 20:00:37 +01:00
parent 4b38da3b85
commit 5ba12cb738
70 changed files with 1240 additions and 284 deletions

View File

@@ -0,0 +1,97 @@
# Appwrite Neu-Einrichtung - Schritt für Schritt
## Schritt 1: Neues Projekt in Appwrite erstellen
1. **Gehe zu Appwrite Dashboard:**
- Falls du cloud.appwrite.io nutzt: https://cloud.appwrite.io
- Falls du webklar.com nutzt: https://appwrite.webklar.com
2. **Erstelle ein neues Projekt:**
- Klicke auf "Create Project"
- Name: `EmailSorter` (oder ein anderer Name)
- Kopiere die **Project ID** (wird angezeigt)
## Schritt 2: API Key erstellen
1. **Gehe zu Settings → API Credentials**
2. **Klicke auf "Create API Key"**
3. **Konfiguration:**
- Name: `EmailSorter Backend`
- Scopes: Wähle **alle Berechtigungen** (Full Access)
- Expiration: Optional (oder leer lassen für kein Ablaufdatum)
4. **Kopiere den API Key** (wird nur einmal angezeigt!)
## Schritt 3: Datenbank erstellen
1. **Gehe zu Databases**
2. **Klicke auf "Create Database"**
3. **Konfiguration:**
- Database ID: `email_sorter_db` (oder ein anderer Name)
- Name: `EmailSorter Database`
4. **Kopiere die Database ID**
## Schritt 4: .env Dateien aktualisieren
### server/.env aktualisieren:
```env
APPWRITE_ENDPOINT=https://appwrite.webklar.com/v1
# ODER falls cloud.appwrite.io:
# APPWRITE_ENDPOINT=https://cloud.appwrite.io/v1
APPWRITE_PROJECT_ID=DEINE_NEW_PROJECT_ID_HIER
APPWRITE_API_KEY=DEIN_NEW_API_KEY_HIER
APPWRITE_DATABASE_ID=email_sorter_db
```
### client/.env aktualisieren:
```env
VITE_APPWRITE_ENDPOINT=https://appwrite.webklar.com/v1
# ODER falls cloud.appwrite.io:
# VITE_APPWRITE_ENDPOINT=https://cloud.appwrite.io/v1
VITE_APPWRITE_PROJECT_ID=DEINE_NEW_PROJECT_ID_HIER
```
## Schritt 5: Bootstrap ausführen
Nachdem du die .env Dateien aktualisiert hast:
```powershell
cd server
npm run bootstrap:v2
```
Dies erstellt automatisch alle benötigten Collections:
- `products`
- `questions`
- `submissions`
- `answers`
- `orders`
- `email_accounts`
- `email_stats`
- `subscriptions`
- `user_preferences`
- `email_digests`
## Schritt 6: Verifizierung
Nach erfolgreichem Bootstrap solltest du sehen:
- ✓ Database created/exists
- ✓ Alle Collections wurden erstellt
- ✓ Alle Attribute wurden hinzugefügt
## Troubleshooting
**Fehler: "Project not found"**
- Prüfe, ob die PROJECT_ID korrekt ist
- Prüfe, ob du den richtigen Endpoint verwendest
**Fehler: "Unauthorized"**
- Prüfe, ob der API_KEY korrekt ist
- Stelle sicher, dass der API Key alle Berechtigungen hat
**Fehler: "Database not found"**
- Stelle sicher, dass die DATABASE_ID korrekt ist
- Das Bootstrap-Skript erstellt die Datenbank automatisch, wenn sie nicht existiert