🎁 Amigo Secreto - Oracle Next Education

Este repositorio presenta el proyecto del reto del Amigo Secreto en la ruta de formación en programación del programa Oracle Next Education de Alura Latam.

📝 Descripción del Proyecto

Amigo Secreto es una aplicación web interactiva que permite organizar sorteos para intercambios de regalos entre amigos, familiares o compañeros de trabajo. La aplicación facilita la selección aleatoria de participantes de manera justa y divertida.

✨ Características

• Interfaz intuitiva: Diseño moderno y responsive con una experiencia de usuario amigable
• Gestión de participantes: Agregar, visualizar y eliminar nombres de la lista
• Validaciones inteligentes: Previene nombres duplicados y campos vacíos
• Sorteo aleatorio: Selección justa y aleatoria del amigo secreto
• Interactividad completa: Soporte para teclado (Enter) y ratón
• Animaciones suaves: Efectos visuales que mejoran la experiencia
• Accesibilidad: Implementación de buenas prácticas de accesibilidad web

🚀 Funcionalidades

Principales

• ✅ Agregar nombres: Los usuarios pueden escribir nombres y añadirlos a la lista
• ✅ Validar entrada: El sistema verifica que los nombres sean válidos y únicos
• ✅ Visualizar lista: Todos los participantes se muestran en una lista organizada
• ✅ Sorteo aleatorio: Selección aleatoria con un solo clic
• ✅ Eliminar participantes: Opción para remover nombres de la lista

Extras

• 🎯 Soporte para tecla Enter
• 🗑️ Eliminación individual de participantes
• 🎨 Animaciones y efectos visuales
• 📱 Diseño responsive para móviles
• ♿ Elementos de accesibilidad (ARIA labels, roles)

🛠️ Tecnologías Utilizadas

• HTML5: Estructura semántica y accesible
• CSS3: Estilos modernos con variables CSS y flexbox
• JavaScript ES6+: Lógica interactiva y manipulación del DOM
• Google Fonts: Tipografías Inter y Merriweather

📁 Estructura del Proyecto

amigo_secreto_alura/
│
├── index.html          # Página principal
├── style.css           # Estilos CSS
├── app.js              # Lógica JavaScript
├── assets/             # Recursos multimedia
│   ├── amigo-secreto.png
│   └── play_circle_outline.png
└── README.md           # Documentación

🎯 Instalación y Uso

Prerrequisitos

• Navegador web moderno
• No requiere instalación de dependencias

Pasos para ejecutar

1. Clonar el repositorio

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

2. Navegar al directorio

   cd amigo_secreto_alura

3. Abrir en el navegador

   • Abrir index.html directamente en tu navegador preferido
   • O usar un servidor local como Live Server en VS Code

📖 Cómo Usar la Aplicación

1. Agregar participantes:

   • Escribir un nombre en el campo de texto
   • Hacer clic en "Añadir" o presionar Enter
   • El nombre aparecerá en la lista

2. Gestionar la lista:

   • Ver todos los participantes agregados
   • Eliminar nombres usando el botón ✕

3. Realizar el sorteo:

   • Hacer clic en "Sortear amigo"
   • El sistema seleccionará un participante aleatoriamente
   • El resultado se mostrará con una animación

🎨 Características de Diseño

• Colores principales: Azul (#4B69FD), Naranja (#fe652b), Amarillo suave (#FFF9EB)
• Tipografías: Inter para textos, Merriweather para títulos
• Layout: Diseño centrado con secciones bien definidas
• Responsive: Adaptable a diferentes tamaños de pantalla

🧪 Validaciones Implementadas

• ❌ Campo vacío: Alerta si no se ingresa un nombre
• ❌ Nombres duplicados: Previene agregar el mismo nombre dos veces
• ❌ Lista vacía: Aviso si se intenta sortear sin participantes
• ✅ Formato correcto: Limpieza automática de espacios extra

🏆 Retos del Proyecto Oracle Next Education

Este proyecto forma parte de los desafíos prácticos del programa Oracle Next Education (ONE) de Alura Latam, enfocado en:

• Desarrollo de lógica de programación
• Manipulación del DOM con JavaScript
• Implementación de interfaces de usuario
• Buenas prácticas de desarrollo web
• Resolución de problemas reales

🤝 Contribuciones

Las contribuciones son bienvenidas. Para contribuir:

1. Fork el proyecto
2. Crea una rama para tu función (git checkout -b feature/nueva-funcion)
3. Commit tus cambios (git commit -m 'Agregar nueva función')
4. Push a la rama (git push origin feature/nueva-funcion)
5. Abre un Pull Request

📄 Licencia

Este proyecto está bajo la Licencia MIT. Ver el archivo LICENSE para más detalles.

👨‍💻 Autor

Desarrollado como parte del programa Oracle Next Education de Alura Latam.

---

🔗 Enlaces Útiles

• Oracle Next Education
• Alura Latam
• Documentación de JavaScript

---

¡Gracias por visitar este proyecto! Si te gustó, no olvides dar una ⭐ al repositorio.