b2b-music-platform
B2B music streaming platform expertise for Cloud Code. Use when discussing features, making architectural decisions, or implementing functionality for commercial venues like restaurants, hotels, retai
SKILL.md.claude/skills/b2b-music-platform/SKILL.md
GitHubCloud Code B2B Music Platform Knowledge
Business Context
Cloud Code is a B2B music streaming platform for commercial venues in Asia. It replaces BeatBreeze and competes with Soundtrack Your Brand, Rockbot, and Mood Media.
Target Users
| User Type | Needs |
|---|---|
| Venue Managers | Easy scheduling, quick controls, mobile access |
| Corporate HQ | Multi-venue dashboard, brand consistency, reporting |
| Staff | Simple override controls, volume adjustment |
| IT/Technical | API access, hardware setup, integrations |
Key Differentiators
- Royalty-Free Content - No licensing fees, predictable costs
- Weather Automation - Automatic playlist switching based on conditions
- AI Features - Voice commands, intelligent playlist generation
- Affordable Hardware - $100 Raspberry Pi vs $649 competitor players
- Local File Support - Play customer's own content alongside library
Pricing Model
Target: $20-25/zone/month (competitors charge $35+)
Multi-Tenancy Architecture
Organization (tenant)
└── Venues (physical locations)
└── Zones (audio outputs: lobby, restaurant, gym)
└── Schedules, Now Playing, Messages
Critical Constraints
- iOS PWA Limitation: No background audio → Need native Capacitor app
- No Spotify/YouTube: ToS prohibits commercial use
- Gapless Playback: 45ms browser gaps → Use 35ms crossfades
- Offline Required: Venues need music even during internet outages
Feature Priorities
Phase 1 (MVP)
- Content management (upload, organize, playlists)
- Audio player with crossfades and ducking
- Drag-drop scheduling calendar
- Multi-zone dashboard
Phase 2
- Weather automation
- AI voice commands
- Native iOS/Android apps
- Advanced analytics
Phase 3
- Generative soundscapes (Mubert integration)
- IoT integrations (lighting, sensors)
- White-label options
When Making Decisions
Always consider:
- Reliability - Music must never stop unexpectedly
- Simplicity - Venue staff are not technical
- Cost - Keep infrastructure costs low for healthy margins
- Offline-first - Assume internet will fail
- Multi-tenancy - Data isolation between organizations