Organisation Hierarchy Resolver

As a shared component used across multiple features, the Organisation Hierarchy Resolver carries above-average schedule risk: any defect discovered late in testing will affect all export flows simultaneously. It should be prioritised early in the sprint plan and given dedicated integration testing against a representative sample of NHF's actual organisational structure, including edge cases such as chapters with multiple region affiliations or recently migrated entities. The validateUserScopeAccess interface adds a security testing obligation. Plan for coordination with the data team to confirm that the organisation, region, and local-chapter tables are fully populated and correctly structured before end-to-end testing begins.

The Organisation Hierarchy Resolver is a shared backend service that traverses NHF's three-tier organisational tree (national → region → chapter) to expand a single scope ID into the full set of constituent entity IDs required for export queries. It consumes the organisation, region, and local-chapter data models and exposes resolveScopeEntities as the primary interface, plus helper methods for targeted traversal (getChildChapters, getRegionChapters) and access control (validateUserScopeAccess). Because it is shared across export features, implement it as a stateless service with recursive or iterative tree traversal; consider caching resolved scope sets with short TTLs since the hierarchy changes infrequently. The getScopeDisplayName interface supports UI label rendering without duplicating hierarchy logic in frontend code.