Organization Selection & Onboarding - Likepersonsapp – Peer Mentor Activity Platform | Generated by Eircodex v3.0

Scope

medium complexity extracted Authentication & Access Control Confidence: 100%

4

Components

58

Shared

0

User Stories

Yes

Analyzed

Description

This feature presents users with an organization selection screen upon first launch, allowing them to choose from available organizations (NHF, Blindeforbundet, HLF, Barnekreftforeningen, etc.) before proceeding with authentication. The onboarding flow guides new users through initial setup steps including role confirmation and terminology familiarization specific to their organization. It ensures users are routed to the correct organizational context and that all subsequent data is scoped to the right tenant from the very first interaction.

User Flow

Organization Selection & Onboarding user flow

Click to expand

Analysis

Business Value

Multi-tenancy is a foundational requirement of the platform: each organization has its own labels, settings, and member data. Without organization selection, users cannot be correctly scoped, and data isolation breaks down entirely. The onboarding flow reduces drop-off for new users by contextualizing the app experience to their specific organization's terminology and workflow from the first screen. This directly improves adoption rates across all four partner organizations and ensures coordinators and peer mentors immediately feel at home rather than navigating a generic interface.

Implementation Notes

Implemented as a Flutter screen using BLoC for state management. The organization list is fetched from the REST API (/api/v1/organizations) and cached locally. Multi-tenancy context (organization ID, labels) is stored in Riverpod global state and injected into all subsequent API calls via request interceptors. The onboarding flow uses a step-based navigator with conditional routing depending on whether the user is new or returning. Deep links and stored preferences allow returning users to skip selection on subsequent launches.

Components (62)

User Interface (2)

ui Onboarding Flow Screen medium ui Organization Selection Screen medium

Service Layer (1)

service Organization Service medium

Data Layer (1)

data Organizations Repository low

Shared Components

These components are reused across multiple features

User Interface (16)

ui Accessible Picker Widget medium Shared ui Speech Input Widget medium Shared ui Contact Card Widget low Shared ui Contact Search Bar Widget low Shared ui View Switcher Widget low Shared ui Activity Summary Widget low Shared ui Approval Status Badge Widget low Shared ui Bottom Navigation Bar Widget low Shared ui Duplicate Warning Badge Widget low Shared ui Receipt Viewer Widget medium Shared ui Benefit Breakdown Chart Widget medium Shared ui AppButton Widget medium Shared ui AppTextField Widget medium Shared ui Modal Navigation Helpers medium Shared ui Page Header Widget low Shared ui Sync Status Indicator Widget low Shared

Service Layer (13)

service Auth Service medium Shared service Role Guard Service medium Shared service Activity Service medium Shared service Role Guard Service low Shared service Contact Service medium Shared service Email Invitation Service medium Shared service Oversight Audit Log Service medium Shared service Reimbursement Approval Audit Logger low Shared service Context Management Service medium Shared service Statistics Service medium Shared service REST API Client high Shared service Accessibility Service high Shared service Encryption Service high Shared

Data Layer (9)

data Token Storage low Shared data Auth Token Repository medium Shared data Activity Repository medium Shared data Contact Repository Cache low Shared data Contact Repository medium Shared data Reimbursement Admin Repository medium Shared data Organization Repository high Shared data Local Cache Repository medium Shared data Audit Log Repository medium Shared

Infrastructure (20)

infrastructure JWT Infrastructure medium Shared infrastructure JWT Infrastructure low Shared infrastructure Auth Middleware medium Shared infrastructure Report API Middleware low Shared infrastructure Report Access Guard low Shared infrastructure Approval Audit Logger low Shared infrastructure End-to-End Encryption Infrastructure high Shared infrastructure Email Delivery Infrastructure low Shared infrastructure Invitation Token Infrastructure medium Shared infrastructure Signed URL Provider low Shared infrastructure Multi-Tenancy Infrastructure high Shared infrastructure Calculator Export Infrastructure medium Shared infrastructure Request & Response Interceptors high Shared infrastructure Design Token System medium Shared infrastructure Semantic Labels Infrastructure medium Shared infrastructure Connectivity Infrastructure low Shared infrastructure Local Database Infrastructure high Shared infrastructure Secure Storage Infrastructure medium Shared infrastructure Connection Pool Infrastructure medium Shared infrastructure Database Migration Infrastructure medium Shared

User Stories

No user stories have been generated for this feature yet.