Modulos y Casos de Uso

##Casos de Uso

##Modulo Ciudad

Definición Caso de Uso	CU-CIUDAD1
Nombre caso de uso:	Crear ciudad.
Actor:	Administrador.
Resumen:	El administrador crea en la BD de ciudades un nuevo registro con sus características básicas y la lista de eventos y sitios vacía.
Precondición:	No existe la ciudad a agregar.
Curso básico de eventos:	1. El administrador ingresa la información de la ciudad a crear.
	2. El sistema valida que esa ciudad no exista y que el nuevo ID a asignarle a la ciudad esté disponible.
	3. El sistema crea el nuevo registro de ciudad en la base de datos.
Poscondición:	La ciudad fue creada.
Caminos de excepción:	El administrador cancela la operación de creación.

Definición Caso de Uso	CU-CIUDAD2
Nombre caso de uso:	Crear evento en ciudad.
Actor:	Administrador.
Resumen:	El administrador crea un evento en determinada ciudad.
Precondición:	La ciudad en la que es el evento ya existe.
	El evento no existe en esa ciudad.
Curso básico de eventos:	1. El administrador selecciona la ciudad a la que se agregará el evento.
	2. El administrador ingresa la información del evento a crear.
	3. El sistema valida que el nuevo ID a asignarle al evento esté disponible.
	4. El sistema agrega el nuevo evento creado a la lista de eventos de esa ciudad.
Poscondición:	El evento es creado en la ciudad.
Caminos de excepción:	El administrador cancela la operación de creación.

Definición Caso de Uso	CU-CIUDAD3
Nombre caso de uso:	Crear sitio de interés en ciudad.
Actor:	Administrador.
Resumen:	El administrador crea un sitio de interés en determinada ciudad.
Precondición:	La ciudad en la que está el sitio de interés ya existe.
	El sitio de interés no existe en esa ciudad.
Curso básico de eventos:	1. El administrador selecciona la ciudad a la que se agregará el sitio de interés.
	2. El administrador ingresa la información del sitio de interés a crear.
	3. El sistema valida que el nuevo ID a asignarle al sitio de interés esté disponible.
	4. El sistema agrega el nuevo sitio de interés creado a la lista de sitios de esa ciudad.
Poscondición:	El sitio de interés es creado en la ciudad.
Caminos de excepción:	El administrador cancela la operación de creación.

Definición Caso de Uso	CU-CIUDAD4
Nombre caso de uso:	Actualizar información de ciudad, evento o sitio de interés.
Actor:	Administrador.
Resumen:	El administrador actualiza los datos de determinada ciudad, evento o sitio de interés.
Precondición:	La ciudad, evento o sitio de interés ya existe.
Curso básico de eventos:	1. El administrador selecciona la ciudad a actualizar.
	2. En caso de querer actualizar la ciudad, no hace nada.
	2. En caso de querer actualizar un evento o un sitio de interés, el sistema valida que el evento o sitio pertenezca a la ciudad escogida.
	3. El administrador ingresa la nueva información.
	4. El sistema valida que no se este cambiando el ID.
	5. El sistema actualiza los datos.
Poscondición:	La ciudad, evento o sitio de interés es actualizada.
Caminos de excepción:	El administrador cancela la operación de actualización.

Definición Caso de Uso	CU-CIUDAD5
Nombre caso de uso:	Borrar ciudad, evento o sitio de interés.
Actor:	Administrador.
Resumen:	El administrador borra determinada ciudad, evento o sitio de interés.
Precondición:	La ciudad, evento o sitio de interés ya existe.
Curso básico de eventos:	1. El administrador selecciona la ciudad.
	2. En caso de querer borrar un evento o un sitio de interés, el sistema valida que el evento o sitio pertenezca a la ciudad escogida.
	2. En caso de querer borrar una ciudad, el sistema borra toda la información de eventos y sitios de interés asociados a ella.
	3. El sistema borra los datos.
Poscondición:	La ciudad, evento o sitio de interés es borrada.
Caminos de excepción:	El administrador cancela la operación de eliminación.

