Aanvullend document

WattFlow operator handleiding

De verkorte handleiding voor dagelijks gebruik en support. Dit document is expres minder technisch: het helpt bij starten, controleren, troubleshooten en het juist uitleggen van de app aan anderen.

Open trainingsgids Open freshness-gids Open hoofdgids Open sequentiediagrammen

1. Waar gebruik je dit document voor?

Gebruik deze handleiding als je WattFlow moet bedienen, uitleggen of ondersteunen zonder meteen in de code of in de volledige architectuur te duiken.

Wel gebruiken voor

Nieuwe gebruiker op weg helpen
Dagelijkse opstart en standaardtraining
Eerste diagnose bij "het werkt niet"
Uitleggen wat Strava en Apple Health precies doen

Niet genoeg voor

BLE-randgevallen en protocolvragen
PowerMatch tuning op code-niveau
Volledige datarouting of exportdetail
Kalibratiedebug tot op FTMS/CPS byte-niveau

2. Dagelijkse startcheck

Als iemand WattFlow gewoon wil gebruiken, is dit de kortste betrouwbare checklijst.

Open Vandaag en kijk eerst naar de dagcontext: actief schema, Freshness en wat vandaag logisch is.
Ga naar Meer > Apparaten en controleer of trainer en sensoren zichtbaar en verbonden zijn.
Controleer in Meer > Workout instellingen of FTP-modus, level-modus, PowerMatch en live power goed staan.
Ga naar Training voor een losse workout of naar Schema voor een plansessie.
Start de sessie en controleer binnen enkele seconden of vermogen, cadans en hartslag logisch reageren.

Vuistregel. Als de trainer verbonden is maar live waarden raar zijn, ligt het probleem vaak niet bij "de workout", maar bij bronkeuze: verkeerde powermeter, verkeerde cadence source of HR via trainer in plaats van directe band.

3. Standaardgebruik in 5 stappen

Stap 1. Koppel apparaten

In Meer > Apparaten koppel je trainer, powermeter, hartslag en cadans. De trainer mag niet tegelijk als externe powermeter gekozen worden.

Stap 2. Begrijp de dag

Vandaag laat zien wat er voor deze dag logisch is. Kijk daar eerst naar Freshness, actieve plansessie en snelle acties.

Stap 3. Kies modus en workout

In Meer > Workout instellingen kies je FTP of level. In Training kun je zoeken, filteren, favorieten gebruiken of een workout importeren.

Stap 4. Start vanuit de juiste plek

Losse workouts start je vanuit Training. Plansessies start je vanuit Vandaag of Schema. Tijdens het rijden kun je pauzeren, hervatten en blokken vooruit of achteruit zetten.

Stap 5. Sla op en bekijk terug

Na afloop verschijnt de samenvatting. Vanaf daar kan de sessie lokaal landen in Historie & imports en optioneel verder naar Strava en Apple Health.

4. Schermen en instellingen die je moet kennen

Scherm of instelling	Wanneer relevant	Praktische uitleg
Vandaag	Dagelijks startpunt	Hier zie je dagcontext, Freshness, actieve plansessie en snelle acties. Dit is nu de eerste plek om te kijken voordat je support of sturing geeft.
Schema	Bij plannen en planvragen	Hier leeft de weekplanning, de plancatalogus, persoonlijke AI-plannen en planprogressie. Niet in Training.
Training	Bij losse workouts en uitvoering	Bibliotheek, favorieten, import en detailweergave. De concrete workoutlaag, niet de weeklaag.
Meer	Bij instellingen, koppelingen en support	Apparaten, workout instellingen, koppelingen, Freshness instellingen, AI plan instellingen, historie en diagnostiek wonen hier nu samen.
FTP	Bij klassieke intervaltraining	De basis voor zones en doelvermogen. Als deze fout staat, voelt bijna alles verkeerd.
Level-modus	Bij meer gevoel-gebaseerd trainen	De gebruiker werkt met niveaus; onder water gebruikt de app een virtuele FTP uit gewicht, geslacht en preset.
PowerMatch	Als een externe powermeter leidend moet zijn	De trainer wordt dan bijgestuurd op basis van de externe meter. Alleen zinvol met echte externe powermeter.
External L/R balance	Als links/rechts-balans van buiten moet komen	Heeft invloed op balansdata, niet per se op de live powerbron.
Start weerstand / Max weerstand	Bij FreeRide	Bepaalt hoe zwaar een FreeRide-blok aanvoelt.
Apple Health	Voor iOS-workoutopslag en FTP/gewichtssync	Leest en schrijft gezondheidsdata; niet bedoeld als sociale trainingsfeed.
Strava	Voor upload en import van ritten	Meer sport-/deelgericht; gebruikt voor uploads en voor recente Strava-imports.

5. Support: snelle diagnose

De tabel hieronder is bedoeld voor de meeste "het werkt niet"-meldingen zonder direct te hoeven debuggen in code.

