ModusPractica Handleiding

⚠️ Het probleem: De meeste muzikanten oefenen elke dag dezelfde stukken, wat leidt tot verspilde tijd aan materiaal dat ze al kennen, terwijl stukken die aandacht nodig hebben worden verwaarloosd. Deze inefficiënte aanpak vertraagt vooruitgang en veroorzaakt frustratie.

💡 Pro versie voordeel: In tegenstelling tot de web-app (beperkt tot ~300 stukken door browser localstorage), biedt deze desktop versie onbeperkte opslag voor professionals met uitgebreide repertoires.

💡 Nieuw in v3.0.1: De app detecteert nu automatisch of u in de Exploratiefase of de Trainingsfase zit. U hoeft dit niet meer handmatig aan te geven via een vinkje — zie Automatische Fase-detectie hieronder voor meer uitleg.

⚠️ Belangrijk: Na het aanmaken van uw profiel, vergeet niet om het op te slaan via de knop "Export Data". Dit creëert een back-up bestand op uw computer of in de cloud. Doe dit na iedere oefendag. Deze data kan eventueel geïmporteerd worden in een andere browser, zodat u daar verder kunt werken.

💡 Tip: Houd secties klein! Voor complexe passages zijn 2-4-8 maten vaak ideaal, maar een chunck kan ook een halve maat of anderhalve maat zijn. Dit maakt het makkelijker om gefocust te oefenen en sneller vooruitgang te boeken.

Stappen:

1. Klik op de knop "+ Create New Profile" op het inlogscherm
2. Voer een profielnaam in (verplicht)
   • Kies een herkenbare naam zoals "Jan", "Maria" of "Leerling 1"
   • De naam moet uniek zijn - u kunt geen twee profielen met dezelfde naam hebben
3. Selecteer optioneel uw ervaringsniveau:
   • Beginner (0-2 jaar)
   • Intermediate (3-5 jaar)
   • Advanced (6+ jaar)
   • Professional
4. Klik op "Create Profile"

⚠️ Belangrijk: Maak direct na het aanmaken van uw profiel een back-up via "Export Data". Dit is uw veiligheidsnet tegen gegevensverlies!

💡 Wanneer moet u uw ervaringsniveau aanpassen?

Als u merkbaar vooruitgang boekt en naar een hoger niveau overgaat, kunt u dit aanpassen in de profiel instellingen. De app behoudt al uw oefenhistorie en geheugenstabiliteitsdata, maar past de planning algoritmes aan voor uw nieuwe niveau.

Stappen:

1. Selecteer het profiel dat u wilt bewerken in de dropdown
2. Klik op de knop "✏️ Edit Profile"
3. Pas de naam en/of het ervaringsniveau aan
4. Klik op "Save Changes" om te bevestigen
5. Of klik op "Cancel" om de wijzigingen te annuleren

🔐 Data behouden: Bij het bewerken van een profiel blijven al uw muziekstukken, secties, oefenhistorie en statistieken volledig intact. Alleen de naam en het ervaringsniveau worden aangepast.

⚠️ Let op: Het verwijderen van een profiel is permanent en kan niet ongedaan gemaakt worden. Alle data wordt definitief verwijderd:

• Alle muziekstukken en secties
• Volledige oefenhistorie
• Alle statistieken en voortgangsgrafieken
• Instellingen en voorkeuren

Stappen om een profiel te verwijderen:

1. Selecteer het profiel dat u wilt verwijderen
2. Klik op de knop "🗑️ Delete Profile"
3. Bevestig in het waarschuwingsvenster dat u zeker bent
   • Het systeem toont u hoeveel muziekstukken verloren gaan
   • U moet bevestigen dat u begrijpt dat dit permanent is
4. Het profiel en alle bijbehorende data worden onmiddellijk verwijderd

🛡️ Veiligheidstip: Maak altijd eerst een back-up via "Export Data" voordat u een profiel verwijdert, voor het geval u later van gedachten verandert!

Wat wordt er geëxporteerd?

• Alle profielen - namen, ervaringsniveaus, aanmaakdatums
• Alle muziekstukken - titels, componisten, secties, kleuren
• Volledige oefenhistorie - alle sessies, beoordelingen, tijdstempels
• Statistieken en metrieken - tau-waardes, memory stability, practice stages
• Instellingen - intensiteitsmodule configuratie, voorkeuren

Stappen om data te exporteren:

1. Klik op de knop "📥 Export Data" onderaan het profielscherm
2. De app genereert automatisch een JSON bestand met alle data
3. Het bestand wordt opgeslagen in uw Downloads map met de naam: ModusPractica_Export_[datum]_[tijd].json
4. Bewaar dit bestand op een veilige locatie:
   • USB-stick (voor back-up)
   • Cloud storage (Google Drive, Dropbox, OneDrive)
   • Externe harde schijf

💡 Best practice: Exporteer uw data regelmatig - bij voorkeur na elke oefensessie of minstens één keer per week. Dit voorkomt gegevensverlies bij browserproblemen of onbedoeld wissen van cache.

Stappen om data te importeren:

1. Klik op de knop "📤 Import Data"
2. Selecteer het JSON export bestand van uw computer
3. Kies uw import strategie:

   Option 1: Merge (Samenvoegen)

   Voegt nieuwe profielen toe aan bestaande data. Als een profiel met dezelfde naam al bestaat, wordt het overgeslagen. Aanbevolen voor het combineren van data van meerdere apparaten.

   Option 2: Replace (Vervangen)

   Verwijdert ALLE bestaande data en vervangt deze met de geïmporteerde data. Gebruik dit voor het volledig herstellen van een back-up.

4. Bevestig uw keuze
5. De app laadt de data en toont een bevestiging

⚠️ Waarschuwing bij Replace modus: Als u "Replace" kiest, worden alle huidige profielen en data permanent verwijderd voordat de import plaatsvindt. Zorg dat u eerst een export maakt van uw huidige data als u deze wilt behouden!

Scenario 1: Van computer naar laptop

1. Exporteer data op computer A
2. Kopieer het JSON bestand naar een USB-stick of cloud storage
3. Download het bestand op computer B
4. Importeer met "Replace" om exact dezelfde data te hebben

