high complexity MVP extracted Organization Management Confidence: 100%
3
Components
43
Shared
0
User Stories
Yes
Analyzed

Description

Multi-Organization Hierarchy enables the platform to model the nested organizational structures of partner organizations, particularly NHF with 12 national associations, 9 regions, and 1,400 local chapters. Admin tooling allows defining parent-child relationships between organizational units, assigning users to the correct hierarchy level, and routing activity data and reporting through the right organizational layer for accurate Bufdir compliance and aggregated statistics.

Sources & reasoning

NHF's documented structure (12 associations, 9 regions, 1,400 chapters) makes a hierarchy model mandatory, not optional. The source explicitly states that activity distribution between organizational levels must be supported and links multi-chapter membership directly to double-reporting risk. Blueprint annotates this as MVP; Phase 1 admin scope confirms it.

No source references — this artifact was included based on reasoning alone (see above).

Analysis

Business Value

NHF's organizational structure - 1,400 local chapters - cannot be represented with a flat user model. Without hierarchy support, activities registered under NHF cannot be correctly attributed to the right chapter, region, or national association, making Bufdir reports inaccurate and risking funding compliance. The feature also directly addresses duplicate registration: multiple coordinators across chapters may register the same activity, and hierarchy-aware data structures enable the platform to detect and flag such duplicates before they corrupt reported figures. This is a Phase 1 MUST because incorrect data at MVP launch would undermine trust in the entire platform across all four organizations.

Implementation Notes

Hierarchy is modeled in the organization_hierarchy_nodes table as an adjacency list with a self-referential parent_id. The admin UI exposes a tree view for managing nodes and assigning users to the correct level. API queries are hierarchy-aware: filtering activities, contacts, and reports by organizational subtree requires recursive CTE queries in Postgres. User membership across multiple local chapters (up to 5 per NHF member) is supported via the user_organization_roles join table with a composite key. Access control rules must respect hierarchy depth - a regional coordinator sees their region's chapters but not others. Circular reference prevention is required in node creation logic.

Components (46)

User Interface (1)

Service Layer (1)

Data Layer (1)

Shared Components

These components are reused across multiple features

User Stories

No user stories have been generated for this feature yet.