WattFlow logo
Aanvullend document

WattFlow sequentiediagrammen

Dit document bevat alleen de hoofdflows in sequentievorm. Het is bedoeld als snelle visuele aanvulling op de brede architectuurdocumentatie, zonder alle lange uitleg ertussen. Daar horen nu ook de AI-planimport en freshness-gestuurde planbijsturing bij.

Open trainingsgids Open freshness-gids Open hoofdgids Open operator handleiding
Leeswijze. De diagrams hieronder zijn bewust operationeel: wie initieert iets, welke service reageert, en waar wordt data of status echt vastgelegd.
Actie of opdracht
Response of status terug
Bevestigde state
Validatie, uitzondering of fallback

1. Scan en trainer verbinden

Dit is de flow die in Instellingen gebeurt wanneer iemand op Scan devices drukt en WattFlow daarna de trainer automatisch probeert te kiezen.

Operator Meer > Apparaten BluetoothManager CoreBluetooth Smart trainer Tap "Scan devices" scanAllSources() Start scan FTMS advertising seen Registry updated best trainer chosen connectTrainer(id) central.connect() Discover services Services + characteristics FTMS valid, status connected

Wat hierbij belangrijk is

  • De trainer moet echt FTMS hebben. Alleen "lijkt op een trainer" is niet genoeg.
  • De Settings-flow auto-connect momenteel alleen de trainer, niet automatisch alle andere sensoren.
  • De keuze is RSSI-gedreven: de beste zichtbare trainer wint als er niet al een expliciete voorkeur is.

2. Extra sensoren koppelen

Powermeter, cadans en hartslag volgen een vergelijkbare maar strengere flow, omdat WattFlow trainers, speed-only sensoren en echte externe meters uit elkaar moet houden.

Operator Meer > Apparaten BluetoothManager Device registry Sensor Select source connectPower / Cadence / HR Validate role + capability FTMS block? wheel-only? Reject trainer as PM reject speed-only CSC Connect peripheral Services discovered + notify active UI shows connected / in use

Belangrijkste regels

  • Een trainer mag niet als externe powermeter of als losse cadence source gebruikt worden.
  • Een wheel-only CSC sensor wordt afgewezen als cadence source.
  • HR via trainer is fallback; een directe HR-sensor wint voor RR- en HRV-data.

3. Workout starten en live sturen

Zodra een workout is gekozen, verschuift de regie naar WorkoutSessionEngine. Die engine start de workout, leest live waarden en stuurt de trainer opnieuw per stap of tick.

Operator TrainingenTab AppModel WorkoutSessionEngine BluetoothManager Trainer Choose workout prepareWorkout(...) Create session Bind live signals Start workout startWorkout() Apply current step Set ERG / resistance Live data Power / cadence / HR 1 Hz target update + PowerMatch ActivitySample recorded every second
Variant Wat er verandert in de flow
FTP-modus Workoutpercentages worden direct doelwatts op basis van huidige FTP.
Level-modus De engine rekent met een virtuele FTP en een niveau-factor; live UI toont nadrukkelijk het niveau.
PowerMatch aan De engine corrigeert trainer-targets op basis van externe powermeterfeedback, maar de trainer blijft FTMS-targets ontvangen.
FreeRide In plaats van target watts verstuurt WattFlow een resistance level.

4. Workout afronden en opslaan

Bij het einde van een workout wordt niet alleen de UI bijgewerkt. De app bouwt een volledige activiteit op, maakt exportbestanden en bereidt daarna optioneel syncs voor.

WorkoutSessionEngine AppModel ActivityStore Exporters Apple Health phase = finished buildActivityRecord() Save local activity Write TCX + FIT lastFinishedActivity set FTP suggestion evaluated saveWorkout(payload) if Health sync on Saved or failed, summary remains available
Operator-opmerking. Een workout is in de praktijk al lokaal opgeslagen zodra de sessie finished raakt. De latere knop "klaar" ruimt vooral de sessie op en kan optioneel Strava-upload doen.

5. Strava upload

Upload gebeurt pas na de samenvatting, wanneer de gebruiker opslaat met Strava-upload aan.

Operator WorkoutSummaryView AppModel StravaConnectService Strava API Tap save onSaveWorkout() Prefer FIT upload fallback to TCX uploadFIT() POST /uploads Poll upload status Upload settled Clear session + switch to Historie

6. Strava import

Historie kan ook andersom werken: WattFlow haalt recente Strava-activiteiten op en bouwt ze lokaal opnieuw op.

