Etiquetar los temas con "mood" y otros atributos permite que el motor de recomendación de Milonga DJ Pro considere el arco emocional al sugerir tandas. La forma más eficiente de gestionar las etiquetas es en un único archivo Excel.
Esta guía no te pide escribir Excel desde cero: lo haces crecer poco a poco a partir de una tabla que la app exporta, para que el lento trabajo de armar la base sea eficiente y seguro.

## 0. Principio clave: Excel es el "maestro"

- Al importar, una celda con valor → sobrescribe (Excel manda)
- Una celda vacía en Excel → conserva la etiqueta existente en la app (el trabajo manual nunca se borra por un vacío)
- Si conservas y actualizas el archivo Excel con cuidado, siempre será la fuente de verdad

> Aquello en lo que inviertes tiempo es el archivo Excel. El lado de la app es una "copia". Guarda el Excel cada vez y haz copias de seguridad.

## 1. El flujo general (ida y vuelta)

PASO 1 — Exportar la semilla
Pulsa `⬆ Exportar etiquetas` en la barra superior → se descarga `tango-library-tags_YYYYMMDD.csv`. Es "una lista de todos los temas de tu biblioteca (título, orquesta, año, etiquetas existentes)", así no escribes desde cero.

PASO 2 — Editar en Excel
Abre ese CSV en Excel → completa las 3 etiquetas obligatorias (abajo) → guarda como Excel (.xlsx) (nombre libre, p. ej. `tango-library-tags.xlsx`).

PASO 3 — Importar
Pulsa `🎭 Importar etiquetas` en la barra superior → elige el `.xlsx` editado.

PASO 4 — Revisar el informe de sincronización
El "Informe de sincronización" tras importar muestra cantidad sincronizada / filas de Excel no coincidentes / temas aún sin etiquetar.
Corrige en Excel las filas no coincidentes y reimporta; toma los temas sin etiquetar como el próximo lote.

PASO 5 — Itera en pasos pequeños
No hagas todo de una vez. Empieza por las orquestas/tandas que más usas. Repite PASO 1–4 para hacerlo crecer.

## 2. Columnas y cómo completarlas

La fila 1 es el encabezado (en inglés). De la fila 2 en adelante, un tema por fila. No cambies la ortografía del encabezado.