Definición Caso de Uso	CU-CIUDAD6
Nombre caso de uso:	Calificar evento.
Actor:	Viajero registrado.
Resumen:	Un viajero que hubiera tenido un determinado evento dentro de su itinerario, da una calificación y opinión del mismo.
Precondición:	Viajero debe estar con sesión iniciada.
Curso básico de eventos:	1. El viajero selecciona el evento a calificar.
	2. El viajero introduce una calificación numérica en una escala de 1 a 5.
	3. El viajero introduce una breve descripción de su opinión del evento.
	4. El sistema valida que se hayan ingresado todos los datos.
	5. El sistema agrega la calificación a la lista de calificaciones de ese evento. La calificación incluye los datos básicos del usuario que la realiza.
Poscondición:	El evento fue calificado por el viajero.
Caminos de excepción:	El viajero cancela la operación de calificación.

Definición Caso de Uso	CU-CIUDAD7
Nombre caso de uso:	Calificar sitio de interés.
Actor:	Viajero registrado.
Resumen:	Un viajero que hubiera tenido un determinado sitio de interés dentro de su itinerario, da una calificación y opinión del mismo.
Precondición:	Viajero debe estar con sesión iniciada.
Curso básico de eventos:	1. El viajero selecciona el sitio de interés a calificar.
	2. El viajero introduce una calificación numérica en una escala de 1 a 5.
	3. El viajero introduce una breve descripción de su opinión del sitio de interés.
	4. El sistema valida que se hayan ingresado los datos introducidos.
	5. El sistema agrega la calificación a la lista de calificaciones de ese sitio de interés. La calificación incluye los datos básicos del usuario que la realiza.
Poscondición:	El sitio de interés fue calificado por el viajero.
Caminos de excepción:	El viajero cancela la operación de calificación.

Definición Caso de Uso	CU-CIUDAD8
Nombre caso de uso:	Editar calificación.
Actor:	Viajero registrado.
Resumen:	Un viajero que haya dado una calificación, la edita.
Precondición:	Viajero debe estar con sesión iniciada.
	Viajero ya había calificado previamente ese evento o sitio de interés.
Curso básico de eventos:	1. El viajero selecciona el evento o sitio de interés previamente calificado.
	2. El viajero edita la calificación numérica o la opinión.
	3. El sistema valida que no sean nulos estos campos.
	4. El sistema actualiza la calificación.
Poscondición:	La calificación fue actualizada por el viajero.
Caminos de excepción:	El viajero cancela la operación de actualización de calificación.

##Modulo Itinerario

Definicion Caso de Uso	CU-ITINERARIO1
Nombre caso de uso:	Crear itinerario.
Actor:	Viajero registrado.
Resumen:	El usuario crea un itinerario identificándolo con un nombre. El itinerario se crea dentro de un rango de fechas.
Precondición:	Viajero debe estar con sesión iniciada.
Curso básico de eventos:	1. El viajero le coloca un nombre al nuevo itinerario.
	2. El sistema valida que no haya otro itinerario con ese nombre.
	3. El viajero define el rango de fechas en las que quiere viajar.
	4. El sistema valida que la fecha inicial es anterior a la fecha final.
	5. El sistema agrega el itinerario a la lista de itinerarios, asociando a éste el viajero que lo creo.
Poscondición:	Se crea un nuevo itinerario para el viajero.
Caminos de excepción:	2. Se muestra la excepción "Ya existe itinerario con ese nombre".
	4. Se muestra la excepción "La fecha de inicio es posterior a la de fin".
	El viajero cancela la operación de creación.

Definición Caso de Uso	CU-ITINERARIO2
Nombre caso de uso:	Agregar ciudad a itinerario.
Actor:	Viajero registrado.
Resumen:	Un viajero agrega una nueva ciudad a su itinerario.
Precondición:	Viajero debe estar con sesión iniciada.
	El itinerario ya existe y pertenece al viajero.
