An open API service indexing awesome lists of open source software.

https://github.com/rominarg/amigo-secreto-oracle

Challenge Alura: Aplicación para organizar un sorteo de "Amigo Secreto". Los usuarios pueden agregar nombres a una lista y realizar un sorteo aleatorio para determinar quién es el amigo secreto.
https://github.com/rominarg/amigo-secreto-oracle

alura css html javascript oracle

Last synced: 3 months ago
JSON representation

Challenge Alura: Aplicación para organizar un sorteo de "Amigo Secreto". Los usuarios pueden agregar nombres a una lista y realizar un sorteo aleatorio para determinar quién es el amigo secreto.

Awesome Lists containing this project

README

        

![HTML5](https://img.shields.io/badge/HTML5-Frontend-orange)
![CSS3](https://img.shields.io/badge/CSS3-Frontend-blue)
![JavaScript](https://img.shields.io/badge/JavaScript-Fullstack-yellow)

![challenge_alura_amigo_secreto](https://github.com/user-attachments/assets/c03ffa2e-90b3-4923-9f74-111adc9ceb65)

## 📝Descripción del Proyecto

Este es un proyecto de sorteo de "Amigo Secreto" desarrollado con **HTML, CSS y JavaScript**. La aplicación permite a los usuarios ingresar nombres en una lista, realizar un sorteo aleatorio y determinar quién es el "Amigo Secreto".
Los usuarios pueden:
✅ Agregar nombres a través de un campo de texto y un botón "Añadir".
✅ Visualizar la lista de participantes.
✅ Realizar el sorteo y mostrar el resultado en pantalla.

![image](https://github.com/user-attachments/assets/f7171233-8144-48b6-a56e-90304b376d14)

## 🚀Estado del Proyecto

✅ **Proyecto completo y funcionando.**
🔧 **Mejoras futuras:**
- Agregar animaciones para mejorar la experiencia de usuario.
- Permitir compartir los resultados del sorteo por redes sociales o correo electrónico.
- Implementar un backend para guardar sorteos anteriores.

## 🔍 Validaciones implementadas

Para garantizar que el sorteo funcione correctamente y evitar errores, el proyecto incluye las siguientes validaciones:

✅ No se pueden ingresar nombres vacíos o con solo espacios.
✅ El nombre debe tener al menos 3 caracteres.
✅ No se pueden agregar nombres duplicados.
✅ No se pueden agregar más de 5 participantes.
✅ Debe haber al menos 2 participantes para iniciar el sorteo.
✅ El sorteo selecciona aleatoriamente un participante de la lista.
✅ El botón "Reiniciar" limpia la lista y permite comenzar de nuevo.

## 🎥 Demostración de funciones y aplicaciones

👉 **[Ver el proyecto en GitHub Pages](https://rominarg.github.io/amigo-secreto-oracle/)**

## 🛠 Tecnologías utilizadas
- **HTML5**
- **CSS3**
- **JavaScript** (para la lógica del sorteo y validaciones)

## 📂 Estructura de carpetas

![image](https://github.com/user-attachments/assets/5a26226e-17a6-4e4b-a548-3389280032ff)

## 🚀 Ejecución en Local

1. Clona el repositorio con:
```bash
git clone https://github.com/rominarg/amigo_secreto_alura
```
No necesitas herramientas adicionales para ejecutar este proyecto

2. Abre el archivo index.html en tu navegador.
3. (Opcional) Si usas Visual Studio Code, instala la extensión Live Server para una mejor experiencia.

## 📜 Licencia
Este proyecto está bajo la licencia MIT.

## 🎯 Conclusión

Este proyecto de **Amigo Secreto** ofrece una solución sencilla y efectiva para realizar sorteos de manera aleatoria y transparente. Gracias a las validaciones implementadas, se garantiza una experiencia de usuario sin errores y fácil de usar.

A futuro, se pueden incorporar mejoras como animaciones, opciones para compartir los resultados y la integración con un backend para almacenar sorteos previos.

¡Gracias por visitar este proyecto! Si te resultó útil, no dudes en darle una ⭐ en GitHub. 🚀