Probleem	Eerst controleren	Waarschijnlijke oorzaak	Eerste oplossing
Trainer wordt niet gevonden	Staat trainer aan? Is vorige app nog verbonden?	Andere app houdt FTMS vast of trainer advertise't niet goed	Sluit andere trainingsapps, scan opnieuw, koppel trainer opnieuw
Geen vermogen zichtbaar	Welke power source is geselecteerd?	Verkeerde bron gekozen of externe meter niet echt verbonden	Check Meer > Apparaten en kijk welke bron "in use" is
Cadans klopt niet	Komt cadans van trainer, CPS of CSC?	Wheel-only sensor gekozen of verkeerde prioriteitsbron	Kies expliciet juiste cadence source; scan speed-only sensoren niet als cadence
HRV ontbreekt	Komt hartslag direct van HR-band?	HR komt via trainer-forwarding zonder RR-intervallen	Gebruik directe HR-sensor met RR-support
ERG voelt verkeerd	Klopt FTP? Staat PowerMatch aan? Is cadans stabiel?	FTP fout, externe meter wijkt af of cadans gate blokkeert PowerMatch	Controleer FTP, powermeterkeuze en test met/zonder PowerMatch
Workout wel klaar maar niet in Strava	Was Strava gekoppeld op opslaan-moment?	Upload pas na samenvatting, of geen FIT/TCX beschikbaar	Open Historie, deel/exporteer opnieuw of upload opnieuw indien nodig
Workout niet in Apple Health	Is Health-sync nog gemachtigd?	Toestemming ontbreekt of is ingetrokken	Apple Health toggle opnieuw aanzetten en autorisatie opnieuw doorlopen

Snelle supportvraag 1

Komt de data uit de juiste bron? Dit is bij WattFlow vaak belangrijker dan "is het device verbonden?".

Snelle supportvraag 2

Gaat het om live trainen, export of sync? Daarmee splits je snel op tussen workout-engine, lokale opslag en externe koppelingen.

6. Integraties: wat hoort waar?

Onderdeel	Doel	Niet voor bedoeld
Strava	Activiteiten uploaden en recente ritten importeren	Geen bron voor live workout-control
Apple Health	Ritten en workouts opslaan, FTP synchroniseren, gewicht teruglezen	Geen social feed of trainingsbibliotheek
Historie in WattFlow	Lokale waarheid voor app-workouts en imports	Geen vervanging voor live BLE-logging

7. AI-plannen en Freshness

Twee nieuwe supportvragen komen nu vaker terug: “waarom ziet mijn persoonlijke plan er zo uit?” en “waarom heeft WattFlow mijn volgende sessie aangepast?”. Die horen niet thuis onder Bluetooth, maar onder planlogica en hersteldata.

Persoonlijk AI-plan

De app maakt zelf niet het volledige plan, maar wel de prompt.
De gebruiker plakt die prompt in een extern AI-model en importeert daarna JSON terug in WattFlow.
Import faalt als schema, intervallen, TSS of workoutreferenties niet kloppen.
Vraag bij problemen altijd of het om het vaste catalogusplan of een persoonlijk AI-plan gaat.

Freshness

Freshness gebruikt Apple Health-signalen zoals slaap, HRV, rusthartslag en load-context.
Onder water werkt dit nu als een readiness-model met morning readiness, day score, confidence en trainability.
“Hoe voel je je?” zit erin omdat sensoren niet alles zien: spierpijn, stress en ervaren slaapkwaliteit geven extra dagcontext.
De feedbackknoppen zijn er zodat WattFlow later beter kan afstemmen of de score voor deze gebruiker eerder te hoog of te laag uitvalt.
Een actieve plansessie kan daardoor Aangepast of Herstel worden.
Als Health-sync uit staat of geen toestemming heeft, moet je die bijsturing ook niet verwachten.
Bij “dit is niet mijn originele plantraining” eerst de Freshness-kaart in Vandaag of Schema bekijken.

Snelle supportvolgorde. Bij planproblemen eerst bepalen of het om catalogusplan, persoonlijk AI-plan of Freshness-aanpassing gaat. Dat voorkomt dat een trainingsvraag onterecht als Bluetooth-bug of exportprobleem wordt behandeld.

8. Wat verzamelen bij bugs?

Als een probleem niet met de korte checks oplost, verzamel dan dit voordat je gaat escaleren.

Welke apparaten precies gekoppeld waren: trainer, powermeter, cadence, hartslag.
Welke training mode actief was: FTP of level.
Of PowerMatch aan of uit stond.
Of het om een vast plan of een persoonlijk AI-plan ging.
Wat de Freshness-score was als de plansessie aangepast werd.
Of het probleem zat in live gedrag, opslaan, Strava of Apple Health.
Naam/tijdstip van de activiteit zodat die in Historie terug te vinden is.
Indien nodig: exports of logs vanuit de developer/supportfuncties.

Beste escalatiepad. Voor vragen over bibliotheek, categorieën of plannen is eerst de trainingsgids handig. Voor herstelscore en planbijsturing is daarna de freshness-gids de beste verdieping. Voor structurele Bluetooth- of PowerMatch-vragen is daarna de hoofdgids de volgende stap. Voor flow-overzicht en volgorde van calls is het diagramdocument sneller.

Deze verkorte handleiding is afgestemd op de huidige Vandaag/Schema/Training/Meer-flow met readiness-architectuur zoals die in de code staat op 9 april 2026.