Switch Active Organization Context in the Admin Session

Administrators — particularly Global Administrators who oversee multiple organizations — need a frictionless mechanism to switch organizational context without session interruption. The Multi-Org Profile Widget provides a persistent, always-visible dropdown in the app shell header showing the active organization. Switching context updates the BLoC state, persists the selection to secure local storage, and ensures that all subsequent screens, queries, and actions are scoped to the newly selected organization. The widget must clearly display the currently active organization at all times to prevent accidental actions under the wrong context.

CRITICAL story-multi-org-membership-handling-organization-administrator-002 5 pts

Story Points

Critical

Priority

Multi-Organization Membership Handling

Feature

User Story

As a administrator

I want to switch the active organization context from the persistent profile widget in the app header so that subsequent actions, reports, and data views are scoped to the selected organization

So that So that I can work within any organization's data context without needing to log out and log back in, and so that every administrative action I take is unambiguously attributed to the correct organization

Acceptance Criteria

Given an administrator with access to multiple organizations, when they tap the Multi-Org Profile Widget, then a dropdown lists all accessible organizations with the currently active one marked
Given an administrator selects a different organization from the dropdown, when the selection is confirmed, then the active context updates immediately across all open screens and the widget reflects the new organization name
Given an administrator switches organization context, when they navigate to activity, report, or member screens, then all displayed data is scoped exclusively to the newly selected organization
Given the app is closed and reopened, when the administrator returns, then the previously selected organization context is restored from secure local storage without requiring re-selection
Given an administrator with only one organization affiliation, when they view the Multi-Org Profile Widget, then the dropdown is disabled or hidden and only the single organization name is displayed

Business Value

Context ambiguity is the root cause of double-reporting errors. A persistent, always-visible organization context indicator with effortless switching ensures administrators never accidentally submit reports or approve activities under the wrong organization — directly protecting Bufdir funding accuracy and organizational trust.

Components

Multi-Organization Membership Handling

Related Feature

Organization Administrator

User Role