3 - Documento de Especificación de los Requerimientos del Sistema.

a  Especificación del Sistema Completo (SyRS)

b  Casos de Uso

1. PROPÓSITO

En este documento se detallarán los siguientes 3 casos de uso:

• Compra de boleto vía web. (no incluye la compra de boleto via App Mobile) 

• Registro de una nueva parada en una línea.

• Consulta del estado de los boletos de una boletera por parte de un cliente vía web. (no incluye la consulta de estado de boletos via App Mobile).

1. Diagrama de Casos de Uso

Diagrama de las 3 funcionalidades que se pide detallar sus casos de uso.

 

b.1 Compra de boleto vía web. (no incluye la compra de boleto via App Mobile)

 

1. Diagrama del Caso de Uso

2. Detalle del Caso de Uso

NOMBRE	Comprar boleto vía Web.
CASO DE USO NO.	##
DESCRIPCIÓN	Este caso de uso permite a un cliente registrado en el sistema adquirir un boleto o pasaje utilizando la aplicación web de la empresa “Tren Alto”.
ACTORES	Cliente/Pasajero
PRIORIDAD	Alta
ESTADO DEL DESARROLLO
PUNTOS DE EXTENSIÓN
PUNTOS DE INCLUSIÓN
PRECONDICIONES	El pasajero tiene tarjeta.
POSTCONDICIONES	El pasajero adquiere recibo por compra web de boleto o carga de la tarjeta con 25 o con 50 boletos/pasajes..
EVENTO DISPARADOR	Intención del cliente/pasajero de adquirir un boleto vía web. Ingreso a la aplicación web.

FLUJO PRINCIPAL	PASO	ACCIÓN
	1	El Cliente ingresa a la aplicación web del sistema de trenes “Tren Alto Web”.
	2	El Sistema despliega la pantalla de logueo.
	3	El Cliente ingresa usuario y password (correctos).
	4	El Sistema valida las credenciales, que como son correctas permite continuar con la transacción, y despliega la pantalla donde se muestra un menú con las funcionalidades que podrá realizar el cliente en esta modalidad web (en una primera instancia se mostrarán las 3 funcionalidades correspondientes a los 3 casos de uso que se detallan en esta documento).
	5	El Cliente selecciona del menú la opción “Comprar boleto vía Web”.
	6	El Sistema despliega la pantalla de ingreso de los datos correspondientes al medio de pago seguro.
	7	El Cliente ingresa todos los datos requeridos correspondientes a un medio de pago seguro.
	8	El Sistema valida que se hayan completado todos los datos del medio de pago, y despliega en la misma pantalla los campos necesarios para completar la transacción mostrando como primer campo la lista de opciones de compra: “Comprar boleto para línea y día específico” y “Cargar tarjeta”.
	9	El Cliente selecciona “Comprar boleto para línea y día especifico”.
	10	El Sistema despliega los campos para mostrar las líneas y los días en modo calendario.
	11	El Cliente selecciona la línea y el día y da Confirmar transacción.
	12	El Sistema valida el medio de pago, registra el boleto en el sistema y emite un comprobante de pago, que es enviado al cliente por mail.
	13	El caso de uso termina con el Cliente recibiendo un mail con el comprobante de pago del boleto adquirido.

FLUJO ALTERNATIVO  A1	PASO	ACCIÓN
		Continúa luego del paso 9 del Flujo Principal.
	10	El Sistema valida el medio de pago, registra el boleto en el sistema y emite un comprobante de pago en formato QR que es enviado al cliente por SMS.
	11	El caso de uso termina con el Cliente recibiendo un mensaje SMS con el código QR, siendo este el comprobante de pago del boleto adquirido.
