Especificación de requerimientos

Requisitos no funcionales

• Construir base de datos propia para el proyecto, que recoja la información útil para la simulación desde diversas fuentes de datos.
• Guardar un histórico de cambios de escenarios económicos que realizan los usuarios.
• Cargar la información correspondiente a la Encuesta Industrial 2007 como fuente de datos para el proyecto.

Requisitos funcionales

Funcionalidades

Casos de uso

1. Registrar usuario

Nombre del caso de uso:	Registrar usuario
Actores participantes:	Usuario
Condiciones de entrada:	El usuario debe acceder a la página de la aplicación
Condiciones de salida:	El usuario tiene un nombre de usuario y contraseña para entrar al sistema
Flujo de básico:	1.- El usuario solicita al sistema la creación de un usuario. 2.- El sistema le solicita los datos del usuario: nombre de usuario, correo electrónico, cédula de identidad, nombre y apellidos, teléfono. También le solicita comprobar una imagen captcha. 3.- El usuario proporciona al sistema sus datos básicos, los datos del captcha y le indica que desea crear el usuario con esos datos. 3.- El sistema verifica que el captcha sea válido, luego verifica si ya existe un usuario para esa cédula de identidad. 4.- El sistema verifica que no existe otro nombre de usuario igual. 5.- Si se cumplen las condiciones establecidas en 3 y 4 entonces el sistema guarda los datos básicos de la persona y su usuario, luego envía un correo electrónico a la persona con un enlace al que debe acceder para introducir su contraseña. 6.- El sistema le notifica al usuario que le ha enviado un correo electrónico desde el correo del sistema, que debe buscarlo y acceder al enlace que se encuentra en él para introducir su contraseña. 7.- El usuario recibe el correo electrónico y accede al enlace para colocar la contraseña. 8.- El sistema solicita al usuario que escriba su contraseña y la confirme escribiéndola por segunda vez, también verifica la robustez de la contraseña a medida que el usuario la escribe. Si la robustez de la contraseña es baja le solicita al usuario que la cambie sino se toma como contraseña válida. El sistema también le solicita al usuario comprobar una imagen captcha además de los datos de la contraseña. 9.- El usuario le indica al sistema que desea guardar su contraseña. 10.- El sistema verifica el captcha y si es válido guarda la contraseña para este usuario, después le notifica al usuario que su contraseña se ha guardado y puede utilizarla en lo inmediato.
Flujos alternativos:	3.1 Si el captcha no es válido el sistema debe recuperar los datos que introdujo el usuario y generar un nuevo captcha para que el usuario lo introduzca nuevamente. 3.2.- Si ya existe un usuario para ese número de cédula de identidad se le debe notificar al usuario que ya tiene un usuario registrado con su cédula y que puede solicitar el reinicio de su contraseña en caso de haberlo olvidado. 4.1.- Si dentro del sistema ya existe un nombre de usuario igual al que colocó el usuario, entonces el sistema debe notificarlo al usuario y recuperar los datos que introdujo el usuario (excepto el nombre de usuario) y generar un nuevo captcha para que introduzca nuevamente el captcha y nombre de usuario.
Requisitos especiales:	1.- En el paso 5 el sistema debe llevar un registro de los correos que se han entregado exitosamente a su destinatario, para poder reenviar el correo pasadas las 24 horas y que no se pueda entregar, si pasan 72 horas sin poderlo entregar se debe generar un archivo con el log de errores de correos (estatus del envío de correo y correo al que se trata de enviar) para que el administrador del sistema pueda revisarlo y contactar al usuario por vía telefónica para aclarar cuál es el problema con su correo electrónico.

2. Entrar al sistema

Nombre del caso de uso:	Entrar al sistema
Actores participantes:	Usuario
Condiciones de entrada:	El usuario debe acceder a la página de la aplicación
Condiciones de salida:	El usuario entra a la aplicación
Flujo de básico:	1.- El usuario accede al sistema. 2.- El sistema le solicita al usuario su nombre de usuario, su contraseña y comprobar la imagen de un captcha. 3.- El usuario coloca su nombre de usuario, su contraseña, el captcha y le indica al sistema que desea entrar. 4.- El sistema verifica la validez del captcha. 5.- El sistema verifica que el usuario exista y la contraseña corresponda a ese nombre de usuario. 6.- Si el usuario existe y la contraseña introducida corresponde al usuario se validan los permisos o roles de acceso que tiene el usuario y se despliegan las funcionalidades a las que puede acceder.
Flujos alternativos:	2.1.- Si el usuario no recuerda su contraseña puede solicitar al sistema recuperarla. En este caso el sistema enviará un correo electrónico al correo del usuario con un enlace para que introduzca la nueva contraseña y le notifica al usuario el envío de este correo. Luego el usuario accede al enlace y el sistema le solicita que introduzca una nueva contraseña y la confirme. Después el sistema guarda la nueva contraseña para el usuario, se lo notifica y lo redirige a la pantalla de entrada del sistema. 4.1.- Si el captcha no es válido el sistema recupera los datos que introdujo el usuario y genera un nuevo captcha para que el usuario lo introduzca y solicite la entrada al sistema nuevamente. 5.1.- Si el nombre de usuario no existe el sistema lo notifica al usuario. 5.2.- Si la contraseña no coincide con la que está guardada en el sistema para ese nombre de usuario, el sistema notifica al usuario que la contraseña enviada no es la correcta.
Requisitos especiales:

