Gorillas Device

Type: BLE wearable (TBD — exact capabilities unknown until device arrives) Status: Pending — arriving Hong Kong ~March 30, 2026 Integration Timeline: 2 days after arrival Device Type ID: gorillas

Expected Capabilities (to be confirmed)

• Heart rate
• SpO2
• Steps / activity
• Sleep tracking
• Temperature (TBD)
• GPS (TBD)

Integration Plan

Day 1: Protocol Analysis + Backend

1. Power on device, scan BLE services and characteristics
2. Document GATT service UUIDs and characteristic UUIDs
3. Identify data packet format (hex dump → decode)
4. Add "gorillas" device type to backend (migration + auto-detection)
5. Map Gorillas metrics to health_metrics columns

Day 2: App Integration + Testing

1. Create gorillas_ble_service.dart in app-user
2. Implement scan, connect, subscribe to notifications
3. Parse incoming data into CreateHealthMetricPayload
4. Add Gorillas device screen with status + metrics cards
5. End-to-end test: pair → sync → verify data in backend → display on web

Relevant Tasks

• GOR-001: BLE protocol analysis
• GOR-002: Backend device type
• GOR-003: BLE service in app-user
• GOR-004: Data mapping
• GOR-005: Device screen in app-user
• GOR-006: Web dashboard page
• GOR-007: Integration test

Notes

• Exact BLE protocol unknown until device arrives
• Budget 2 extra hours for unexpected protocol quirks
• May need firmware documentation from manufacturer
• If device uses proprietary app, may need to reverse-engineer BLE protocol