TradicionES

Descripción General

TradicionES es una aplicación diseñada para permitir la reproducción de música tradicional argentina de manera 100% offline. El proyecto está enfocado principalmente en trabajadores del ámbito rural e individuos que se encuentran en zonas sin acceso a internet, garantizando disponibilidad musical continua sin importar la ubicación.

Estado del Proyecto

El proyecto se encuentra actualmente en fase de desarrollo activo.

• La interfaz de usuario cuenta con las secciones estructurales (Inicio, Explorar, Agregar, Playlists) maquetadas y preparadas para su futura integración con datos dinámicos.
• El reproductor de audio está implementado y es funcional, aunque por el momento su uso se gestiona exclusivamente mediante la consola del navegador.

Tecnologías Utilizadas

La iteración actual se basa en tecnologías web estándar:

• HTML5 y CSS3
• JavaScript (ES6+)
• JSON (Gestión del catálogo musical)

Nota: Al finalizar la etapa de desarrollo web, el objetivo principal es empaquetar el código como un archivo APK para su distribución como aplicación móvil nativa.

Instalación y Ejecución Local

Para probar el proyecto en un entorno de desarrollo local, siga estos pasos:

1. Clone este repositorio en su máquina local:

   git clone https://github.com/tu-usuario/TradicionES.git

2. Abra el directorio del proyecto utilizando su editor de código preferido (ej. Visual Studio Code).
3. Inicie el archivo index.html mediante un servidor local (se recomienda la extensión Live Server de VS Code).

Uso del Reproductor (Modo Consola)

Dada la fase actual de desarrollo, la reproducción de audio se controla temporalmente desde las herramientas de desarrollador del navegador.

Para iniciar la reproducción:

1. Abra el proyecto en el navegador y acceda a la consola (típicamente presionando F12 o Ctrl+Shift+I).
2. Ingrese y ejecute el siguiente bloque de código JavaScript:

const { getAllSongs } = await import('./js/data/catalog.js');
// El número '0' representa el índice de la pista a reproducir (rango de 0 a 23)
player.loadQueue(await getAllSongs(), 0); 

Importante: Para conocer qué canción corresponde a cada índice numérico, consulte el archivo Catalog.md. Tenga en cuenta que en el catálogo las canciones se enumeran del 1 al 24, pero el índice del array en la consola inicia en 0.

Contribuciones y Reporte de Errores

El proyecto está abierto a la colaboración. Todo feedback y código es bienvenido.

• Reporte de fallos o sugerencias: Si identifica algún error o tiene una propuesta, por favor abra un Issue en el repositorio detallando la situación.
• Pull Requests (PR): Para enviar modificaciones de código directamente, siga este flujo:
  1. Realice un Fork del repositorio.
  2. Cree una rama específica para su funcionalidad o corrección (git checkout -b feature/nueva-caracteristica o fix/correccion-error).
  3. Realice sus cambios y documéntelos con un commit descriptivo (git commit -m "Descripción detallada del cambio").
  4. Suba la rama a su repositorio (git push origin nombre-de-la-rama).
  5. Abra una Pull Request hacia este repositorio para su revisión y eventual integración.

Licencia

Este proyecto se distribuye bajo la licencia GNU General Public License v3.0 (GPLv3). Para mayor información, consulte el archivo LICENSE incluido en el repositorio.