Curso básico de eventos:	1. El usuario busca la ciudad que desea visitar.
	2. El usuario elige las fechas en las que va a visitar la ciudad.
	3. El sistema valida que la fecha inicial es anterior a la fecha final.
	4. El sistema valida que las fechas entren en el rango de fechas del itinerario.
	5. El sistema valida que en esas fechas no haya otra ciudad del itinerario.
	6. El sistema valida que la ciudad no exista ya en el itinerario.
	7. El sistema agrega la ciudad a la lista de ciudades de ese itinerario.
Poscondición:	La ciudad ha sido agregada al itinerario del viajero.
Caminos de excepción:	1. No existe la ciudad querida en la BD. Se cancela la operación.
	3. Se muestra la excepción "La fecha de inicio es posterior a la de fin".
	4. Se muestra la excepción "Las fechas no pertenecen al rango de fechas del itinerario".
	5. Se muestra la excepción "En esas fechas hay otra ciudad".
	4. Se muestra la excepción "Ya existe esa ciudad en el itinerario". Se cancela la operación.
	El viajero cancela la operación de agregación.

Definición Caso de Uso	CU-ITINERARIO3
Nombre caso de uso:	Agregar evento a ciudad de itinerario.
Actor:	Viajero.
Resumen:	El viajero agrega un evento a una determinada ciudad de un determinado itinerario.
Precondición:	El viajero debe estar registrado y logueado.
	El viajero es el creador del itinerario.
Curso básico de eventos:	1. El viajero selecciona la ciudad previamente agregada de su itinerario.
	2. El viajero busca los eventos de esa ciudad y selecciona el deseado.
	3. El viajero escoge la fecha en la que visitará ese evento.
	4. El sistema verifica que la fecha ingresada este dentro de la fecha de visita a la ciudad.
	5. El sistema verifica que en la fecha ingresada no haya otro sitio de interés o evento.
	6. El sistema verifica que el evento no se encuentre ya en esa ciudad.
	7. El viajero agrega el evento a la ciudad de su itinerario.
Poscondición:	Un evento es agregado a una ciudad de un itinerario.
Caminos de excepción:	Si alguna de las validaciones falla se muestra un mensaje al viajero y se cancela la operación.
	El viajero cancela la operación de agregación.

Definición Caso de Uso	CU-ITINERARIO4
Nombre caso de uso:	Agregar sitio de interés a ciudad de itinerario.
Actor:	Viajero.
Resumen:	El viajero agrega un sitio de interés a una determinada ciudad de un determinado itinerario.
Precondición:	El viajero debe estar registrado y logueado.
	El viajero es el creador del itinerario.
Curso básico de eventos:	1. El viajero selecciona la ciudad previamente agregada de su itinerario.
	2. El viajero busca los sitios de interés de esa ciudad y selecciona el deseado.
	3. El viajero escoge la fecha en la que visitará ese sitio de interés.
	4. El sistema verifica que la fecha ingresada este dentro de la fecha de visita a la ciudad.
	5. El sistema verifica que en la fecha ingresada no haya otro sitio de interés o evento.
	6. El sistema verifica que el sitio de interés no se encuentre ya en esa ciudad.
	7. El viajero agrega el sitio de interés a la ciudad de su itinerario.
Poscondición:	Un sitio de interés es agregado a una ciudad de un itinerario.
Caminos de excepción:	Si alguna de las validaciones falla se muestra un mensaje al viajero y se cancela la operación.
	El viajero cancela la operación de agregación.

Definicion Caso de Uso	CU-ITINERARIO5
Nombre caso de uso:	Crear linea de tiempo de itinerario.
Actor:	Viajero registrado.
Resumen:	El usuario crea la linea de tiempo de un itinerario suyo.
Precondición:	Viajero debe estar con sesión iniciada.
	El itinerario existe y el viajero es su creador.
Curso básico de eventos:	1. El viajero selecciona el itinerario del cual quiere la linea de tiempo.
	2. El viajero selecciona la opción de creación de línea de tiempo.
	3. El sistema crea la línea basado en las ciudades, eventos y sitios que el viajero a agregado previamente al itinerario.
Poscondición:	Se crea una línea de tiempo para el itinerario determinado.
Caminos de excepción:	El viajero cancela la operación de creación.

