Skip to content

Este es el reproductor y la radio online del Supermercado del Primo

License

Notifications You must be signed in to change notification settings

Jeanpigi/reproductor

Repository files navigation

Supermercado Primo - Reproductor y radio de Música Web

El Supermercado Primo presenta un reproductor de música web y radio online el cuál esta desarrollado con las tecnologías Node.js, Express y SqlLite. Esta aplicación avanzada permite a los usuarios disfrutar de su música favorita mientras brinda una experiencia fluida y confiable. Ambos servicios consumen la misma musica y anuncios.

Características principales

  • Registro de usuarios: Los usuarios pueden crear fácilmente una cuenta personal para acceder a todas las funcionalidades del reproductor de música.
  • Inicio de sesión seguro: Con un sistema de autenticación robusto, los usuarios pueden iniciar sesión de manera segura en sus cuentas.
  • Carga de canciones y anuncios: La aplicación permite a los usuarios autorizados cargar y almacenar sus canciones o anuncios en formato MP3 y M4A para acceder a ellas en cualquier momento y desde cualquier dispositivo. Nota: los anuncios se deben almacenar en formato MP3.
  • Reproducción de canciones y anuncios: Los usuarios pueden reproducir sus audios cargados sin problemas, brindando una experiencia auditiva excepcional.
  • API para información de canciones: Además de las funcionalidades principales, la aplicación también proporciona una API intuitiva que permite a los desarrolladores obtener información detallada sobre las canciones almacenadas.
  • Permite consumir el servicio de radio online, escuchando musica y anuncios.

Requisitos previos

Antes de ejecutar la aplicación, asegúrate de tener instalado lo siguiente:

  • Node.js (v18 o superior)
  • Crear las carpetas correspondientes dentro de la carpeta public (music, audios, himno, diciembre);
  • Agregar los audios solo en la carpeta de diciembre en formato mp3, al igual debe agregar el himno en formato mp3 en la carpeta de himno.

Instalación

  1. Clona este repositorio:

       git clone git@github.com:Jeanpigi/reproductor.git
  2. Ve al directorio del proyecto:

       cd reproductor
  3. Instala las dependencias:

       npm install
  4. Configura la base de datos sqllite3:

  • La forma básica, es crear el nombre de la base de datos, luego crear las tablas necesarias que para este caso serán: usuarios, canciones y anuncios. Nota: puedes crearla con una archivo .js en el directorio raíz del proyecto y correrlo con node.
     node db.js
  • Las tablas que necesita son una para almacenar los usuarios, otra para alamacenar la ruta de la musica, y por último la tabla para alamcenar la ruta de los anuncios.
  1. Configura las variables de entorno:
  • Crea un archivo .env en el directorio raíz del proyecto.
  • Copia el contenido del archivo .env.example y pégalo en el archivo .env
  • Completa las variables de entorno con tus propios , estos valores son los que permiten el acceso a la base de datos.
  1. Si quieres correr el servidor mediante el siguiente comando:
   npm run start
  1. Accede a la aplicación en tu navegador web en la siguiente URL: http://localhost:3005

Uso

  1. Regístrate en la aplicación para crear una cuenta de usuario.
  2. Inicia sesión con tu cuenta de usuario.
  3. Carga canciones en formato MP3 o M4A desde la sección de administración.
  4. Carga anuncios en formato MP3 desde la sección de administración.
  5. Reproduce las canciones en el reproductor.
  6. Reproduce audio mediante la radio online.
  7. Utiliza la API para obtener información sobre las canciones.

API

La aplicación proporciona las siguientes rutas de la API:

  • GET /api/canciones: Obtiene todas las canciones.
  • GET /api/anuncios: Obtiene todos los anuncios.

Contribución

Si deseas contribuir a este proyecto y ayudarlo a crecer, sigue estos pasos:

  1. Crea un fork de este repositorio.
  2. Crea una nueva rama con un nombre descriptivo: git checkout -b nombre_de_rama.
  3. Realiza las modificaciones necesarias y realiza los commits correspondientes.
  4. Envía tus cambios al repositorio remoto: git push origin nombre_de_rama.
  5. Abre un pull request para revisar tus cambios y fusionarlos con la rama principal.

Authors

  • Jean Pierre Giovanni Arenas Ortiz

Licencia

Esta obra está bajo una Licencia Creative Commons Atribución-NoComercial-SinDerivadas 4.0 Internacional.