https://github.com/paulomppatricio/amigo-secreto-pmpp
Aplicativo para sortear um amigo secreto (Challenge Programa ONE).
https://github.com/paulomppatricio/amigo-secreto-pmpp
Last synced: 4 months ago
JSON representation
Aplicativo para sortear um amigo secreto (Challenge Programa ONE).
- Host: GitHub
- URL: https://github.com/paulomppatricio/amigo-secreto-pmpp
- Owner: PauloMPPatricio
- Created: 2025-01-25T02:47:55.000Z (5 months ago)
- Default Branch: main
- Last Pushed: 2025-01-27T20:14:11.000Z (5 months ago)
- Last Synced: 2025-01-27T21:25:53.022Z (5 months ago)
- Language: CSS
- Size: 38.1 KB
- Stars: 0
- Watchers: 1
- Forks: 0
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
Awesome Lists containing this project
README
# 🎉 Amigo Secreto
Um aplicativo interativo para facilitar a organização de sorteios de amigo secreto de maneira intuitiva, prática e divertida! Com um design moderno e responsivo, esta ferramenta ajuda você a adicionar amigos à lista, visualizar os participantes e realizar o sorteio diretamente na tela.
---
## 🌟 Destaques do Projeto
- **Interatividade Simples**: Adicione nomes, veja a lista crescer em tempo real e sorteie um amigo secreto com apenas um clique.
- **Design Moderno**: Layout responsivo e atraente com uma paleta de cores vibrantes e fontes estilizadas.
- **Código Modular e Bem Documentado**: Foco em boas práticas de desenvolvimento e organização.
---
## 🛠️ Tecnologias Utilizadas
- **HTML5**: Estruturação semântica da interface.
- **CSS3**: Design responsivo com variáveis de cores e animações para uma experiência visual refinada.
- **JavaScript (ES6)**: Implementação da lógica de sorteio e manipulação do DOM.
---
## 🚀 Funcionalidades
1. **Adicionar Amigos**:
- Digite o nome de cada participante na entrada de texto.
- Verifique a lista atualizada automaticamente na interface.
2. **Sortear Amigo Secreto**:
- Um clique no botão sorteia um nome aleatório da lista.
- O nome do amigo secreto é exibido em destaque.
3. **Limpeza Automática**:
- Após o sorteio, a lista e o título são automaticamente limpos para um novo uso.
---
## 🎨 Design Responsivo
- Paleta de cores primárias e secundárias ajustadas para alta legibilidade e apelo visual.
- Integração com fontes customizadas do Google Fonts: `Inter` e `Merriweather`.
---
## 📦 Instalação
1. Clone o repositório:
```bash
git clone https://github.com/PauloMPPatricio/amigo-secreto-pmpp.git
```
2. Navegue até o diretório:
```bash
cd amigo-secreto-pmpp
```
3. Abra o arquivo `index.html` no navegador.
---
## 📖 Uso
1. Abra o aplicativo no navegador.
2. Digite os nomes dos participantes no campo de entrada.
3. Clique no botão "Adicionar" para salvar cada nome na lista.
4. Quando todos os participantes forem adicionados, clique no botão "Sortear amigo".
5. Veja o nome sorteado ser exibido na tela!
---
## 🧪 Executando Testes
### Testes Manuais
- **Adicionar Nomes**:
1. Insira diferentes tipos de dados no campo de entrada (números, strings vazias ou strings com números).
2. Verifique se os inputs inválidos são rejeitados com alertas.
- **Sortear Amigo**:
1. Certifique-se de que o sorteio só ocorre quando há nomes na lista.
2. Teste o comportamento após o sorteio (limpeza da lista e do título).
---
## 🤝 Como Contribuir
1. Faça um fork do projeto.
2. Crie uma branch para a sua feature ou correção:
```bash
git checkout -b minha-feature
```
3. Commit suas alterações:
```bash
git commit -m "Adicionei uma nova funcionalidade"
```
4. Faça um push para a branch:
```bash
git push origin minha-feature
```
5. Abra um Pull Request.
---
## 📜 Licença
Este projeto está licenciado sob a licença MIT. Consulte o arquivo `LICENSE` para mais detalhes.
---
## 👥 Autores e Reconhecimento
- **Paulo Mauricio Pereira Patricio**: Idealizador e desenvolvedor deste projeto incrível!
- Desafio Challenge do Programa ONE - Oracle Next Educations (Grupo 8, fase 2).
- Inspirado em experiências compartilhadas e na diversão de celebrar momentos com amigos.
---
## 📩 Contato
Se tiver dúvidas ou sugestões, entre em contato:
- **Email**: [email protected]
- **LinkedIn**: [Seu Perfil](https://www.linkedin.com/in/paulomppatricio/)