Skip to main content

Visió del projecte

Line Dance Platform (LDP) és un projecte per centralitzar, estructurar i fer explotable la informació de:

  • balls (dances),
  • cançons (songs),
  • coreògrafs,
  • events, venues i classes (a mig termini),
  • enllaços a vídeos, stepsheets i música.

L’objectiu no és substituir les fonts originals, sinó:

  • connectar i enriquir la informació dispersa,
  • oferir una eina de treball per professors, organitzadors i balladors,
  • preparar una base de dades i una API que permetin futurs productes (web, mòbil, integracions).

Objectius principals​

1. Catàleg de referència de balls i cançons​

  • Tenir una base de dades coherent de:
    • balls,
    • cançons,
    • relació ball–cançó–coreògraf.
  • Permetre:
    • cercar un ball i veure les cançons associades,
    • cercar una cançó i veure els balls que s’hi ballen,
    • consultar metadades bàsiques (nivell, mur, comptes, any, etc.).

2. Eina de treball per professors i organitzadors​

  • Facilitar la feina de:
    • preparar sessions,
    • planificar classes,
    • gestionar llistes de balls i música.
  • A mig termini:
    • relacionar balls amb events i classes,
    • veure què s’ha ballat on i quan.

3. Base per a futurs serveis i integracions​

  • Construir una API robusta sobre la qual es puguin fer:
    • apps mòbils,
    • dashboards,
    • integracions amb altres sistemes (per exemple webs d’associacions, festivals, etc.).
  • Pensar en:
    • volums de dades creixents,
    • imports massius,
    • enriquiment automàtic.

Principis de disseny​

1. Domini primer, tecnologia al servei del domini​

  • Les decisions de model de dades es fan pensant:
    • en com treballen realment professors, balladors i organitzadors,
    • en la terminologia i pràctica habitual del line dance.
  • La tecnologia (Spring Boot, React, PostgreSQL, etc.) està al servei del domini, no al revés.

2. Escalabilitat funcional i tècnica​

  • Començar amb un MVP útil:
    • CRUD ric per a balls i cançons,
    • autenticació bàsica,
    • cerca.
  • Però sempre pensant en:
    • events,
    • venues/locations,
    • classes,
    • imports i enriquiment,
    • app mòbil.

3. Respecte a les fonts originals​

  • No es vol “copiar” ni substituir portals existents:
    • es guarden metadades i enllaços, no continguts complets.
  • Sempre dins els límits de:
    • termes de servei (TOS),
    • drets d’autor i drets d’imatge.

4. Transparència i traçabilitat​

  • Qualsevol import o canvi massiu:
    • ha de ser traçable,
    • ha de passar per un staging revisable (en fases avançades).
  • El model ha de permetre saber:
    • d’on ve la dada,
    • quan s’ha modificat,
    • qui l’ha aprovat.

Públic objectiu​

Professors i organitzadors​

  • Consultar i gestionar:
    • catàleg de balls i cançons,
    • llistes de sessions,
    • (futur) events i classes.
  • Tenir una eina que redueixi:
    • Excel dispersos,
    • webs personals difícils de mantenir.

Balladors i públic general (a mitjà termini)​

  • Cercar:
    • quin ball es fa amb una determinada cançó,
    • on es fan classes o ballades.
  • Veure:
    • coreògrafs i informació relacionada.

Desenvolupadors i col·laboradors tècnics​

  • Tenir:
    • un backend clar i extensible,
    • un frontend modular,
    • una documentació coherent (aquesta web).

Roadmap resumit​

  • Fase 1–3:
    Backend base, frontend bàsic i autenticació JWT amb rols.

  • Fase 4A:
    CRUD manual ric per convertir la web en una eina usable del dia a dia.

  • Fase 4B–4E:
    Sistema d’import, staging i enriquiment de dades.

  • Fase 5:
    App mòbil per consulta (i en el futur, per gestió senzilla) des de qualsevol lloc.

Detall complet:
👉 roadmap/roadmap-global
👉 roadmap/roadmap-technical-details

Com llegir aquesta documentació​

  • Si busques la idea i el perquè:
    → comença per overview/vision (aquest document).

  • Si vols entendre la tècnica:
    → mira overview/tech-stack i architecture/architecture-overview.

  • Si vols saber què s’està fent ara:
    → consulta roadmap/backlog i history/changelog.