ZenEdge
ZenEdge (zs-mrd-backend) is the device and edge bridge for SpaceOS. It connects the virtual booking world (ZenCore) to the physical device world (IoT Adapter).
What ZenEdge Owns
| Domain | Description |
|---|---|
| Physical Spaces | Real-world rooms with device attachments |
| Adapters | IoT device bridges (locks, Wi-Fi, fans, lights) |
| Device Management | Registration, health monitoring, capability discovery |
| Magic Links | Time-bound auth links for booking access |
| Meeting Room Displays | Display provisioning and pairing |
| Webhooks | Device event forwarding |
Tech Stack
- Runtime: Node.js + TypeScript
- Framework: NestJS
- Database: PostgreSQL via TypeORM
- API Base:
https://api-zenedge.zenspace.io
Key Modules
| Module | Responsibility |
|---|---|
adapter | Adapter protocol implementation and management |
physical-space | Physical space CRUD and device mapping |
device | Device registration and health monitoring |
display | Meeting room display management |
magic-link | Time-bound access link generation |
iot-device | IoT device management |
iot-gateway | Gateway registration and status |
webhook | Event forwarding and logging |
auth | API key and display token authentication |
storage | File storage for screenshots and assets |
Authentication
| Method | Use Case |
|---|---|
x-api-key | System integration (ZenCore → ZenEdge) |
x-org-api-key | Organization-scoped external access |
| Display JWT | Meeting room display authentication |
| Magic Link Token | Time-bound booking access |
Next Steps
- Physical Spaces — Managing physical locations
- Device Management — IoT device lifecycle
- Magic Links — Booking access links