118 lines
3.6 KiB
Markdown
118 lines
3.6 KiB
Markdown
# Backend-Proxy Setup - Deployment Anleitung
|
|
|
|
## 📋 Übersicht
|
|
|
|
Diese Anleitung erklärt, wie Sie die Appwrite Function für Geocoding deployen, um CORS-Probleme zu vermeiden.
|
|
|
|
## 🚀 Deployment Schritte
|
|
|
|
### 1. Appwrite Console öffnen
|
|
|
|
Navigieren Sie zu Ihrer Appwrite Console:
|
|
`https://appwrite.joshihomeserver.ipv64.net/console`
|
|
|
|
### 2. Function erstellen
|
|
|
|
1. Klicken Sie auf **Functions** im Menü
|
|
2. Klicken Sie auf **Create Function**
|
|
3. Füllen Sie die Details aus:
|
|
- **Name**: `geocode-location`
|
|
- **Function ID**: Wird automatisch generiert (z.B. `65a123456789abc`)
|
|
- **Runtime**: Wählen Sie `Node.js 18.0` oder höher
|
|
- **Execute Access**: `Any` (damit alle eingeloggten User die Function nutzen können)
|
|
|
|
### 3. Code hochladen
|
|
|
|
**Option A: Über die Console**
|
|
1. Gehen Sie zum Tab **Deployment**
|
|
2. Erstellen Sie ein neues Deployment
|
|
3. Wählen Sie **Manual** als Deployment-Methode
|
|
4. Laden Sie folgende Dateien hoch:
|
|
- `appwrite_functions/geocode-location/main.js`
|
|
- `appwrite_functions/geocode-location/package.json`
|
|
5. Setzen Sie **Entrypoint**: `main.js`
|
|
6. Klicken Sie auf **Deploy**
|
|
|
|
**Option B: Über CLI** (wenn Appwrite CLI installiert)
|
|
```bash
|
|
cd /home/digitalman/Development/flutter_tank_web_app
|
|
appwrite deploy function
|
|
```
|
|
|
|
### 4. Function ID in Flutter App eintragen
|
|
|
|
1. Nach erfolgreichem Deployment kopieren Sie die **Function ID**
|
|
2. Öffnen Sie `lib/config/environment.dart`
|
|
3. Ersetzen Sie `YOUR_FUNCTION_ID_HERE` mit Ihrer Function ID:
|
|
|
|
```dart
|
|
static const String appwriteGeocodeFunctionId = '65a123456789abc'; // Ihre ID hier
|
|
```
|
|
|
|
### 5. Testen
|
|
|
|
**In der Appwrite Console:**
|
|
1. Gehen Sie zu Ihrer Function
|
|
2. Klicken Sie auf **Execute**
|
|
3. Verwenden Sie diesen Test-Body:
|
|
```json
|
|
{
|
|
"lat": 47.9385165,
|
|
"lon": 13.762887,
|
|
"apiKey": "NTYxMDQ3NTY2OWI3NDI5ZGIzZWIxOWNiNTNhMDEwODY6YTQ4MTJhYzYtYmYzOC00ZmE4LTk4YzYtZDBjNzYyZTAyNjBk"
|
|
}
|
|
```
|
|
4. Erwartete Response:
|
|
```json
|
|
{
|
|
"success": true,
|
|
"location": "Straßenname Hausnummer, PLZ Stadt",
|
|
"coordinates": {
|
|
"lat": 47.9385165,
|
|
"lon": 13.762887
|
|
}
|
|
}
|
|
```
|
|
|
|
**In der Flutter App:**
|
|
1. Starten Sie die App neu
|
|
2. Erstellen Sie einen neuen Tankeintrag
|
|
3. Die Standortabfrage sollte nun über den Backend-Proxy laufen
|
|
4. Sie sollten eine Erfolgs-Snackbar mit der Adresse sehen
|
|
|
|
## 🔧 Troubleshooting
|
|
|
|
### Function ID nicht gesetzt
|
|
**Problem:** Console-Warnung: "Appwrite Function ID nicht konfiguriert"
|
|
**Lösung:** Schritt 4 nochmal durchführen und App neu starten
|
|
|
|
### Function Execution fehlgeschlagen
|
|
**Problem:** Status ist nicht "completed"
|
|
**Lösung:**
|
|
1. Prüfen Sie die Logs in der Appwrite Console
|
|
2. Stellen Sie sicher, dass die Runtime korrekt ist
|
|
3. Prüfen Sie ob alle Dateien hochgeladen wurden
|
|
|
|
### PTV API Fehler
|
|
**Problem:** "PTV API Fehler - Status Code: 401"
|
|
**Lösung:** API Key in `environment.dart` überprüfen
|
|
|
|
### CORS weiterhin ein Problem
|
|
**Problem:** Immer noch CORS-Fehler
|
|
**Lösung:**
|
|
1. Stellen Sie sicher, dass die alte `getNearbyLocation` Methode nicht mehr verwendet wird
|
|
2. Prüfen Sie, dass `appwriteService.geocodeLocation` aufgerufen wird
|
|
3. Cachen leeren und App neu builden
|
|
|
|
## ✅ Erfolgskriterien
|
|
|
|
Nach erfolgreichem Deployment sollten Sie:
|
|
- ✅ Eine Erfolgs-Snackbar mit Adresse sehen (nicht nur Koordinaten)
|
|
- ✅ Keine CORS-Fehler mehr in der Browser-Console
|
|
- ✅ In den Logs: "📍 Verwende Backend-Proxy für Geocoding..."
|
|
- ✅ In den Logs: "✅ Geocoding erfolgreich: [Adresse]"
|
|
|
|
## 📝 Alternative ohne Deployment
|
|
|
|
Falls Sie die Function nicht deployen möchten, wird automatisch auf Koordinaten-Speicherung zurückgegriffen. Die App funktioniert weiterhin, speichert aber `Lat: XX.XXXXXX, Lon: YY.YYYYYY` statt der Adresse.
|