The hierarchy
Everything addresses the same path: organization → site → equipment group → equipment → point. It is also the unified namespace a historian tag is mapped into, so AHU1.SAT from a vendor system becomes a supply air temperature on a named air handler in a named building.
| Level | Carries | Example |
|---|---|---|
| Organization | Name, slug, plan, feature entitlements, users | Galway Medical |
| Site | Location and coordinates, floor area, utility records, status | Vascular Plant, Galway |
| Equipment group | An area or system: press shop, cleanroom, plant room | Production cells |
| Equipment | Type, criticality, manufacturer and model, its points | Cleanroom CR-1 (type cleanroom) |
| Point | Name, unit, sensor type, value kind (numeric, boolean, enum), nominal range, current value, last seen | Room Differential Pressure, pascal |
Readings
A reading is one canonical record whatever produced it: device id, timestamp in epoch milliseconds, measure name, value, unit and a quality flag. Boolean points read On or Off. History is served per point over a lookback in hours.
Ids
Real records carry ids generated by the backend. Everything a reference pack owns carries an id beginning sim-, which is how every service tells synthetic data from live data and keeps the two from being merged.
Equipment types
The type catalogue covers HVAC equipment, sensors and controls, and meters, plus one section per industry from the packs: presses, compressors, cleanrooms, sterilisers, turbines, halls, theatres, autoclaves and the rest. A rule scoped by type matches on these values.