Usuario:ManuelRomero/ProgramacionWeb/INAEM2017/App MasterMind

Descripción del juego
https://es.wikipedia.org/wiki/Mastermind
 * Este juego consiste en encontrar una secuencia de colores previamente establecida
 * Aquí una descripción del juego
 * Nosotras vamos a hacer una versión un poco personal, adaptándola a unas especificaciones propias, pero basadas en la filosofía del juego
 * Vamos a realizar la aplicación estableciendo una serie de requisitos y abordandolos de uno en uno

RF1 Página inicial
Al conectornos a la página, veremos un mensaje de bienvenida con una pequeña especificación del juego y un botón para empezar que nos llevará a otra página jugar.php



Para la ventana se puede jugar con el css para dar al texto un poco de color.

En este caso he decidido crear un div de presentación y dar un poco de color a la lista de números, al h2 y al botón submit que me llevará a empezar el juego.

Un pantanllazo de la palicación



RF2 Empezar a jugar
Ahora vamos a ver qué código debemos de especificar para la página que vamos a tener en jugar.

Todas las acciones se realizarán en esta página o script.
 * Vamos a realizar la aplicación estableciendo una serie de requisitos y abordandolos de uno en uno


 * Antes de poder establecer la implementación de estos requisitos vamos a pensar en la pantalla que hemos de generar o el diseño gráfico, pasa establecer dónde van a visualzarse la información
 * Vamos a establecer tres partes gráficas en nuestro juego, identificadas cada una un un identificador de div (En la imagen #....), de modo que las contenidos que queremos que aparezcan en información deberán de ir en un div de informacion, como se especifica en el código siguiente




 * Ahora vamos a abordar cada una de las acciones

1.- Generar la clave Debemos de generar una combinación de colores que el usuario a de acertar. Esta combinación la llamaremos $clave y será un array de 4 colores. Los colores se establecerá a partir de una serie de colores previamente establecidos. Serán
 * Para impementar este requisito lo que tendremos que hacer es que si no existe la clave, la creamos y la guardamos en una variable de sesión, y si existe la leemos ya que la podremos necesitar posteriormente


 * La función genera_clave
 * Este requisito no genera ninguna salida para la página, por lo que no altera el contenido

2.- Visualizar la Clave Para este requisito debemos de tener una opción (botón) que cuando el usuario lo presione se pueda visualziar la clave.


 * El botón o input de tipo submit deberá de estar el la sección de opciones.
 * El contenido de la clave deberá de aparecer en la sección de información.
 * Estebleceremos también que el texto que aparezca en el botón cambie, de forma que cuando presionemos Mostrar clave nos muestre la clave y el texto del botón sea Ocultar clave. A la vez si presionamos Ocultar clave que ya no se muestre y aparezca el texto inicial. Para ello vamos a controlar con una variable el texto que aparece en el botón.
 * El código html para este botón
 * El contenido de la clave debe de aparecer en la sección de información
 * El código php que debe de tener la página para atender a esta solicitud
 * Ahora vamos a ver el código de la función mostrar_clave($clave).
 * Para que nos muestre a demás del texto,. un background del color, podemos jugar con el css. Estableceremos un css con los nombres de los colores (ver css más abajo), y así lo que retornará la función mostrar_clave(..)
 * Y el resultado
 * Con la opción de mostrar clave
 * Cuando hemos presionado y ahora muestra ocultar clave


 * 3.-Mostrar el menu de jugadas y botón para jugar
 * Para ello tenemos que mostrar un formulario con 4 opciones para que el usuario elija 4 colores y un botón para darle a jugar
 * El reusltado de dar a jugar lo implementaremos en el siguiente requisito.
 * Es importante que el formulario que generemos debe de estar en la sección de jugadas, para que aparezca ubicado en la sección que le hemos reservado en el diseño de la pantalla.
 * Vamos a usar una función que me devuelva un formulario, cada color lo seleccionaremos con un select ( un input desplegable con los colores permitidos)
 * Para que quede más vistoso, además del texto, cada opción tendrá un estilo en el class que se encargará de darle un color de fondo
 * La implementación de la función que retorna el formulario


 * Las opciones quedarán con colores



Observalo en el dibujo como van cambiando de color



Como hemos comentado, separamos las funciones en fichero independiente

RF3.- Jugar
Este requisito es la parte fundamental de la partida

Implicará que el usuario selecciona una jugada seleccionando los colores

Ya le hemos dado un aspecto visual para que seleccionar la jugada tenga un poco de color, para ello hemos usado el css y un poco de java script (nunca está mal recordar, se aprende para no olvidar y usar).

Ahora en nuestro script querremo considerar esta opcion (que le hemos dado a jugar), por lo que lo que queremos que ocurrra deberá estar en un Ahora vamos a contemplar los siguietnes requisitos

En ello queremos que la comparación nos aporte dos valores, el número de colores que hemos acertado, y de ellos cuantos los hemos especificado en la posición correcta. Para ello hacemos que la función nos devuelva el número de colores acertado, y para las posiciones vamos a pasar un parámetro por referencia para que quede modificado después de la ejecución de la función Ahora nos queda mostrar el resultado de la comparación
 * Leer la jugada
 * Para esto, tendremos que leer la jugada
 * Una vez leída, la guardamos en una variable de sesión y anotamos para el mensaje de información que esta es la jugada número (las que hayamos guardado hasta ahora
 * Para el concepto de la variable de sesión ver imagen al final del tema.
 * Ahora la comparamos con la clave.

Vamos a incluir en el mensaje un redondel negro por cada color acertado en posición y un redondel blanco por los colores acertados en posiciones erróneas. pondremos un número en cada redondel.



Además haremos que se muestren todos los resultados anteriores para permitir al usuario usarlo, aunque no le vamos a mostrar los colores que ha seleccionado de momento.

Para este cometido vamos a crear dos clases en css para generar los colores y una función que nos retorne todos los colores correspondientes a los aciertos (ver más abajo el css facilitado). Iremos también almacenando los resultados para mostrar el histórico, lo haremos en una variable de sesión llamada resultado.

Esta variable será un array indexado, donde cada posición será un array de dos posiciones, una indicará en número de posiciones podemos ver pos en la imagen acertadas (color y posicion), y el otro elemento especificará el número de colores podemos ver col en la imagenacertados en posición incorrecta



A continuación el código completando el anterior



RF4.- Valorar el resultado
Este requisito es bastante sencillo de implementar No implica interactuación con el usuario, por lo que no detallaremos caso de uso, simplemente si al realizar una jugada hemos terminado vamos a ir a otra pantalla que nos especificará el fin del juego Esta situación se producirá la realizar 16 jugadas o al acertar los colores y posiciones

En esta ventana de fin de juego informaremos de la situación (por qué hemos terminado el juego), y tras 5 segundos esta situación y redirigimos automáticamente a la ventana inicial. En este caso vamos a gestionar todas las acciones en un fichero finJuego.php

Este fichero recibirá por GET el número de posiciones acertadas y con este valor podremos discernir por qué motivo ha acabado el juego

También mostraremos todas las jugadas anteriores y el valor de la clave. Para ello vamos a revisar cual es el contendido de los valores que guardamos en la sesión que podemos ver en la siguiente imagen

Esta situación la consideraremos en cada jugada, por lo tanto está claro la sección del jugar.php donde la tenemos que poner



{{Plegable|hide|jugar.php con el requisito de evaluar jugada|

{{MRM_Recursos de la Web|Title=App de MisterMind implementación del requisito 3| }}
 * http://manuel.infenlaces.com/MasterMind/MasterMind4/index.php

RF5.- Mostrar jugadas o regenerar la clave
Vamos a añadir dos opciones junto con la de mostrar la clave.

Será ver las jugadas realizadas y poder volver a generar la clave.

Es importante ver el impacto que esto puede tener sobre nuestra aplicación.

Esta parte la dejamos como una mejora si la queréis implementar.