Location Hierarchy
VenueTrack organizes every physical space into a single navigable tree with up to seven levels.
Hierarchy Levels
| Level | Tier Name | Example |
|---|---|---|
| 0 | Organization Hub | "Acme Entertainment" |
| 1 | Building / Vessel | "MV Ocean Star" |
| 2 | Main Area / Venue | "Grand Theater" |
| 3 | Functional Room | "Theater Audio Rack Room" |
| 4 | Sub-Space / Closet | IDF closet |
| 5 | Storage Unit / Rack | Equipment rack |
| 6 | Specific Slot | Individual position |
How It Works
A single Location model uses a self-referencing parent_id with a hierarchy_level (0–6). Each location has a LocationType constrained by min_level / max_level, so users cannot nest a Building inside a Closet. The tree is navigated via an expandable index with child counts for assets, racks, and sub-locations at each node.
Who It's For
Venue managers and AV teams modeling complex multi-building or multi-vessel campuses with deeply nested physical spaces.
UX Details
- Expandable tree browser with inline asset, rack, and sub-location counts at every node.
- Auto-constrained child types — creating a child location automatically limits available types by hierarchy level.
- Billing-aware — creating Level 1 locations (buildings/vessels) is blocked when the organization exceeds its subscription quota.