FLUJO ALTERNATIVO A2	PASO	ACCIÓN
		Continua luego del paso 8 del Flujo Principal
	9	El Cliente selecciona “Cargar tarjeta”.
	10	El Sistema muestra en pantalla una lista con las opciones: “25 unidades” y “50 unidades”.
	11	El Cliente selecciona “25 unidades” y confirma la transacción.
	12	El Sistema valida el medio de pago, carga en la tarjeta del cliente 25 boletos/pasajes y despliega en pantalla un mensaje de “Carga de 25 boletos/pasajes realizada con éxito”. Además envía un mensaje SMS al Cliente con el código QR comprobante de pago de la compra efectuada.
	13	El caso de uso termina con la tarjeta/boletera del Cliente cargada con 25 boletos/pasajes y recibiendo un mensaje SMS con el código QR, siendo este el comprobante de pago de la compra efectuada.
FLUJO ALTERNATIVO A3	PASO	ACCIÓN
		Continua luego del paso 8 del Flujo Principal
	9	El Cliente selecciona “Cargar tarjeta”.
	10	El Sistema muestra en pantalla una lista con las opciones: “25 unidades” y “50 unidades”.
	11	El Cliente selecciona “50 unidades” y confirma la transacción.
	12	El Sistema valida el medio de pago, carga en la tarjeta del cliente 50 boletos/pasajes y despliega en pantalla un mensaje de “Carga de 50 boletos/pasajes realizada con éxito.”. Además envía un mensaje SMS al Cliente con el código QR comprobante de pago de la compra efectuada.
		El caso de uso termina con la tarjeta/boletera del Cliente cargada con 50 boletos/pasajes y recibiendo un mensaje SMS con el código QR, siendo este el comprobante de pago de la compra efectuada.
FLUJO ALTERNATIVO A4	PASO	ACCIÓN
	1	El Cliente ingresa a la aplicación web del sistema de trenes “Tren Alto Web”.
	2	El Sistema despliega la pantalla de logueo.
	3	El Cliente ingresa usuario y password (alguno incorrecto).
	4	El Sistema valida las credenciales, al no ser correcta la pareja usuario-password, despliega en la pantalla un mensaje de error indicando que los datos ingresados no son validos, por lo tanto no puede continuar con la transacción pues no ha sido autenticado.
	5	Termina el caso de uso con el Cliente visualizando el mensaje de error y aceptando el mismo.

 

b.2 Registro de una nueva parada en una línea.

 

1. Diagrama del Caso de Uso

2. Detalle del Caso de Uso

NOMBRE	Registrar nueva parada en una línea
CASO DE USO NO.	##
DESCRIPCIÓN	Este caso de uso permite a un administrador de la aplicación registrar en el sistema de la empresa “Tren Alto”, una nueva parada en una línea.
ACTORES	Administrador de la aplicación.
PRIORIDAD	Alta
ESTADO DEL DESARROLLO
PUNTOS DE EXTENSIÓN
PUNTOS DE INCLUSIÓN
PRECONDICIONES	La parada nueva ya fue ingresada en el sistema.
POSTCONDICIONES	La parada queda incorporada en la línea en la que se ingresó durante el registro.
EVENTO DISPARADOR

FLUJO PRINCIPAL	PASO	ACCIÓN
	1	El Administrador ingresa a la aplicación “Tren Alto”
	2	El Sistema despliega la pantalla de logueo con los campos Usuario y Password.
	3	El Administrador ingresa los datos de usuario y password correctos.
	4	El Sistema valida las credenciales, que como son correctas permite continuar con la transacción, y despliega la pantalla donde se muestra un menú con las siguientes opciones:  Gestión de Trenes Gestión de Líneas Gestión de Turnos  Gestión de Conductores  Gestión de Paradas  Gestión de Tipo de Pasaje Gestión de Pasajeros (con tarjeta)  Gestión de Tarjetas Gestión de Perfiles
	5	El Administrador seleccionará “Gestión de Líneas”
	6	El Sistema desplegará la pantalla correspondiente a “Gestión de Líneas”, la que tendrá un menú o lista de las funcionalidades que podrá realizar el administrador para las líneas.  Las mismas son: Ingresar una línea nueva. Modificar datos de una línea. Dar de baja una línea. Agregar una parada a una línea. Quitar una parada de una línea.
	7	El Administrador selecciona “Agregar una parada a una línea.”
	8	El Sistema despliega la pantalla correspondiente a esta funcionalidad, con los campos correspondientes para realizar esta transacción.
	9	El Administrador completa todos los campos requeridos ingresando datos válidos para que se complete la transacción. Luego confirma la misma presionando el botón “Confirmar”.
	10	El Sistema valida que exista la parada XX y la línea YY, y como se ingresaron datos válidos, entonces confirma que existe la parada XX y la línea YY, luego asocia a la línea YY la parada XX.  El Sistema despliega mensaje: “La parada “XX” se agregó exitosamente a la línea “YY”.”
	11	El caso de uso termina con el Administrador presionando “Aceptar” en el mensaje de éxito de la transacción.

