Versión 3.0
SANTIAGO GARCÍA, Marcos MARTÍNEZ CARVAJAL, Juan MATEO FIOL, Alex LLAMBIES CABOT, Miquel
27-4-2016
Software Firefighter (SF)
DOCUMENTO DE
REQUISITOS
Página | 1
Control de Versiones
Versión Fecha ModificacionesVersión 1.0 13/03/2016 -Especificación de requisitos iniciales Versión 1.2 07/04/2016 -Actualización de los requisitos
Versión 1.3
12/04/2016 -Actualización de los requisitos
-Desarrollo de prólogo, apéndice y Stakeholders
Versión 1.4 17/04/2016
-Actualización de prologo y apéndice -Desarrollo de la introducción -Actualización de los requisitos Versión 1.5 20/04/2016 -Desarrollo del glosario Versión 1.6 21/04/2016 -Mejora de los requisitos: DE y TC Versión 2.0 27/04/2016
-Desarrollo de requisito no funcional -Ampliación de glosario
-Desarrollo de modelos del sistema (casos de uso)
Versión 2.1 12/05/2016
-Agrupación de requisitos DE -Modificación de diagrama de casos de uso Versión 2.2 13/05/2016
-Actualización del diagrama de casos de uso -Actualización del glosario
-Modificación del Apéndice Versión 2.3 20/05/2016 -Desarrollo de diagramas de secuencia Versión 2.4 21/05/2016 -Desarrollo de diagrama de clases Versión 3.0 27/05/2016 -Desarrollo de interfaces de usuario
Página | 2
Prólogo
El documento de requisitos ayuda a asegurar que todos los lectores estén informados de los pasos que vayan a producirse durante el proyecto.
Esto puede evitar ciertos malentendidos como la realización de requisitos inconsistentes o incompletos, malentendidos entre los clientes y desarrolladores o falta de inclusión de prestaciones iniciales.
El documento funcional específica, antes de que se empiece a programar, como debe ser el software y qué es lo que debe hacer.
Un documento de requisitos sólido también sirve como una guía para el desarrollo, la evolución y para mantenimiento del programa. Teniendo una lista de las funciones que el producto debe suplir, es más sencillo crear un producto que abarque los requisitos especificados.
También puede ayudarle a organizar el tiempo y los recursos de manera más eficiente, y planificar su proyecto con mayor precisión.
Además, el desarrollador puede consultarlo para aclarar cualquier duda que tenga sobre cómo funciona el software.
Página | 3
Índice
Control de Versiones --- Página 1
Prólogo --- Página 2
Índice --- Página 3
Introducción --- Página 4
Stakeholders --- Página 6
Definición y Especificación de Requisitos --- Página 7
Modelos del Sistema --- Página 10
o Diagrama de casos de uso --- Página 10
o Diagrama de clases --- Página 11
o Diagramas secuencia --- Página 13
Generar contrato --- Página 13
Consultar contrato --- Página 14
Reservar material --- Página 15
Notificar incidencia --- Página 16
o Interfaces de usuario --- Página 17
Reservar material --- Página 17
Consultar contrato --- Página 20 Glosario --- Página 22
Página | 4
Introducción
IBN es una empresa dedicada a la informática. Se ofrecen 3 tipos de contrato al cliente los cuales son reparar, hacer un mantenimiento preventivo y el desarrollo de proyectos. Los contratos de mantenimiento se contratan por horas a la semana mientras que los otros dos por trabajo realizar.
Para realizar los trabajos la empresa cuenta con un equipo de 10 técnicos distribuidos por las Islas Baleares donde hay 7 técnicos en Mallorca, 2 en Ibiza y 1 en Menorca. Los técnicos cuentan con un almacén, gestionado por el director de operaciones y director ejecutivo los cuales consultan el material que no esté en stock para reponerlo y ponerlo a disposición para futuras tareas. También cuentan con furgonetas con
herramientas para realizar el trabajo.
El director ejecutivo, abrumado por el papeleo que la administración de la empresa causaba, nos contrató para desarrollar una aplicación informática que tendrá por objetivo ayudarle en la administración de la empresa, agilizar y hacer más sencilla y rápida la información de los servicios ofrecidos. Ésta constará de diversas funciones para ayudar a los empleados en sus tareas diarias.
Para el director de operaciones, la aplicación deberá asistirle en las tareas de
administración interna de la empresa, es decir, ayudarle a llevar un registro actualizado del material de la empresa, desde furgonetas a las herramientas del almacén. También deberá facilitar la comunicación y la asignación de tareas entre técnicos a partir de consultas en los contratos con los clientes y las peticiones que éstos generen.
Los técnicos podrán ver sus tareas a realizar. Una vez realizada cada tarea se facilitará un espacio para que documente los detalles de futuras incidencias o la imposibilidad de terminar la tarea asignada para que cualquier técnico pueda continuar dicha incidencia desde donde lo dejó el técnico anterior.
Para el director ejecutivo, la aplicación va más enfocada en atención al cliente. Así deberá registrar las llamadas que se realicen con los clientes, dar facilidades en la creación del contrato con el cliente tanto si se trata de un proyecto, reparaciones o de mantenimiento preventivo. Como es natural cada tipo de contrato contará con sus opciones de creación.
El cliente podrá valorar la atención recibida por el técnico y la satisfacción de dicho trabajo, además de solicitar atención.
Con esta aplicación se podrá agilizar los servicios que ofrece IBN haciendo más fluido y menos pesado la interacción entre los stakeholders así como la sencillez y rapidez de las tareas.
El cliente solicitará a través de una llamada telefónica o en persona uno de los servicios ofrecidos por la empresa y cuando consigan un acuerdo se creará el contrato que podrá
Página | 5
ser visible en la aplicación. Se le acreditará al cliente una clave de acceso y una ID para poder identificarse y acceder a las funciones que le proporciona el sistema.
El director ejecutivo le confirmará cuando podrá ser atendida su petición.
Además, cuando el cliente reciba su servicio, podrá valorar el servicio y notificar su descontento en algún aspecto si se ha producido alguna incidencia o problema a través de la aplicación.
Por la otra parte, el técnico que esté haciendo la tarea si le hace falta alguna herramienta que no tiene en su furgoneta, podrá pedírsela al director de operaciones para más tarde cogerla del almacén de la propia empresa y el director de operaciones actualizará el stock del material del almacén.
El técnico también es responsable de hacer el presupuesto al cliente y notificar la finalización del trabajo donde se creara un registro del trabajo con información sobre cuantas horas ha trabajado, que tipo de servicio, los materiales usados y posibles nuevas incidencias detectadas.
El director de operaciones en todo momento podrá saber dónde se encuentran sus trabajadores (los técnicos) y la localización de sus clientes, y el podrá gestionar las tareas repartiéndolas entre los técnicos más cercanos a la ubicación del cliente.
También, junto al director directivo serán capaces de ver el historial de su almacén para saber que herramientas y que materiales han sido proporcionadas a sus técnicos.
Una vez finalizado el servicio, el técnico previamente había de marcar la tarea en curso y al terminar tendrá que actualizar su estado como finalizada. A partir de ahí podrá pasar a la siguiente tarea.
Página | 6
Stakeholders
Director de Operaciones (DO):Persona encargada de dirigir la empresa IBN cuyas funciones principales son distribuir las tareas a los técnicos y saber en todo momento donde se encuentra su personal junto a su disponibilidad. Sus funciones se complementan con el Director Ejecutivo como es el control del almacén y las consultas de las incidencias de los clientes.
Director Ejecutivo (DE): Persona que forma parte de la empresa IBN cuyas funciones son crear contratos legales con los clientes que lo soliciten, atender sus peticiones y consultar todo tipo de registros para llevar un control de la empresa. También comparte el control del almacén con el Director de Operaciones.
Técnico (TC): Personas que trabajan en la empresa IBN y realizan una tarea dependiendo de la incidencia asignada cumpliendo con las condiciones del contrato del cliente. Este puede solicitar herramientas y materiales que le sean necesarios notificándolo a los encargados del almacén. Al final de la tarea realiza un reporte de cómo ha ido la incidencia.
Cliente de IBN (CL): Persona que solicita una tarea a la empresa IBN previamente teniendo un contrato con la empresa. Puede contratar el servicio de reparaciones, creación de proyectos, como los de instalación o para el desarrollo de una aplicación, o mantenimiento preventivo de un sistema informático ya existente. Este podrá valorar el servicio realizado del técnico.
Página | 7
Definición y Especificación
de Requisitos
-Requisitos funcionales
Requisitos del Director de Operaciones
o R_DO0: Consultar ubicación de técnicos
o R_DO1: Consultar tareas aceptadas
o R_DO2: Comprobar disponibilidad de los técnicos Calendario de disponibilidad
Tarea actual
o R_DO3: Consultar contratos de clientes
o R_DO4: Distribuir tareas a los técnicos
Especificar el contrato del cliente
Especificar incidencia registrada del cliente
Especificar ubicación del cliente
Especificar rango de horarios del cliente
Especificar horas de trabajo disponibles
o R_DO5: Consultar registro de material
Proporcionar listado de material usado por un técnico
Proporcionar listado de material en stock
o R_DO6: Registrar material
Especificar material en stock
Especificar material asignado a un técnico
Especificar material nuevo
Requisitos del Director Ejecutivo
o R_DE0: Consultar registro de material
Proporcionar listado de material usado por un técnico
Proporcionar listado de material en stock
o R_DE1: Registrar material
Especificar material en stock
Especificar material asignado a un técnico
Especificar material nuevo
o R_DE2: Generar contrato legal con el cliente
Registrar detalles especiales del cliente
Responsable por ausencia de titular del contrato
Información de incidencias anteriores sobre un material
Registrar tipo de servicio
Información sobre el servicio requerido
Registrar condiciones de cliente
Página | 8 Proporcionar acreditación (ID y clave de acceso)
o R_DE3: Modificar condiciones del contrato de cliente
o R_DE4: Consultar historial del cliente Incidencias registradas del cliente
Incidencias nuevas Incidencias resueltas Historial de valoración de servicio
o R_DE5: Consultar ficha del técnico Incidencias registradas del técnico Estadísticas de técnico
Horas trabajadas totales Número de incidencias resultas Media de las valoraciones del cliente Calendario de disponibilidad
o R_DE6: Consultar contratos de clientes
o R_DE7: Generar nóminas de técnicos
Información de tareas asignadas
Horas trabajadas (mes)
o R_DE8: Evaluar incidencias
Aceptar/rechazar incidencia registrada
Notificar tareas aceptadas al director de operaciones
Requisitos de Técnico
o R_TC0: Consultar tareas
Tareas pendientes
Tareas para hoy
Tarea concreta
Tareas urgentes
Información de una tarea
Contrato de cliente
Historial de incidencias anteriores
Ubicación y horario
Estado de la incidencia
Grado de la incidencia
o R_TC1: Reservar material
Especificar familia, modelo, cliente Especificar cantidad
o R_TC2: Actualizar calendario de disponibilidad
Horarios disponibles
Días disponibles
o R_TC3: Confirmar tarea como realizada
Informar horas de servicio
Especificar incidencia en servicio
Página | 9
Requisitos de Cliente
o R_CL0: Identificarse con datos de acreditación
o R_CL1: Consultar contrato legal
o R_CL2: Notificar incidencia
Clasificar el grado
Especificar detalles de incidencia
o R_CL3: Valorar servicio proporcionado por el técnico
o R_CL4: Notificar una queja de un servicio proporcionado
Detallar motivo de queja
Especificar datos del técnico
-Requisitos no funcionales
Disponibilidad de la aplicación de las 24 horasPágina | 10
Modelos del Sistema
Desarrollo de los modelos con los que ofrecemos una descripción del sistema.
Página | 11 -DIAGRAMA DE CLASES
Página | 12 Nuestras piezas, que son de clientes, todas pertenecen a un tipo de modelo y este modelo a una familia, esto es para poder realizar una búsqueda avanzada sobre las piezas y poder encontrar con más facilidad la pieza deseada. Estas piezas se guardan en un almacén que puede tener muchas piezas.
Nuestros técnicos tienen una o más disponibilidades, marcando cuando ellos están
disponibles, la disponibilidad en sí sería el conjunto de todos esos días disponibles. También relacionado con un técnico, a éste se le asignan varias tareas, aunque puede ser que no tenga ninguna asignada en el momento, y cada tarea puede ser realizada por uno o más técnicos. Una tarea siempre está relacionada con su contrato y éste puede dar lugar a una o más tareas. También una tarea puede tomarse como una incidencia siempre que proceda de un contrato de reparación emergente que entonces esa tarea estará relacionada con la incidencia. Nuestros clientes pueden realizar las valoraciones que quieran, por lo que pueden estar relacionados de cero a muchas valoraciones, y cada valoración va sólo relacionada con el cliente que la haya realizado. A parte cada cliente puede tener de cero a más contratos depende de los que haya firmado con nosotros y cada contrato está relacionado con un único cliente.
Página | 13 -DIAGRAMAS DE SECUENCIA
Página | 14 ·R_DO3: Consultar contratos de clientes
Página | 15 · R_TC1: Reservar material
Página | 16 · R_CL2: Notificar incidencia
Página | 17
-INTERFACES DE USUARIO · R_TC1: Reservar material
Página | 18
Página | 19
Página | 20 ·R_DO3: Consultar contratos de clientes
Página | 21
Página | 22
Glosario
Reparación: Servicio ofrecido por la empresa en la cual arreglamos el hardware estropeado del usuario.
Incidencia: Es un problema por parte de un usuario el cual puede provenir de una petición de servicio por parte del cliente donde este explica los daños causados por el problema o mientras un técnico está en proceso de una tarea.
Registro: Documento en el cual se archivan las actualizaciones de datos. Donde estos pueden ser listas de tareas de técnicos, de incidencias, entrada y salida de herramientas del almacén.
Mantenimiento preventivo: Revisión periódica del hardware y de sistemas informáticos con el fin de evitar futuras incidencias y garantizar su correcto funcionamiento.
Herramienta: Es un instrumento el cual es usado por un técnico para poder reparar alguna cosa concreta.
Material: Es un tipo de objeto, concretamente relacionado con piezas
tecnológicas, el cual es usado por un técnico para sustituirlo por otro o aplicarla a la reparación.
Stock: Unidades disponibles de aquel material que sea necesario o solicitado. Queja; Es una notificación por parte del cliente dirigida al director ejecutivo en
la que el cliente describe un problema que haya sucedido con el técnico mientras estaba atendiendo su tarea.