Scenario 2: Data van meerdere studenten combineren

1. Elke student exporteert hun eigen profiel
2. Docent importeert elk bestand met "Merge"
3. Alle studentprofielen zijn nu beschikbaar op één apparaat

⚠️ GEVAAR: De knop "🗑️ Clear All Data" onderaan het scherm verwijdert:

• Alle profielen (zonder uitzondering)
• Alle muziekstukken en secties
• Alle oefenhistorie en statistieken
• Alle instellingen en voorkeuren

Dit kan NIET ongedaan gemaakt worden! Gebruik deze functie alleen als u absoluut zeker bent. Maak eerst een export als u de data ooit nog nodig zou kunnen hebben.

💡 Samenvatting: Data beheer best practices

• Exporteer regelmatig - minstens één keer per week
• Bewaar back-ups op meerdere locaties - USB + cloud storage
• Test uw back-ups - probeer eens een import op een testapparaat
• Label uw export bestanden duidelijk - voeg datums toe aan bestandsnamen
• Voordat u een profiel verwijdert - maak eerst een export
• Bij browserproblemen - importeer uw laatste back-up

📝 Opmerking voor gevorderden: Het export JSON bestand bevat alle data in leesbaar formaat. Als u technisch onderlegd bent, kunt u het bestand handmatig bewerken met een teksteditor om specifieke aanpassingen te maken, voordat u het opnieuw importeert.

🎵 Waarom chunking zo krachtig is

• Vermindert cognitieve belasting: Kleinere secties zijn makkelijker te verwerken
• Verhoogt focus: U kunt zich concentreren op specifieke technische uitdagingen
• Versnelt vooruitgang: Mastery van kleine delen stapelt sneller op
• Voorkomt frustratie: Vroege successen motiveren doorgang
• Verbetert retentie: Elk chunk krijgt zijn eigen geheugenspoor en herhalingsschema

💡 Praktische richtlijnen

• Beginners: 1-4 maten per chunk (soms zelfs een halve maat voor zeer technische passages)
• Intermediates: 2-8 maten per chunk
• Gevorderden: 4-16 maten, afhankelijk van complexiteit
• Professionals: 8-32 maten, maar splits nog steeds uitdagende passages op

Vuistregel: Als u een sectie niet vlot 3× achter elkaar foutloos kunt spelen na 5 minuten oefenen, is het waarschijnlijk te groot—splits het verder op!

Stap 1: Maak het stuk aan

1. Klik op "+ New Piece" in het Dashboard
2. Vul in:
   • Titel: "Für Elise"
   • Componist: "Ludwig van Beethoven"
   • Kleur: Kies bijvoorbeeld blauw
3. Klik "Save"

Stap 2: Analyseer de structuur

Open uw partituur en identificeer natuurlijke secties:

Opmerking: Dit is een grove opdeling. In de praktijk zou u deze verder kunnen splitsen, vooral voor technisch uitdagende passages in sectie B.

Stap 3: Voeg chunks toe

Klik op het stuk in het Dashboard om de detailpagina te openen, dan:

1. Klik "+ Add Section"
2. Voor het hoofdthema:
   • Naam: "Sectie A - Hoofdthema"
   • Maten: "1-23"
   • Beschrijving: "Karakteristiek E-Dm-E frase" (optioneel)
   • Target Reps: Voer het gewenste doelaantal in (bijv. 8). Het veld start leeg en vereist een waarde — de app heeft geen vaste standaard meer.
3. Klik "Save Section"
4. Herhaal voor de andere secties

Stap 4: Start uw eerste sessie

1. Op het Dashboard zie je nu de nieuwe sectie verschijnen in "Today's Agenda"
2. Klik op de sectie zelf om de oefensessie te starten
3. Dit opent de Practice Session interface waar u:
   • De timer start wanneer u begint
   • Fouten en correcte herhalingen bijhoudt
   • Uw prestatie beoordeelt na afloop

🔧 Een sectie bewerken:

1. Ga naar de stuk detailpagina
2. Klik op het ✏️ icoon naast de sectie
3. Pas de beschrijving of andere details aan
4. Klik "Save"

Let op: De sectienaam kan niet worden gewijzigd omdat dit de identifier is voor de planner. De oefenhistorie blijft behouden.

➕ Een chunk splitsen:

Als u merkt dat een chunk te groot is, gebruikt u de ingebouwde splitsfunctie:

1. Ga naar de stukdetailpagina en zoek de chunk.
2. Klik op ✂ Split bij de chunk.
3. Voer twee nieuwe kind-bereiken in en het gewenste doel-aantal herhalingen (leeg veld, geen standaard).
4. Klik ✂️ Confirm Split. De ouder-chunk wordt gearchiveerd; de twee kind-chunks starten opnieuw met interval 1 dag.

🔗 Chunks combineren:

Als twee aangrenzende chunks goed zitten, gebruikt u de ingebouwde samenvoegfunctie:

1. Klik op ⊕ Merge Mode in de stukdetailpagina.
2. Selecteer de chunks die u wilt samenvoegen via de selectievakjes.
3. Klik Merge Selected, vul het nieuwe bereik en de gewenste doelherhalingen in (leeg veld, geen standaard) en bevestig.
4. De ouder-chunks worden gearchiveerd; de nieuwe samengevoegde chunk start actief.

⚠️ Veelgemaakte fouten bij chunking

• Te grote chunks: "Ik zal de hele eerste pagina als één chunk nemen" → Splits op! Succes bij kleine delen motiveert meer.
• Te veel chunks tegelijk toevoegen: "Ik voeg nu alle 47 chunks van dit stuk toe" → Begin met 2-3 chunks. Voeg geleidelijk toe.
• Chunks zonder duidelijke grenzen: "Maten 5-9... of was het 6-10?" → Wees precies. Schrijf het op in de naam.
• Negeren van muzikale structuur: Een chunk splitsen midden in een frase → Respecteer de muzikale logica.
• Te perfectionistisch over de eerste opdeling: U kunt het altijd later aanpassen! Start en leer gaandeweg.

✅ Onderhoud van volledige stukken:

1. Voeg het volledige stuk toe als nieuwe sectie (bijv. "Hele stuk - onderhoud")
2. Zet Target Repetitions op 1
3. Speel het stuk volledig door
4. Evalueer met "Excellent" als het goed ging - de planner zet dan automatisch een nieuwe onderhoudsdatum
5. U bepaalt zelf of u het stuk nog een keer wilt spelen op dezelfde dag - de geplande datum blijft ongewijzigd na extra herhalingen

Tip: Extra herhalingen op dezelfde dag beïnvloeden de planning niet. De volgende onderhoudsdatum wordt alleen aangepast na de eerste sessie van de dag.

Zo voegt u chunks samen

1. Open een stuk en ga naar de chunklijst.
2. Klik op ⊕ Merge Mode.
3. Selecteer minstens twee chunks via de selectievakjes die verschijnen.
4. Klik op Merge Selected.
5. Vul in het venster het nieuwe gecombineerde maatbereik in, eventueel een beschrijving, en het doel-aantal herhalingen.
6. Klik op ⊕ Confirm Merge.

Wat gebeurt er na het samenvoegen?

• Er wordt een nieuwe samengevoegde chunk aangemaakt als frisse actieve chunk.
• De volgende reviewdatum wordt conservatief overgenomen: de app gebruikt de vroegste reviewdatum van de geselecteerde ouder-chunks, maar nooit een datum in het verleden.
• De oorspronkelijke ouder-chunks worden gearchiveerd, niet verwijderd, zodat hun oefengeschiedenis intact blijft.
• Stabiliteitsdata wordt pessimistisch overgenomen, zodat de nieuwe grotere chunk niet ten onrechte als volledig geconsolideerd wordt behandeld.

⚠️ Belangrijk: Samenvoegen controleert niet automatisch of de gekozen chunks muzikaal logisch op elkaar aansluiten. U blijft zelf verantwoordelijk voor een zinvol nieuw bereik en voor chunks die echt bij elkaar horen.

Zo splitst u een chunk

1. Open de stukdetailweergave en zoek de chunk die u wilt verfijnen.
2. Klik bij die chunk op ✂ Split.
3. Voer twee nieuwe kind-bereiken in en kies het doel-aantal herhalingen.
4. Klik op ✂️ Confirm Split.

Wat gebeurt er na het splitsen?

• Er worden twee nieuwe kind-chunks aangemaakt en beide starten opnieuw met een interval van 1 dag en een nieuwe oefenstatus.
• De ouder-chunk wordt gearchiveerd, niet verwijderd, zodat historische data behouden blijft.
• De kind-chunks erven herkomst- en stabiliteitskoppelingen van de ouder, zodat de continuïteit in het datamodel bewaard blijft.
• De beschrijving van de ouder-chunk wordt naar de kinderen gekopieerd, zodat u die alleen nog hoeft te verfijnen.

⚠️ Belangrijk: De app controleert de notatie van het maatbereik en voorkomt dubbele kind-bereiken, maar bepaalt de muzikale splitsing niet voor u. Kies dus twee bereiken die technisch en structureel zinvol zijn.

Wetenschappelijke achtergrond

Deze functies sluiten aan bij bekende oefenprincipes. De cognitieve-belastingstheorie, geassocieerd met John Sweller, laat zien dat kleinere en duidelijk afgebakende leereenheden overbelasting verminderen. Onderzoek naar deliberate practice, geassocieerd met K. Anders Ericsson, benadrukt het isoleren van zwakke plekken voordat u ze opnieuw integreert in een groter geheel. In de praktijk betekent dat:

• Splits wanneer een passage te veel informatie of te veel technische eisen tegelijk bevat.
• Voeg samen wanneer eerder geïsoleerde chunks sterk genoeg zijn om als één coherente frase of beweging te functioneren.

💡 Hoe werkt het? Na elke afgeronde oefensessie analyseert de app automatisch uw recente prestaties. Zodra de voorwaarden voor een merge- of split-suggestie vervuld zijn, verschijnt er een gekleurde banner bovenaan de stukdetailpagina. U behoudt altijd de volledige controle: u beslist zelf of u het voorstel accepteert of negeert.

💡 Suggestion: Merge bars 1–4 and bars 5–8 into a single section.

Both sections are stable. Combining them will help you practice the musical connection between these passages.

• "Accept" — De app voegt de twee chunks samen tot één groter blok en plant dit nieuwe blok veilig in. De volgende reviewdatum wordt conservatief berekend op basis van de vroegste reviewdatum van de samengevoegde chunks, zodat u niet voor verrassingen komt te staan. De oorspronkelijke chunks worden gearchiveerd zodat de geschiedenis bewaard blijft.
• "Dismiss" — U negeert het voorstel. De chunks blijven ongewijzigd in de agenda staan en u continueert ze afzonderlijk te oefenen. De banner verdwijnt en keert pas terug als de omstandigheden opnieuw aan de criteria voldoen.

✅ Wanneer “Accept” kiezen? Als u beide passages afzonderlijk vlot en zelfverzekerd kunt spelen, is samenvoegen de logische volgende stap. U traint dan de overgang ertussen — precies de vaardigheid waaruit muzikale flow bestaat.

⚠️ Wanneer “Dismiss” kiezen? Twijfelt u of de stukken écht stabiel zitten? Wijs het voorstel dan af. Er is geen haast — de app stelt het alleen opnieuw voor nadat u meer sessies heeft afgerond en de data het opnieuw aantonen.

⚠️ Suggestion: Split section “Bars 9–16” into two smaller parts.

This section shows repeated difficulty. Splitting it may help your brain process and consolidate it more effectively.

• "Accept" — De app halveert de chunk automatisch in twee kleinere micro-chunks (bijv. 8 maten worden er twee van elk 4). Beide nieuwe chunks starten met een vers interval van 1 dag. Zo kan uw brein elke helft afzonderlijk verwerken en consolideren, waarna u ze later opnieuw kunt samenvoegen via een merge-suggestie.
• "Dismiss" — U negeert het voorstel. De chunk blijft ongewijzigd. Dit kan zinvol zijn als u de moeite al herkent en een eigen alternatieve strategie wilt proberen (bijv. nog langzamer oefenen of een andere aanpak).