Columna | Oblig. | Contenido / cómo completar
--- | --- | ---
`track_id` | — | ID interno. Si está en el CSV exportado, no lo toques (se compara primero)
`title` | ◎ | Título del tema (p. ej. Bahía Blanca)
`orchestra` | ◎ | Orquesta (p. ej. Carlos Di Sarli)
`genre` | ○ | `tango` / `vals` / `milonga` / `cortina`
`year` | △ | Año de grabación (1900–2100). Se aplica si está presente
`singer` | △ | Cantor (vacío = instrumental). Se aplica si está presente
`bpm` | △ | Tempo (número). Si está vacío, se usa el valor autoanalizado
`key` | △ | Tonalidad (p. ej. Am, D minor, F# minor)
`primary_mood` | ◎ | Mood primario (uno de los 13 de abajo). Las filas con esto vacío no se sincronizan
`secondary_moods` | △ | Moods secundarios. Separados por coma, varios permitidos (p. ej. `郷愁,切望`)
`flow_type` | ◎ | `Descent` / `Ascent` / `Sustain` / `Bounce`
`intensity` | ◎ | 1–5 (1 = ambiental, 5 = clímax)
`notes` | △ | Nota libre (uso, "para la apertura", etc.)

> Completa primero solo las 3 obligatorias: `primary_mood` / `flow_type` / `intensity`. `title` y `orchestra` ya vienen completados por la exportación. Temas de la misma orquesta/época suelen compartir etiquetas, así que copiar-pegar acelera el trabajo.

## 3. Elegir primary_mood (13 moods)

Mood (JA) | Significado (ES) | Familia | Uso típico
--- | --- | --- | ---
哀愁 | Aishū — melancolía/pena | melancólico | Milonga temprana / obras de cierre
郷愁 | Kyōshū — nostalgia | melancólico | Nostálgico / una apertura moderada
諦念 | Teinen — resignación | melancólico | Sensación de aceptación
切望 | Setsubō — anhelo | anhelo | Ansia de avanzar
回想 | Kaisō — reminiscencia | calmo | Recuerdos tranquilos
安らぎ | Yasuragi — serenidad | calmo | Calmo, asentado
希望 | Kibō — esperanza | positivo | El inicio de una subida
情熱 | Jōnetsu — pasión | apasionado | El núcleo del clímax
決意 | Ketsui — determinación | apasionado | Fuerza de voluntad
喜び | Yorokobi — alegría | positivo | Euforia / final
華やかさ | Hanayakasa — esplendor | positivo | Euforia brillante
軽快 | Keikai — ligereza | positivo | Buen tempo, ágil
緊張 | Kinchō — tensión | tenso | Tensión dramática

> La misma familia (p. ej. 哀愁⇔郷愁⇔諦念) conecta de forma natural; un salto brusco entre familias necesita un tema puente, que el motor tiene en cuenta. Si dudas, elige por "lo que siente el bailarín en este tema". Escribe el término en japonés en la celda.

## 4. flow_type (la forma del tema)

Valor | Significado | Ejemplo
--- | --- | ---
`Descent` | Descendente. De pico a calma | Tipo desvanecimiento final (estilo Bahía Blanca)
`Ascent` | Ascendente. De calma a intensidad | Tipo dramático (estilo Adiós Nonino)
`Sustain` | Sostenido, energía estable | Tensión continua (estilo La Yumba)
`Bounce` | Rebote, ondulante | Tipo pegadizo (estilo El Choclo)

## 5. intensity (1–5)

Valor | Nivel | Sensación
--- | --- | ---
1 | Ambient | Atmosférico, intro suave
2 | Low | Calmo, moderado
3 | Medium | Tango estándar
4 | High | Va creciendo
5 | Max Peak | Clímax, final

## 6. Ejemplo (un tema)

Columna | Valor
--- | ---
title | Bahía Blanca
orchestra | Carlos Di Sarli
genre | tango
year | 1957
singer | (vacío = instrumental)
primary_mood | 哀愁
secondary_moods | 郷愁, 切望
flow_type | Descent
intensity | 3
notes | Obra maestra "downer" / para la apertura o el cierre

## 7. Cuando un tema no coincide (consejos de coincidencia)

Al importar, la app busca en este orden:

1. Coincide `track_id`
2. Coincide el título + la orquesta coincide de forma laxa (`Biagi` y `Rodolfo Biagi` ambos OK)
3. Si el título es único en la biblioteca, coincide por eso

Mayúsculas, ancho completo/medio y notación con corchetes como `[Tango]` se absorben automáticamente. Si aún dice "Sin tema coincidente":

- Verifica que la ortografía de título/orquesta no difiera mucho de la biblioteca (sobre todo la notación feat.)
- Lo más fiable: basa tu archivo en el CSV de `⬆ Exportar etiquetas` (tiene `track_id`, así que siempre coincide)
- Si existen varios temas con el mismo título y la orquesta no permite distinguir, se omite a propósito para evitar coincidencias erróneas

## 8. Lo que NO hay que hacer / precauciones

- No cambies la ortografía del encabezado (fila 1) ni borres columnas
- No dejes `primary_mood` vacío creyendo que está "etiquetado" (las filas vacías no se sincronizan)
- No rompas el formato "guardando encima" del CSV → para importar, guarda como .xlsx
- No tengas el Excel en un solo lugar → haz copias de seguridad a menudo (es la fuente de verdad)

> Importar = "Excel manda / los vacíos se dejan". Importar con columnas vacías no borrará etiquetas existentes, pero una celda donde sí pusiste un valor sobrescribirá. Revisa una vez antes de importar.

## 9. Enfoque recomendado

1. Empieza por las orquestas que más usas (tus tandas estándar)
2. Copia-pega `primary_mood` entre la misma orquesta/época de una vez
3. Una vez hechas las 3 obligatorias, completa `secondary_moods` y `year/singer`
4. Mientras armas tandas en vivo, anota los temas donde una sugerencia "no encajó" → refléjalo en Excel
5. Usa los "temas aún sin etiquetar" del informe como tu lista de tareas para la próxima vez