FLUJO ALTERNATIVO  A1	PASO	ACCIÓN
		Continúa luego del paso 8 del Flujo Principal.
	9	El Administrador completa todos los campos requeridos ingresando en la parda un dato NO valido pero si en la línea. Luego confirma la transacción presionando el botón “Confirmar”.
	10	El Sistema valida que exista la parada XX y la línea YY, pero como los datos de la parada no son válidos, entonces devuelve mensaje de error: “Los datos de la parada XX no son correctos”.
	11	El caso de uso termina con el Administrador presionando “Aceptar” en el mensaje de error de la transacción.
FLUJO ALTERNATIVO A2	PASO	ACCIÓN
		Continúa luego del paso 8 del Flujo Principal.
	9	El Administrador completa todos los campos requeridos ingresando en la parda un dato valido pero ingresa un dato NO valido en la línea. Luego confirma la transacción presionando el botón “Confirmar”.
	10	El Sistema valida que exista la parada XX y la línea YY, confirma los datos de la pues son válidos, pero devuelve mensaje de error, porque los datos de la línea no lo eran: “Los datos de la línea YY no son correctos”.
	11	El caso de uso termina con el Administrador presionando “Aceptar” en el mensaje de error de la transacción.

b.3 CONSULTA DEL ESTADO DE LOS BOLETOS DE UNA BOLETERA POR PARTE DE UN CLIENTE VÍA WEB (no incluye la consulta de estado de boletos via App Mobile).

 

1. Diagrama del Caso de Uso

2. Detalle del Caso de Uso

NOMBRE	Consulta del estado de los boletos de una boletera por parte de un cliente vía web.
CASO DE USO NO.	##
DESCRIPCIÓN
ACTORES
PRIORIDAD
ESTADO DEL DESARROLLO
PUNTOS DE EXTENSIÓN
PUNTOS DE INCLUSIÓN
PRECONDICIONES
POSTCONDICIONES
EVENTO DISPARADOR

FLUJO PRINCIPAL	PASO	ACCIÓN
	1	El Cliente ingresa a la aplicación web del sistema de transporte “Tren Alto Web”.
	2	El Sistema despliega la pantalla de logueo.
	3	El Cliente ingresa usuario y password (correctos).
	4	El Sistema valida las credenciales, que como son correctas permite continuar con la transacción, y despliega la pantalla donde se muestra un menú con las funcionalidades que podrá realizar el cliente en esta modalidad web (en una primera instancia se mostrarán las 3 funcionalidades correspondientes a los 3 casos de uso que se detallan en esta documento).
	5	El Cliente selecciona del menú la opción “Consulta del estado de los boletos de una boletera”.
	6	El Sistema despliega la pantalla de ingreso de los datos correspondientes para esta transacción.
	7	El Cliente ingresa todos los datos requeridos para poder realizar la consulta, en este caso, sus datos personales. Dado que solo tiene una tarjeta activa por periodo, no se requiere más información que aquella que lo identifica dentro del registro de clientes/pasajeros.
	8	El Sistema valida que se hayan completado todos los datos para poder resolver la consulta, como los mismos son correctos, ejecuta la consulta y despliega en la misma pantalla el listado de los boletos/pasajes de la boletera con el estado correspondiente a cada uno. Y habilita las opciones de exportar la información: csv, pdf, etc.
	9	El Cliente selecciona “Exportar a CSV” y confirma la transacción.
	10	El Sistema genera el archivo CSV, y lo muestra abierto al Cliente, para que pueda realizar las acciones que guste con dicho archivo.
	11	El Cliente cierra la consulta presionando el botón “Salir”.
	12	El caso de uso termina con el Cliente saliendo de la funcionalidad.