✅ Wanneer “Accept” kiezen? Als u het gevoel heeft dat een passage steeds maar niet wil lukken — ongeacht hoeveel u oefent — is opsplitsen vrijwel altijd de beste zet. Kleinere stukken zijn veel makkelijker te consolideren. Zodra de twee helften elk afzonderlijk stabiel zitten, stelt de app automatisch een merge voor om ze opnieuw te verbinden.

⚠️ Let op bij “Dismiss”: Als u het voorstel herhaaldelijk afwijst terwijl de passage niet verbetert, riskeert u onnodige frustratie. Wees bereid om losser om te gaan met de oorspronkelijke indeling — een passage in tweeën splitsen is geen falen, maar een slimme tactiek die professionele muzikanten de hele tijd toepassen.

Wetenschappelijke achtergrond

De Smart Suggestions bouwen voort op hetzelfde fundament als de handmatige merge- en splitfuncties (zie sectie 4A), maar reageren proactief op uw oefendata. De cognitieve-belastingstheorie (Sweller) verklaart waarom een te grote leerdosis het leren blokkeert: het werkgeheugen raakt verzadigd voordat informatie naar het langetermijngeheugen kan worden overgebracht. Onderzoek naar deliberate practice (Ericsson) laat zien dat isoleren van zwakke plekken — gevolgd door herïntegratie — de kern is van expertiseopbouw. De Smart Suggestions automatiseren precies dit principe: ze helpen u de optimale chunk-grootte te vinden voor elke fase van uw leerproces.

1. Open het Dashboard
2. Zoek de chunk die u wilt oefenen in "Today's Agenda" of "All Pieces"
3. Klik op de chunk zelf (niet op het edit-icoon)
4. De Practice Session interface opent automatisch

💡 Wat u ziet wanneer de sessie opent:

• Stuktitel en chunk informatie - Wat u gaat oefenen
• Memory Zone - De leerfase (Exploration, Consolidation, Mastery, of Overlearning)
• Laatste oefendatum - Wanneer u deze chunk voor het laatst geoefend heeft
• Timer - Voor het bijhouden van oefentijd
• Tracking Metrics - Tellers voor correcte herhalingen, fouten, en streak resets
• Energie niveau - Uw huidige fysieke en mentale staat
• Notities veld - Voor het documenteren van observaties

Functie: Houdt bij hoeveel tijd u aan deze chunk besteedt.

Dit zijn de kern-metingen die het Ebbinghaus-algoritme gebruikt om uw volgende oefendatum te berekenen:

Functie: Het doel aantal foutloze herhalingen dat u wilt bereiken in deze sessie.

Functie: Bepaalt hoe agressief het overlearning algoritme reageert op fouten.

Voorbeeld: Uw chunk heeft een doel van 8 herhalingen. U maakt 10 fouten voor de eerste correcte herhaling → 100% = 10 target reps (MAX(8, 10)), 50% = 9 target reps (8 + floor((10−8)/2)).

Functie: Registreer uw fysieke en mentale staat tijdens de oefensessie.

Gebruik: Deze data wordt opgeslagen voor toekomstige analyse. Het kan helpen om patronen te identificeren - misschien presteert u beter 's ochtends of na een koffiepauze!

Functie: Volg uw tempo-progressie voor chunks waar tempo een belangrijk leerdoel is.

Functie: Documenteer observaties, ontdekkingen, en problematieken tijdens de sessie.

Auto-load: Notities van uw vorige sessie worden automatisch geladen, zodat u uw eerdere observaties direct kunt raadplegen en aanvullen.

Deze knop opent het Evaluation Modal - het laatste belangrijke onderdeel van de sessie.

Dit is de belangrijkste input voor het Ebbinghaus-algoritme. Uw evaluatie bepaalt direct het volgende herhalingsinterval:

Als u minstens 2 sessies heeft voltooid voor deze chunk, toont het evaluatie modal automatisch een Success Ratio Trend Chart.

Gebruik: Deze visualisatie helpt u om uw consistentie te beoordelen en trends te identificeren (bijv. "Mijn success rate daalt - misschien te snel door chunks heen?").

Nadat u een prestatie-evaluatie heeft geselecteerd, klikt u op "Save Evaluation".

Wat gebeurt er nu:

1. De sessie wordt opgeslagen in practiceSessions array van het stuk
2. Een entry wordt toegevoegd aan practiceHistory voor statistieken
3. De chunk properties worden bijgewerkt:
   • lastPracticeDate → vandaag
   • completedRepetitions → +correct repetitions
   • targetTempo en achievedTempo bijgewerkt
4. Het Ebbinghaus-algoritme berekent het volgende herhalingsinterval:
   • Stage 0-2: Vaste 1-dag intervallen (foundation phase)
   • Stage 3+: Ebbinghaus formule (t = -τ × ln(R*)) met performance adjustment
5. nextReviewDate wordt gezet
6. Als u uw targetRepetitions bereikte, wordt practiceScheduleStage verhoogd met 1
7. Adaptieve systemen worden bijgewerkt:
   • Personalized Memory Calibration (PMC) leert uw individuele retentie-karakteristiek
   • Memory Stability Manager trakt stabiliteit (S) en difficulty (D)
   • Adaptive Tau Manager berekent geoptimaliseerde τ-waardes
8. Draft wordt gewist (auto-save data verwijderd)
9. U wordt teruggeleid naar het Dashboard

⚠️ Wat als de chunk te moeilijk is?

Soms oefent u een chunk 10+ minuten zonder één succesvolle herhaling te bereiken. Dit is normaal voor uitdagende passages!

Het systeem herkent dit automatisch:

• Als u 2+ minuten geoefend heeft maar 0 correcte herhalingen bereikte
• Toont het evaluatie modal een waarschuwing: "Passage too difficult?"
• De sessie wordt gemarkeerd als sessionOutcome: 'Incomplete'

Gevolgen:

• Vast 1-dag interval - u krijgt morgen opnieuw een kans
• Geen stage penalty - uw practice stage blijft hetzelfde
• Data wordt bewaard - uw tijd en moeite worden geregistreerd
• Geen target increment - target blijft 6

