Este proyecto es parte de un desafío para desarrollar una aplicación web simple para sortear amigos secretos. La aplicación permitirá a los usuarios ingresar nombres y luego sortearlos aleatoriamente para determinar quién le regala a quién.
- Descripción del Proyecto
- Funcionalidades
- Tecnologías Utilizadas
- Instalación
- Uso
- Contribución
- Licencia
La aplicación "Amigo Secreto" es una herramienta sencilla diseñada para facilitar la organización de sorteos de amigo secreto. Los usuarios pueden añadir los nombres de todos los participantes y, con un solo clic, la aplicación realizará un sorteo justo y aleatorio, mostrando los pares resultantes.
- Añadir Participantes: Permite a los usuarios ingresar y añadir nombres a una lista de participantes, con validación para evitar duplicados.
- Remover Amigo: Permite eliminar amigos individualmente de la lista haciendo clic sobre el botón "X" al lado de su nombre.
- Visualizar Lista de Amigos: Muestra los nombres de los participantes añadidos en una lista visible en la interfaz.
- Mensajes de Error Mejorados: Las advertencias (ej. pocos amigos para sortear) ahora aparecen directamente en la interfaz, con un estilo visual distinto y desaparecen automáticamente.
- Estilos de Footer: Se añadió un pie de página con información de autor y un enlace a GitHub.
- Responsividad General: La interfaz se adapta a diferentes tamaños de pantalla, incluyendo el encabezado, secciones de entrada y botones.
- Comentarios en el Código: El código fuente incluye comentarios para mejorar la legibilidad y comprensión de las funciones.
- Sortear Amigo Secreto: Realiza un sorteo aleatorio robusto que asegura que nadie se regale a sí mismo y que cada participante tenga un único receptor, evitando la reciprocidad directa (A no da a B si B da a A).
- Limpiar Lista: Permite borrar todos los nombres de la lista y los resultados del sorteo, así como limpiar los datos guardados en el almacenamiento local.
- Persistencia de Datos: La lista de amigos se guarda automáticamente en el almacenamiento local del navegador, permitiendo que los datos persistan entre sesiones.
- Mostrar Resultados: Presenta claramente los resultados del sorteo con un estilo visual mejorado para destacar los emparejamientos.
- HTML5: Para la estructura y contenido de la página web.
- CSS3: Para el diseño y la estilización de la interfaz de usuario.
- JavaScript: Para la lógica interactiva de la aplicación, incluyendo la adición de nombres y el algoritmo de sorteo.
Para obtener una copia local y ejecutar este proyecto, sigue estos sencillos pasos:
- Clona el repositorio:
git clone https://github.com/tu-usuario/challenge-amigo-secreto.git
- Navega al directorio del proyecto:
cd challenge-amigo-secreto - Abre el archivo
index.htmlen tu navegador web preferido.
- Abre
index.htmlen tu navegador. - Ingresa los nombres de los participantes en el campo de texto y haz clic en "Añadir".
- Una vez que todos los nombres estén en la lista, haz clic en el botón "Sortear amigo" para ver los resultados.
Las contribuciones son bienvenidas. Si tienes alguna sugerencia o mejora, por favor, abre un 'issue' o envía un 'pull request'.
Este proyecto está bajo la Licencia MIT. Consulta el archivo LICENSE para más detalles.