docs.zenspace.io
    docs.zenspace.io
    • 🧭 Introduction
    • 🧱 System Components
    • 🧰 Tech Stack
    • 🏗️ System Architecture
    • 🌐 Deployment Architecture
    • 🗄️ Database Design Documentation
    • API Endpoints
      • RaspberryPi
        • Heartbeat API
        • Retrieve all active sensors and device permissions
        • Control a device (e.g., turn on/off, adjust intensity)
        • Enable or disable a device
        • Register a meeting space ID and retrieve network details
      • Meeting Space
        • Schedule meeting space state
        • Get meeting spaces by customer
        • Get meeting space state by ID
        • Get meeting space state by device ID
        • Disable meeting space state
        • Send meeting space state by meeting space ID
        • Store meeting space availability
        • Create Google Calendar
      • Device Management
        • Create device
        • Create device sensors
        • Create or update admin unlock codes
        • Upload meeting space screenshot
      • Authentication
        • Create authorization token
      • Messaging
        • Send message to Android device
      • Booking
        • Send meeting space state by booking ID
        • Create or update booking

    🧭 Introduction

    📌 Project Overview#

    Workspace Management is a smart, end-to-end platform designed to manage ZenSpace SmartPods — modern, IoT-enabled meeting and workspaces placed in public venues like malls, airports, hotels, and convention centers. These SmartPods are compact, soundproof units that can be booked on-demand by users seeking a quiet and private space to work or meet.
    The software system integrates a booking platform, IoT automation, and hardware management to ensure a seamless user experience while enabling venues to monetize otherwise underutilized spaces. From scheduling to automated lighting and fan control, and from real-time room displays to backend device coordination via Raspberry Pi and AWS Lambda, the Workspace Management platform ensures each pod operates independently, reliably, and securely.
    Whether the pod is located in a quiet corner of a hotel lobby or a bustling convention center, this platform makes it easy for users to book, use, and exit — while automating hygiene protocols, safety measures, and device management.

    🎯 Goals#

    Provide users with instant access to SmartPods via web or touch display.
    Offer venues a scalable and automated way to monetize idle space.
    Maintain high standards of hygiene, privacy, and user trust.
    Automate environmental controls (light, fan) to reduce energy waste.
    Enable remote monitoring, analytics, and support for multiple pods.

    ✅ Key Features#

    On-Demand Booking: Web and touchscreen portals allow real-time reservations.
    Device Automation: Lights, fans, locks, and sensors controlled via Raspberry Pi.
    External Room Display: Shows pod availability and admin interface.
    Internal Control Panel: Lets users manage pod settings during their session.
    Cloud-Connected: AWS Lambda and Supabase for scalable backend operations.
    Venue Revenue Tools: Enable subscriptions, hourly rates, and premium upgrades.
    Next
    🧱 System Components
    Built with