Data Layer medium complexity backend
0
Dependencies
0
Dependents
1
Entities
0
Integrations

Description

Persistence layer for organizational nodes and their parent-child relationships. Stores node metadata and supports efficient subtree and ancestor lookups for scoping and aggregation.

Feature: Multi-Organization Hierarchy

org-hierarchy-store

Sources & reasoning

Required by NHF's stated structure (§69) and listed as an Admin Portal core capability (§143). Placed in Core Product because the MVP admin scope (§244-247) lists user management and org settings but not hierarchy, and NHF is the org most needing it after MVP launch.

Responsibilities

  • Persist organizational nodes and their attributes
  • Maintain parent-child edges between nodes
  • Provide efficient subtree and ancestor traversal queries
  • Enforce referential integrity for node assignments
  • Support transactional moves of subtrees

Interfaces

insertNode(node): NodeId
updateParent(nodeId, parentId): void
fetchSubtree(nodeId): OrgNode[]
fetchAncestors(nodeId): OrgNode[]

Related Data Entities (1)

Data entities managed by this component