Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/hugojunior/quizeiro
Esta plataforma possibilita a criação ilimitada de jogos personalizados com suas próprias perguntas e respostas, para que você possa compartilhá-los com seus amigos.
https://github.com/hugojunior/quizeiro
educational game javascript laravel mysql phaser php quiz quizapp tailwindcss uni7
Last synced: 4 days ago
JSON representation
Esta plataforma possibilita a criação ilimitada de jogos personalizados com suas próprias perguntas e respostas, para que você possa compartilhá-los com seus amigos.
- Host: GitHub
- URL: https://github.com/hugojunior/quizeiro
- Owner: hugojunior
- Created: 2023-09-19T15:59:43.000Z (about 1 year ago)
- Default Branch: main
- Last Pushed: 2024-06-03T04:17:50.000Z (6 months ago)
- Last Synced: 2024-06-03T17:26:49.171Z (6 months ago)
- Topics: educational, game, javascript, laravel, mysql, phaser, php, quiz, quizapp, tailwindcss, uni7
- Language: PHP
- Homepage: http://quizeiro.games/
- Size: 8.68 MB
- Stars: 4
- Watchers: 2
- Forks: 0
- Open Issues: 1
-
Metadata Files:
- Readme: README.md
Awesome Lists containing this project
README
# Quizeiro
Quizeiro é uma plataforma gratuita que permite que os usuários criem seus próprios quizzes personalizados e os compartilhem com amigos.
> [!NOTE]
> Este projeto é parte integrante da disciplina de Estágio II do Curso de Sistemas de Informação na [UNI7](https://www.uni7.edu.br/).
## Vantagens
- Seguro
- Gratuito
- Divertido
- Placar Dinâmico
- Sem Propagandas
- Ativação Imediata
- Quizzes Ilimitados
- Relatórios Completo
- Links Compartilháveis
- Agendamento de Quiz
- Quizzes Públicos e Privados
- Integração com ChatGPT para Geração de Perguntas
## Estrutura do projeto
O projeto é dividido em três partes:
1. **Ambiente inicial** - O espaço onde você se familiariza com o projeto e pode criar sua conta.
2. **Ambiente administrativo** - O ponto de acesso onde você faz login e gerencia seus quizzes.
3. **Ambiente do quiz** - O espaço gerado ao criar um quiz, juntamente com o link a ser compartilhado para permitir a participação das pessoas.
## Regras de pontuação
O cálculo da pontuação é determinado pela quantidade de perguntas respondidas corretamente e pelo tempo restante. Assim, cada pergunta respondida corretamente adiciona 20 pontos proporcionalmente, enquanto cada segundo restante acrescenta 1 ponto.
## Instalação do projeto
O projeto roda usando o framework [Laravel](https://laravel.com/) e está configurado para ser executado usando [Docker](https://docs.docker.com/get-docker/). Portanto, é essencial ter o Docker instalado para que funcione corretamente.
> [!WARNING]
> Antes de executar o projeto, assegure-se de que as seguintes portas estejam disponíveis em sua máquina ou altere a configuração no arquivo [docker-composer.yml](docker-compose.yml): 80 (Nginx), 3306 (MySQL) e 6379 (Redis).
### Clonando o repositório
```bash
git clone [email protected]:hugojunior/quizeiro.git
```
### Entrando na pasta do projeto
```bash
cd quizeiro
```
### Definindo o arquivo com variáveis de ambiente
```bash
cp laravel/.env.example laravel/.env
```
### Rodando docker
```bash
docker compose --env-file laravel/.env up -d
```
### Acessando o container
```bash
docker compose --env-file laravel/.env exec quizeiro bash
```
### Dentro do container: Rodando composer (instalação de dependências)
```bash
cd laravel && composer install
```
### Dentro do container: Rodando migrations (estrutura do banco de dados)
```bash
php artisan migrate
```
Se todos os passos foram seguidos corretamente nessa ordem, você deve conseguir acessar a aplicação usando `http://localhost` ou `http://127.0.0.1`.
> [!NOTE]
> Você pode configurar um domínio local no arquivo `/etc/hosts`. Exemplo: 127.0.0.1 quizeiro.local
## Contato e suporte
Em caso de dúvidas sobre o projeto ou dificuldades na execução de alguma tarefa, sinta-se à vontade para entrar em contato comigo por [e-mail](mailto:[email protected]).