Advies: Overweeg de chunk op te splitsen in kleinere sub-chunks, of oefen eerst langzamer tempo. Soms is het verstandig om te pauzeren en met een frisse geest terug te komen.

Als u de sessie wilt annuleren zonder op te slaan, klik op "Cancel Session".

Wat gebeurt er:

• Als u data heeft ingevoerd (tijd, pogingen, notities), krijgt u een waarschuwing
• Na bevestiging wordt alle sessiedata verwijderd
• Draft wordt gewist
• U keert terug naar het Dashboard
• Niets wordt opgeslagen - de chunk blijft ongewijzigd

⚠️ Let op: Annuleren kan niet ongedaan gemaakt worden! Als u per ongeluk annuleert, moet u de sessie opnieuw doen.

💾 Automatische opslag

ModusPractica slaat uw sessie automatisch op als draft elke 30 seconden terwijl u oefent.

Wat wordt opgeslagen in de draft:

• Timer status (totalElapsedSeconds, isRunning, pausedTime)
• Tracking metrics (failedAttempts, correctRepetitions, streakResets)
• Dr. Gebrian state (errorsBeforeFirstCorrect, hasAchievedFirstCorrect, targetRepetitions)
• Energy level selectie
• Session notes
• Tempo values (target, achieved)
• Timestamp van laatste save

Recovery scenario's:

• Browser crash: Bij heropenen van de sessie laadt het systeem automatisch de draft
• Per ongeluk venster sluiten: Draft wordt hersteld bij volgende sessie voor dezelfde chunk
• Elektriciteit uitval: Als de draft was opgeslagen binnen 30 sec, is data behouden

💡 Tip: U ziet een indicator "💾 Unsaved Changes" rechtsonder als er niet-opgeslagen data is. Deze verdwijnt zodra de auto-save triggert.

Het Intensity Module is een geavanceerd systeem dat real-time feedback geeft over uw oefenintensiteit en kwaliteit.

Gebruik: Deze metrics zijn bedoeld voor gevorderde gebruikers die hun oefenproces willen optimaliseren. Voor beginners zijn ze optioneel.

✅ Aanbevolen aanpak:

• Start de timer zodra u begint - accuraat bijhouden is cruciaal voor statistieken
• Registreer elke poging eerlijk - kwaliteit boven kwantiteit
• Gebruik failed attempts conservatief - alleen voor echte mislukkingen vóór eerste succes
• Neem micro-breaks serieus - na 3 correcte herhalingen even pauzeren helpt consolidatie
• Wees eerlijk bij evaluatie - het systeem is alleen zo goed als uw input
• Documenteer observaties - toekomstige-u zal u dankbaar zijn voor goede notities
• Track tempo progressie - ook kleine stappen vooruit zijn motiverend om te zien
• Splits te moeilijke chunks op - als u 0 correcte herhalingen bereikt na 10+ minuten, is de chunk te groot

⚠️ Veelgemaakte fouten:

• Te optimistisch evalueren: "Het ging best goed" → Excellent → Interval te lang → Memory failure volgende sessie
• Target handmatig aanpassen zonder reden: Dit schakelt Dr. Gebrian uit - laat het systeem zijn werk doen
• Failed attempts blijven verhogen na eerste succes: Gebruik "Reset ↻" bij streak break, niet failed attempts
• Timer vergeten te starten: Retroactief invullen is mogelijk maar minder accuraat
• Notities negeren: Gedocumenteerde inzichten zijn goud waard bij toekomstige sessies
• Te snel doorheen chunks racen: Kwaliteit > kwantiteit - liever 3 chunks excellent dan 10 chunks mediocre

🧠 De kern: Waarom adaptief leren?

ModusPractica's kracht ligt in het gebruik van spaced repetition (gespreide herhaling) gebaseerd op de Ebbinghaus vergeetcurve. In plaats van willekeurig te herhalen of alles elke dag te oefenen, plant het systeem herhalingen op het optimale moment—net voordat u het dreigt te vergeten. Dit maximaliseert retentie terwijl het uw oefentijd minimaliseert.

De wiskundige formule

Waar:

• R(t) = Retentie (kans op succesvolle recall) na tijd t
• t = Tijd sinds laatste herhaling (in dagen)
• τ (tau) = Geheugen half-waardetijd—de tijd waarin retentie daalt naar ~37% (e^-1)
• e = Euler's getal (~2.718)

Het optimale herhalingsmoment

ModusPractica berekent uw volgende oefendatum met de inverse Ebbinghaus formule. De complete formule houdt rekening met de asymptotische baseline:

Waar:

• t = Optimale interval tot volgende herhaling (dagen)
• τ = Uw persoonlijke tau-parameter (zie verderop)
• R* = Gewenste retentie-drempel (target retention threshold)
• L₀ = Initial learning strength = 0.80 (80% direct na leren)
• B = Asymptotic retention baseline = 0.15 (15% blijft altijd over)
• ln = Natuurlijke logaritme

Basisberekening van tau

ModusPractica start met een wetenschappelijke baseline en past deze aan op basis van meerdere factoren:

1️⃣ Personalized Memory Calibration (PMC)

Wat het doet: Leert uw individuele geheugenpatronen door voorspellingen te vergelijken met werkelijke prestaties.

2️⃣ Memory Stability Manager (MSM)

Wat het doet: Traceert geheugen-stabiliteit en moeilijkheid per sectie gebaseerd op SuperMemo SM-17+ algoritmes.

3️⃣ Adaptive Tau Manager (ATM)

Wat het doet: Coördineert PMC en MSM data om een geïntegreerde, betrouwbare tau te berekenen.

💡 Wanneer moeilijkheidsgraad wijzigen?

• Difficult → Average: Wanneer u consistent "Good" evalueert en minimale streak resets heeft
• Average → Easy: Wanneer u 3+ sessies "Excellent" achter elkaar scoort
• Easy → Mastered: Pas in stage 5+ wanneer materiaal foutloos en automatisch is
• Mastered → Average: Als u merkt dat kwaliteit degradeert na lange intervallen

ℹ️ Planner: Tijdens het plannen per sessie gebruikt het systeem performance-afgeleide retentiedoelen (R*). De moeilijkheidsgebonden R* hierboven zijn beleidswaarden en vormen het algemene kader.