Operator Meer > Historie AppModel StravaConnectService Strava API ActivityStore Open "To import" Fetch candidates fetchImportActivities() GET /activities Candidates Candidates returned List shown Import selected activity importActivity(id) GET activity + streams + laps Save imported local record Activity saved, optional Health sync follows Activity appears in Historie

7. Apple Health sync

Apple Health heeft eigenlijk twee aparte flows: toestemming/inkomend profiel, en uitgaande workout/FTP-sync.

Operator Meer > Koppelingen AppModel AppleHealthService HealthKit Enable Health setAppleHealthSyncEnabled(true) requestAuthorization() requestAuthorization Granted / denied Refresh auth state Refresh profile from Health Read bodyMass + cycling FTP Values returned Apply local weight + FTP Later: workout finish -> saveWorkout(payload) FTP change -> saveCyclingFTP(ftp)

8. Trainerkalibratie

De trainer spin-down is de meest "fysieke" flow in de app: de gebruiker moet echt optrekken en uitrollen, terwijl WattFlow de voortgang bewaakt via FTMS-speed.

Operator Settings UI BluetoothManager Trainer / FTMS Open calibrate Start trainer calibration Request control Start FTMS spin-down FTMS speed updates Phase 1: pedalUp Phase 2: coastDown Phase 3: finished Guidance updated in UI

9. AI-plan maken en importeren

Het AI-plan is een bewust tweestapsproces: WattFlow bouwt de strikte prompt en valideert daarna de JSON-import, maar het genereren zelf gebeurt buiten de app.

Gebruiker PlanView AIPlanViews AIPlanImportService Extern AI-model Store Open persoonlijk plan Start wizard buildNewPlanPrompt(input) Prompt bevat harde regels: JSON only, vaste schema keys, loadregels en intervalcontract Prompttekst terug Prompt plakken en JSON laten genereren JSON terug, plakken in importsheet validate + decode + adapt Checks: workout refs, TSS-curve, sessiedagen, types save(plan + workouts) Persoonlijk plan zichtbaar in PlanView

10. Freshness en planbijsturing

De freshness-flow bepaalt niet het hele plan opnieuw, maar kijkt vlak voor weergave of de volgende plansessie gelijk kan blijven, verlaagd moet worden of vervangen moet worden door herstel. Onder water loopt dit nu via een readiness-architectuur met morning readiness, day score en trainability.

App / foreground AppModel AppleHealthService FreshnessCalculator FreshnessTrainingAdvisor PlanView Open Vandaag of Schema loadFreshnessAnalysisInputs() Sleep, HRV, RHR, resp, temp, load compute(inputs, previousState) Anchor + HRV selectie, readiness componenten, confidence/caution, morning lock, day score en trainability DailyState + detail snapshot advice(for next planned workout) Keep / reduce / replace Mogelijke UI-status: Normaal, Aangepast, Herstel of Rust / herstel Gebruiker ziet freshness-score en aangepaste sessie

Bijbehorende bronbestanden

Flow Belangrijkste code
Scannen en verbinden WattFlow/Views/MoreTabView.swift, WattFlow/Views/SettingsTabView.swift, WattFlow/Services/BluetoothManager.swift
Workout starten en live sturen WattFlow/AppModel.swift, WattFlow/Services/WorkoutSessionEngine.swift, WattFlow/Services/BluetoothManager.swift
Strava WattFlow/AppModel.swift, WattFlow/Services/StravaConnectService.swift
Apple Health WattFlow/AppModel.swift, WattFlow/Services/AppleHealthService.swift
AI-plan prompt en import WattFlow/Views/AIPlanViews.swift, WattFlow/Services/AIPlanImportService.swift, WattFlow/Services/AIPlanWorkoutAdapter.swift, WattFlow/Services/AIPlanStore.swift
Freshness en planbijsturing WattFlow/AppModel.swift, WattFlow/Services/AppleHealthService.swift, WattFlow/Services/FreshnessCalculator.swift, WattFlow/Services/FreshnessTrainingAdvisor.swift

Deze diagrams zijn een operationele vereenvoudiging van de codeflow op 9 april 2026. Voor planopbouw, AI-prompts, categorieën en trainingsbibliotheek is de trainingsgids de juiste aanvulling. Voor de volledige Freshness/readiness-flow, morning lock, confidence en caution is de freshness-gids de juiste verdieping. Voor alle randgevallen en routingdetails blijft de hoofdgids leidend.