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.
• Diseño responsivo de la aplicación poder acceder a ella desde diferentes tipos de dispositivos.

Requisitos funcionales

Funcionalidades

Casos de uso

1. Registrar usuario

Descripción textual

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: correo electrónico, cédula de identidad, nombre y apellidos, institución, cargo. También le solicita comprobar una imagen captcha. 3.- El usuario proporciona al sistema sus datos, los datos del captcha y le indica que desea registrarse con esos datos. 3.- El sistema verifica que el captcha sea válido, luego verifica si ya existe un usuario con la misma cédula de identidad que introdujo el usuario. 4.- Si se cumplen las condiciones anterior (punto 3.-) entonces el sistema guarda los datos básicos de la persona y envía un correo electrónico al administrador del sistema indicándole que hay una nueva solicitud de registro de usuario que debe atender. 5.- El sistema presenta un mensaje al usuario indicando que su solicitud de registro se ha enviado al administrador del sistema y se le notificará a su correo electrónico cuando el administrador analice su solicitud. 6.- El administrador del sistema entra al panel administrativo y aprueba el registro del usuario. 7.- El sistema envía un correo electrónico a la persona que hizo la solicitud para notificar que se ha aprobado el registro de su usuario y también le coloca un enlace al que debe acceder para introducir su contraseña. 8.- El usuario recibe el correo electrónico y accede al enlace para colocar la contraseña. 9.- 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. 10.- El usuario le indica al sistema que desea guardar su contraseña. 11.- 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 utilizar su usuario inmediatamente.
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. 6.1.- Si el administrador no logra comprobar las credenciales institucionales que introdujo el usuario en su solicitud entonces rechaza su solicitud para crear el usuario y el sistema le envía un correo al usuario notificándole que su solicitud se ha rechazado por no poder comprobar sus credenciales institucionales.
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.

Prototipo de interfaz no funcional

Autenticación del usuario

2. Entrar al sistema

Descripción textual

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 que 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:

Prototipo de interfaz no funcional

Autenticación del usuario

3. Administrar el sistema

Descripción textual

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. 3.- El sistema verifica la existencia del usuario y la validez de su contraseña. 4.- 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, aprobar las solicitudes de registro que hacen los nuevos usuarios, 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:

Prototipo de interfaz no funcional

Autenticación del usuario

4. Modelar cadena productiva

Descripción textual

Nombre del caso de uso:	Modelar cadena productiva
Actores participantes:	Usuario
Condiciones de entrada:	El usuario entra al sistema
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 busca la Unidad Económica a partir de la cual quiere generar la cadena productiva, puede buscarla por RIF, razón social o nombre. 2.- El sistema busca en la información de SIGESIC a las Unidades Económicas que cumplen con los criterios de búsqueda y presenta los resultados mostrando sus datos: RIF, nombre, ubicación. 3.- El usuario selecciona la unidad económica con la que desea modelar la cadena. 4.- El sistema busca los productos de esa unidad económica que se encuentran en los datos de SIGESIC y le muestra al usuario un listado de todos los productos con los siguientes datos: nombre, código arancelario y especificación técnica. 5.- El usuario selecciona el producto que desea tomar para modelar su cadena productiva. 6.- El sistema le solicita al usuario el año a tomar en cuenta para la cadena, los niveles aguas arriba y aguas abajo que desea modelar. 7.- El usuario introduce el año, la cantidad de niveles aguas arriba y aguas abajo que desea para la cadena productiva y le indica al sistema que genere la cadena con esos parámetros. 8.- El sistema busca los datos que necesita para construir la cadena productiva según la información de SIGESIC. 9.- El sistema genera la cadena productiva construyendo un árbol con todos sus elementos organizado según los enlaces de la cadena. 10.- El sistema despliega un árbol con la cadena productiva modelada, también muestra información de cada unidad económica involucrada en la cadena modelada. La información de las unidades económicas que se despliega es: nivel donde se ubica, nombre, RIF y ubicación geográfica, además por cada producto de esa unidad económica se muestra: nombre, cantidad producida, precio unitario, código arancelario, unidad de medida y una lista de los insumos (código arancelario, nombre, relación insumo/producto, costo unitario en Bs, cantidad requerida, costo en Bs.). 11.- El sistema despliega la opción de descargar la cadena que se ha modelado. 12.- El usuario le indica al sistema que desea descargar la cadena. 13.- El sistema genera el grafo de la cadena que se encuentra modelada en el árbol y le permite al usuario descargarla en formato .svg.
Flujos alternativos:	2.1.- Si el sistema no consigue unidades económicas que cumplan con los criterios de búsqueda le muestra un mensaje al usuario indicando que no hay unidades económicas con esos atributos en la información de SIGESIC.
Requisitos especiales:

Prototipo de interfaz no funcional

Modelado de cadena productiva

5. Editar cadena productiva

Descripción textual

Nombre del caso de uso:	Editar cadena productiva
Actores participantes:	Usuario
Condiciones de entrada:	El usuario ha generado una cadena productiva.
Condiciones de salida:	Se muestra la cadena modificada y las cadenas similares que otros usuarios han guardado.
Flujo de básico:	1.- El usuario le indica al sistema que desea editar la cadena productiva que ha generado. 2.- El sistema le muestra al usuario la posibilidad de eliminar elementos en el árbol de la cadena productiva. 3.- El usuario elimina la cantidad de elementos que considera pertinente. 4.- El usuario le indica al sistema que desea guardar la cadena modificada. 5.- El sistema le solicita al usuario un nombre para asociarlo a la cadena modificada. 6.- El usuario introduce un nombre para la cadena modificada y le indica al sistema que la guarde 7.- El sistema guarda las modificaciones realizadas por el usuario a la cadena productiva y busca otras modificaciones que se hayan hecho a esa cadena (por otros usuarios o por él mismo usuario que la está guardando). 8.- El sistema despliega el listado de modificaciones de la cadena que ha encontrado para que el usuario las abra o las compare con la cadena que ha modificado. 9.- El usuario le indica al sistema que desea comparar la cadena que tiene en el árbol con alguna de las modificaciones del listado. 10.- El sistema le muestra dos árboles con ambas cadenas indicando las diferencias entre ambas. 11.- El usuario le indica al sistema que quiere abrir las cadenas que se muestran en el listado de modificaciones de la cadena original. 10.- El sistema carga en el árbol la cadena modificada que ha seleccionado el usuario.
Flujos alternativos:	8.1.- Si el sistema no consigue modificaciones para la cadena en estudio no despliega el listado de modificaciones.
Requisitos especiales:	En el punto 3.- se debe tomar en cuenta que al eliminar un elemento del árbol todos sus subelementos también serán eliminados. En el punto 10.- se debe advertir al usuario que al abrir una nueva cadena perderá la visualización de la que tiene en estudio actualmente.

Prototipo de interfaz no funcional

Modelado de cadena productiva

6. Calcular divisas para producir un bien

Descripción textual

