Serveis externs
Inventari de tots els serveis externs que utilitza Line Dance Platform, amb guies de configuració.
Configuració ràpida
# 1. Copia la plantilla
cp .env.example .env
# 2. Omple les variables dels serveis que vulguis activar
# 3. Arrenca la infraestructura
docker compose up -d
# 4. Arrenca el backend (perfil local)
cd backend && mvn spring-boot:run -Dspring-boot.run.profiles=local
La cascada de configuració és: .env → application.yml (defaults) → application-local.yml (overrides locals).
Inventari de serveis
| Servei | Tipus | Obligatori | Auth | Guia |
|---|---|---|---|---|
| PostgreSQL 16 | Base de dades | Sí | User/pass local | Backend Setup |
| pgAdmin 4 | Eina admin BD | No | User/pass local | Backend Setup |
| YouTube Data API v3 | Metadata vídeos | No | API Key | Guia YouTube |
| Spotify Web API | Cerca musical | No | Client ID/Secret | Guia Spotify |
| iTunes Search API | Cerca musical | No | Cap (pública) | — |
| Deezer API | Cerca musical + previews | No | Cap (pública) | — |
| ACRCloud | Identificació musical | No | Access Key/Secret | Guia ACRCloud |
| OpenRouter | IA (parsing descripcions) | No | API Key | Guia OpenRouter |
| SMTP / Gmail | Email (verificació, reset) | No | App Password | Guia SMTP |
Serveis sense autenticació
iTunes Search API
API pública d'Apple per cercar cançons. No requereix registre ni claus.
- URL base:
https://itunes.apple.com/search - Funcionalitat a LDP: Cerca de cançons, artwork, previews, links Apple Music
- Límits: Aproximadament 20 peticions/minut (sense documentar oficialment)
- Component:
ITunesMusicProvider.java
Deezer API
API pública de Deezer per cercar cançons i obtenir previews de 30 segons.
- URL base:
https://api.deezer.com - Funcionalitat a LDP: Cerca de cançons, BPM (via lookup individual), previews MP3, artwork, ISRC, links Deezer
- Límits: Generosos, sense rate limiting estricte
- Component:
DeezerMusicProvider.java
Nivells de funcionalitat
Què funciona segons els serveis configurats:
| Serveis configurats | Funcionalitat disponible |
|---|---|
| Cap (només PostgreSQL) | CRUD complet: balls, cançons, coreògrafs, events. Cerca i filtres. |
| + Spotify | Cerca cançons multi-plataforma, BPM, gèneres, energy, links Spotify |
| + YouTube | Importació automàtica de balls des d'URLs YouTube, metadata de vídeos |
| + OpenRouter | Parsing automàtic amb IA de descripcions YouTube (coreògraf, cançó, estil...) |
| + ACRCloud | Identificació de cançons per micròfon (Shazam-like) |
| + SMTP | Verificació d'email al registre, reset de contrasenya |
| Tots | Experiència completa |
tip
iTunes i Deezer sempre estan disponibles (APIs públiques). La cerca multi-plataforma funciona fins i tot sense Spotify — simplement tindrà menys resultats.
Variables d'entorn
Totes les variables estan documentades al fitxer .env.example a l'arrel del projecte. Consulta la guia de cada servei per obtenir els valors.