Stage progressie mechanisme

U vordert naar de volgende stage wanneer u uw Target Repetitions bereikt in een sessie. Dit gebeurt niet automatisch—alleen als u de target haalt!

💡 Pro tips voor stage management:

• Wees geduldig in Stage 0-2: De dagelijkse herhalingen zijn een investering. Spring niet over naar stage 3 zonder solide fundament!
• Verwacht regressie in Stage 3-4: Langere intervallen testen uw retentie. Gelegelijke "Fair" of "Good" evaluaties zijn normaal—het systeem leert hiervan.
• Verlaag target reps niet handmatig: Als u stage 5+ bereikt heeft, heeft u bewezen dat 6+ herhalingen haalbaar zijn. Houd dit aan voor sterke consolidatie.
• "Mastered" difficulty is niet voor iedereen: Gebruik het alleen voor chunks die u echt foutloos en moeiteloos beheerst in stage 5+.
• Stage reset bij major edits: Als u een chunk drastisch wijzigt (tempo verhogen met 40+ BPM, toevoegen van ornamentatie), overweeg dan om terug te gaan naar stage 0 met een nieuwe chunk naam.

⚠️ Veelvoorkomende misconcepties:

• Mythe: "Hogere stage = beter"
  Realiteit: Stage is slechts een indicator van consolidatie-voortgang. Een stage 3 chunk die u excellent beheerst is waardevoller dan een stage 8 chunk die degradeert.
• Mythe: "Ik moet elke dag alle chunks oefenen"
  Realiteit: ModusPractica is ontworpen om dit te VERMIJDEN. Vertrouw op de planning—chunks in stage 8 hoeven misschien maar 1× per maand.
• Mythe: "Als het interval lang is, vergeet ik het zeker"
  Realiteit: Het systeem past zich aan. Als u inderdaad vergeet (evaluatie: Poor/Fair), wordt het interval ingekort. Desirable difficulty is goed voor leren!
• Mythe: "Adaptieve systemen zijn te complex, ik stel alles handmatig in"
  Realiteit: De adaptieve systemen hebben 10+ sessies nodig om te convergeren. Geef ze de tijd—handmatige override vereist zeer diepgaande kennis van SRS algoritmes.

De adaptieve lus

1. U voegt een nieuwe chunk toe → Stage 0, τ = baseline (~9-11 dagen)
2. U oefent (Stage 0-2) → Dagelijkse herhalingen, systeem observeert uw performance
3. Stage 3 bereikt → Ebbinghaus planning activates, eerste interval ~2-3 dagen
4. U oefent de chunk na 3 dagen → Evaluatie: "Good"
   • PMC: "Performance was zoals verwacht" → τ blijft stabiel
   • MSM: Stability groeit 1.3× → S = 2.3d
   • ATM: Integreert data → τ = 11.5d
   • Volgend interval: ~3.5 dagen (R* = 0.80)
5. U oefent na 4 dagen (iets langer) → Evaluatie: "Excellent"
   • PMC: "Beter dan verwacht!" → τ verhogen met 5%
   • MSM: Stability groeit 1.3× → S = 3.0d
   • ATM: τ = 12.5d
   • Volgend interval: ~5 dagen (Excellent bonus × 1.8)
6. U oefent na 5 dagen → Evaluatie: "Fair" + 2 streak resets
   • PMC: "Slechter dan verwacht" → τ verlagen met 3%
   • MSM: Stability daalt door streaks → S = 2.6d, Difficulty stijgt
   • ATM: τ = 11.0d
   • Volgend interval: ~2.5 dagen (Fair penalty)
7. Cyclus herhaalt... → Gradueel convergeert τ naar uw werkelijke retentie-karakteristiek

🎓 Klaar voor de volgende stap?

Nu u begrijpt hoe het adaptieve systeem werkt, kunt u vol vertrouwen uw oefendata invoeren. Het systeem leert van elke sessie en optimaliseert zich automatisch voor uw unieke geheugen.

→ Verder naar Sectie 7: Intensiteitsmodule (Geavanceerd)

Belangrijk: De intensiteitsmodule beïnvloedt niet de planning (τ/interval). Ze geeft duur- en herhalingsaanbevelingen gebaseerd op uw Success Ratio en het Overlearning Quotum (OLQ). U kunt de module in- of uitschakelen in de instellingen.

• Initial Acquisition (0–40%): Veel fouten, steil leren
• Refinement (40–70%): Afnemende fouten, techniek stabiliseert
• Consolidation (70–85%): Weinig fouten, automatisering start
• Mastery (85–95%): Zeer weinig fouten, hoge consistentie
• Overlearning (95–100%): Foutloos, performance-ready

UI: In het sessiescherm verschijnt onder het OLQ‑doel een regel “Estimated Duration”. Wanneer er voldoende historische data is gebruikt de app uw geleerde gemiddelde tijd per correcte herhaling (robuuste schatting met outlier‑filter en trimming); anders valt ze terug op de fase‑defaults hierboven. De UI toont ook een eenvoudige range (±20%) en betrouwbaarheidsniveau (laag/medium/hoog) op basis van het aantal sessies waarover gekalibreerd werd.

Module aan/uit: Wanneer de module uit staat, gebruikt de app een vaste duur (standaard 15 minuten) en worden geen OLQ-instructies getoond. Wanneer de module aan staat, krijgt u een dynamische instructie met fase, target en geschatte tijd.

Archiveren van onwerkbare chunks

Als een sessie CR = 0 oplevert (geen enkele correcte herhaling), markeert de module de sectie als onwerkbaar voor deze sessie en adviseert ze archivering. Dit voorkomt verstoorde statistieken en focust u op haalbare delen.

💡 Hoe werkt de Retentie-check in de praktijk?

1. De app detecteert beheersing wanneer de vorige sessie evaluatie Good of Excellent was én de Stabiliteits-index hoog genoeg is.
2. In plaats van de standaard OLQ-target (bijv. 8 herhalingen), stelt de app het doelherhalingenaantal in op 3.
3. U speelt de passage 3× foutloos — de groene Retentie-check badge verdwijnt en de sessie is geslaagd.
4. Vindt u het toch moeizamer dan verwacht? Gebruik de + knop rechts van de teller om handmatig extra herhalingen toe te voegen. De app past het interval dan conservatiever aan.

⚠️ Wanneer verschijnt de Retentie-check niet? Als de app de vorige sessie als onvolledig, tegenvallend (evaluatie: Poor/Fair) of instabiel (lage Stabiliteits-index) beoordeelt, activeert de Retentie-check niet. U krijgt dan de normale OLQ-doelteller.

⚠️ Wanneer de Frustratie-beveiliging activeert:

• De app toont een pop-up die de neerwaartse spiraal signaleert.
• Ze biedt aan om het doelherhalingenaantal te verlagen voor deze sessie, zodat u een succeservaring kunt bereiken zonder uw focus en motivatie volledig te verliezen.
• U kunt dit aanbod accepteren of negeren — de keuze blijft bij u.

• De sessie te pauzeren en een korte mentale pauze in te lassen (2–5 minuten) zodat de consolidatie kan beginnen.
• Van stuk te wisselen en later op de dag of de volgende dag terug te komen — dit is de kern van Interleaving en levert tot 40% betere langetermijnretentie op dan doorbuffelen.
• Het Interleaved Lab te gebruiken voor een afgewisseld circuit als alternatief voor eenfocus-oefenen.

✅ Wetenschappelijke achtergrond: De 12-minuten grens is gebaseerd op onderzoek naar cognitieve vermoeidheid bij motorisch leren (Schmidt & Lee, 2011). Na circa 10–15 minuten intensief eenfocus-oefenen neemt de kwaliteit van nieuwe geheugenconsolidatie sterk af. Afwisseling en slaap zijn de echte motoren achter diepe leerconsolidatie.

📋 Samenvatting: Slimme Begeleiding in v3.0.1

Tip: De dagelijkse agenda is gebaseerd op uw individuele planning (Ebbinghaus/τ). Oefen eerst de items met een rode/oranje status (achterstallig of vandaag), en werk daarna aan groen/grijs (binnenkort/optioneel).

Waarom dit belangrijk is: Effectief oefenen gaat niet alleen over wat u speelt, maar ook over wanneer en in welke volgorde. Door de meest kwetsbare herinneringen als eerste te tonen, maximaliseert de app de retentie per eenheid oefentijd en zorgt het ervoor dat geen enkel deel van uw repertoire stilletjes achteruitgaat.

💡 Praktisch voordeel: Als u 45 minuten oefentijd heeft, toont de agenda nu een realistisch beeld van hoeveel chunks u echt kunt afwerken — gebaseerd op uw tempo en uw Opstarttijd, niet een statistisch gemiddelde. Dit maakt dagplanning aanzienlijk effectiever.

Grafieken gebruiken uw geregistreerde sessies (CR/FA, duur, tempo) uit de praktijkgeschiedenis. Onvolledige of zeer korte sessies kunnen worden uitgefilterd om vertekingen te vermijden.

Praktisch advies: Gebruik grafieken voor kwaliteitsbewaking (fouten dalen? stabiliteit stijgt?) en statistieken voor tijdbewaking (waar gaat uw oefentijd naartoe?). Zo stuurt u evidence-based bij.

Resultaat: u krijgt geen willekeurige lijst, maar een zorgvuldig uitgebalanceerd circuit dat maximaal leerrendement haalt uit precies de tijd die u hebt ingepland.

Mindset: zie een “zwaar” Lab‑circuit niet als straf, maar als de kortste weg naar meesterschap. Elke moeilijke overgang, elke onverwachte wissel en elke bewuste pauze is een signaal dat uw brein aan het herorganiseren is naar een hoger niveau van controle.

Wanneer gebruiken? Opwarming, experiment, techniekblokken buiten planning, of wanneer u iets wil bijhouden zonder het te schedulen.

Vooruitblik: Uitbreiding naar meerdere media‑referenties per stuk/sectie (audio, noten, externe links) staat op de roadmap.

📊 LocalStorage vs. IndexedDB op een rij

📍 Data is lokaal en browsergekoppeld

Ondanks de verbeterde techniek blijft uw data lokaal opgeslagen op dit apparaat, en specifiek gekoppeld aan de browser waarmee u ModusPractica gebruikt. Dit betekent:

• U kunt niet zomaar naar een andere browser op hetzelfde apparaat wisselen en dezelfde data zien
• Als u ModusPractica op een andere computer gebruikt, heeft u een geëxporteerd bestand nodig om uw voortgang mee te nemen
• Uw data staat niet automatisch in een cloud of op een extern server

🚨 Wanneer kan data verloren gaan?

• Browsergeschiedenis wissen inclusief "sitegegevens" of "cookies en gecachte bestanden" — dit kan de gehele IndexedDB-database verwijderen
• Apparaat formatteren of een nieuwe browser installeren zonder eerst data te exporteren
• Browser-instelling "bij afsluiten wissen" — als uw browser is ingesteld om data automatisch te verwijderen bij het afsluiten
• Privé- of incognitomodus — data opgeslagen in privémodus wordt verwijderd zodra u het venster sluit

🛡️ De gouden regel: exporteer regelmatig

De Export Data (JSON) functie — te vinden op het profielscherm — is uw enige 100% veilige manier om uw voortgang te bewaren. Een exportbestand is een gewoon tekstbestand dat u kunt bewaren op:

• Een USB-stick
• Cloud-opslag (Google Drive, Dropbox, OneDrive)
• Een externe harde schijf

Ons advies: maak er een vaste gewoonte van om na elke grote oefensessie een export te maken. Het kost u slechts een paar seconden en biedt volledige gemoedsrust — ook bij browser-updates, apparaatwissels of een onverwachte schoonmaakbeurt van de browser.

💡 Samengevat: Met IndexedDB is uw data technisch veiliger en omvangrijker dan ooit tevoren. Maar net als bij een professionele opname van uw repetities: de beste beveiliging bent uzelf. Exporteer regelmatig, bewaar uw backups op meerdere plaatsen, en uw jaren aan oefengeschiedenis zijn volledig beschermd.