Nombre del caso de uso:	Calcular divisas para producir un bien
Actores participantes:	Usuario
Condiciones de entrada:	El usuario entra al sistema.
Condiciones de salida:	El sistema despliega los requerimientos de divisas por unidad económica o por producto según lo solicite el usuario.
Flujo de básico:	1.- El usuario busca la Unidad Económica a partir de la cual quiere generar la cadena productiva, puede buscarla por RIF, razón social o nombre. 2.- El sistema busca en la información de SIGESIC a las Unidades Económicas que cumplen con los criterios de búsqueda y presenta los resultados mostrando sus datos: RIF, nombre, ubicación y también le muestra la posibilidad de consultar las divisas de cada unidad económica. 3.- El usuario le solicita al sistema los requerimientos de divisas de una unidad económica. 4.- El sistema le solicita al usuario el tipo de cambio nominal a utilizar (Bs. por cada $) y el año a tomar en cuenta para la búsqueda. 5.- El usuario introduce el tipo de cambio nominal y el año de búsqueda, y luego le indica al sistema que calcule los requerimientos de divisas. 6.- El sistema analiza la cadena productiva completa hacia atrás de esa unidad económica para el año indicado, buscando si las unidades económicas involucradas en esa cadena hacia atrás importaron insumos. 7.- 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.. 8.- 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. 9.- 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. 10.- El sistema le muestra al usuario los requerimientos de divisas de la unidad económica de cada producto en cada nivel de la cadena (cantidad, unidad de medida, precio unitario en $, monto total por producto en $), así como también el monto total en $ de la cadena productiva.

Prototipo de interfaz no funcional

Cálculo de divisas para producir un bien

7. Mostrar información de la Matriz Insumo Producto asociada a una cadena

Descripción textual

Nombre del caso de uso:	Mostrar información de la Matriz Insumo Producto asociada a una cadena
Actores participantes:	Usuario
Condiciones de entrada:	El usuario ha modelado una cadena productiva.
Condiciones de salida:	El sistema presenta al usuario la información asociada a la cadena productiva que ha conseguido en la Matriz Insumo Producto.
Flujo de básico:	1.- El usuario le solicita al sistema que le muestre la información de la Matriz Insumo Producto asociada a la cadena productiva que tiene en el árbol que está analizando. 2.- 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 ha tomado al modelar la cadena, hasta conseguirla (búsqueda cronológica hacia atrás). 3.- 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. 4.- El sistema despliega los datos de producción de la actividad económica del nodo raíz de la cadena y los cinco principales productos importados de la cadena según la MIP.
Flujos alternativos:	2.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.
Requisitos especiales:

Prototipo de interfaz no funcional

Visualización de información proveniente de otras fuentes de datos

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

Descripción textual

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:

Prototipo de interfaz no funcional

Visualización de información proveniente de otras fuentes de datos

9. Observar la propiedad de las UE en una cadena productiva

Descripción textual

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:

Prototipo de interfaz no funcional

[]

10. Simular escenario económico

Descripción textual

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 junto al á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, salario promedio en año cero, porcentaje de desviación estándar, para los tres años que se van a simular introduce: la tasa de cambio Bs./$, el porcentaje de variación del salario, el porcentaje de variación de precios, la tasa de ganancia, el porcentaje de variación de la demanda y el valor en Bs. de la unidad tributaria. 2.- El usuario guarda el escenario económico que ha creado con los parámetros y la cadena que está analizando. 3.- El sistema guarda el escenario y le presenta al usuario la opción de simular el escenario económico que ha guardado. 4.- 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. 5.- Una vez terminada la simulación el sistema le muestra al usuario los resultados en secciones separadas: Producción, Empleo, Costos y Precio. En la sección de Producción le presenta una tabla con la producción en unidades físicas y la variación de dicha producción. En la sección Empleo muestra una tabla con el número de empleados, el costo de mano de obra administrativa, operativa y el valor de las variables exógenas asociadas a estas como lo son la variación del salario y la unidad tributaria, y un gráfico que muestra solamente la producción en unidades de medida. En la sección Costos desglosa el costo total en costo de insumos y otros costos, se presentan en tabla los resultados en Bolívares y se dibujan las variaciones, también muestra el valor introducido por el usuario para las variaciones de precios en los tres años de simulación. En la sección Precios muestra en tabla el precio unitario en Bolívares y su respectiva variación, además de los valores de las variables exógenas como la tasa de ganancia y el tipo de cambio nominal, en el gráfico presenta las variaciones del precio. También le muestra 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:
Requisitos especiales:

Prototipo de interfaz no funcional

Evaluación de escenarios