FLUJO ALTERNATIVO  A1	PASO	ACCIÓN
		Continúa luego del paso 8 del Flujo Principal.
	9	El Cliente selecciona “Exportar a PDF” y confirma la transacción, presionando el botón “Confirmar”.
	10	El Sistema genera el archivo PDF, y levanta la herramienta correspondiente al tipo de archivo y abre el archivo para que el Cliente pueda visualizar el archivo PDF, para que pueda realizar las acciones que guste con dicho archivo.
	11	El Cliente cierra la consulta presionando el botón “Salir”.
	12	El caso de uso termina con el Cliente saliendo de la funcionalidad.
FLUJO ALTERNATIVO A2	PASO	ACCIÓN
	1	El Cliente ingresa a la aplicación web del sistema de trenes “Tren Alto Web”.
	2	El Sistema despliega la pantalla de logueo.
	3	El Cliente ingresa usuario y password (alguno incorrecto).
	4	El Sistema valida las credenciales, al no ser correcta la pareja usuario-password, despliega en la pantalla un mensaje de error indicando que los datos ingresados no son validos, por lo tanto no puede continuar con la transacción pues no ha sido autenticado.
	5	Termina el caso de uso con el Cliente visualizando el mensaje de error y aceptando el mismo.

Propósito del sistema 

Sistema de software para la gestión de pasajes, personal y maquinaria del Tren Alto, Sistema de Transporte del ayuntamiento de una ciudad.

Objetivos de negocio que cubre el sistema que se quiere construir.

Alcance del sistema 

Sistema de software para la gestión de pasajes, personal y maquinaria del Sistema de Transporte del ayuntamiento de una ciudad “Tren Alto”.

Descripción general del sistema

Contexto del sistema 

El Ayuntamiento de una ciudad abre una licitación para la creación de un Sistema de Transporte de Tren Alto, a ser utilizado en dos partes de la ciudad. 

La licitación culmina y la empresa ganadora comienza sus tareas de construcción de las vías del Tren Alto. Esta empresa le encomienda a su grupo de desarrolladores, la realización de un software para la gestión de pasajes, personal y maquinaria del Tren Alto.

El sistema deberá permitir realizar el listado y alta/baja/modificación de: 

• Trenes 

• Líneas 

• Turnos 

• Conductores 

• Paradas 

• Tipo de Pasaje 

• Pasajeros (con tarjeta)

El sistema deberá permitir renovar la tarjeta de los pasajeros con tarjeta así como cambiarla a estado cancelado o anulado, en caso de extravío o robo. 

El sistema deberá permitir a los pasajeros con tarjeta realizar la compra de boletos en locales certificados (pudiendo ser con tarjeta de un pasajero identificado en el sistema o mediante dinero), así como también encargarse de validar el boleto en el tren a la hora que un pasajero aborde. Luego de pasar la tarjeta o el boleto electrónico en un scanner del tren, este imprime un recibo para el usuario.

Para los clientes ya registrados, el sistema permitirá mediante el ingreso a una página web o una App Android o IoS, ingresando un medio de pago seguro, la compra de un boleto (a ser registrado por el sistema internamente) para ser usado en una línea un día específico o la compra de una boletera de 25 o 50 unidades para ser usados en cualquiera de las líneas del sistema. 

Además se querrá crear reportes que permitan obtener información acerca del uso de la cantidad de pasajeros por línea determinada, por período de tiempo, pasajeros con tarjeta y cantidad de boleteras compradas por período de tiempo, etc. 

El sistema se debe integrar con el sistema de RRHH existente en la empresa para acceder a la información del personal involucrado (conductores principalmente). 

El sistema debe proveer seguridad por perfiles para los diferentes usuarios del sistema, otorgándoles un usuario y contraseña para que lo utilicen para consultas en una web administrativa.

Para realizar este sistema, la empresa decidió constituir un equipo interno de desarrollo con recursos propios: 

