• Author / Uploaded
• EduArdo Rubio CAbanillas

Citation preview

2014

Especificación De Requerimientos

ELABORADO POR: Eric Velandia Sebastián Vivas VERSION APROBADA: 2.4 UNIVERSIDAD: Pontificia Universidad Javeriana

Tabla de Contenido Historial De Revisiones .............................................................................................. 2 Tabla de Ilustraciones............................................................................................... 4 1.

2.

3.

4.

Introducción........................................................................................................ 5 1.1

Propósito ....................................................................................................... 5

1.2

Alcance ........................................................................................................ 5

Descripción General.......................................................................................... 6 2.1

Perspectiva ................................................................................................... 6

2.2

Funciones del Producto ............................................................................. 7

2.3

Clases y Características del Usuario ........................................................ 7

2.4

Ambiente Operativo................................................................................... 7

2.5

Restricciones de Diseño y Desarrollo ....................................................... 7

Requerimientos de Interfaces Externas .......................................................... 9 3.1

Interfaces de Usuario .................................................................................. 9

3.2

Interfaces de Hardware ........................................................................... 10

3.3

Interfaces de Software ............................................................................. 10

3.4

Interfaces de Comunicación .................................................................. 11

Características del Sistema ............................................................................ 12 4.1 Metodología de Especificación ................................................................. 12 4.2 Metodología de Priorización ....................................................................... 13 4.3 Plantilla de definición de requerimientos y funcionalidades ................ 14 Anexo A: Glosario ............................................................................................... 15 Anexo B: Modelos De Análisis............................. Error! Bookmark not defined.

Referencias .............................................................................................................. 16

Pagina. 1

Historial De Revisiones Nombre

Fecha

Cambio

Versión

Eric Velandia, 2 de Agosto, 2014 Introducción, 1.0 Sebastián Vivas Descripción General y Plantilla de requerimientos Eric Velandia, 4 de Agosto, 2014 Correcciones 1.1 Sebastián Vivas secciones 1, 2 e Interfaces externas Eric Velandia, 7 de Agosto, 2014 Correcciones Sebastián Vivas sección 3

1.2

Eric Velandia, 9 de Agosto, 2014 Plantilla de 1.3 Sebastián Vivas requerimientos Eric Velandia, 13 de Sebastián Vivas 2014

Agosto, Citas, Notas, Pie 1.4 de página, Correcciones sugeridas.

Eric Velandia, 13 de Sebastián Vivas 2014

Agosto, Correcciones Generales

Eric Velandia, 15 de Sebastián Vivas 2014

Agosto, Organización del 2.1 documento, pie de página, referencias

Eric Velandia, 16 de Sebastián Vivas 2014

Agosto, Metodologías de 2.2 recolección.

Pagina. 2

2.0

Eric Velandia, 17 de Sebastián Vivas 2014

Agosto, Metodologías de 2.3 priorización.

Eric Velandia, 3 de Noviembre Sebastian Vivas

Pagina. 3

Correcciones Finales

2.4

Tabla de Ilustraciones Ilustración 1: Proceso de facturación de un tiquete .......................................... 6 Ilustración 2: Interfaces de usuario......................................................................... 9 Ilustración 3: Interfaces de Hardware.................................................................. 10 Ilustración 4: Especificación Ágil de Requerimientos........................................ 12 Ilustración 5: Metodología de priorización ......................................................... 13

Pagina. 4

1. Introducción En el presente documento se definen y analizan los requisitos del sistema “Aplicación Móvil Para La Transferencia Y Aprobación De Tiquetes De Servicio Por Medio De Tecnología NFC” el cual será desarrollado por los estudiantes de ingeniería de sistemas, Eric Velandia Colmenares y Sebastian Vivas Ospina de la Pontificia Universidad Javeriana como trabajo de grado. Para este documento se adopta la guía de requerimientos de software de la IEEE (Estándar 830 -1993) [1]i.

1.1

Propósito

