12. Onboarding relatie-uitnodigingen
12.1 Scherm meta data
| Veld | Waarde |
|---|---|
| Scherm-ID | SCH-GEN-12-01 |
| Schermnaam | Onboarding relatie-uitnodigingen |
| Doelgroep / onderdeel | Nieuwe ingelogde gebruikers met geclaimde externe relatie-uitnodigingen |
| Route / URL-patroon | /onboarding/relationships met POST-acties onder /onboarding/relationships/invitations/{invitationId}/decision |
| Autorisatie / vereiste context | Ingelogde gebruiker met lege OnboardingCompletedAtUtc, ten minste één rol en compatibele geclaimde pending relatie-uitnodigingen. |
| Primair domeinobject | RelationshipInvitations, RelationshipEvents, UserRelationships, Users |
| Documentatiestatus | Functioneel contract en eerste technische schermbasis voor Feature 11 Batch 3B.1; visuele finetuning/mockup kan later nog volgen. |
12.2 Doel
Dit scherm dwingt nieuwe gebruikers om geclaimde relatie-uitnodigingen expliciet te accepteren of te weigeren voordat zij de normale OefenHub-applicatie bereiken. Het scherm is onderdeel van de eerste onboarding en niet de algemene mailbox.
12.3 Inhoud
Het scherm toont minimaal:
- persoonlijke, begrijpelijke uitleg waarom de gebruiker dit scherm ziet;
- per uitnodiging: uitnodiger, aangemaakt/verzonden op en een centrale relatietype-toelichting die uitlegt wat de relatie mogelijk maakt;
- compact herhaalbaar kaart-/lijstpatroon zodat meerdere uitnodigingen achter elkaar beoordeeld kunnen worden;
- actie
Accepteren; - actie
Weigeren; - veilige foutmelding wanneer de uitnodiging tijdens verwerking niet meer geldig is.
De tekst blijft gebruikersgericht. Vermijd afstandelijke of technische formuleringen zoals alleen verwijzen naar “dit e-mailadres”.
12.4 Navigatie en shell
Tijdens dit scherm blijven profielmenu, berichtenicoon en reguliere navigatie verborgen, vergelijkbaar met de rolkeuzeflow. De shell mag wel een losse Uitloggen-actie tonen als veilige escape. De greeting volgt centraal de first-visit-sessiecontext: tijdens de eerste bezoekdag blijft dit Welkom <voornaam>, ook na afronden van een onboardingstap; op latere dagen wordt dit Welkom terug, <voornaam>. Refresh of opnieuw inloggen stuurt terug naar dit scherm zolang verplichte beslissingen openstaan.
12.5 Buiten scope
- Volledige mailbox.
- Vrije berichtcomposer.
- Relatie ontkoppelen na acceptatie.
- Niveauautorisaties.
12.6 Visuele uitwerking
De eerste technische schermbasis gebruikt een rustige onboardingkaart binnen de bestaande shell-afspraken. Verdere visuele finetuning kan later volgen wanneer er meer echte uitnodigingsscenario's beschikbaar zijn. Richting:
- rustige onboardingkaart op de centrale achtergrond;
- duidelijke, compacte lijst met uitnodigingskaarten die ook bij meerdere open uitnodigingen hanteerbaar blijft;
- geen losse relatietypekop boven de kaart; de relatietype-uitleg staat in één compacte zin onder de uitnodiger;
- de ontvangstdatum staat compact in het actieblok onder de knoppen;
- primaire actie voor accepteren;
- secundaire actie voor weigeren die visueel aansluit bij accepteren, maar niet dezelfde nadruk krijgt;
- uitleg over acceptatie/weigering onder de lijst, zodat de bovenkant persoonlijk en rustig blijft; deze uitleg benoemt dat accepteren de relatie direct actief maakt, weigeren alleen deze uitnodiging sluit en beide keuzes worden teruggekoppeld aan de uitnodiger;
- geen technische maildeliverydetails op dit scherm.