Kennisbank/Aan de slag/De onboarding tour en het headerkompas
01Aan de slag4 min lezen

De onboarding tour en het headerkompas

Hoe een nieuwe tenant van "waar klik ik eerst?" naar "ik weet waarvoor elke module dient" gaat zonder Loom-video - en waarom het kompaspictogram in de header blijft.

Nieuwe tenants hebben een duidelijke eerste run nodig, geen gokspel waarin ze overal klikken tot er iets gebeurt. De onboarding tour geeft die begeleide start: waar het dashboard zit, waarvoor elke module dient en welke zones bij hun rol horen.

De hub tour

Bij de eerste sign-in toont het platform automatisch een tour van het home dashboard: de role-tuned widgets die de tenant ziet, de modules in de sidebar, het user menu en de notification bell. De tour kan bij elke stap worden gesloten en verschijnt automatisch maar een keer - een tenant die er op dag een doorheen klikte, ziet hem op dag drie niet opnieuw. De hub tour eindigt met een vraag: "wil je een diepere tour van een module?"

Negen moduletours

Ja zeggen tegen een moduletour brengt de gebruiker in een begeleide wandeling door die module. Er worden er negen meegeleverd: Core (receiving, grading, erasure), Market (verified listings, deal rooms), Auction (een lot publiceren, volgen, bieden), Escrow (deposit, ship-guard, release), Trade-In (de customer flow en operatorzijde), Sourcing (bieden op requests), Compliance (certs, evidence packages, audit trail), Admin (users, settings, de toolbox), Settings (de configuratiepagina’s en waar elke pagina geldt). Elke tour is onafhankelijk - de user kiest welke tours hij neemt en in welke volgorde.

Het headerkompas

Een pictogram in de header - een klein kompas - is de resume-knop. Klikken opent de tourcatalogus en toont welke tours gedaan zijn, welke gedeeltelijk zijn en welke nog niet gestart zijn. Een user die na drie maanden beseft dat hij Auction nooit gebruikt heeft, kan de Auction tour via het kompas kiezen in plaats van te moeten onthouden waar de tour stond. Het kompas is rustig - het knippert niet, pulseert niet en vraagt geen aandacht. Het is een knop die wacht.

Hoe de tours werken

De tours gebruiken driver.js voor de highlight overlays en stapnavigatie. Elke stap pint op een echt DOM-element met een stabiele selector - wanneer de onderliggende UI verandert, wordt de tourcontent mee bijgewerkt (een hernoemde knop betekent dat zowel de selector als de copy verandert). Stappen zijn kort: 1-3 zinnen, een screenshot aan UI, een knop om verder te gaan. Een volledige moduletour telt gemiddeld 6-10 stappen.

Sluiten en hervatten

Een tour kan bij elke stap onderbroken worden. Esc indrukken, buiten de tour klikken of Skip gebruiken sluit de tour af met opgeslagen voortgang. Terugkeren via het kompas gaat verder waar de user stopte, of begint opnieuw vanaf boven. Meerdere tours kunnen tegelijk in-progress zijn (Trade-In gestart, gepauzeerd, Auction gestart); het kompas toont beide met hun voortgang.

Waarom on-screen in plaats van video

Omdat een Loom-video pauzeert op een ander scherm dan dat van de user. De on-screen tour pint op de echte UI van de user: de echte data van de tenant, de role-tuned widgets, de taalvoorkeur. Een nieuwe operations lead hoeft de video niet naar zijn scherm te vertalen - de tour staat al op zijn scherm.