rve/learning-platform
1
0
Fork 0
Code Issues Pull Requests Actions Packages Projects Releases Wiki Activity

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

New Issue
Closed
opened 2026-07-13 06:55:13 +00:00 by rve · 0 comments
rve commented 2026-07-13 06:55:13 +00:00
Owner
Copy Link

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.

## 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 closed this issue 2026-07-13 07:20:01 +00:00
Sign in to join this conversation.
No Branch/Tag Specified
Branches Tags
Labels
No items
No Label
Milestone
No items
No Milestone
Projects
Clear projects
No project
Assignees
Clear assignees
eho lmi lpr not rdi rve
No Assignees
1 Participants
Notifications
Due Date
No due date set.
Dependencies

No dependencies set.

Reference: rve/learning-platform#30
Delete Branch "%!s()"

Deleting a branch is permanent. Although the deleted branch may continue to exist for a short time before it actually gets removed, it CANNOT be undone in most cases. Continue?