managarten/picture/apps/web/docs/STORAGE_SETUP.md
Till-JS c712a2504a feat: integrate uload and picture, unify package naming
- Add uload project with apps/web structure
  - Reorganize from flat to monorepo structure
  - Remove PocketBase binary and local data
  - Update to pnpm and @uload/web namespace

- Add picture project to monorepo
  - Remove embedded git repository

- Unify all package names to @{project}/{app} schema:
  - @maerchenzauber/* (was @storyteller/*)
  - @manacore/* (was manacore-*, manacore)
  - @manadeck/* (was web, backend, manadeck)
  - @memoro/* (was memoro-web, landing, memoro)
  - @picture/* (already unified)
  - @uload/web

- Add convenient dev scripts for all apps:
  - pnpm dev:{project}:web
  - pnpm dev:{project}:landing
  - pnpm dev:{project}:mobile
  - pnpm dev:{project}:backend

🤖 Generated with [Claude Code](https://claude.com/claude-code)

Co-Authored-By: Claude <noreply@anthropic.com>
2025-11-25 04:00:36 +01:00

120 lines
4.1 KiB
Markdown

# Storage Bucket Setup für User Uploads
## Schritt 1: SQL Statement ausführen
### Option A: Erste Installation (Policies existieren noch nicht)
1. Öffne die **Supabase Dashboard**: https://supabase.com/dashboard
2. Wähle dein Projekt aus
3. Navigiere zu **SQL Editor**
4. Kopiere den Inhalt von `setup-storage-bucket.sql`
5. Führe das SQL-Script aus
### Option B: Update (Policies existieren bereits)
1. Öffne die **Supabase Dashboard**: https://supabase.com/dashboard
2. Wähle dein Projekt aus
3. Navigiere zu **SQL Editor**
4. Kopiere den Inhalt von `update-storage-policies.sql`
5. Führe das SQL-Script aus
**Falls Fehler "policy already exists"**: Verwende `update-storage-policies.sql` statt `setup-storage-bucket.sql`
## Schritt 2: Überprüfung
### Bucket überprüfen
Navigiere zu **Storage** im Supabase Dashboard:
- Du solltest einen Bucket namens `user-uploads` sehen
- Public: ✓ Enabled
- File Size Limit: 10 MB
- Allowed MIME types: image/jpeg, image/jpg, image/png, image/webp
### Policies überprüfen
Navigiere zu **Storage > Policies**:
- Du solltest 4 Policies für `user-uploads` sehen:
- ✓ Users can upload their own images (INSERT)
- ✓ Public images are publicly accessible (SELECT)
- ✓ Users can update their own images (UPDATE)
- ✓ Users can delete their own images (DELETE)
## Schritt 3: Testen
### Test 1: Upload über die Web-App
1. Öffne die Web-App: http://localhost:5173/app/upload
2. Wähle ein Bild aus oder nutze Drag & Drop
3. Klicke auf "Upload"
4. Das Bild sollte erfolgreich hochgeladen werden
5. Überprüfe in **Storage > user-uploads** im Supabase Dashboard
### Test 2: Zugriff auf öffentliche URL
1. Nachdem Upload erfolgreich war, kopiere die `public_url` aus der Konsole
2. Öffne die URL in einem neuen Browser-Tab
3. Das Bild sollte sichtbar sein (ohne Authentifizierung)
### Test 3: Galerie-Integration
1. Navigiere zur Galerie: http://localhost:5173/app/gallery
2. Die hochgeladenen Bilder sollten in der Galerie erscheinen
3. Klicke auf ein Bild, um die Detail-Ansicht zu öffnen
## Datei-Struktur im Bucket
```
user-uploads/
├── {user_id_1}/
│ ├── 1234567890-abc123.jpg
│ ├── 1234567891-def456.png
│ └── 1234567892-ghi789.webp
└── {user_id_2}/
├── 1234567893-jkl012.jpg
└── 1234567894-mno345.png
```
## Sicherheit
### ✅ Was ist geschützt:
- User können nur in ihren eigenen Ordner hochladen
- User können nur ihre eigenen Dateien bearbeiten/löschen
- Upload nur für authentifizierte User
- Datei-Größe ist auf 10MB begrenzt
- Nur erlaubte Bild-Formate (JPG, PNG, WebP)
### ⚠️ Was ist öffentlich:
- Alle hochgeladenen Bilder sind über ihre public_url zugänglich
- Jeder mit der URL kann das Bild sehen (auch ohne Account)
- Dies ist gewollt für die Galerie-Anzeige
### 🔒 Optionale Verbesserungen für später:
- Private Bilder: Separate Bucket für private Uploads
- Signed URLs: Temporäre URLs für sensible Inhalte
- CDN: CloudFlare oder AWS CloudFront vor Supabase Storage
## Troubleshooting
### Fehler: "Bucket bereits vorhanden"
- Kein Problem! Das Script verwendet `ON CONFLICT DO NOTHING`
- Die Policies werden trotzdem erstellt
### Fehler: "Permission denied"
1. Überprüfe ob du als authentifizierter User eingeloggt bist
2. Überprüfe die Policies im Supabase Dashboard
3. Führe das SQL-Script erneut aus
### Fehler: "File too large"
- Stelle sicher, dass die Datei kleiner als 10MB ist
- Die Validierung erfolgt sowohl im Frontend als auch im Backend
### Bilder werden nicht in der Galerie angezeigt
1. Überprüfe ob der Bucket `public` ist
2. Überprüfe ob die `public_url` korrekt generiert wird
3. Öffne die Browser-Konsole für Fehler-Logs
## Alternative: UI-basiertes Setup
Falls du das SQL-Script nicht ausführen möchtest, kannst du den Bucket auch manuell im UI erstellen:
1. **Storage > Create Bucket**
- Name: `user-uploads`
- Public: ✓ Enable
- File Size Limit: 10485760 (10MB)
- Allowed MIME types: image/jpeg, image/jpg, image/png, image/webp
2. **Storage > Policies > New Policy**
- Erstelle die 4 Policies manuell mit den gleichen Bedingungen wie im SQL-Script