El propósito de este documento es definir el funcionamiento general y dar a conocer las características más relevantes del proyecto “Aplicación Móvil Para La Transferencia Y Aprobación De Tiquetes De Servicio 4 Por Medio De Tecnología NFC”, se tendrán en cuenta características tanto funcionales como no funcionales las cuales serán explicadas de manera detallada al usuario final.

1.2

Alcance

El proyecto “Aplicación Móvil Para La Transferencia Y Aprobación De Tiquetes De Servicio Por Medio De Tecnología NFC” se basa en la recepción de tiquetes de servicios petroleros en la locación, por medio de la tecnología de Comunicación de campo cercano para la respectiva revisión y aprobación por parte del encargado en la locación (Company Man) 2 y el ingeniero dueño del contrato (contract owner).

Pagina. 5

2. Descripción General En esta sección se definen los aspectos generales del sistema. Abarcando funciones generales del producto descripción del ambiente operativo 1 y características que se tienen en cuenta del usuario final2.

2.1

Perspectiva

En los campos petroleros se manejan diferentes servicios como, lodos 3 , cementos 4 , herramientas en general entre otros, cada compañía de servicios realiza una serie de trabajos en la locación y al final de cada trabajo entregan un tiquete de servicio físico, el cual cuenta con una breve descripción del trabajo y los ítems usados en dichas operaciones con sus respectivos costos. Estos tiquetes son revisados por el Company Man y previamente aprobados. Una vez el tiquete es aprobado en campo, es cargado dentro de una base de datos 5 y posteriormente el tiquete es enviado a las oficinas en Bogotá para una nueva revisión y aprobación por parte del ingeniero a cargo del respectivo contrato. Finalmente el tiquete es aprobado y facturado. Este proceso tarda varios días y consume muchos recursos naturales como el uso innecesario de papel. Esta propuesta busca digitalizar y agilizar este proceso mediante Tecnología móviles permitiendo la transmisión mediante NFC, la aprobación por medio de dispositivos móviles y su envió mediante los mismos. En el siguiente cuadro se explica el proceso de aprobación actual:

Entrega del tiquete

Aprobacion en campo

Envio a oficinas

Aprobacion en oficinas

Facturacion del servicio

ILUSTRACIÓN 1: PROCESO DE FACTURACIÓN DE UN TIQUETE

Ambiente operativo: conglomeración de sistema operativo e interfaz de usuario. Usuario Final: Usuario para quien se construye el producto, quien usará el producto. 3 Lodos: el servicio de lodos contiene los productos químicos que conforman un barril de fluido el cual va a ser usado para la perforación del pozo. Las principales características del lodo es dar lubricidad, mantener la presión del hueco y ayudar a la limpieza. 4 Cementos: El servicio de cementos es usado para mantener la tubería en su sitio y ayudar a que el hueco no se derrumbe. 5 Base de datos: Conjunto de datos almacenados en una maquina dentro de tablas. 1 2

Pagina. 6

2.2

Funciones del Producto

Las funciones generales del producto son listadas a continuación: •

Transferencia de archivos por medio de NFC. 1

•

Aprobación de documentos mediante firmas digitales 6 por usuario.

•

Envió de documentos por medio de correo electrónico.

•

Revisión de documentos.

• Generación de reportes para la carga de tiquetes a una base de datos Oracle.

2.3

Clases y Características del Usuario

Existen tres tipos de usuarios los cuales se definen y detallan a continuación: • Account Manager: es el encargado de atender los diferentes requerimientos de los usuarios y es quien entrega el tiquete del servicio prestado en campo al company man3. • Company Man: es la persona encargada de la locación en donde se están ejecutando los diferentes trabajos por parte de las compañías de servicios y es la persona quien recibe el tiquete de la compañía de servicios. • Contract Owner: es el ingeniero encargado de un contrato de servicio usado en campo, es la persona responsable de la aprobación final del tiquete.

2.4

Ambiente Operativo

El software debe correr bajo el sistema operativo Android en dispositivos móviles que cuenten con Tecnología NFC 1 para la transmisión de archivos.