• Modelo de Proceso: Iterativo Incremental 

• Se establece un plazo de entrega del sistema de seis meses a partir de la fecha de inicio y tres entregas o demos intermedias. 

Luego de la primera instancia de refinamiento de los requerimientos, que los analistas del equipo de desarrollo tienen con el usuario, luego de un análisis inicial, surgen algunas dudas a los analistas. Con lo cual se realiza una siguiente reunión para poder refinar aún más los requerimientos.

De la misma se obtienen las siguientes respuestas:

• Los actores relevantes para esta situación serían:

• Usuario final.

• Vendedor (ya sea de locales certificados o de la propia compañía).

• Administrador de la Aplicación (configuración de la misma, mantenimiento de perfiles).

• Gestor de Trenes. 

• Gestor de Líneas y Paradas.

• Gestor de Turnos. 

• Gestor de Conductores

• Gestor de Pasajes (ABM de Tipo de Pasaje)

• El scanner del tren.

Nota: En este caso, se modelará asignando al “Administrador de la Aplicación” el rol de todos los actores Gestores.

• Se requiere ABM de perfiles (para cubrir el requerimiento de seguridad para diferentes usuarios del sistema).

• Se requiere ABM de “Locales Certificados”.

• Pasajeros con o sin tarjetas están todos registrados.

• Cada pasajero puede tener más de una tarjeta, pero sólo una activa a la vez. Esta situación se da ante un extravío o hurto, que hay que “Anular” dicha tarjeta, y asignarle una nueva al cliente/pasajero (esto implica dar de alta una nueva tarjeta – ABM Tarjetas) y además, cargarle en caso que tuviera remanente de pasajes en la tarjeta cancelada, la misma cantidad en la nueva tarjeta asignada.

• Cada tarjeta tiene vencimiento, ejemplo 6 o 12 meses, elegir un plazo, y este será fijo.

• Si la tarjeta tiene cargado pasajes al momento del vencimiento, se renueva el vencimiento por el valor predeterminado (los 6 o 12 meses).

• Si la tarjeta no ha sido utilizada, o sea, no se han cargado pasajes, al momento del vencimiento, la tarjeta se da de baja. Esta baja es lógica. Al volver a cargar boletos/pasajes se vuelve a activar, generándose nuevamente otro periodo de vigencia.

• En la compra de pasajes a través de la aplicación web o para móvil de un cliente registrado

• Hay que validar que el cliente efectivamente está registrado.

• Hay que verificar si tiene tarjeta. 

• Si tiene tarjeta entonces la compra de pasajes será de 25 o 50 pasajes.

• Todos los pasajes valen lo mismo, independientemente del tramo, del origen y destino del viaje o de la cantidad de paradas.

• En los locales certificados, un pasajero registrado y con tarjeta del sistema de trenes, podrá comprar boletos, ya sea con tarjeta de crédito o con dinero en efectivo. En el local certificado, el vendedor cargará la tarjeta con el pasaje o sino emitirá un boleto electrónico con código de barras para ser leído por el scanner del tren.

• En el momento de abordar, se validará el pasaje en un scanner que emitirá el recibo en caso de que se escanee la tarjeta o el boleto electrónico. La forma de validación será a través de un web service hacia la base de datos de la empresa, que cotejará del boleto electrónico línea y horario.

• RRHH brinda un servicio para obtener datos del personal de la empresa. Por ejemplo, para poder realizar mantenimiento de perfiles asociados al personal, utilizaremos una interfaz en la cual ingresaremos la CI/Pasaporte (nro y país) y el servicio de RRHH nos brindará los siguientes datos:

• Nombre

• Apellido

• Cargo

• Perfiles (eventualmente podría ser una lista)

Funciones del sistema

Las siguiente tabla muestra las funciones del sistema:

#	Funciones del Sistema	Acción	Actor
1	ABM Tarjetas	Alta, modificación y baja (lógica) de las Tarjetas del Sistema.	Administrador de la Aplicación
2	ABM Perfiles	Alta, modificación y baja (lógica) de los Perfiles del Sistema.	Administrador de la Aplicación
3	ABM Trenes	Alta, modificación y baja (lógica) de los Trenes de la Empresa.	Administrador de la Aplicación
4	ABM Líneas	Alta, modificación y baja (lógica) de las Líneas de la Empresa.	Administrador de la Aplicación
5	ABM Turnos	Alta, modificación y baja (lógica) de los Turnos de la Empresa.	Administrador de la Aplicación
6	ABM Conductores	Alta, modificación y baja (lógica) de los Conductores de la Empresa.	Administrador de la Aplicación
7	ABM Paradas	Alta, modificación y baja (lógica) de las Paradas.	Administrador de la Aplicación
8	ABM Tipo de Pasaje	Alta, modificación y baja (lógica) de los Tipos de Pasajes.	Administrador de la Aplicación
9	ABM Locales Certificados	Alta, modificación y baja (lógica) de los Locales Certificados.	Administrador de la Aplicación
10	Registro de una nueva parada en una línea.	Para especificar en forma detallada	Administrador de la Aplicación
11	Renovar Tarjeta	Porque caducó el periodo de vigencia, se le renueva la tarjeta al comprar nuevamente pasajes/boletos.	Cliente / Pasajero
12	Anular Tarjeta	Anula la tarjeta dejandola inactiva, en caso de extravio o hurto. Baja lógica.	Cliente / Pasajero
13	Comprar Pasaje Web	Para identificar y descripción breve	Cliente / Pasajero
14	Comprar Pasaje App Android	Permite al cliente/pasajero comprar boletos a través de una aplicación de un dispositivo movil con sistema operativo Android.	Cliente / Pasajero

15	Comprar Pasaje App Mobile IoS	Permite al cliente/pasajero comprar boletos a través de una aplicación de un dispositivo movil con sistema operativo IoS.	Cliente / Pasajero
16	Consulta del estado de los boletos de una boletera por parte de un cliente vía web.	Para especificar en forma detallada	Cliente / Pasajero
17	Alta de Cliente / Pasajero	Permite registrar un nuevo Pasajero/Cliente en el sistema al vendedor.	Vendedor
18	Modificación de datos del Cliente / Pasajero	Permite al vendedor modificar los datos del Pasajero/Cliente en el sistema .	Vendedor
19	Venta pasajes	Venta de boletos / pasajes en local certificado - si aun no tenia tarjeta se le entrega una tarjeta física o una virtual con la carga de los pasajes siempre y cuando cargue por lo menos 10 boletos	Vendedor

Características del usuario

Definiciones

Referencias

Aquí se mencionan los documentos o estándares en los que se basa el documento en curso. Además de los que complementan la información de este.

Los documentos son los siguientes:

1. Plan de Calidad

2. Casos de Uso-Parte 3.b-Detalle-Final

3.D

3.C

Actor	# CU	Caso de Uso	Acción
Pasajero	1	Adquirir Tarjeta
Pasajero	2	Renovar Tarjeta	Para identificar y descripción breve
Pasajero	3	Cancelar Tarjeta	Para identificar y descripción breve
Pasajero	4	Anular Tarjeta	Para identificar y descripción breve
Pasajero	5	Comprar Pasaje Web	Para identificar y descripción breve
Pasajero	6	Comprar Pasaje App Android	Para identificar y descripción breve
Pasajero	7	Comprar Pasaje App Mobile IoS	Para identificar y descripción breve
Administrador de la Aplicación	8	ABM Perfiles
	9	ABM Trenes
	10	ABM Líneas
	11	ABM Turnos
	12	ABM Conductores
	13	ABM Paradas
	14	ABM Tipo de Pasaje
	15	ABM Pasajeros (con tarjeta)
	16	ABM Locales Certificados
	17	ABM Tarjetas
	18	Compra de boleto vía web. (no incluye la compra de boleto via App Mobile)	Para especificar en forma detallada
	19	Registro de una nueva parada en una línea.	Para especificar en forma detallada
	20	Consulta del estado de los boletos de una boletera por parte de un cliente vía web.	Para especificar en forma detallada