Skip to content

tamillycosta/MathX

Repository files navigation

Mathx: Exercise Generator

1. Visão Geral

O Mathx é uma plataforma interativa e um pequeno jogo educativo, focado na geração de desafios de matemática básica. O objetivo do projeto é proporcionar uma experiência prática de aprendizado, ao mesmo tempo que explora conceitos fundamentais do framework Laravel, como:

  • Controllers
  • Views
  • Routes
  • Middlewares
  • Blade Template: herança de templates e componetes

Este projeto serve como uma base para entender e aplicar esses conceitos em uma aplicação web simples, mas funcional.

2.1. Requisitos do Sistema

  • PHP: 8.0 ou superior
  • Laravel: 9.x

2.2. Dependências

  • Composer: composer install
  • NPM: npm install

3. Funcionalidades do projeto

A plataforma oferece uma maneira interativa de testar conhecimentos nas operações básicas de matemática, como soma, subtração, multiplicação, divisão e potenciação.

Modo Gerador de Exercícios

Permite a geração de exercícios para as operações mencionadas. Com ele, é possível:

  • Gerar Exercícios: Os usuários podem gerar questões de até 100 operadores, com valores variando de 1 a 999.
  • Impressão e Download: É possível baixar ou imprimir os exercícios gerados.
  • Respostas para Gabarito: Cada exercício vem acompanhado de um conjunto de respostas, facilitando a correção.
  • Quantidade de Questões: O sistema permite gerar até 100 questões por vez, proporcionando uma experiência de prática flexível e escalável.

Modo Game

  • Desafios Interativos: O usuário é desafiado a resolver questões de soma, subtração, multiplicação, divisão e potênciação em um formato de jogo.
  • Pontuação e Feedback: A cada resposta correta, o usuário ganha pontos. Feedback imediato é fornecido para respostas erradas, permitindo o aprendizado contínuo.
  • Níveis de Dificuldade: O modo game permite ajustar a dificuldade das questões, com base nas operações envolvidas.

4. Implementaçaõ do projeto

O projeto segue a arquitetura MVC do Laravel, com a implementação de Services como o PartnerService para gerar exercícios e validar respostas.

4.1 Services

Foram desenvolvidos submódulos responsáveis pela construção dos exercícios e das perguntas utilizadas no jogo, gerando as entidades de Operações e Levelsdos desafios.

About

Este repositório contém um projeto desenvolvido com o objetivo de aprimorar técnicas no ecossistema básico do framework Laravel.

Resources

Stars

Watchers

Forks

Releases

No releases published

Packages

 
 
 

Contributors