Definición Caso de Uso	CU-ITINERARIO6
Nombre caso de uso:	Actualizar información de itinerario, ciudad, evento o sitio de interés.
Actor:	Viajero registrado.
Resumen:	El viajero actualiza los datos de determinado itinerario, ciudad, evento o sitio de interés.
Precondición:	El itinerario, ciudad, evento o sitio de interés ya existe.
	El viajero debe estar registrado y logueado.
Curso básico de eventos:	1. El viajero selecciona el itinerario a actualizar.
	2. En caso de querer actualizar el itinerario, no hace nada.
	2. En caso de querer actualizar la ciudad, el sistema valida que la ciudad pertenezca al itinerario escogido.
	2. En caso de querer actualizar un evento o un sitio de interés, el sistema valida que el evento o sitio pertenezca a la ciudad escogida.
	3. El viajero ingresa la nueva información.
	4. El sistema valida que no se este cambiando el ID.
	5. El sistema actualiza los datos.
Poscondición:	El itinerario, ciudad, evento o sitio de interés es actualizado.
Caminos de excepción:	El viajero cancela la operación de actualización.

Definición Caso de Uso	CU-ITINERARIO7
Nombre caso de uso:	Borrar itinerario, ciudad, evento o sitio de interés.
Actor:	Viajero registrado.
Resumen:	El viajero borra determinado itinerario, ciudad, evento o sitio de interés.
Precondición:	La ciudad, evento o sitio de interés ya existe.
	El viajero debe estar registrado y logueado.
Curso básico de eventos:	1. El viajero selecciona el itinerario.
	2. En caso de querer borrar un evento o un sitio de interés, el sistema valida que el evento o sitio pertenezca a la ciudad escogida.
	2. En caso de querer borrar una ciudad, el sistema valida que la ciudad pertenezca al itinerario escogido. Luego, borra toda la información de eventos y sitios de interés asociados a ella.
	2. En caso de querer borrar un itinerario, el sistema borra toda la información de ciudades asociadas a el.
	3. El sistema borra los datos.
Poscondición:	El itinerario, ciudad, evento o sitio de interés es borrado.
Caminos de excepción:	El viajero cancela la operación de eliminación.

##Modulo Viajero

Definicion Caso de Uso	CU-VIAJERO1
Nombre caso de uso:	Crear usuario.
Actor:	Viajero no registrado.
Resumen:	Un viajero que quiera usar el servicio crea una cuenta personal para ese fin
Precondición:
Curso básico de eventos:	1. El viajero selecciona la opción de crear cuenta.
	2. El viajero introduce un correo.
	3. El sistema valida que este correo no esté en uso por otro viajero.
	4. El usuario introduce sus datos personales.
	5. El usuario introduce una contraseña.
	6. El usuario introduce la confirmación de la contraseña.
	7. El sistema valida que las 2 contraseñas coincidan.
	8. El sistema le crea una nueva cuenta al viajero.
Poscondición:	El viajero tiene nueva cuenta.
Caminos de excepción:	Paso 3: El correo introducido ya está en uso. Debe introducir otro.
	Paso 7: Las contraseñas no coinciden. Debe volver a escribirlas.
	El viajero cancela la creación.

Definicion Caso de Uso	CU-VIAJERO2
Nombre caso de uso:	Actualizar información de la cuenta.
Actor:	Viajero registrado.
Resumen:	Un viajero actualiza su información personal.
Precondición:	El viajero esta con sesión iniciada.
Curso básico de eventos:	1. El viajero selecciona la opción de editar cuenta.
	2. El viajero cambia sus datos personales.
	3. El sistema valida que no deje datos nulos.
	4. El sistema valida que no cambie el correo electrónico.
	5. El sistema actualiza la información del viajero.
Poscondición:	El viajero tiene su cuenta actualizada.
Caminos de excepción:	Paso 3: Hay datos nulos. Debe llenarlos todos.
	Paso 4: Intenta cambiar el correo. No lo deja continuar la operación.
	El viajero cancela la actualización.