2.5

Restricciones de Diseño y Desarrollo 7

Se debe hacer uso de los protocolos de intercambio de datos vía internet y NFC 1. Respecto a la seguridad, se debe considerar el uso de sesiones para limitar el acceso a usuarios no autorizados.

Firmas Digitales: mecanismo criptográfico que permite identificar a un individuo de manera digital. 7 Restricciones de diseño y desarrollo: limitaciones con las que se cuentan a causa de la arquitectura y diseño del producto. 6

Pagina. 7

El cliente no ha especificado ninguna otra limitante en diseño o desarrollo, y algunos de las características las dejó al criterio de los desarrolladores.

Pagina. 8

3. Requerimientos de Interfaces Externas En esta sección se trataran los requisitos del sistema 8 de una manera detallada, haciendo énfasis en la cada una de las interfaces del sistema y las funcionalidades del mismo.

3.1

Interfaces de Usuario9

Teclado

SmartPhone

Pantalla

ILUSTRACIÓN 2: INTERFACES DE USUARIO ✓ Smartphone: Es el hardware principal en donde se ejecutará el sistema y cuenta con varios componentes necesarios para el funcionamiento óptimo del sistema.

o Pantalla: mediante este dispositivo, el usuario podrá visualizar los datos y demás resultados del sistema, además gracias a la

Requisitos del sistema: necesidad que debe ser satisfecha por el producto para cumplir con todas sus funcionalidades. 9 Interfaces de usuario: superficies con las que el usuario final debe interactuar. 8

Pagina. 9

interfaz gráfica de la aplicación el usuario podrá desarrollar diferentes tareas de selección y visualización. o Teclado: por medio de este dispositivo el usuario podrá introducir algunos datos requeridos por el sistema.

3.2

Interfaces de Hardware

NFC Chip ILUSTRACIÓN 3: INTERFACES DE HARDWARE 

3.3

Chip NFC: el sistema necesita de un chip NFC 1, el cual viene integrado al dispositivo móvil para la transferencia de datos entre dispositivos Smartphone. Este dispositivo es fundamental para el funcionamiento del sistema ya que por medio de este chip se realizaran diferentes tareas.

Interfaces de Software

Las interfaces de software requeridas por el sistema son: o El sistema operativo Android 10 versión 4.4 Kitkat, sobre el cual se ejecutara el aplicativo. Para evitar problemas de compatibilidad en los dispositivos en los cuales se ejecutaran las pruebas.[2]ii

Android: sistema operativo usado por la compañía google en gran cantidad de dispositivos móviles. 10

Pagina. 10

o Dalvik Virtual Machine 11 , la cual será la encargada de traducir el lenguaje de alto nivel.

3.4

Interfaces de Comunicación

o Las interfaces de comunicación con las cuales interactuará el sistema son: o El protocolo de comunicación ISO/IEC 14443 el cual es un estándar para tarjetas de proximidad. [3]iii Ya que es el estándar oficial para NFC 1 en dispositivos móviles. o E-mail para la comunicación entre usuarios.

Virtual Machine: máquina virtual encargada de convertir los comandos del usuario en comandos de máquina. 11

Pagina. 11

4. Características del Sistema En esta sección trabajaremos en la plantilla de requerimientos en donde se detallan cada una de las funcionalidades del sistema y su asociación con los casos de uso.

4.1 Metodología de Especificación Agile Requirements 12 de SCRUM 13 es la metodología aplicada para la especificación de requerimientos.iv La especificación de requerimientos por medio de SCRUM es una metodología netamente comunicativa donde se plantea un documento de back log en el cual se definen las diferentes funcionalidades y requerimientos fundamentales del producto que desea el stakeholder 9v . Una vez se reúnen estas funcionalidades del producto se inicia a la fase de priorización. [4]vi vii A continuacion la ilustracion 4 recopila el detalle de la construccion del product back log:

Priorización Recopilación

Categorización

