Giter Club home page Giter Club logo

memory-game's Introduction

Introducción

El juego del Memory consiste en un número par de cartas con imágenes por un lado y el reverso de color genérico. Cada imagen aparece únicamente en dos de las cartas.

Memory Game Board

Cuando el juego comienza, todas las cartas están boca abajo. El jugador gira dos de las cartas, seleccionándolas mediante un click sobre ellas. Si las dos cartas tienen la misma imagen, se quedan boca arriba. En caso contrario recuperan su posición original después de un breve periodo de tiempo.

El objetivo del juego es conseguir dar la vuelta a todas las cartas en el menor número de intentos. Es decir, cuantos menos intentos mejor puntuación.

El cliente nos ha facilitado una versión no finalizada del juego, y nos pide que lo adaptamos a tecnologías modernas de desarrollo web que nos permita tener un código robusto y escalable

Requisitos

  • Los requerimientos se facilitan como historias de usuario dentro del trello: https://trello.com/invite/b/WFeFXnH9/ATTI2910f63594a6f6fbdddcea3f6a19753eB06ACF76/memory-f5.
  • La UI debe constar de tres pantallas: hero-intro, settings y game:
    • hero-INTRO
      • Hero-image con animación y botón start tras 2" de animación
    • settings
      • RadioButton para seleccionar dificultad del juego (+ tarjetas)
      • RadioButton para seleccionar temática del juego (al menos 2)
      • Formulario para elegir nombre de usuario y avatar
    • game
      • Ver siguiente apartado

Planificación del Juego

Para programar el juego, necesitarás recrear las partes físicas del mismo (el layout) e implementar las reglas del juego (la lógica). Este juego es una versión mono-jugador, lo cual simplifica la lógica en cierto modo.

💡 La clave es la organización. Mantén separadas la parte de código del layout y del interfaz de usuario por una parte y el código del juego por otro

El layout

  • Añade al html las partes que tendrá tu juego: El tablero, las cartas y la puntuación:
<!DOCTYPE html>
<html>
  <head>
    <title>Superhero Memory Game</title>
    <link type="text/css" rel="stylesheet" href="memory.css" media="screen">
  </head>
  <body>
  </body>
</html>

Si te fijas no hemos añadido un botón Start. En realidad no es necesario. Se pueden renderizar las cartas y crear un listener para comenzar el juego cuando el usuario clica en un elemento.

Añade los estilos

  • En la sección header, recuerda añadir el link to your CSS file.
<link type="text/css" rel="stylesheet" href="memory.css" media="screen">

El código

Echa un vistazo a los ficheros de inicio src/memory.js y src/main.js que recogen la lógica y las interacciones HTML/CSS respectivamente.

La lógica del juego

Usaremos los test de Jasmine para probar la lógica del juego, que es bastante simple. Necesitaremos sólo una claseMemoryGame com métodos para mezclar y comparar las cartas y para comprobar que el juego ha terminado

  • En primer lugar: Crea el método constructor de la clase MemoryGame. Recibirá por parámetro un array de cartas. Asígnalas a la propiedad this.cards. Necesitaremos también un array de cartas seleccionadas (this.pickedCards) para almacenar las cartas seleccionadas por el jugador y poder compararlas. Y, por último, dos propiedades: this.pairsClicked y this.pairsGuessed para añadir las parejas elegidas y las acertadas.

  • Crea el método para mezclar las cartas cada vez que se inicia un nuevo juego. Idea: Sería una buena idea implementar algún tipo de algoritmo similar al Algoritmo de Fisher-Yates.

_shuffleCard() {
};
  • Cuando un usuario selecciona dos cartas, necesitaremos comprobar si son la misma. Crearemos el método checkIfPair, que reciba dos parámetros que serán las dos cartas seleccionadas por el jugador. El método añadirá una de ellas a la propiedad pairsClicked y si las cartas son iguales entonces añade una al pairsGuessed. Esta función devolverá true o false según el resultado de la comparación de ambas cartas.
checkIfPair(firstCard, secondCard) {

};
  • Memory no tiene 'Game Over', sólo necesitamos una función 'Win' donde comprobar que la propiedad pairsGuessed ha alcanzado el número de parejas que existen.
finished() {
};

Interacciones HTML/CSS

Piensa en las interacciones entre el usuario y el juego: El usuario clicará los elementos de la página y recibirá un resultado según acertó o no la pareja.

  • Lo primero que necesitamos es utilizar la información para llenar las cartas del tablero. Este comportamiento queremos que se dispare tan pronto como se cargue la página. Así que lo añadiremos al evento 'onload' de la venta de forma dinámica.
