Acá hay gato encerrado...

• 0) Habitación inicial. Tiene como acciones
  • Ir a 1
  • Ir a 2
• 1) Tiene como acciones
  • ir a 0
  • Ir a 3
  • Agarrar item: llave mística
• 2) Tiene como acciones
  • Ir a 0
  • Agarrar item: piedra
• 3) Tiene como acciones
  • Ir a 1
  • Ir a 6
  • Usar item: llave mística =habilita=> Ir a 4
• 4) Tiene como acciones
  • Ir a 3
  • Ir a 7
  • Usar item: piedra =habilita=> Agarrar item punta de pala
• 5) Tiene como acciones
  • Ir a 5
  • Agarrar item: clavos
• 6) Tiene como acciones
  • Ir a 3
  • Usar item: punta de pala =habilita=> Ir a 9
  • Usar item: llave mística =habilita => Ir a 5
• 7) Tiene como acciones
  • Ir a 4
  • Agarrar item madera
• 8) Tiene como acciones
  • Ir a 9
  • Salir del laberinto
• 9) Tiene como acciones
  • Ir a 6
  • Usar item madera =habilita=> Ir a 8

Para que un jugador supere este laberinto bien podría:

1. Ir a 2
2. Agarrar piedra
3. Ir a 0
4. Ir a 1
5. Agarrar llave mística
6. Ir a 3
7. Usar llave mítica
8. Ir a 4
9. Usar piedra
10. Agarrar punta de pala
11. Ir a 7
12. Agarrar madera
13. Ir a 4
14. Ir a 6
15. Usar punta de pala
16. Ir a 9
17. Usar madera
18. Ir a 8
19. Salir del laberinto

Ayudas para encarar el problema

Para que sea mas simple de entender algunos computines nos regalaron algunas horas de su tiempo y nos ayudaron a masticar un poco el problema, el resultado de lo que estuvieron haciendo es un bosquejo con un poco de inspiración en historias de usuario que dejamos a continuación:

• Como administrador del sistema quiero
  • crear, modificar y eliminar laberintos
  • crear (modificar y eliminar) habitaciones que admitan distintas acciones
    • marcar habitación como inicial
    • marcar habitación como final
    • crear acción de ir a otra habitación
    • crear acción de agarrar un item
    • crear acción de usar un item y definir que acción tiene como consecuencia
• Como participante quiero
  • elegir un laberinto para poder jugarlo
  • realizar acciones disponibles dentro de las habitaciones:
    • moverme a la habitación permitida
    • agarrar un item disponible
    • usar un item permitido
    • salir del laberinto
  • conocer el inventario con el que cuento mientras estoy jugando
  • abandonar un laberinto
  • ver los laberintos que superé y los que abandoné

NOTAS: Es importante darnos cuenta que no es lo mismo un laberinto configurado (listo para que alguien lo juegue) que un laberinto que está siendo recorrido. Los laberintos se recorren por jugador pero el juego de uno no influye en el juego del otro.

Entrega 1: Cliente de escritorio

Nuestro objetivo es tener una aplicación de escritorio que permita al administrador configurar laberintos

NOTA: Las pantallas son sugerencias, pueden modificarlas, pero para este primer trabajo práctico tienen que consultar las modificaciones con alguno de los docentes de la materia.

Sugerencia para realizar el Trabajo Práctico: Realizar todas las pantallas de Agregar acciones y por último realizar la Pantalla Inicial.

Pantalla inicial

Para eso crearemos una pantalla inicial que mostrará el nombre del Administrador (en este caso Juan). Es opcional crear una pantalla previa que permita un loggeo de Usuario.

La pantalla tendrá los laberintos creados en el sistema (en el caso de la primera vez, la lista estará vacía).

Edición: Si el usuario selecciona un laberinto, automáticamente, en el lado derecho aparecerá su nombre y las habitaciones que tiene (si no tiene ninguna habitación, la lista aparecerá vacía). El nombre puede editarse y se reflejará ese cambio inmediatamente en el listado de Laberintos.

Borrado: Si, teniendo un laberinto seleccionado, se clickea el botón "Quitar laberinto", se eliminará el mismo de la lista y todos los campos de la derecha aparecerán vacíos.

Agregado: Cuando el usuario clickea el botón "Agregar laberinto", aparecerá un nuevo elemento en el listado laberintos y su nombre podrá modificarse igual que en la edición.

Las habitaciones funcionarán igual que los laberintos:

Edición: Al seleccionar una habitación, del lado derecho aparecerán todos campos (Nombre, si es habitación inicial, si es habitación final y las acciones) completos permitiendo modificaciones.

Borrado: Si, teniendo una habitación seleccionada, se clickea el botón "Quitar habitación", se eliminará la misma de la lista y todos los campos de la derecha aparecerán vacíos.

Agregado: Cuando el usuario clickea el botón "Agregar habitación", aparecerá un nuevo elemento en el listado "Habitaciones de:" y su nombre podrá modificarse igual que en la edición.

Realizar todos los controles que crean necesarios (por ejemplo: no permitir varias habitaciones finales)

Pantalla de agregar acción

Cuando en la pantalla anterior se clickea el botón "Agregar acción", se abrirá la siguiente pantalla:

La misma cuenta con 3 botones que nos llevarán cada uno a una configuración de cada acción.

Pantalla de agregar acción: Ir a otra habitación

Esta pantalla contará con un desplegable que listará todas las habitaciones actualmente creadas. Una vez que el usuario seleccione la que desea, deberá clickear el botón "Agregar" para efectivamente agregar la acción de ir a la habitación elegida dentro de la habitación seleccionada.