Product Backlog ILUSTRACIÓN 4: ESPECIFICACIÓN ÁGIL DE REQUERIMIENTOS

Agile Manifiesto: Es una corriente moderna de desarrollo ágil de software que se rige los siguientes supuestos: o Individuos e interacciones sobre procesos y herramientas o Software funcionando sobre documentación extensiva o Colaboración con el cliente sobre negociación contractual o Respuesta ante el cambio sobre seguir un plan 13 SCRUM: es un modelo de planeación, desarrollo e implementación de software basado en la el Agile Manifiesto. 12

Pagina. 12

4.2 Metodología de Priorización La priorización de los requerimientos es fundamental para Scrum, por tanto se definen dos (2) evaluadores en el equipo quienes una vez se reúnan los requerimientos del producto, son los encargados de asignar un puntaje de 1 a 10 a cada requerimiento dependiendo de su importancia para el producto, una vez puntuados todos los requerimientos se procede a categorizar los requerimientos en cinco (5) categorías del 1 al 5 donde 1 es la categoría de los requerimientos no tan importantes y cinco la más importante. [5] viii

Puntaje Evaluador 1

Puntaje Evaluador 2

ILUSTRACIÓN 5: METODOLOGÍA DE PRIORIZACIÓN

Pagina. 13

Categorizacion

4.3 Plantilla de definición de requerimientos y funcionalidades Para una consulta detallada de los requisitos y funcionalidades del sistema consulte la siguiente plantilla, allí encontrará una lista de requerimientos con su respectiva categorización y priorización además de una explicación de los casos de uso. Esta priorización se basa en el product back log de scrum. En donde los stake holders asignan un puntaje a cada requerimiento y ese puntaje después es organizado en diferentes categoríasix.

Ver Plantilla de Requerimientos

Pagina. 14

Anexo A: Glosario NFC (Near Field Communication): es una tecnología de comunicación inalámbrica, de corto alcance y alta frecuencia que permite el intercambio de datos entre dispositivos. 1. Locación: Área geográfica en donde se realizan operaciones de construcción, perforación o completamiento de pozos petroleros. 2. Company Man: Gerente de operaciones del taladro, es aquella persona que coordina y dirige al equipo en locación encargado de la perforación de un pozo petrolero. 3. Proveedor: persona encargada de representar a una compañía de servicios, usuario quien realiza la interacción con los ingenieros y la gente en campo. 4. Tiquete de servicio: factura que recibe la compañía por un servicio utilizado en campo. 5. Elemento de gasto: código con el cual se identifica a un servicio. 6. Contract Owner: Ingeniero que administra un contrato de servicios. 7. Campo: conjunto de locaciones. 8. Account Manager: Persona de la empresa de servicio encargada de satisfacer las necesidades del contract owner. 9. Stakeholder: es un término muy común en los proyectos de software usado para agrupar el conjunto de trabajadores, organizaciones sociales, accionistas, proveedores y demás interesados en el proyecto.

Pagina. 15

Referencias 830-1993 - IEEE Recommended Practice for Software Requirements Specifications. i

ii

Android Platform, Más información en www.android.com

ISO/IEC 14443:2008 Identification Cards, Contactless integrated circuit cards, Proximity cards iii

A Semantic and Collaborative Platform for Agile Requirements Evolution, Nirav Ajmeri, Riddhima Sejpal, Smita Ghaisas, Tata Research, Design and Development Centre (TRDDC). v A Guide to Agile Requirements Documentation, Sherif Mansour, Confluence, 2013. vi Agile Manifesto disponible en: www.agilemanifesto.org/iso/es/ iv

Agile Requirements Modeling, Scott W Amber, Disponible en: http://www.agilemodeling.com/ viii Agile Requirements Definition and Management, Scrum Alliance, disponible en: www.scrumalliance.org vii

NORPLAN: Non-functional Requirements Planning for agile processes, Farid, W.M. Mitropoulos, F.J. IEEE, 2013. ix

Pagina. 16