📜 Documentación 📜

Simulación de completado del album de figuritas mundial 2022 en JAVA. Proyecto realizado por Luciano Agustín Inama y Matias Avila para la materia Programacion III de la Universidad Nacional General Sarmiento.

Paquetes 📦

• Modelo
• Interfaces
• Vista
• Test
• Utilidades

Clases 📃

• Paquete Modelo

1. Album
2. Persona
3. FabricaDeSimulaciones
4. PaqueteFiguritasNormal
5. SimulacionUnaPersona
6. SimulacionVariasPersonasRegalo
7. SimulacionVariasPersonasIntercambio
8. SistemaDeSimulacion

• Paquete Interfaces

1. Generador
2. Observador
3. Simulacion

• Paquete Vista

1. InterfazSimuladorAlbum

• Paquete Test

1. PersonaTest
2. AlbumTest
3. SimulacionUnaPersona
4. SimulacionVariasPersonasRegaloTest
5. SimulacionVariasPersonasIntercambioTest

• Paquete Utilidades

1. GeneradorRandom
2. ObservadorPorConsola
3. GeneradorPrefijado

Descripción del modelo de interfaces [interfaces] ✍🏻

Interfaz Generador:

Contiene los nextInt y nextIntCExclusion, ambos utilizados para crear generadores.

Interfaz Observador:

Contiene el metodo notificar, el cual se utiliza en los observadores para generar salidas en consola.

Interfaz Simulacion:

Esta interfaz contiene todos los metodos que son utilizados en todas las simulaciones para el proceso de simulación.

Descripción de Responsabilidades de Clases [Modelo] ✍🏻

Clase Persona:

Encargada de las responsabilidades de una persona en la simulación. Las cuales son:

1. Rellenar su propio album.
2. Poder regalar figuritas si asi se lo requieren.
3. Poder intercambiar figuritas si asi se lo requieren. (Primeramente sin ninguna condicion particular todas las figuritas valen otra)

Clase Album:

Encargada de representar la entidad album de la simulacion. Su tarea es clara, representar un album de figuritas. Rellenarse, controlar figuritas repetidas, e indicar cuando ya tenga todas las figuritas pegadas.

Clase FabricaDeSimulaciones:

Encargada de fabricar cualquier tipo de simulacion solicitado.

Clase PaqueteFiguritasNormal:

Encargada de generar los paquetes de figuritas para completar el album, sin ninguna condición especial. Todas las figuritas tienen la misma posibilidad de salir, la elección de figuritas para el paquete es aleatoria.

Clase SimulacionUnaPersona:

Encargada de realizar la simulacion de completado de album de una sola persona. Responsable de dar la cantidad total de gasto de la persona para completar el album.

Clase SimulacionVariasPersonasRegalo:

Encargada de realizar la simulación de completado de album entre n personas donde si alguna tiene una figurita que otro necesita, se la regala sin pedir nada a cambio. Responsable tambien de dar la cantidad total de gasto de las personas para completar los n participantes cada uno su album.

Clase SimulacionVariasPersonasIntercambio:

Encargada de realizar la simulación de completado de album entre n personas donde se realizan intercambios de 1 a 1 figurita solo con la condición que las figuritas intercambiadas no las posean las personas que realizan el intercambio. Responsable además de dar la cantidad total de gasto de las personas para completar los n participantes cada uno su album.

Descripción de Responsabilidades de Clases [Utilidades] ✍🏻

Clase GeneradorPrefijado:

Encargada de crear un generador de numeros, el cual funciona con un rango especificado al momento de crearlo. Es utilizado en las clases de Test.

Clase GeneradorRandom:

Esta clase crea un generador de tipo Random, el cual contiene un metodo especial que genera numeros aleatorios y excluye uno pasado por parametro.

Clase ObservadorPorConsola:

Clase encargada de crear los observadores que utilizan los datos de la simulación y los muestran por consola.

Descripción del modelo de interfaces [Vista] ✍🏻

Clase InterfazSettingSimulacion:

La clase encargada de manejar todo el codigo que maneja la interfaz (Codigo usuario). La misma le permite al usuario seleccionar el tipo de simulacion que quiere, especificar parametros como cantidad de personas, cantidad de figuritas, precio, étc, para luego generar la simulacion y mostrar el resultado de la misma en pantalla.