Fauna Quiz

Jogo educativo com tematica da fauna brasileira, desenvolvido para auxiliar pessoas com deficiencias intelectuais na memorizacao e raciocinio logico.

Objetivos e Publico-Alvo

O Fauna Quiz foi projetado para ser uma ferramenta de apoio a aprendizagem inclusiva. O publico-alvo sao pessoas com deficiencias intelectuais que se beneficiem de:

• Interface simples, com alto contraste e elementos visuais claros.
• Botoes grandes com areas de clique generosas e feedback visual imediato.
• Fontes sans-serif legiveis e de alto contraste.
• Reproducao de audio narrativo para acompanhamento da historia.
• Reforco positivo ao completar cada fase.

Tecnologias Utilizadas

Camada	Tecnologia
Frontend	HTML5, CSS3 (Custom Properties), JavaScript ES6
Backend	PHP 8.x com PDO
Database	MySQL / MariaDB
Servidor	Apache (XAMPP / WAMP / LAMP)

Estrutura do Projeto

/
|-- assets/
|   |-- css/
|   |   |-- base.css          (Variaveis CSS, reset, botoes, utilitarios)
|   |   |-- aluno.css
|   |   |-- dashboard.css
|   |   |-- Historia.css
|   |   |-- index.css
|   |   |-- JOGO1.css
|   |   |-- Memoria.css
|   |   |-- pontuacao.css
|   |   |-- professor.css
|   |   |-- proxFase.css
|   |   |-- quiz.css
|   |-- js/
|   |   |-- aluno.js
|   |   |-- audio-manager.js  (Classe centralizada de audio)
|   |   |-- dashboard.js
|   |   |-- Historia.js
|   |   |-- login.js
|   |   |-- Memoria.js
|   |   |-- pontuacao.js
|   |   |-- proxFase1.js
|   |   |-- proxFase2.js
|   |   |-- quiz.js
|   |-- img/                  (Imagens dos animais e cenarios)
|   |-- audio/                (Narracoes em formato OGG)
|-- api/
|   |-- config.php            (Credenciais da base de dados)
|   |-- conexao.php           (Conexao PDO)
|   |-- salvar_pontuacao.php  (Endpoint para salvar pontuacao)
|   |-- relatorio.php         (Endpoint para listar pontuacoes)
|-- database/
|   |-- schema.sql            (Script SQL para criar a base de dados)
|-- pages/
|   |-- aluno.html
|   |-- dashboard.php
|   |-- Historia.html
|   |-- JOGO1.html
|   |-- Memoria.html
|   |-- pontuacao.php
|   |-- professor.html
|   |-- proxFase1.html
|   |-- proxFase2.html
|   |-- quiz.html
|-- index.html                (Pagina de entrada)
|-- README.md

Pre-requisitos

• XAMPP (ou WAMP, LAMP) com Apache e MySQL/MariaDB.
• PHP 8.0 ou superior.
• Navegador moderno (Chrome, Firefox, Edge) com suporte a ES6 e CSS Grid.

Guia de Instalacao

1. Inicie o XAMPP e ligue os servicos Apache e MySQL.

2. Copie a pasta do projeto para o diretorio htdocs do XAMPP:

   C:\xampp\htdocs\fauna-quiz\
   

3. Importe a base de dados:

   • Abra o phpMyAdmin (http://localhost/phpmyadmin).
   • Clique em "Novo" e crie uma base de dados chamada fauna_quiz (ou execute o script diretamente).
   • Aceda ao separador "SQL", cole o conteudo de database/schema.sql e execute.
   • Como alternativa, execute pelo terminal:

     mysql -u root < database/schema.sql
     

4. Configure as credenciais (se necessario):

   • Edite o ficheiro api/config.php e ajuste as constantes DB_USER e DB_PASS conforme a sua instalacao MySQL.

5. Aceda ao jogo no navegador:

   http://localhost/fauna-quiz/
   

Como Utilizar

Fluxo do Jogo (Aluno)

1. Na pagina inicial, clique em "Aluno".
2. Digite o nome (minimo 3 caracteres) e clique em "Jogar".
3. Na introducao, clique em "Iniciar Historia" para comecar a narrativa interativa com audio.
4. Navegue pela historia com os botoes "Anterior" e "Avancar".
5. Ao fim da historia, responda ao Quiz de 4 perguntas sobre a fauna brasileira (tempo limite: 5 minutos).
6. Apos o quiz, veja a mensagem de parabens e siga para o Jogo da Memoria.
7. Encontre todos os pares de animais no jogo da memoria.
8. A pontuacao (tempos) sera exibida e enviada para a base de dados.
9. Para jogar novamente, clique em "Reiniciar Jogo".

Dashboard (Professor)

1. Na pagina inicial, clique em "Professor".
2. Utilize as credenciais de teste:
   • Usuario: admin
   • Senha: admin
3. Sera exibida a tabela com todos os registos dos alunos, ordenados por data.
4. Clique em "Voltar" para regressar a pagina inicial.

Observacoes

• O audio reproduz automaticamente ao navegar pela historia e ao acertar as perguntas do quiz.
• Caso o bloqueio de autoplay do navegador impeça a reproducao, clique uma vez na pagina para ativar o som.
• As imagens dos animais utilizadas no jogo da memoria correspondem aos animais apresentados na historia.