addEventListener('load',function(){
});
  • La otra interacción importante es el listener del clic. Añádelo cuando se haya cargado el documento.
let back = document.querySelector('back');
back.addEventListener('click', function(){
});

Requerimientos técnicos

  • Desarrolla el front con React Vite + Vitest (intentad utilizar TDD para el desarrollo)
  • Dearrolla el back con nestjs
  • Buenas prácticas de arquitectura y programación.

Modalidades pedagógicas

  • Los equipos serán de 1, 2 o 3 personas, trabajando de forma individual o pair-programming.
  • El plazo para la realización del proyecto es de 6 días. Cada día habrá un hito que habrá que ir cubriendo.
  • El trabajo debe organizarse a través de kanban.
  • El repositorio inicial del proyecto está subido a github classroom y consta de dos ramas:
    • main con esta información y el starter-code de la versión javascript del juego
    • solution con el juego desarrollado en javascript
  • Se trabajará usando git-flow para el control del desarrollo.

Criterios de rendimiento

  • El objetivo del proyecto es repasar JavaScript, TypeScript, React y Nest.js + bbdd. Se puede utilizar cualquier recurso técnico de estas tecnologías pero sin comprometer el alcance.
  • Cada día habrá una puesta en común del resultado obtenido.
  • Siempre es recomendable que cada equipo encuentre la solución, pero si tenéis problemas con el desarrollo del juego podéis trabajar a partir de la rama solution.

memory-game's People

memory-game's Issues

AS A USER I WANT TO FLIP TWO CARDS AND COMPARE EACH OTHER SO THAT I CAN COMPLETE A CARDS PAIR GUESSED

Acceptance Criteria

  • I can see the card board displayed in the screen, then I can click any card and I will see the image behind the card.
  • I can click a second card then I will be update the pairs clicked value
  • After second card revealed both will turn down again if not paired.
  • After second card revealed both cards will remain visible and the pair guessed value increased.
  • I can play while unrevealed cards remain.

AS A DEVELOPER I WANT TO DEFINE THE ARQUITECTURE OF THE APPLICATION AND SET THE DEVELOPMENT ENVIRONMENT SO THAT WE CAN START WITH THE REST OF STORIES

Front-end Scaffolding

  1. install vite
  2. install vitest, jsdom, @testing-library
  3. install dependencies: usequery,...
  4. create folders, components and first tests
  5. set data folder with test data

Back-end scaffolding

  1. install nest and generate game resources
  2. connect mongo
  3. test services y controllers
  4. test database

Acceptance Criteria

  • starter tests for all frontend components work correctly
  • starter tests for all backend components work correctly

AS A USER I WANT TO SEE AN INTRO SO THAT I COULD BE MOTIVATED TO PLAY

When starting the user can see an animated image during 2 seconds
After 2'' image dessapears

Tasks

  1. search image
  2. hero component with animation
  3. after 2'' a button start should appear

Acceptance Criteria

  • When starting the user can see an animated image during 2 seconds
  • After 2'' the button start appears and I can click it to navigate to settings page

Recommend Projects

  • React photo React

    A declarative, efficient, and flexible JavaScript library for building user interfaces.

  • Vue.js photo Vue.js

    🖖 Vue.js is a progressive, incrementally-adoptable JavaScript framework for building UI on the web.

  • Typescript photo Typescript

    TypeScript is a superset of JavaScript that compiles to clean JavaScript output.

  • TensorFlow photo TensorFlow

    An Open Source Machine Learning Framework for Everyone

  • Django photo Django

    The Web framework for perfectionists with deadlines.

  • D3 photo D3

    Bring data to life with SVG, Canvas and HTML. 📊📈🎉

Recommend Topics

  • javascript

    JavaScript (JS) is a lightweight interpreted programming language with first-class functions.

  • web

    Some thing interesting about web. New door for the world.

  • server

    A server is a program made to process requests and deliver data to clients.

  • Machine learning

    Machine learning is a way of modeling and interpreting data that allows a piece of software to respond intelligently.

  • Game

    Some thing interesting about game, make everyone happy.

Recommend Org

  • Facebook photo Facebook

    We are working to build community through open source technology. NB: members must have two-factor auth.

  • Microsoft photo Microsoft

    Open source projects and samples from Microsoft.

  • Google photo Google

    Google ❤️ Open Source for everyone.

  • D3 photo D3

    Data-Driven Documents codes.