# Platphorm Sonify

> Real-time robot sonification tool. Backend events become ambient lofi music.

Platphorm Sonify transforms robot fleet events into an ambient lofi music stream.
Each event type maps to a distinct sound: LOGIN events cascade like coins,
LOGOUT events degrade the mix, E_STOP triggers harsh noise bursts, and
TASK_START plays bright coin drops.

## API

- POST /api/events - Send robot events (single or array)
- GET /api/events?after_seq=N - Poll for new events (cursor-based)
- GET /api/events?all=1 - Get all stored events
- GET /api/health - Service health check
- GET /api/docs - OpenAPI 3.1 specification

## Event Types & Sound Mapping

Good (coin sounds):
- TASK_START - Bright coin drops
- LOGIN - Ascending coin cascade

Neutral (warm tones):
- TASK_END - Warm completion bell

Bad (degraded sounds):
- LOGOUT - Descending sad tone
- E_STOP / EMERGENCY - Harsh noise burst
- TASK_CANCELLED - Gritty warning tone
- goto_outcome: INACTIVE, ABORTED, ABORTED_VIA_TOUCHSCREEN - Warning tone

## Required Fields

- robot_id (string, required) - Robot identifier e.g. "xap035"
- event_type (string, required) - Event classification

## Optional Fields

- time - Timestamp "YYYY-MM-DD HH:MM:SS"
- task_id - UUID for the task
- destination - Task destination
- badge_code - Badge/location code
- duration_sec - Duration in seconds
- goto_outcome - Navigation outcome (affects sound for TASK_END)

## Links

- Full docs: /llms-full.txt
- API spec: /api/docs
- Parent: https://platphormnews.com
- Organization: https://platphormnews.com