DeskUp

Distributed Desk Management System with Embedded Elements

DeskUp is a comprehensive desk management platform developed as a semester project for Distributed Software Systems. It combines web technologies, embedded systems, and intelligent scheduling to create a complete smart office solution.

📋 Overview

DeskUp manages standing desks with smart height adjustment capabilities, user session tracking, automated cleaning schedules, and ergonomic optimization through computer vision. The system integrates multiple components:

• Web Application (Laravel + Tailwind CSS)
• Desk Simulator (Python REST API)
• Embedded Controller (Raspberry Pi Pico W)
• AI Height Analyzer (Python + MediaPipe)

🏗️ Architecture

┌─────────────────────────────────────────────────────────────┐
│ DeskUp System │
├──────────────┬──────────────┬──────────────┬────────────────┤
│ Laravel Web │ Python AI │ Wifi2Ble │ Raspberry Pi │
│ Application │ Service │ Simulator │ Pico W │
│ (Port 80) │ (Port 5000) │ (Port 8443) │ (Embedded) │
└──────────────┴──────────────┴──────────────┴────────────────┘

✨ Features

Web Application

• User Management: Authentication, profiles, and session tracking
• Desk Control: Real-time desk height adjustment and monitoring
• Smart Scheduling: Automated recurring cleaning schedules
• 3D Layout View: Interactive office layout visualization using Three.js
• Health Statistics: User activity tracking and ergonomic analytics
• Notifications: Real-time alerts for events and cleanings
• PDF Export: Generate reports and statistics
• Admin Dashboard: Comprehensive system management

AI Height Analyzer

• Computer vision-based pose detection using MediaPipe
• Ergonomic assessment and posture analysis
• Height estimation from images
• Optimal desk height calculation
• Detailed anthropometric analysis

Wifi2Ble Desk Simulator

• REST API for desk control and monitoring
• Simulates multiple desks with configurable properties
• Real-time position, speed, and status tracking
• Error logging and usage counters
• HTTPS support with SSL certificates
• Data persistence across restarts

Pico4DeskUp (Embedded)

• OLED display for user information
• UART communication with desk hardware
• Real-time height monitoring
• User login/logout detection
• Desk assignment tracking

🚀 Getting Started

Prerequisites

• Docker & Docker Compose
• PHP 8.2+ (for local development)
• Python 3.8+ (for local development)
• Node.js 18+ (for local development)
• Raspberry Pi Pico W SDK (for embedded development)

Quick Start with Docker

1. Clone the repository

   git clone https://github.com/dricondop/DeskUp.git
   cd DeskUp

2. Configure environment

   cd DeskUp
   cp .env.example .env
   # Edit .env with your settings

3. Start all services

   docker-compose up -d

4. Access the application

   • Web App: http://localhost
   • Wifi2Ble Simulator: https://localhost:8443
   • Python AI Service: http://localhost:5000

Manual Setup

Laravel Web Application

cd DeskUp
# Install dependencies
composer install
npm install
# Configure environment
cp .env.example .env
php artisan key:generate
# Setup database
touch database/database.sqlite
php artisan migrate
php artisan db:seed
# Start development server
composer dev
# Or separately:# php artisan serve# php artisan queue:listen# npm run dev

Python AI Service

cd DeskUp/python_service
# Create virtual environment
python -m venv venv
source venv/bin/activate # On Windows: venv\Scripts\activate# Install dependencies
pip install -r requirements.txt
# Start service
python main.py

Wifi2Ble Simulator

cd Wifi2Ble
# Start HTTP server
python simulator/main.py --port 8000
# Or HTTPS server
python simulator/main.py --port 8443 --https \
--certfile config/cert.pem --keyfile config/key.pem
# With custom desk count and simulation speed
python simulator/main.py --desks 100 --speed 60

Raspberry Pi Pico W

cd Pico4DeskUp
# Build the project
mkdir build &&cd build
cmake ..
make
# Flash to Pico (connect via USB)# Copy Pico4DeskUp.uf2 to the Pico drive

📚 Documentation

Component Documentation

• Laravel Application - Web application details
• Python AI Service - Height analyzer documentation
• Wifi2Ble Simulator - REST API documentation

Key Commands

Laravel Artisan Commands

# Run cleaning scheduler (manual)
php artisan cleaning:run
# Complete expired events
php artisan events:complete-expired
# Run scheduler continuously
php artisan schedule:work
# Run tests
composer test# or
php artisan test

Development

# Run linter
vendor/bin/pint
# Clear cache
php artisan config:clear
php artisan cache:clear

🛠️ Technology Stack

Backend

• Laravel 12 - PHP web framework
• SQLite - Database
• Python 3 - AI service & simulator
• MediaPipe - Pose detection
• C/C++ - Embedded firmware

Frontend

• Tailwind CSS 4 - Styling
• Three.js - 3D visualization
• Vite - Build tool
• Axios - HTTP client

Infrastructure

• Docker - Containerization
• Nginx - Web server
• UART - Hardware communication
• I2C - OLED display interface

📦 Project Structure

DeskUp/
├── DeskUp/ # Laravel web application
│ ├── app/ # Application logic
│ ├── resources/ # Views and assets
│ ├── routes/ # Route definitions
│ ├── database/ # Migrations and seeders
│ └── python_service/ # AI height analyzer
├── Wifi2Ble/ # Desk simulator API
│ ├── simulator/ # Python REST server
│ ├── config/ # SSL certificates & API keys
│ └── data/ # Persistent desk state
├── Pico4DeskUp/ # Raspberry Pi Pico firmware
│ ├── *.cpp/*.h # Source files
│ └── build/ # Build artifacts
└── docker-compose.yml # Docker orchestration

🔒 Security

• API key authentication for desk simulator
• HTTPS support with SSL/TLS
• Laravel authentication and authorization
• Admin role-based access control
• Rate limiting on sensitive endpoints

🧪 Testing

# Laravel testscd DeskUp
php artisan test# Python service testscd DeskUp/python_service
python test_service.py
# Wifi2Ble API testscd Wifi2Ble
python tests/simple_api_test.py

📄 License

This project is licensed under the MIT License - see the LICENSE file for details.

Copyright (c) 2024 Krzysztof Sierszecki, SDU

👥 Contributors

Developed as part of the SPE25 - Distributed Software Systems with Embedded Elements course.

🐛 Troubleshooting

Common Issues

1. Docker containers won't start

   • Ensure ports 80, 5000, and 8443 are available
   • Check Docker daemon is running
   • Review logs: docker-compose logs

2. Laravel migration fails

   • Ensure database file exists: touch database/database.sqlite
   • Clear config cache: php artisan config:clear

3. Pico won't connect

   • Verify UART connections
   • Check I2C wiring for OLED display
   • Review serial output for errors

4. AI service errors

   • Install all Python dependencies
   • Ensure camera/image permissions
   • Check MediaPipe compatibility

📧 Support

For questions or issues, please open an issue on the GitHub repository.

🔄 Version

Current Version: 1.0.0

---

DeskUp - Smart Desk Management for Modern Offices