ZenSpace
    ZenSpace
    • ZenSpace Integration Documentation
    • ZenSpace General Architecture - Overview
    • ZenSpace API V1.0
      • Device Management
        • lock
          • Get Device Status
          • Subscribe to Device Events
          • Action on IoT Device
          • Get Device Control
        • camera
          • Get Device Status
          • Subscribe to Device Events
          • Action on IoT Device
          • Get Device Instruction
          • Get Device Control
        • light
          • Get Device Instruction
          • Get Device Status
          • Subscribe to Device Events
          • Action on IoT Device
          • Get Device Control
        • fan
          • Get Device Status
          • Subscribe to Device Events
          • Action on IoT Device
          • Get Device Instruction
          • Get Device Control
        • o3-sensor
          • temprature
            • Subscribe to Device Events Copy Copy
            • Get Device Status
          • buzzer
            • Get Device Status Copy
            • Action on IoT Device
          • occupancy
            • Get Device Status
          • ring-light
            • Action on IoT Device
            • Get Device Status
          • Get Device Instruction
          • Get Device Status
          • Subscribe to Device Events
          • Action on IoT Device
          • Get Device Control
        • meeting-room-display
          • Get Device Status
        • Get Device Instruction Copy
        • Fetch Associated Device Types
      • Bookings
        • Create, Update, or Cancel a Booking
        • Bulk Booking Operation
        • Check-in Operation
      • Meeting Space
        • Store Meeting Space Availability
        • Get the list of meeting spaces.
        • Get the state of a specific meeting space.
    • ZenSpace API V2.0
      • Device Management
        • lock
          • Get Device Control
          • Action on IoT Device
          • Subscribe to Device Events
          • Get Device Status
        • camera
          • Subscribe to Device Events
          • Get Device Control
          • Get Device Instruction
          • Action on IoT Device
          • Get Device Status
        • light
          • Get Device Status
          • Subscribe to Device Events
          • Get Device Instruction
          • Get Device Control
          • Action on IoT Device
        • fan
          • Get Device Instruction
          • Get Device Control
          • Action on IoT Device
          • Subscribe to Device Events
          • Get Device Status
        • o3-sensor
          • temprature
            • Get Device Status
            • Subscribe to Device Events Copy Copy
          • buzzer
            • Action on IoT Device
            • Get Device Status Copy
          • occupancy
            • Get Device Status
          • ring-light
            • Get Device Status
            • Action on IoT Device
          • Action on IoT Device
          • Get Device Control
          • Subscribe to Device Events
          • Get Device Status
          • Get Device Instruction
        • meeting-room-display
          • Get Device Status
        • Fetch Associated Device Types
        • Get Device Instruction Copy
      • Bookings
        • Check-in Operation
        • Bulk Booking Operation
        • Create, Update, or Cancel a Booking
      • Meeting Space
        • Get the state of a specific meeting space.
        • Get the list of meeting spaces.
        • Store Meeting Space Availability
    • ZenSpace Supported Devices
      • ZenSpace Device Integration

    ZenSpace General Architecture - Overview

    ZenSpace-general-architecture.drawio.png
    ZenSpace system is built with five core components:
    1. Automation IoT
    Tech Stack: ReactJS + Supabase
    Purpose:
    Super Admin can create customers.
    Each customer admin can:
    Create meeting spaces.
    Configure Smart Displays (Meeting Room Displays).
    Assign admin staff to manage each Smart Display.
    Details:
    Automation IoT panel communicates with ZenSpace APIs (Lambda functions).
    Manages device configurations like locks, lights, fans, and sensors.
    2. Booking Admin
    Tech Stack: ReactJS + Supabase
    Purpose:
    Super Admin can:
    Create customers.
    Add locations or groups under each customer.
    Customer Admin can:
    Create meeting spaces under locations.
    Manage pricing and availability for these spaces.
    Manage bookings.
    Map the created meeting space with Automation IoT meeting spaces using an authentication key (ZenSpace API Key).
    Sync availability with the Automation system.
    3. Booking Client
    Tech Stack: ReactJS + Supabase
    Purpose:
    This is the customer's end-user-facing application.
    Allows end users to view availability and book meeting spaces.
    4. Meeting Room Display / Smart Display App
    Platform: Android App
    Configured through: Automation IoT Panel
    Flow:
    Automation IoT calls ZenSpace APIs (Lambda functions).
    ZenSpace APIs trigger Firebase Notifications to Smart Displays.
    Smart Displays fetch updated states via ZenSpace REST APIs.
    Hardware Setup:
    Smart Display connects to an IoT Box.
    IoT Box uses UART Protocol to communicate with physical devices:
    Smart Lock
    Smart Light
    Smart Fan
    WiFi Access
    Temperature Sensor
    Camera
    Door Feedback Sensor
    Role:
    Acts as a gateway between ZenSpace APIs and physical IoT devices.
    5. ZenSpace APIs (Lambda Functions)
    Tech Stack: Python (AWS Lambda)
    Purpose:
    Manage meeting room states:
    Available Now
    Available At
    Reserved
    In-use
    Disabled
    Serve as a gateway between:
    Automation IoT Panel
    External Booking Systems
    Smart Displays or Meeting Room Display
    Important:
    ZenSpace API Key is used for authentication between the external booking app and automation IoT.
    Summary Flow
    Admins manage setup via Automation IoT and Booking Admin.
    End users book via the Booking Client.
    Smart Displays or Meeting Room Displays update in real-time through Firebase notifications and pull room states using ZenSpace REST APIs.
    IoT hardware is directly controlled through the Smart Display + IoT Box connected to ZenSpace APIs.
    Modified at 2025-04-27 03:06:21
    Previous
    ZenSpace Integration Documentation
    Next
    ZenSpace API V1.0
    Built with