Wordttery é um aplicativo de sorteio dinâmico baseado em palavras-chave (senhas). Desenvolvido como uma Single Page Application (SPA), o projeto permite gerenciar inscrições de participantes e realizar sorteios justos de forma rápida e intuitiva.
Este aplicativo foi projetado para facilitar sorteios em eventos, transmissões ao vivo ou grupos. A grande diferença do Wordttery para um aplicativo de sorteio comum é o uso de palavras-chave validadoras: para que um participante ganhe o sorteio, ele precisa ter preenchido corretamente as 3 palavras secretas (senhas) estipuladas pelo administrador do sorteio.
O aplicativo conta com uma interface moderna construída com Tailwind CSS, consumindo uma API própria muito leve feita em Node.js (Express) que armazena os dados localmente em um arquivo .json, garantindo segurança e persistência sem a necessidade de um banco de dados complexo.
- Configuração do Sorteio: O administrador utiliza o painel esquerdo para definir as 3 "Palavras Válidas" da rodada e clica em Salvar. (As palavras digitadas não ficam expostas).
- Inscrição: Os usuários preenchem o formulário com Nome, E-mail e as 3 palavras que eles acreditam ser as corretas. As palavras digitadas também são ocultadas por segurança.
- Persistência de Dados: Assim que um participante se inscreve, ele aparece na tabela à direita. Os dados das palavras são anonimizados no retorno visual (
***) para que ninguém copie as respostas uns dos outros. - Sorteio Justo: Ao clicar em "Sortear Agora", o sistema sorteia aleatoriamente um inscrito. Em seguida, ele verifica se as palavras fornecidas pelo inscrito coincidem com as palavras configuradas pelo administrador (ignorando diferenças de maiúsculas, minúsculas e acentuação).
- Se as palavras estiverem erradas, o sorteio é anulado e um novo deve ser feito.
- Se estiverem certas, o usuário é consagrado o vencedor na tela.
- Gerenciamento: O administrador pode remover inscritos individualmente na tabela, ou limpar o ganhador atual.
- Node.js instalado em sua máquina.
- Clone este repositório ou baixe os arquivos.
- No terminal, acesse a pasta do projeto e instale as dependências:
npm install
- Inicie o servidor local:
node server.js
- Acesse o aplicativo no seu navegador pelo endereço: http://localhost:3000
(Opcional) Para expor o projeto publicamente, você pode utilizar o ngrok rodando o comando correspondente e utilizando o arquivo ngrok.yml incluso.
MIT License
Copyright (c) 2026 Wordttery
A permissão é concedida, gratuitamente, a qualquer pessoa que obtenha uma cópia deste software e dos arquivos de documentação associados (o "Software"), para lidar com o Software sem restrições, incluindo, sem limitação, os direitos de usar, copiar, modificar, mesclar, publicar, distribuir, sublicenciar e/ou vender cópias do Software, e para permitir que as pessoas a quem o Software é fornecido o façam, sujeito às seguintes condições:
O aviso de copyright acima e este aviso de permissão devem ser incluídos em todas as cópias ou partes substanciais do Software.
O SOFTWARE É FORNECIDO "COMO ESTÁ", SEM GARANTIA DE QUALQUER TIPO, EXPRESSA OU IMPLÍCITA, INCLUINDO MAS NÃO SE LIMITANDO ÀS GARANTIAS DE COMERCIALIZAÇÃO, ADEQUAÇÃO A UM DETERMINADO FIM E NÃO INFRAÇÃO. EM NENHUM CASO OS AUTORES OU DETENTORES DOS DIREITOS AUTORAIS SERÃO RESPONSÁVEIS POR QUALQUER REIVINDICAÇÃO, DANOS OU OUTRA RESPONSABILIDADE, SEJA EM UMA AÇÃO DE CONTRATO, DELITO OU DE OUTRA FORMA, DECORRENTE DE, OU EM CONEXÃO COM O SOFTWARE OU O USO OU OUTRAS NEGOCIAÇÕES NO SOFTWARE.