3. Administrar el sistema

Nombre del caso de uso:	Administrar el sistema
Actores participantes:	Administrador web
Condiciones de entrada:	El administrador debe acceder a la página de administración de la aplicación
Condiciones de salida:	El usuario entra a la aplicación de administración del sistema
Flujo de básico:	1.- El administrador web accede al panel administrativo del sistema. 2.- El administrador web coloca su usuario y contraseña y le indica al panel administrativo que desea entrar. 2.- El sistema verifica la existencia del usuario y la validez de su contraseña. 3.- Si el usuario existe y su contraseña es válida le da entrada al panel administrativo, donde el administrador web podrá modificar la contraseña de un usuario, cambiar los permisos y roles de un usuario, así como también registrar, consultar, modificar y/o eliminar los datos de objetos básicos, tales como tipos de moneda. La definición de estos objetos son parte del proceso de construcción del software.
Flujos alternativos:
Requisitos especiales:

4. Modelar cadena productiva

Nombre del caso de uso:	Modelar cadena productiva
Actores participantes:	Usuario
Condiciones de entrada:	El usuario selecciona una unidad económica, un bien, un año, los niveles aguas arriba y aguas abajo que desea para modelar la cadena, y la tasa de cambios Bs./$.
Condiciones de salida:	El sistema muestra un árbol con la cadena productiva generada según los datos de Sigesic y toda la información asociada a ella.
Flujo de básico:	1.- El usuario le indica al sistema que quiere modelar la cadena productiva según los parámetros que definió previamente (unidad económica, bien, año, los niveles aguas arriba y aguas abajo, y la tasa de cambio Bs./$). 2.- El sistema busca los datos que necesita para construir la cadena productiva según la información de SIGESIC. 3.- El sistema genera la cadena productiva construyendo un árbol con todos sus elementos organizado según los enlaces de la cadena. 4.- El sistema verifica la existencia de la actividad económica del nodo raíz de la cadena en las Matrices Insumo Producto (MIP) que tenga como fuentes de información, partiendo desde la MIP del año anterior más cercano al año que se toma para modelar la cadena, hasta conseguirla. 5.- El sistema consulta la producción de la actividad económica (Bs.) del nodo raíz y los cinco principales productos importados de la cadena en la MIP. 6.- El sistema despliega el árbol con la cadena productiva modelada y si consiguió la actividad económica en la MIP también despliega los datos de producción de su actividad económica y los cinco principales productos importados de la cadena en la MIP.
Flujos alternativos:	2.1.- Si el sistema no consigue datos para construir la cadena le informa al usuario que no hay datos suficientes para construir la cadena que está solicitando. 4.1.- Si la actividad económica del nodo raíz de la cadena no está en la MIP del año que se está modelando se le notifica al usuario que esta información no está disponible. 5.1.- Si no hay insumos importados para esa actividad económica en la MIP se le notifica al usuario al desplegar la cadena modelada.
Requisitos especiales:

5. Calcular divisas para producir un bien

Nombre del caso de uso:	Calcular divisas para producir un bien
Actores participantes:	Usuario
Condiciones de entrada:	El usuario después de modelar una cadena productiva le solicita al sistema realizar el cálculo de las divisas usadas para producir el bien raíz de la cadena.
Condiciones de salida:	El sistema despliega la cadena productiva del bien hacia atrás con los datos correspondientes a las divisas utilizadas en esa cadena.
Flujo de básico:	1.- El sistema analiza la cadena productiva base y reconstruye esa cadena completa hacia atrás, luego busca si las unidades económicas involucradas en esa cadena hacia atrás importaron insumos. 2.- El sistema obtiene el Precio de Adquisición Internacional del año concluido de los insumos importados según la información de SIGESIC, este valor representa el monto total pagado por el insumo por la UE en Bs. 3.- El sistema realiza la conversión del monto de los insumos importados de Bs. a $ según la tasa de cambio proporcionada por el usuario al modelar la cadena productiva. 4.- El sistema suma los montos de los insumos importados en Bs. y en $, por niveles de la cadena, por unidad económica en la cadena y el total de la cadena. 5.- El sistema despliega la cadena productiva completa hacia atrás, indicando los montos de insumos importados por niveles, por unidad económica y total en Bs. y en $.
Flujos alternativos:	1.1.- Si el sistema no consigue unidades económicas involucradas que hayan importado insumos entonces le indica al usuario que no hay insumos importados involucrados en la producción de ese bien para el año de la cadena base.
Requisitos especiales:

6. Generar cadena productiva de la UE según Encuesta Industrial

