Onboarding-track: zelf-gepacete 5-daagse thema-introductie vanuit de "New here?"-kaart #30

New Issue

2026-07-13T06:55:13Z

rve commented

2026-07-13 06:55:13 +00:00

Doel

Een zelf-gepacete onboarding-track van 5 dagen op thema-niveau, aangeboden als optie in de bestaande "New here?"-kaart op het Dashboard. Nieuwe medewerkers worden zo in de breedte (niet in de diepte) kennis gemaakt met alle thema's, zodat ze na ~5 dagen de algemene dagelijkse/wekelijkse werkprocessen van Respellion begrijpen en een eerste opdracht kunnen oppakken.

Productbeslissingen (met de owner afgestemd)

Altijd beschikbaar voor elke ingelogde gebruiker (ook als opfrisser voor bestaande medewerkers); niet gekoppeld aan de enrollment-gate of curriculum_started_at.
Pacing: 5 "dag"-slots als richtlijn, thema's verdeeld; volledig zelf-gepaced (sneller mag). Geen kalender-/volgorde-vergrendeling.
Afronding: duidelijk "onboarding voltooid"-scherm + voortgang zichtbaar in de "New here?"-kaart (bv. 3/5 dagen). Geen leaderboard-punten, geen afsluitende quiz.

Aanpak

Thema = de trackbare eenheid; "dag" = presentatie-groepering die bij het lezen wordt berekend (herindeling verliest nooit voortgang).
Lazy, gecachte, lichte AI-content: nieuwe fast-tier LLM-tool emit_onboarding_overview produceert per thema een kort overzicht (wat het is / waarom het ertoe doet voor dagelijks/wekelijks werk / kernpunten / welke topics), gegenereerd bij eerste opening en gecached met een topics-fingerprint voor hergeneratie.
Entry alleen op het Dashboard ("New here?"-kaart: CTA + voortgangschip) + nieuwe route /onboarding-track die los staat van de enrollment-gate (bestaande, ongebruikte skipEnrollmentGate-prop).
Twee nieuwe PocketBase-collections (onboarding_overviews, onboarding_completions) volgens de post-#18/#27-conventies (TEXT team_member_id, expliciete auth-rules).

Acceptatiecriteria

Ingelogde gebruiker ziet CTA + voortgangschip (X/5 dagen of "voltooid") in de "New here?"-kaart.
/onboarding-track bereikbaar ongeacht enrollment_status.
Alle KB-thema's, geordend op de actieve curriculum-schedule, gegroepeerd in ≤5 dag-slots; per thema een breedte-overzicht.
Thema afvinken persisteert (overleeft reload) en verhoogt de Dashboard-voortgang; alles klaar → afrondingsscherm + chip "voltooid".
Content lazy gegenereerd, gecached, hergegenereerd bij gewijzigde topic-set (fingerprint-mismatch).
Leeg KB (0 thema's) → vriendelijke lege staat, chip verborgen; <5 thema's → min(5, N) dag-slots.
Geen punten, geen quiz. Pure helpers unit-getest; npm run test/lint/build groen.

Levering

Branch feat/onboarding-track, PR met Closes #<dit issue>, groene pipeline.

## Doel Een **zelf-gepacete onboarding-track van 5 dagen** op thema-niveau, aangeboden als optie in de bestaande **"New here?"**-kaart op het Dashboard. Nieuwe medewerkers worden zo *in de breedte* (niet in de diepte) kennis gemaakt met **alle** thema's, zodat ze na ~5 dagen de algemene dagelijkse/wekelijkse werkprocessen van Respellion begrijpen en een eerste opdracht kunnen oppakken. ## Productbeslissingen (met de owner afgestemd) - **Altijd beschikbaar** voor elke ingelogde gebruiker (ook als opfrisser voor bestaande medewerkers); **niet** gekoppeld aan de enrollment-gate of `curriculum_started_at`. - **Pacing:** 5 "dag"-slots als richtlijn, thema's verdeeld; volledig zelf-gepaced (sneller mag). Geen kalender-/volgorde-vergrendeling. - **Afronding:** duidelijk "onboarding voltooid"-scherm + voortgang zichtbaar in de "New here?"-kaart (bv. `3/5 dagen`). **Geen** leaderboard-punten, **geen** afsluitende quiz. ## Aanpak - **Thema = de trackbare eenheid; "dag" = presentatie-groepering** die bij het lezen wordt berekend (herindeling verliest nooit voortgang). - **Lazy, gecachte, lichte AI-content**: nieuwe fast-tier LLM-tool `emit_onboarding_overview` produceert per thema een kort overzicht (wat het is / waarom het ertoe doet voor dagelijks/wekelijks werk / kernpunten / welke topics), gegenereerd bij eerste opening en gecached met een topics-fingerprint voor hergeneratie. - **Entry** alleen op het Dashboard ("New here?"-kaart: CTA + voortgangschip) + nieuwe route `/onboarding-track` die los staat van de enrollment-gate (bestaande, ongebruikte `skipEnrollmentGate`-prop). - Twee nieuwe PocketBase-collections (`onboarding_overviews`, `onboarding_completions`) volgens de post-#18/#27-conventies (TEXT `team_member_id`, expliciete auth-rules). ## Acceptatiecriteria 1. Ingelogde gebruiker ziet CTA + voortgangschip (`X/5 dagen` of "voltooid") in de "New here?"-kaart. 2. `/onboarding-track` bereikbaar ongeacht `enrollment_status`. 3. Alle KB-thema's, geordend op de actieve curriculum-schedule, gegroepeerd in ≤5 dag-slots; per thema een breedte-overzicht. 4. Thema afvinken persisteert (overleeft reload) en verhoogt de Dashboard-voortgang; alles klaar → afrondingsscherm + chip "voltooid". 5. Content lazy gegenereerd, gecached, hergegenereerd bij gewijzigde topic-set (fingerprint-mismatch). 6. Leeg KB (0 thema's) → vriendelijke lege staat, chip verborgen; `<5` thema's → `min(5, N)` dag-slots. 7. Geen punten, geen quiz. Pure helpers unit-getest; `npm run test`/`lint`/`build` groen. ## Levering Branch `feat/onboarding-track`, PR met `Closes #<dit issue>`, groene pipeline.

rve referenced this issue from a commit

2026-07-13 07:08:51 +00:00

feat: 5-day theme-level onboarding track from the "New here?" card (#30)

rve referenced a pull request that will close this issue

2026-07-13 07:09:25 +00:00

Onboarding-track: 5-daagse thema-introductie vanuit de "New here?"-kaart (#30) #31

rve closed this issue

2026-07-13 07:20:01 +00:00

rve referenced this issue from a commit

2026-07-13 07:20:01 +00:00

Merge pull request 'Onboarding-track: 5-daagse thema-introductie vanuit de "New here?"-kaart (#30)' (#31) from feat/onboarding-track into main

Sign in to join this conversation.