# Requerimientos específicos
La organización de esta sección se realizó con base en la plantilla de A.5 de SRS Sección 3 organizada por el rasgo, la cual encontramos en el estandar 830-1998 "Prácticas recomendadas para una especificación de requerimientos de software" de la ieee. IEEE 830-1998 - IEEE Recommended Practice for Software Requirements Specifications (opens new window)
# Requisitos de la interfaz externa
El sistema Dashboard SIV-TCR tiene una dependencia directa con el sistema SIV-TCR. Esta dependencia directa hace referencia al uso del API (implementada en el sistema SIV-TCR) y la información cargada en las gráficas del dashboard.
La arquitectura de software para la comunicación entre dichos sistemas es de tipo REST, lo que permite consumir datos de manera rápida y segura. Las peticiones son enviadas a través de la url desde el dash hacia el siv-tcr devolviendo este último la respuesta con los datos solicitados.
Solo se puede acceder al dashboar por medio del sistema Viáticos-TCR (opens new window). El link anterior lleva al área dev.
El sistema dashboard-sivtcr no tiene otra dependicia de software con otro sistema.
# Interfaz del usuario
La interfaz de usuario del Dashboard - SIV TCR cuenta de los siguientes componentes:
Header: En la parte superior de todas las vistas encontraremos el nombre y puesto del usuario que haya ingresado al dashboard.
Sidebar: Componente estático que aparece en todas las vistas del dashboard. Este sidebar cuenta con la funcionalidad de navegar a través de él por medio de las siguientes opciones: Viáticos, Conceptos, Comprobación, Transporte, Comprobantes, Razones y Motivos, Lugares, Puestos, Proveedores, Vuelos, Empresas y Listado de viáticos. Además tiene el logo de la empresa en la parte superior.
Filtros: El sistema cuenta con una sección para los filtros principales los cuales incluyen: Empresa, Región, Sucursal y Puesto. Cada una de las opciones tiene la posibilidad de seleccionar 1 o más elementos de la lista.
Sección buscador: En ella encontramos los filtros por fecha inicial y fecha final. Además tenemos 3 botones; para aplicar los filtros, para desplegar la sección de búsqueda avanzada y para limpiar filtros.
Búsqueda avanzada: Esta sección se encuentra oculta hasta que se de clic en el botón "Búsqueda avanzada". Este componente muestra las opciones: Centros de costos, patrona, facturadora, departamento, razón, motivo, tipo de solicitud, concepto de viático, estatus, por dispersión. Esta opciones pueden o no mostrarse dependiendo de la vista en la que nos encontremos.
# Interfaz del hardware
No se tienen interfaces de hardware para este sistema. El sistema comparte espacio en los servidores de DIT.
# Interfaz del software
A continuación se describen los frameworks que utiliza el dashboard-sivtcr.
Bootstrap: En su versión 5.0.2 para estilos (spinners).
dit-vue-components: En sus versión 1.2.0 utilizado para los loaders de las gráficas.
foundation-sites: En su versión 6.6.3 utilizado para la estructura del front-end.
highcharts-vue: En su versión 1.4.0 utilizado para crear las gráficas.
vue-multiselect: En su versión 2.1.6 facilita la búsqueda de selección de múltiples opciones en los componentes desplegables.
vue-pagination-2: En su versión 3.0.9 para la paginación del sistema.
# Interfaces de comunicación
La comunicación se hace por medio de la arquitectura REST para consumir información esto a través del protocolo tcp/ip por el puerto 8080.
La comunicación con la base de datos es por el puerto 3306.
Toda la información viaja en la web por medio del protocolo https con una arquitectura cliente-servidor.
# Sistema ofrece
# Viáticos
En esta vista encontraremos las gráficas relacionadas a los viáticos. Se podrá hacer uso de todos los filtros a excepción de "Conceptos viáticos" y "Por dispersión".
# Secuencia del estímulo
Esta se puede manejar como la vista principal, una vez entrando al dashboard cargará esta vista y se mostrarán las gráficas con datos.
Para poder filtrar se requiere seleccionar filtros(cualesquiera) y posteriormente dar clic en el botón de 'Buscar'. Esto enviará una petición al sistema SIV-TCR que devolverá todos los datos filtrados necesarios para llenar las gráficas.
# Requisitos funcionales asociados
# 1. Viaticos pagados - Cantidad Solicitudes
# 2. Viaticos pagados - Cantidad Monetaria
# 3. Solicitud de anticipos - En trámite
# 4. Solicitud de reembolsos - En trámite
# 5. Comparativa viáticos - Variación comparativa
# 6. Solicitudes de viáticos - Por rango de monto
# Conceptos
En esta vista encontraremos las gráficas relacionadas a los conceptos. Se podrá hacer uso de todos los filtros a excepción de "Por dispersión".
# Secuencia del estímulo
Esta vista será cargada una vez se haya dado clic en la opción "Conceptos" desde el sidebard.
Para poder filtrar se requiere seleccionar filtros(cualesquiera) y posteriormente dar clic en el botón de 'Buscar'. Esto enviará una petición al sistema SIV-TCR que devolverá todos los datos filtrados necesarios para llenar las gráficas.
# Requisitos funcionales asociados
# 1. Solicitudes por concepto
# 2. Monto por concepto
# 3. Promedio de gastos por concepto
# 4. Monto fuera de políticas
# Comprobación
En esta vista encontraremos las gráficas relacionadas a los viáticos y su estado de comprobación. Se podrá hacer uso de todos los filtros a excepción de "Estatus" y "Por dispersión".
# Secuencia del estímulo
Esta vista será cargada una vez se haya dado clic en la opción "Comprobación" desde el sidebard.
Para poder filtrar se requiere seleccionar filtros(cualesquiera) y posteriormente dar clic en el botón de 'Buscar'. Esto enviará una petición al sistema SIV-TCR que devolverá todos los datos filtrados necesarios para llenar las gráficas.
# Requisitos funcionales asociados
# 1. Viajes por comprobar
# 2. Tiempos de comprobación
# Transporte
En esta vista encontraremos las gráficas relacionadas a los tipos de transporte que se solicitan en los viáticos. Se podrá hacer uso de todos los filtros a excepción de "Por dispersión".
# Secuencia del estímulo
Esta vista será cargada una vez se haya dado clic en la opción "Transporte" desde el sidebard.
Para poder filtrar se requiere seleccionar filtros(cualesquiera) y posteriormente dar clic en el botón de 'Buscar'. Esto enviará una petición al sistema SIV-TCR que devolverá todos los datos filtrados necesarios para llenar las gráficas.
# Requisitos funcionales asociados
# 1. Viajes - Solicitud por tipo de transporte
# 2. Viajes - Monto por tipo de transporte
# 3. Viajes comparativa - Solicitud por tipo de transporte
# 4. Viajes comparativa - Monto por tipo de transporte
# Comprobantes
En esta vista encontraremos las gráficas relacionadas a los tipos de comprobantes que se tienen en los viáticos. Se podrá hacer uso de todos los filtros a excepción de "Por dispersión" y "Conceptos de viáticos".
# Secuencia del estímulo
Esta vista será cargada una vez se haya dado clic en la opción "Comprobantes" desde el sidebard.
Para poder filtrar se requiere seleccionar filtros(cualesquiera) y posteriormente dar clic en el botón de 'Buscar'. Esto enviará una petición al sistema SIV-TCR que devolverá todos los datos filtrados necesarios para llenar las gráficas.
# Requisitos funcionales asociados
# 1. Solicitudes deducibles y no deducibles - Cantidad de comprobantes
# 2. Montos deducibles y no deducibles - Monto de comprobantes
# Razones y motivos
En esta vista encontraremos las gráficas relacionadas a los viáticos y sus razones y motivos por los cuales se solicitaron. Se podrá hacer uso de todos los filtros a excepción de "Por dispersión" y "Conceptos de viáticos".
# Secuencia del estímulo
Esta vista será cargada una vez se haya dado clic en la opción "Razones y motivos" desde el sidebard.
Para poder filtrar se requiere seleccionar filtros(cualesquiera) y posteriormente dar clic en el botón de 'Buscar'. Esto enviará una petición al sistema SIV-TCR que devolverá todos los datos filtrados necesarios para llenar las gráficas.
# Requisitos funcionales asociados
# 1. Razones - Solicitudes por razón de viaje
# 2. Razones - Monto por razón de viaje
# 3. Motivos - Solicitudes por motivo de viaje
# 4. Motivos - Monto por motivo de viaje
# 5. Comparativa - Solicitudes por razón de viaje
# 6. Comparativa - Monto por razón de viaje
# 7. Comparativa - Solicitud por motivo de viaje
# 8. Comparativa - Monto por motivo de viaje
# Lugares
En esta vista encontraremos las gráficas relacionadas a los viáticos y los lugares desde donde se solicitaron. Se podrá hacer uso de todos los filtros a excepción de "Por dispersión".
# Secuencia del estímulo
Esta vista será cargada una vez se haya dado clic en la opción "Lugares" desde el sidebard.
Para poder filtrar se requiere seleccionar filtros(cualesquiera) y posteriormente dar clic en el botón de 'Buscar'. Esto enviará una petición al sistema SIV-TCR que devolverá todos los datos filtrados necesarios para llenar las gráficas.
# Requisitos funcionales asociados
# 1. Lugares - Solicitud por región
# 2. Lugares - Monto por región
# 3. Comparativa - Itinerarios por región
# 4. Comparativa - Monto de itinerarios por región
# 5. Lugares - Número de itinerarios por sucursal
# 6. Lugares - Monto de itinerarios por sucursal
# 7. Comparativa - Itinerarios por sucursal
# 8. Comparativa - Monto de itinerarios por sucursal
# Puestos
En esta vista encontraremos las gráficas relacionadas a los viáticos y los puestos de los usuarios que los solicitaron. Se podrá hacer uso de todos los filtros a excepción de "Por dispersión".
# Secuencia del estímulo
Esta vista será cargada una vez se haya dado clic en la opción "Puestos" desde el sidebard.
Para poder filtrar se requiere seleccionar filtros(cualesquiera) y posteriormente dar clic en el botón de 'Buscar'. Esto enviará una petición al sistema SIV-TCR que devolverá todos los datos filtrados necesarios para llenar las gráficas.
# Requisitos funcionales asociados
# 1. Puestos - Solicitud por puesto
# 2. Puestos - Monto por puesto
# 3. Comparativa - Número de solicitudes por puesto
# 4. Comparativa - Monto de solicitudes por puesto
# Proveedores
En esta vista encontraremos las gráficas relacionadas a los viáticos y los proveedores que se incluyen en cada solicitud. Se podrá hacer uso de todos los filtros a excepción de "Por dispersión".
# Secuencia del estímulo
Esta vista será cargada una vez se haya dado clic en la opción "Proveedores" desde el sidebard.
Para poder filtrar se requiere seleccionar filtros(cualesquiera) y posteriormente dar clic en el botón de 'Buscar'. Esto enviará una petición al sistema SIV-TCR que devolverá todos los datos filtrados necesarios para llenar las gráficas.
# Requisitos funcionales asociados
# 1. Proveedores - Solicitud por proveedor
# 2. Proveedores - Monto por proveedor
# 3. Comparativa - Solicitud por proveedores
# 4. Comparativa - Monto por proveedores
# Vuelos
En esta vista encontraremos las gráficas relacionadas a las solicitudes de vuelos. Se podrá hacer uso de todos los filtros a excepción de "Por dispersión" y "Concepto".
# Secuencia del estímulo
Esta vista será cargada una vez se haya dado clic en la opción "Vuelos" desde el sidebard.
Para poder filtrar se requiere seleccionar filtros(cualesquiera) y posteriormente dar clic en el botón de 'Buscar'. Esto enviará una petición al sistema SIV-TCR que devolverá todos los datos filtrados necesarios para llenar las gráficas.
# Requisitos funcionales asociados
# 1. Vuelos - Solicitudes por aeropuerto
# 2. Vuelos - Monto por aeropuerto
# 3. Vuelos - Solicitudes comprobadas
# 4. Vuelos - Montos comprobadas
# 5. Comparativa - Solicitudes comprobadas
# 6. Comparativa - Montos comprobadas
# Empresas
En esta vista encontraremos las gráficas relacionadas a las solicitudes que se realizan por empresa. Se podrá hacer uso de todos los filtros a excepción de "Por dispersión".
# Secuencia del estímulo
Esta vista será cargada una vez se haya dado clic en la opción "Empresas" desde el sidebard.
Para poder filtrar se requiere seleccionar filtros(cualesquiera) y posteriormente dar clic en el botón de 'Buscar'. Esto enviará una petición al sistema SIV-TCR que devolverá todos los datos filtrados necesarios para llenar las gráficas.
# Requisitos funcionales asociados
# 1. Empresas - Solicitudes por empresas
# 2. Empresas - Monto por empresas
# 3. Facturadora - Solicitudes por facturadora
# 4. Facturadora - Montos por facturadora
# 5. Patronas - Solicitudes por patrona
# 6. Patronas - Montos por patrona
# Restricción del diseño
En algunas vistas hay filtros que no son aplicables. También los nombres muy largos en las opciones desplegables no se ven completos por lo cual hay que scrollear para ver todo el nombre.
En el listado de viáticos se muestran solo de 20 en 20 registros por lo que se agregó un buscador para avanzar a una página en específico.
Algunas gráficas no despliegan por completo los nombres de los resultados por lo cual se decidió en dejarles un espacio más grande.
# Atributos de sistema de software
Rendimiento: El sistema depende directamente del SIV-TCR así que la velocidad de carga se mantendrá rápida mientras el sistema origen se encuentre funcionando.
Seguridad: Se cuenta con un token de seguridad para el manejo de sesiones y restringir el acceso a la Api.
Usabilidad: El sistema fue creado con buenas prácticas de UIX para un fácil acceso, navegación y control del sistema.
Mantenibilidad: El sistema se creo bajo el enfoque de componentes con buenas prácticas de desarrollo lo que facilita la mantenibilidad del producto.
# Otros requisitos
Para acceder a este dashboard es necesario ser usuario de tipo "Administrador súper" e ingresar desde el sistema SIV-TCR