Nombre del caso de uso:	Generar cadena productiva de la UE según Encuesta Industrial
Actores participantes:	Usuario
Condiciones de entrada:	El usuario solicita al sistema generar la cadena productiva de la UE raíz de una cadena modelada.
Condiciones de salida:	El sistema presenta al usuario un grafo con la cadena productiva de la UE basada en los datos de la Encuesta Industrial (EI).
Flujo de básico:	1.- El sistema busca a la unidad económica raíz de la cadena modelada en las Encuestas Industriales que tiene como fuente de datos, partiendo desde la del año más reciente tomando como referencia el año de la cadena modelada hasta ubicarla. 2.- El sistema construye la cadena productiva según los datos de la Encuesta Industrial. 3.- El sistema despliega el grafo de la cadena productiva mostrando también el año base utilizado en la Encuesta Industrial consultada.
Flujos alternativos:	1.1.- Si el sistema no ubica a la UE en ninguna de las Encuestas Industriales que tiene como fuente de datos, entonces le indica al usuario que no puede generar el grafo de su cadena productiva porque no se encuentra la UE en la Encuesta Industrial de los años que ha consultado.
Requisitos especiales:

7. Consultar monopolios horizontales

Nombre del caso de uso:	Observar la propiedad de las UE en una cadena productiva
Actores participantes:	Usuario
Condiciones de entrada:	El usuario solicita al sistema la observación de la propiedad de las UE de una cadena productiva.
Condiciones de salida:	Se muestran los datos de los socios que tienen la propiedad de varias UE dentro de la cadena en caso de existir.
Flujo de básico:	1.- El sistema consulta el RIF de los socios de las unidades económicas involucradas dentro de los datos de la cadena modelada. 2.- El sistema acumula el número de veces que se repite cada RIF de un socio en la participación accionaria de las UE de la cadena. 3.- Si al menos uno de los RIFs de los socios se repite, entonces se despliega la información correspondiente los socios que tienen participación accionaria de varias empresas dentro de la cadena. El sistema permite ver por cada socio su RIF y Nombres y Apellidos, así como también el Nombre (o Razón Social) de la UE y su % de participación accionaria para cada empresa de las que es propietario.
Flujos alternativos:	3.1.- Si ningún RIF se repite el sistema le informa al usuario que no hay socios que tengan la propiedad de varias UE dentro de la cadena productiva modelada.
Requisitos especiales:

7. Simular escenario económico

Nombre del caso de uso:	Simular escenario económico
Actores participantes:	Usuario
Condiciones de entrada:	El usuario ha modelado una cadena productiva (cadena base) desde los datos de SIGESIC.
Condiciones de salida:	El sistema despliega los resultados de la simulación en el árbol de la cadena simulada
Flujo de básico:	1.- El usuario coloca los parámetros que el escenario económico va a tener para efectos de la simulación, estos parámetros son: valor en Bs. de la unidad tributaria, tasa de cambio Bs./$ en los tres años de la simulación, variación del salario, tasa de ganancia, variación de la demanda y variación de precios. 2.- El usuario decide si va a eliminar relaciones entre los eslabones de la cadena base para modificar su estructura y procede a eliminarlos en el árbol de la cadena. 3.- El usuario guarda el escenario económico que ha creado con los parámetros y la nueva (o la misma) estructura de la cadena. 4.- El sistema verifica si el mismo escenario ha sido guardado por otros usuarios. 5.- Si otros usuarios han guardado el mismo escenario, es decir, la misma estructura de la cadena en un escenario, entonces el sistema calcula cuantos son, luego busca los datos del usuario y de sus escenarios. 6.- El sistema guarda el escenario y despliega la lista de los usuarios que han guardado el mismo escenario con el total de usuarios que se han conseguido en esta búsqueda. 7.- Una vez que el sistema ha guardado el escenario le presenta al usuario la opción de simular el escenario económico que ha guardado. 8.- Si el usuario indica que desea realizar la simulación del escenario económico entonces el sistema pasa a simular con un horizonte de 3 años y los parámetros y estructura fijadas en el escenario, indicándole al usuario durante la simulación que está realizando los cálculos pertinentes y al terminar le mostrará los resultados. 9.- Una vez terminada la simulación el sistema le muestra al usuario los resultados en el árbol de la cadena productiva, y le presenta la opción para generar un reporte en formato imprimible (puede ser pdf) con los resultados de la simulación. 10.- Si el usuario activa la opción para generar el reporte el sistema coloca los parámetros de la simulación, el árbol de la cadena con los resultados de la simulación, la fecha y hora de la simulación y la fecha de la generación del reporte en un archivo que el usuario puede descargar o imprimir.
Flujos alternativos:	2.1.- Si el usuario decide no eliminar relaciones entre eslabones el árbol de la cadena se mantiene igual a la cadena base. 5.1.- Si no hay usuarios que hayan guardado el mismo escenario no se muestra la lista de escenarios de otros usuarios.
Requisitos especiales: