O Gerador de Frases Aleatórias é uma aplicação web que combina uma API Flask robusta com um frontend moderno e interativo. Oferece quatro categorias distintas de frases para diferentes ocasiões e humores!

1. Acesse a página principal: http://localhost:5000
2. Clique em qualquer um dos 4 botões temáticos
3. Aproveite as frases aleatórias! 🎉

# Exemplos de requisições
curl http://localhost:5000/naos
curl http://localhost:5000/curiosidades
curl http://localhost:5000/frases_geek
curl http://localhost:5000/insultis
curl http://localhost:5000/desmotivacionais
curl http://localhost:5000/bomdia

• Python 3.8+
• pip (gerenciador de pacotes Python)

1. Clone o repositório

   git clone https://github.com/seu-usuario/gerador-frases-aleatorias.git
   cd gerador-frases-aleatorias

2. Crie um ambiente virtual (recomendado)

   python -m venv venv
   
   # Windows
   venv\Scripts\activate
   
   # Linux/Mac
   source venv/bin/activate

3. Instale as dependências

   pip install -r requirements.txt

4. Estruture os arquivos de dados

   projeto/
   ├── app.py
   ├── templates/
   │   └── index.html
   ├── static/
   │   └── css
   |   |   └── styles.css
   │   └── images
   |   |   └── apple-touch-icon.png
   |   |   └── favicon-16x16.png
   |   |   └── favicon-32x32.png
   |   |   └── og-image.png
   │   └── js
   |       └── app.js
   └── data/
       ├── naos.json
       ├── curiosidades.json
       ├── frases_geek.json
       └── insultis.json
       └── desmotivacionais.json
       └── bomdia.json
   

5. Execute a aplicação

   python app.py

6. Acesse no navegador

   http://localhost:5000
   

Para rodar a aplicação usando Docker/Podman: (substitua a palavra "docker" por "podman" nos comandos abaixo)

1. Construa a imagem Docker:

   docker build -t frases-aleatorias -f Containerfile .

2. Execute o container:

   docker run -d -p 5000:5000 --name frases-api frases-aleatorias

3. Acesse a aplicação:

   http://localhost:5000
   

Certifique-se de que o arquivo requirements.txt e todos os arquivos necessários estejam no diretório do projeto antes de construir a imagem.

O frontend foi desenvolvido com foco na experiência do usuário, oferecendo:

• Design Glassmorphism: Efeito de vidro fosco moderno
• Gradientes Animados: Fundo que muda de cor suavemente
• Partículas Flutuantes: Elementos visuais que dão vida à interface
• Animações Suaves: Transições elegantes em todos os elementos

• ✅ Responsivo: Funciona perfeitamente em desktop e mobile
• ✅ Loading States: Feedback visual durante o carregamento
• ✅ Tratamento de Erros: Mensagens amigáveis para problemas
• ✅ Contador: Acompanha quantas frases foram geradas
• ✅ Efeitos Hover: Interações visuais nos botões

Cada categoria possui sua própria identidade visual

Todos os endpoints possuem limitação de requisições para evitar abuso:

• Limite Global: 200/dia, 50/hora
• Limite por Endpoint: 5/segundo, 10/minuto

• 200: Sucesso
• 429: Limite de requisições excedido
• 500: Erro interno (arquivo não encontrado, JSON inválido, etc.)

• Flask: Framework web minimalista e flexível
• Flask-Limiter: Controle de rate limiting
• Python JSON: Manipulação de dados estruturados

• HTML5: Estrutura semântica moderna
• CSS3: Animações, gradientes e efeitos visuais
• Vanilla JavaScript: Funcionalidades interativas (sem dependências)
• Fetch API: Requisições assíncronas para a API

• JSON: Armazenamento estruturado das frases
• UTF-8: Suporte completo a caracteres especiais

1. Edite os arquivos JSON em /data/
2. Mantenha a estrutura existente:

   // Para naos.json, desmotivacionais.json e bomdia.json
   ["Sua nova frase aqui"]
   
   // Para science_facts.json
   [{"fact": "Seu fato científico aqui"}]
   
   // Para geek_quotes.json
   [{"quote": "Citação", "character": "Personagem", "source": "Fonte"}]
   
   // Para insultis.json
   [{"insult": "Seu insulto sutil aqui"}]

Edite as configurações no app.py:

limiter = Limiter(
    default_limits=["500 per day", "100 per hour"],  # Ajuste aqui
    # ...
)

@app.route('/endpoint')
@limiter.limit("10 per second;20 per minute")  # Ou aqui

O CSS está separado no diretório static/css para facilitar modificações. Principais variáveis para customizar:

• Cores dos botões: Classes .btn-naos, .btn-curiosidades, etc.
• Animações de fundo: Keyframe @backgroundShift
• Efeitos: Propriedades backdrop-filter, box-shadow

Contribuições são sempre bem-vindas! Para contribuir:

1. Fork o projeto
2. Crie uma branch para sua feature (git checkout -b feature/MinhaFeature)
3. Commit suas mudanças (git commit -m 'Adiciona MinhaFeature')
4. Push para a branch (git push origin feature/MinhaFeature)
5. Abra um Pull Request

• 🎯 Novas categorias de frases
• 🌍 Suporte a múltiplos idiomas
• 📊 Dashboard com estatísticas de uso
• 🔔 Sistema de favoritos
• 🎨 Novos temas visuais
• 📱 App mobile nativo

Este projeto está sob a licença MIT. Veja o arquivo LICENSE para mais detalhes.

Este projeto foi criado como uma forma divertida de praticar desenvolvimento web full-stack, combinando uma API robusta com um frontend moderno e interativo.

A ideia surgiu da necessidade de ter respostas criativas e elegantes para diferentes situações do dia a dia, desde recusar convites até quebrar o gelo em conversas!

Este projeto foi inspirado no repositório no-as-a-service, criado por hotheadhacker.

Foi reescrito completamente em Python, com frases traduzidas para o português e novos elementos adicionados.