Garmin sync: zo werkt het in beide richtingen

Een van de meest gevraagde features tijdens de alpha was: "kunnen jullie mijn calorieën naar Garmin pushen?". Ja. En meer.

Wat MealForge naar Garmin stuurt

• Dagelijkse calorie-inname uit je dagboek.
• Waterinname (liter en glazen).
• Macronutriënten als notitie bij de dag.

Wat MealForge ophaalt uit Garmin

• Activiteiten van gisteren (loop, fiets, krachttraining, etc).
• Verbruikte calorieën per activiteit.
• Hartslagdata waar relevant voor het training-reconciliation algoritme.

Wanneer

Elke nacht om 05:00 lokale tijd. Dat heeft drie redenen:

1. Garmin's API is rustiger 's nachts en de rate-limits zijn ruimer.
2. Je hebt 's ochtends een vers dashboard.
3. Bij een storing aan onze of Garmin's kant heb je de hele dag om het te zien voordat het je avondplanning beïnvloedt.

Beveiliging

We gebruiken de inofficiële garmin-connect library. Je gebruikersnaam en wachtwoord worden versleuteld opgeslagen met AES-256-GCM, sleutelbeheer via Google Secret Manager. Je credentials worden alleen gebruikt voor de nachtelijke sync, niet voor on-demand calls.

Wat als de sync faalt

We retryen niet stilletjes. Drie opeenvolgende fouten zetten de integratie op needs_reauth. Je krijgt een banner op het dashboard en een mail om opnieuw te koppelen.

Toekomst

Op de roadmap: real-time push via Garmin's webhook-API zodra die algemeen beschikbaar wordt voor consumer-apps.