🏠 Overview › 🎯 Features ›🎯 Multi-Organization Hierarchy

Multi-Organization Hierarchy

Feature Detail

high complexity extracted Organization Management Confidence: 100%
12
Components
106
Shared
0
User Stories
Yes
Analyzed

Description

Multi-Organization Hierarchy enables the platform to model complex organizational structures where a top-level national organization (e.g., NHF) contains multiple sub-organizations such as regional branches and local associations, each with their own users, settings, and data. Administrators can define parent-child relationships between organizations, assign roles scoped to a specific level of the hierarchy, and view aggregated statistics and reports that roll up data from child organizations into parent-level dashboards. The hierarchy management page provides a tree view of the full organizational structure with drill-down navigation, inline editing of relationships, and the ability to move sub-organizations between parents. Access controls ensure that data remains tenant-isolated while allowing authorized administrators to view cross-organization aggregates.

User Flow

Multi-Organization Hierarchy user flow
Click to expand

Analysis

Business Value

NHF has the broadest organizational structure of all workshop participants — 12 national associations, 9 regions, and 1,400 local associations — and requires the platform to accurately reflect this hierarchy to prevent double-reporting and correctly attribute activities to the right organizational level. Without multi-organization hierarchy support, coordinators at the regional level cannot oversee local association data, and national administrators cannot generate consolidated Bufdir reports. This feature directly unblocks accurate Bufdir reporting, which is identified as a must-have across all four organizations. It also supports the member associations feature and the multi-tenancy commercial model, enabling Norse Digital Products to serve umbrella organizations and their member bodies under a single platform contract, which significantly increases the average contract value and reduces churn.

Implementation Notes

The hierarchy is modeled in PostgreSQL using a closure table pattern on the organizations table, enabling efficient ancestor/descendant queries without recursive CTEs. The API exposes endpoints for GET /api/v1/organizations/:id/hierarchy, POST for creating child organizations, and PATCH for moving nodes. The admin portal renders the hierarchy using a recursive React tree component with expand/collapse controls and drag-to-reorder (with keyboard fallback for WCAG 2.2 compliance). Row-level security policies are parameterized by the user's highest organization scope, resolved at query time via a JWT claim. Aggregate reports use materialized views refreshed nightly for performance. The Global Admin role bypasses organization scope restrictions for system-wide visibility, while Org Admins are limited to their own subtree. Database migrations include scripts to seed the initial hierarchy from existing organization data.

Components (118)

User Interface (4)

ui Hierarchy Management Page high ui Hierarchy Management Page high ui Organization Node Editor medium ui Organization Tree Widget high

Service Layer (3)

service Aggregate Report Service medium service Hierarchy Service high service Hierarchy Service high

Data Layer (3)

data Hierarchy Store high data Hierarchy Store high data Materialized View Refresher medium

Infrastructure (2)

infrastructure Closure Table Adapter high infrastructure Hierarchy Migration Seeder medium

Shared Components

These components are reused across multiple features

Service Layer (34)

service Auth API Client medium Shared service Password Policy Validator low Shared service Permission Validation Middleware high Shared service Activity Service medium Shared service Event API Client low Shared service Event Repository Service medium Shared service File Upload Service high Shared service Expense Type Service high Shared service Contact Service medium Shared service STT Service medium Shared service Keyboard Navigation Service medium Shared service Screen Reader Support Service high Shared service Screen Reader Support Service high Shared service Localization Service medium Shared service Localization Service medium Shared service Repository Data Source Router high Shared service Role Scope Resolver low Shared service Audit Log Service medium Shared service Audit Log Service medium Shared service Report Access Control Service medium Shared service Export Audit Logger low Shared service Report Export Service medium Shared service Report Export Service medium Shared service Terminology Context Provider medium Shared service Terminology Service medium Shared service Terminology Service medium Shared service Feature Registry Loader low Shared service Hierarchy Access Control Service high Shared service Hierarchy Scope Resolver medium Shared service Association Service medium Shared service Audit Log Service high Shared service DPA Content Provider low Shared service Cookie Consent Service medium Shared service Cookie Consent Service medium Shared

Data Layer (22)

data Token Store low Shared data Token Store low Shared data Secure Token Store medium Shared data Secure Token Store medium Shared data Activity Store low Shared data Event List Cache Store low Shared data Expense Type Store medium Shared data Contact Store low Shared data Contact Store low Shared data Notes Store low Shared data Assignment Count Store low Shared data Push Token Repository low Shared data Notification Audit Log Store low Shared data Push Token Store low Shared data Push Token Store low Shared data Organization Impact Settings Repository low Shared data Accessibility Preferences Store low Shared data Local SQLite Database high Shared data Sync Queue medium Shared data Report Store high Shared data Mobile Terminology Store medium Shared data Security Metrics Repository medium Shared

Infrastructure (38)

infrastructure Keychain/Keystore Adapter low Shared infrastructure JWT Claims Extractor low Shared infrastructure Organization Labels Adapter low Shared infrastructure Keychain/Keystore Adapter low Shared infrastructure Auth API Client medium Shared infrastructure REST API Client medium Shared infrastructure WCAG Accessibility Adapter low Shared infrastructure Registration API Client low Shared infrastructure Accounting API Client high Shared infrastructure PDF Renderer Adapter medium Shared infrastructure File Share Adapter low Shared infrastructure FCM/APNs Adapter high Shared infrastructure Share Sheet Adapter low Shared infrastructure Share Plus Adapter low Shared infrastructure Platform Accessibility Bridge medium Shared infrastructure Semantics Override Adapter high Shared infrastructure URL Launcher Adapter low Shared infrastructure Markdown Content Renderer low Shared infrastructure Network Connectivity Monitor low Shared infrastructure Expense Receipt Storage Adapter low Shared infrastructure Audit Log Writer low Shared infrastructure Feature Flag Checker low Shared infrastructure Logo Upload Adapter low Shared infrastructure Terminology Constants Registry low Shared infrastructure Feature Flag Cache Adapter low Shared infrastructure Org Scope JWT Resolver medium Shared infrastructure Association Audit Logger low Shared infrastructure Token Blocklist medium Shared infrastructure Analytics Tracker low Shared infrastructure SEO Metadata Config low Shared infrastructure Analytics Tracker low Shared infrastructure Analytics Tracker low Shared infrastructure Sales Analytics Tracker low Shared infrastructure Email Provider Adapter low Shared infrastructure Terms of Service Content Provider low Shared infrastructure Legal PDF Asset Provider low Shared infrastructure Consent-Gated Script Loader low Shared infrastructure Legal Page Layout low Shared

User Stories

No user stories have been generated for this feature yet.