FUNCTIONAL_GUIDE.md
1. Experiencia del Usuario (Frontend)
1.1 Navegación Principal
La aplicación utiliza un diseño de tres columnas optimizado para monitores de alta resolución:
- Barra Lateral Izquierda: Navegación rápida a "Home", "Explorar", "Daily Mix" y acceso a la biblioteca personal (Likes y Playlists).
- Contenedor Central: El área de contenido principal con scroll suave y efectos de entrada animados. Incluye encabezados de gran tamaño con tipografía "Black" para una estética premium.
- Barra Lateral Derecha (Contextual): Se activa automáticamente al reproducir una canción, mostrando el arte de tapa en alta resolución, letra/prompt de la pista y metadatos extendidos.
1.2 Sistema de Base de Datos Musical (PersistentPlayer)
Ubica el catálogo en la parte inferior, permanece activo durante toda la sesión.
- Controles de Audio: Play/Pause con transiciones suaves, Salto de pista (Anterior/Siguiente), Shuffle (Aleatorio) y Repeat (Bucle).
- Barra de Progreso Interactiva: Permite el rastreo preciso del catálogo. Al pasar el cursor, muestra el tiempo exacto.
- Gestión de Volumen: Slider fluido con icono de estado dinámico.
- Pantalla de Mini-Arte: Muestra la portada de la canción actual y sus etiquetas asociadas.
2. Biblioteca y Playlists
2.1 Gestión de Favoritos
El sistema permite marcar tracks con un "Like", lo que los añade automáticamente a la sección de "Likes" en la barra lateral. Esta acción se sincroniza en tiempo real con la base de datos de Supabase.
2.2 Creación de Listas Personalizadas
Los usuarios pueden crear nuevas playlists, asignarles un nombre y descripción. Estas listas son persistentes y permiten añadir o eliminar canciones de forma dinámica mediante el menú de opciones (tres puntos) en cada track.
3. Sistema de Notificaciones HUD
Para mejorar el feedback táctil y visual, se ha implementado un sistema de notificaciones tipo "Toast" en la esquina inferior derecha. Cada acción (añadir a playlist, dar like, errores de conexión) genera una alerta con estética Glassmorphism que desaparece automáticamente tras unos segundos.
4. Panel de Administración V.2
El área administrativa ha sido rediseñada para ofrecer una experiencia técnica y forense:
- Búsqueda de Clip_Nodes: Búsqueda avanzada por UUID o términos técnicos.
- Visualización de Matriz: Cada pista muestra su "Impact_Matrix", un gráfico que representa el rendimiento o métricas internas asignadas al clip.
- Editor de Estado: Los administradores pueden alternar el estado de un clip entre "Online" y "Draft" con un solo clic, impactando inmediatamente en lo que el usuario final puede ver.
5. Diseño y Estética Premium
La plataforma utiliza un lenguaje visual coherente basado en:
- Glassmorphism: Uso extensivo de desenfoque de fondo (backdrop-blur) para capas de profundidad.
- Gradientes de Malla: Fondos dinámicos que cambian suavemente para evitar la monotonía visual.
- Tipografía Dual: Uso de fuentes Sans-serif pesadas para títulos y fuentes Monospace para datos técnicos y metadatos.
6. Conclusión y Futuro del Proyecto
Kipu Music Pro no es solo un repositorio, es un sistema escalable diseñado para crecer junto con el catálogo musical de David. El enfoque en la tecnología abierta y la interfaz de alta fidelidad asegura que la experiencia de escucha sea tan avanzada como la música que contiene.