Documentation Index
Fetch the complete documentation index at: https://altostrat.io/docs/llms.txt
Use this file to discover all available pages before exploring further.
What are Organization Hierarchies?
Organization hierarchies provide the structural foundation for modeling complex business relationships within workspaces. These flexible tree structures support everything from simple departmental layouts to sophisticated multi-tier partner networks with automatic resource management. Organization hierarchy capabilities:- Model complex business structures up to 10 levels deep
- Automatic usage aggregation from leaf to root organizations
- Cascading limit enforcement with inheritance
- Scalable from small teams to enterprise partner networks
- Real-time resource tracking and allocation
How Organization Hierarchies Work
Organization hierarchies create sophisticated tree structures with automatic resource management and limit enforcement: Hierarchy structure limits:- Maximum depth: 10 levels of nesting
- Maximum children: 100 direct children per organization
- Scalable design: Support for complex enterprise structures
- Usage aggregation: Resource consumption flows up from children to parents
- Limit inheritance: Limits cascade down with most restrictive taking precedence
- Real-time tracking: Instant visibility into resource consumption across levels
- Flexible allocation: Dynamic resource sharing within hierarchy boundaries
Usage Tracking: Automatic Resource Aggregation
Organization hierarchies provide sophisticated usage tracking with automatic aggregation for complete resource visibility at every level:How Usage Tracking Works
Every organization maintains dual usage metrics for comprehensive resource monitoring:- Direct Usage: Resources consumed directly by the organization (excluding children)
- Subtree Usage: Combined usage including the organization and all descendants
- Real-time visibility into resource consumption across all levels
- Accurate cost allocation and chargeback capabilities
- Automatic limit enforcement with hierarchical context
- Simplified reporting and capacity planning
Usage Aggregation Example
This example demonstrates how resource usage automatically aggregates up the hierarchy:- Engineering subtree usage (75): Direct usage (5) + children’s direct usage (30 + 40)
- Sales subtree usage (50): Direct usage (10) + children’s direct usage (15 + 25)
- Company HQ subtree usage (135): Direct usage (10) + children’s subtree usage (75 + 50)
Limit Enforcement: Hierarchical Resource Control
Organization hierarchies provide sophisticated limit enforcement using a “most restrictive wins” approach for precise resource control across complex structures.How Hierarchical Limits Work
Effective limits for any organization are determined by the most restrictive value from three sources:- Subscription capacity: Total resources available from billing account
- Organization-specific limits: Limits set directly on the organization
- Parent organization limits: All limits up the hierarchy chain
Limit Interpretation Rules
- No limit set (
null): Inherits from parent or subscription (allows free resource flow) - Limit set to
0: Explicit resource denial for organization and all descendants - Limit set to positive value: Enforced cap that cannot exceed parent or subscription limits
Limit Inheritance Example
This example shows how limits cascade through the hierarchy:- Team 1: Uses its explicit 30-user limit
- Team 2: Inherits 50-user limit from Division 1 parent
- Team 3: Requested 60 users but limited to 50 by Division 1 parent
- Team 4: Inherits 80-user limit from Root Organization
Real-World Organization Hierarchy Use Cases
Organization hierarchies support diverse business models and operational structures:Multi-Tier Reseller Network: Channel Partner Management
Perfect for software vendors managing complex channel partner relationships with automatic usage aggregation and limit enforcement throughout the partner ecosystem. Key benefits:- Automatic usage rollup from end customers to vendors
- Cascading limits from master distributors to resellers
- Real-time channel performance visibility
- Flexible resource allocation across partner tiers
Enterprise Department Structure: Corporate Hierarchy Management
Model sophisticated corporate structures with geographic and functional organization for enterprise resource allocation and compliance management. Use cases:- Regional resource allocation and budgeting
- Departmental cost center management
- Compliance boundary enforcement
- Global office and subsidiary management
Franchise Operations: Multi-Location Brand Management
Organize franchise networks with regional and district structures for comprehensive brand management while maintaining individual franchisee autonomy. Capabilities:- Regional and district-level organization
- Store-specific resource limits and tracking
- Franchise-wide performance visibility
- Automated usage aggregation for reporting
Organization Hierarchy Best Practices
Follow these proven practices for optimal hierarchy design and management:Hierarchy Design Principles
- Mirror business structure: Align organization names with actual business units and reporting relationships
- Optimize for simplicity: Use shallow hierarchies when possible for easier management and understanding
- Plan for evolution: Design with future reorganizations in mind as moves affect usage and limits
- Consider scale: Balance hierarchy depth with operational complexity
Operational Management
- Monitor usage patterns: Regular review of subtree usage for capacity planning and optimization
- Implement alerting: Proactive monitoring for organizations approaching resource limits
- Audit hierarchy structure: Periodic review of organization structure for optimization opportunities
- Document relationships: Maintain clear documentation of business logic behind hierarchy design
Technical Architecture and Performance
Organization hierarchies are built with enterprise-grade technical capabilities:Performance Optimization
- Atomic operations: All hierarchy updates use atomic transactions for data consistency
- Efficient queries: Path-based queries instead of recursive lookups for better performance
- Scalable design: Optimized for deep hierarchies and large organization counts
- Concurrent support: High-concurrency operations without performance degradation
Enterprise Features
- Complete audit trail: All modifications logged for compliance and debugging
- Real-time consistency: Immediate reflection of changes across all hierarchy levels
- Distributed locking: Prevents race conditions in high-traffic environments