Pantalla de agregar acción: Agarrar un elemento

Esta pantalla contará con un campo que permitirá escribir el elemento que aparecerá. Una vez que el usuario clickee el botón "Agregar", se agregará la acción de agarrar el elemento escrito dentro de la habitación seleccionada.

Pantalla de agregar acción: Usar un elemento

Esta pantalla contará con un desplegable que listará todos los elementos creados en el laberinto hasta ahora (Atención! No deben aparecer elementos de otros laberintos).

El usuario deberá obligatoriamente crear una acción para que se corresponda con lo que habilitará el elemento seleccionado. Para esto tendrá que clickear en el botón "Agregar acción" que abrirá la pantalla de "Agregar acción" (la que permite clickear en los tres botones).

Una vez que el usuario termine de crear la acción se mostrará en este lugar la acción creada.

Cuando el usuario clickee el botón "Agregar", se agregará la acción de Usar el elemento seleccionado habilitando la acción creada dentro de la habitación seleccionada.

Entrega 2: Cliente web + Servidor REST

Nuestro objetivo es tener una página web que permita resolver laberintos

Alternativa MPA

La alternativa a SPA es Multi Page Application. La idea es que cambia el contenido entero de la página y no solo una parte.

Selección de Laberinto (lobby)

Desde esta página podemos ver los laberintos disponibles para jugar y también una descripción de los mismos. Tener presente que pueden ser más o menos de tres laberintos.

Abandonar Laberinto

Cuando un jugador decide abandonar el laberinto, se muestra esta ventana de confirmación. Si acepta vuelve a la pantalla de seleccionar laberinto. Si cancela no tiene efecto.

Entrega 3: Cliente mobile

Nuestro objetivo es tener una aplicación mobile que permita visualizar los laberintos y posible y gestionar nuestro inventario.

Para ello debe:

1. Codificar las pantallas necesarias
2. Crear los servicios que sean necesario agregar a la api rest actual

Aclaraciones:

• Las pantallas son solo un mockup, no es un maquetado final de como debería de quedar (si deben contener los elementos que se describen, pero no es necesario que sea identico a la foto)
• Si en el modelo actual mantienen un inventario por Laberinto y no un inventario general el boton para consultar el inventario debe estar en la pantalla de Detalles del laberinto.

Laberintos disponibles

Detalles del laberinto

Gestionar Inventario

Criterios de corrección - Interfaz Desktop: Arena

Condiciones mínimas de aprobación

• Test, al menos un tests para las funcionalidades:
  • Crear laberinto
  • Agregar acción al laberinto
• Bindings:
  • Labels: al menos un label bien bindeado
  • Lista:
    • item seleccionado
    • items posibles
• Pantallas
  • Crear acciones
  • Crear accion usar
  • Crear acción agarrar
  • Crear acción pasar a otra habitación
• Toda la lógica de dominio en el proyecto de dominio, a lo sumo una condición para decidir si abrir una ventana u otro pero nada más
• App model en la vista de crear laberinto

OJO: Que no haya código repetido en la vista

Condiciones mínimas de promoción

• Inicialización en el objeto application
• Pantallas
• Crear laberinto
• Al menos un buen mensaje de error / notificación

Para el 10

• Buen modelado del dominio
  • Habitaciones
  • Diferentes acciones
• Ningún error en ejecución, todo bien anotado con @Observable, los getters y setters bien definidos
• Validaciones con bindings sobre propiedades que se actualizan disparando los eventos que correspondan
• Sin repetición de lógica en la creación de los componentes visuales
• Usar el info de los diálogos o a lo sumo una ventana que muestre un mensaje de error y se pueda cerrar
• Trabajar sobre la disposición de los elementos visuales con los layouts
• App models en el proyecto de dominio, en un package separado.

Criterios de corrección - Interfaz Web: Angular

Condiciones mínimas de aprobación

• Test: al menos un test en el dominio para las funcionalidades
  • Jugar un laberinto (iniciar el laberinto y simular jugar)
  • Realizar una acción
• Bindings:
  • Labels: al menos un label bien bindeado
  • Lista de laberintos
    • Laberinto seleccionado
      • Cambie el laberinto al jugar
    • Laberintos posibles
      • Ver todos los posibles laberintos para elegir
• Pantallas
  • Tengan una vista medianamente decente
• Toda la lógica de dominio en el proyecto de dominio, a lo sumo una cosita mínima, pero nada más en el controller
• Servicios (ambos con los datos pedidos)
  • Listado de laberintos: llamar al servicio al entrar
  • Jugar un laberinto: llamar al servicio al clickear el botón Jugar
  • Mantener los cambios de estado tanto en el modelo como en la vista (ejemplo: al iniciar un laberinto, el laberinto actual del jugador que está en el server es el laberinto seleccionado)
  • Que no se mande el objeto de dominio (podría mandar algun dato de más pero seguro no el objeto como viene)

Condiciones mínimas de promoción

• Incluye el resultado el del juego: ganaste - perdiste - etc (se informa) con toda la lógica relacionada (en el server)
• Las acciones disponibles se muestran bien al cambiar de habitación
• Implementación correcta de cambiar habitación / agarrar o usar un item
• Los 3 servicios pedidos funcionando correctamente
• Mostrar las imágenes del laberinto correctamente

Para el 10

• Ningún error en ejecución
• Validaciones con mensajes de error bien manejados a través de los servicios
• CSS y HTML claros, uso de boostrap (css ++)
• Separación en varios controllers