Skip to main content

Glossary

TermDefinition
AdapterA bridge service that translates between SpaceOS and a physical IoT device (lock, Wi-Fi AP, fan, etc.). One adapter = one device.
API KeyA secret token (x-api-key) used for system-level, machine-to-machine authentication between services.
BookingA reservation for a meeting space during a specific time window, with lifecycle states from pending to completed.
BullMQThe Redis-based job queue library used by the Scheduler service for delayed jobs and state transitions.
Business HoursOperating hours defined per meeting space that control when bookings can be made.
Capability DiscoveryThe process by which SpaceOS queries an adapter's /capabilities endpoint to learn what the device supports.
Criticality TierA classification (CRITICAL, STANDARD, OPTIONAL) that determines how device failures affect booking access.
Dynamic PricingRules that adjust meeting space pricing based on time of day, day of week, or demand.
IoT AdapterThe on-premise gateway service (zs-iot) running on Raspberry Pi that manages local devices.
JWTJSON Web Token used for user authentication after OTP verification.
Magic LinkA time-bound authentication URL sent to booking organizers that grants device access.
Meeting Room Display (MRD)A dedicated screen (web app or Android kiosk) mounted outside a room showing real-time status.
Meeting SpaceA virtual, bookable unit in ZenCore (room, desk, pod) with pricing and availability rules.
Multi-TenantArchitecture where each organization's data is isolated from other organizations.
Org API KeyAn organization-scoped API key (x-org-api-key) with permission-based access control.
OrganizationThe top-level tenant entity. All spaces, users, and bookings belong to an organization.
OTPOne-Time Password sent via email/phone for user authentication.
Physical SpaceA real-world room or pod managed by ZenEdge, linked to a virtual Meeting Space via mapping.
Physical Space MappingThe link between a ZenCore virtual meeting space and a ZenEdge physical space.
SchedulerThe zs-bullmq service that manages time-based state transitions and job scheduling.
Space GroupA logical grouping of meeting spaces (e.g., a building floor) with shared timezone and address.
TailscaleVPN mesh network used to securely connect on-premise IoT Adapters to the cloud platform.
VoucherA discount code that can be applied to bookings for reduced or free pricing.
WebhookAn HTTP callback that SpaceOS sends to external systems when events occur (booking created, status changed, etc.).
ZenCoreThe main API platform (zs-backend) handling auth, organizations, bookings, payments.
ZenEdgeThe device/edge bridge service (zs-mrd-backend) handling physical spaces, devices, and adapters.