De grondlegger van spaced repetition

Hermann Ebbinghaus ontdekte dat geheugenretentie exponentieel afneemt over tijd. Zijn baanbrekende onderzoek toonde aan dat strategisch getimede herhalingen de retentie-intervallen dramatisch kunnen verlengen terwijl hoge recall-percentages behouden blijven. De Ebbinghaus vergeetcurve vormt de kern van het ModusPractica algoritme:

waarbij R(t) de waarschijnlijkheid van retentie is na tijd t, en τ (tau) de geheugenvervaldconstante.

🎵 Kernonderzoek voor de Intensiteitsmodule

Dr. Molly Gebrian, auteur van "Learn Faster, Perform Better: A Musician's Guide to the Neuroscience of Practicing" (2024), is een vooraanstaand onderzoeker in muziekpedagogie en neurowetenschappen. Haar onderzoek heeft aangetoond dat gericht overlearning (oefenen voorbij initiële beheersing) essentieel is voor betrouwbare prestaties onder stress. Dit onderzoek vormt de basis voor het Overlearning Quotum (OLQ) systeem in ModusPractica.

Belangrijkste bevindingen:

• Minimale drempel: Minstens 6 correcte herhalingen zijn nodig om motorisch geheugen te consolideren
• Fase-specifieke targets: Het aantal benodigde herhalingen stijgt naargelang de leertrajectfase:
  • Beginfase (Initial Acquisition): 6-8 correcte herhalingen
  • Verfijningsfase (Refinement): 7-10 herhalingen
  • Consolidatiefase (Consolidation): 8-12 herhalingen
  • Beheersingsfase (Mastery): 9-14 herhalingen
  • Overlearning fase: 10-18 herhalingen
• Performance onder stress: Extra herhalingen voorbij het punt van eerste succes verhogen de betrouwbaarheid tijdens optredens of examens aanzienlijk
• Foutcorrectie principe: Het aantal extra herhalingen moet worden aangepast op basis van het aantal initiële fouten - meer vroege fouten vereisen meer overlearning herhalingen

Implementatie in ModusPractica:

Het OLQ-systeem combineert Dr. Gebrian's fase-specifieke baselines met een dynamische aanpassing gebaseerd op technische moeilijkheid:

Voorbeeld: In de Consolidation fase (FixedGoal = 8) met 4 initiële fouten, wordt de target: 8 + ceil(4 × 0.5) = 8 + 2 = 10 correcte herhalingen.

Belangrijk inzicht: Fouten maken tijdens het initiële leren—mits met corrigerende feedback—leidt tot superieure langetermijnretentie vergeleken met foutloos leren. Dit onderzoek heeft direct geleid tot het onderscheid in ModusPractica tussen:

• Failed Attempts (FA): Motorische uitvoeringsfouten die informatief zijn maar scheduling niet beïnvloeden
• Streak Resets (SR): Geheugenopslagfouten die wel leiden tot scheduling aanpassingen

Motorisch leren theorie: Schmidt & Lee's onderzoek naar motorische controle en leren onderscheidt drie fasen:

• Acquisitie: Hoge foutpercentages zijn normaal tijdens motorische exploratie
• Verfijning: Fouten nemen af naarmate bewegingspatronen stabiliseren
• Retentie: Fouten reflecteren voornamelijk geheugenverval, niet motorische exploratie

De drie fasen van motorisch leren: Fitts & Posner's klassieke model identificeert drie fundamentele fasen die ModusPractica gebruikt voor de TDS (Technical Difficulty Score) classificatie:

1. Cognitieve fase: Focus op begrip (komt overeen met Initial Acquisition in ModusPractica)
2. Associatieve fase: Verfijning van techniek (Refinement & Consolidation)
3. Autonome fase: Automatische uitvoering (Mastery & Overlearning)

Geavanceerde geheugen tracking: ModusPractica's Memory Stability Manager implementeert concepten van SuperMemo's SM-17 algoritme, dat het begrip van memory stability (S) introduceerde—een kwantitatieve maat voor hoe goed een geheugen geconsolideerd is.

S-waarde vertegenwoordigt het verwachte interval (in dagen) waarop retentiewaarschijnlijkheid zou dalen tot een kritische drempel (typisch 90%).

1. Ebbinghaus, H. (1885/1913). Memory: A contribution to experimental psychology. Teachers College, Columbia University.
2. Gebrian, M. (2024). Learn Faster, Perform Better: A Musician's Guide to the Neuroscience of Practicing. Oxford University Press.
3. Kornell, N., & Bjork, R. A. (2008). Learning concepts and categories: Is spacing the "enemy of induction"? Psychological Science, 19(6), 585-592.
4. Schmidt, R. A., & Lee, T. D. (2011). Motor control and learning: A behavioral emphasis (5th ed.). Human Kinetics.
5. Fitts, P. M., & Posner, M. I. (1967). Human performance. Brooks/Cole.
6. Wozniak, P. A., & Gorzelanczyk, E. J. (1994). Optimization of repetition spacing in the practice of learning. Acta Neurobiologiae Experimentalis, 54, 59-62.
7. Cepeda, N. J., Pashler, H., Vul, E., Wixted, J. T., & Rohrer, D. (2006). Distributed practice in verbal recall tasks: A review and quantitative synthesis. Psychological Bulletin, 132(3), 354-380.
8. Walker, M. P., Brakefield, T., Morgan, A., Hobson, J. A., & Stickgold, R. (2002). Practice with sleep makes perfect: Sleep-dependent motor skill learning. Neuron, 35(1), 205-211.
9. Roediger, H. L., & Karpicke, J. D. (2006). Test-enhanced learning: Taking memory tests improves long-term retention. Psychological Science, 17(3), 249-255.
10. Settles, B., & Meeder, B. (2016). A trainable spaced repetition model for language learning. Proceedings of the 54th Annual Meeting of the Association for Computational Linguistics, 1848-1858.

📄 Voor volledige wetenschappelijke details: Bekijk het uitgebreide wetenschappelijke paper "Adaptive Spaced Repetition for Motor Skill Acquisition in Music Practice" dat de volledige theoretische basis, algoritmes en validatie documenteert.