SISTEMATIZACIÓN DE LA GENERACIÓN DE PRESUPUESTOS PARA PROYECTOS DE OBRA: ESPECIFICACIÓN REQUERIMIENTOS DE SOFTWARE

Transcripción

1 SISTEMATIZACIÓN DE LA GENERACIÓN DE PRESUPUESTOS PARA PROYECTOS DE OBRA: SISTEMA DE ADMINISTRACIÓN DE MATERIALES DE TUBERÍA PARA INARGOS LTDA. ESPECIFICACIÓN REQUERIMIENTOS DE SOFTWARE VERSIÓN 1.0 BOGOTÁ, COLOMBIA, FEBRERO DE 2011

2 HISTORIAL DE CAMBIOS Fecha Versión Descripción Autor 5/2/ Se le da inicio al documento. Se crean las plantillas y secciones definidas por el grupo de trabajo. Camilo González González

3 TABLA DE CONTENIDO Historial de cambios Introducción Propósito Alcance Descripciones de participantes y usuarios Resumen de los participantes Clasificación y levantamiento de los requerimientos Requerimientos funcionales Documentación Requerimientos Funcionales Requerimientos no Funcionales Documentación Requerimientos No Funcionales Funciones y características del Producto Crear un proyecto nuevo Asociar sistemas y subsistemas a algún proyecto específico Asociar isométricos a un sistema específico Asociar listado de materiales a un isométrico específico Administrar materiales de tubería Administrar cantidades de obra de los materiales de tubería Generar reportes de diferentes tipos Estándares aplicables Requerimientos de documentación Interfaces Interfaces de usuario Interfaces de Software Interfaces de comunicación... 12

4 1 INTRODUCCIÓN En el presente documento se especificarán los requerimientos, temas claves a tener en cuenta antes, durante y después del desarrollo del sistema que automatiza la administración de materiales de tuberías. Se pretende analizar el contexto de negocio, los participantes principales, las necesidades básicas y las características que debe tener el producto terminado, también es básico dejar claro el alcance del proyecto y sus restricciones. Ahora bien, el producto que se va a desarrollar tiene como objetivo principal reducir los tiempos asociados a la generación de presupuestos de las secciones de tubería dentro de los proyectos de Inargos Ltda., desde este punto en adelante nos referiremos a ese producto como el sistema de administración de materiales de tubería, sistema AMT para abreviar. 1.1 PROPÓSITO El objetivo es descomponer los elementos de negocio y documentar los requerimientos funcionales y no funcionales, además se debe detallar los elementos internos y externos involucrados con el desarrollo y funcionamiento del producto. Se le da principal importancia a las necesidades y responsabilidades de cada participante del proyecto. Los detalles de cómo el sistema AMT suple cada una de las necesidades no hace parte de este documento, eso se detallará en futuras especificaciones. Finalmente el documento sirve para darle trazabilidad a los procesos y necesidades del sistema. 1.2 ALCANCE Como se especificó en el punto anterior, el documento dejará claro el contexto, necesidades, características y sus elementos involucrados, pero no pretende ofrecer una solución particular del sistema que se desea desarrollar, ni detalles de cómo se pretenden satisfacer necesidades o servicios a través de implementación.

5 2 DESCRIPCIONES DE PARTICIPANTES Y USUARIOS Con el fin de cumplir con todos los requerimientos del sistema AMT es necesario involucrar a todos los participantes, usuarios y entidades relacionadas/os con el sistema. En esta sección se describirán de forma detallada los usuarios y los participantes, haciendo énfasis en los problemas que cada uno percibe (que son precisamente los que se desean resolver). 2.1 RESUMEN DE LOS PARTICIPANTES Nombre Descripción Responsabilidad Gerencia Inargos Ltda. Empresa interesada en mejorar sus procesos de negocio asociados a la generación de presupuestos de obra. Definir las estrategias de negocio. Se espera que colaboren con permisos y actividades importantes asociadas al desarrollo del sistema AMT. Directores de proyecto Ingenieros Inargos Ltda. Auxiliares de Ingeniería Dibujantes Proveedores Materiales de Tubería Contratistas Principal representante de algún proyecto específico, es el vínculo entre el cliente y la compañía. Grupo de personas encargadas de desarrollar algún proyecto específico dentro de la compañía, con la ayuda y supervisión del Director de proyecto. Grupo de apoyo a los proyectos dentro de Inargos Ltda. Expertos en el manejo técnico de herramientas de software asociadas al dibujo y modelado. Empresas dedicadas a la venta de suministros de materiales de tubería. Encargados del abastecimiento y transporte de los productos. Empresas dedicadas a la construcción, fabricación y montaje de los elementos de los proyectos de diseño. Vigilar y controlar el ciclo de vida de los proyectos. El objetivo es trabajar en equipo y definir en detalle las funcionalidades del sistema AMT. Es importante la cooperación con el desarrollo del sistema AMT y colaborar con la definición de las tareas/procesos de cada uno asociadas al producto. Es importante la cooperación con el desarrollo del sistema AMT y colaborar con la definición de las tareas/procesos de cada uno asociadas al producto. Es importante la cooperación con el desarrollo del sistema AMT y colaborar con la definición de las tareas/procesos de cada uno asociadas al producto. Suministrar de una forma u otra los precios asociados a los materiales de tubería. No tienen ninguna responsabilidad con el sistema AMT. Al contrario, las funciones del sistema AMT ayudaran a generar documentos para que el trabajo del contratista sea más

6 preciso y eficiente. Subcontratistas Empresas dedicadas al diseño e interventoría, las cuales Inargos Ltda. suele subcontratar para apoyar el desarrollo de algún proyecto específico. A la hora de participar en un proyecto de diseño deben colaborar con el suministros de listas de materiales y precios asociados a los diseños que ellos realizaron. Clientes Inargos Ltda. Empresas interesadas en contratar los servicios de Inargos Ltda. Suministrar información asociada al proyecto para llevarlo a cabo con éxito. El sistema AMT brindará varios beneficios asociados a las cantidades de obra y precisión de los presupuestos de compra. Arquitecto Arquitecto de software del sistema AMT. Diseñador de más alto nivel de la estructura del sistema. Definir patrones y abstracciones importantes del sistema, los cuales proporcionan un marco de trabajo importante para el futuro diseño detallado y desarrollo del producto. Analistas Grupo de análisis de las necesidades de Inargos y los requerimiento del sistema AMT. Realizar estudios preliminares, definir los procesos de negocio asociados al sistema y documentar los requerimientos del producto. Diseñador Diseñadores del sistema AMT Desarrollar diseño detallado del sistema AMT, teniendo en cuenta todo el trabajo previo del arquitecto y los analistas. Desarrollador Grupo de pruebas Grupo encargado de implementar y desarrollar el sistema AMT Grupo encargado de realizar las pruebas, para asegurar la calidad y funcionamiento del producto. Implementar y desarrollar todo los diseños y soluciones propuestas para el correcto funcionamiento del sistema AMT. Utilizar herramientas especializadas y crear conjuntos de pruebas para probar todas las funcionalidades y atributos de calidad del sistema AMT.

7 2.2 CLASIFICACIÓN Y LEVANTAMIENTO DE LOS REQUERIMIENTOS Para levantar y documentar todos los requerimientos asociados al sistema AMT se desarrollarán entrevistas y se documentarán los procesos de negocio; con base en estos documentos se identificarán todos los requerimientos funcionales y no funcionales necesarios. 3 REQUERIMIENTOS FUNCIONALES Dentro del proceso de entrevistas y modelado de los procesos de negocio, se identificaron tres grandes módulos necesarios, estos tres grande módulos nos ayudan a agrupar los requerimientos funcionales. Módulo de Clientes o Este módulo se encargará de administrar toda la información relacionada con los clientes: Nombres, correos, industria, Direcciones, Contactos, Referencias, cuentas asociadas, perfil, etc. Módulo de Materiales o Este módulo tiene como objetivo resumir y recolectar toda la información de items de tubería junto con sus atributos asociados. El módulo debe ser flexible para agregar nuevos atributos a medida que el negocio varié. o El módulo debe tener funcionalidades básicas, tal como búsquedas, ediciones, agregación. Todos los requerimientos serán debidamente documentados a continuación y en los anexos correspondientes Módulo de Proyectos o Finalmente el módulo de proyectos es un componente que agrupa y hace uso de los otros dos módulos: del módulo de clientes y del módulo de items de materiales. El módulo tiene como objetivo agrupar toda la funcionalidad asociada a la administración de materiales dentro de un proyecto cualquiera y a organizar todas las consultas necesarias para que la aplicación agregué valor a la organización. 3.1 DOCUMENTACIÓN REQUERIMIENTOS FUNCIONALES Por favor referirse a la documentación de los requerimientos y sus modelos asociados en el siguiente vínculo:

8 4 REQUERIMIENTOS NO FUNCIONALES Atributo de calidad Usabilidad: Entendibilidad, aprendizaje, operatividad, claridad y ayudabilidad. Funcionalidad: Precisión Funcionalidad: Interoperabilidad Confiabilidad: Tolerancia a fallas y recuperación Portabilidad: Adaptabilidad e Instalabilidad Descripción Esfuerzo necesario para el uso. Tal como esfuerzo de los usuarios para reconocer los conceptos lógicos y su aplicación, el esfuerzo para el aprendizaje de los servicios y funciones y, el esfuerzo para operar y controlar las operaciones. Por otro lado debe tener ayudas y debe ser claro en la presentación de los datos. Los resultados arrojados por el sistema deben ser correctos y precisos. Se puede revisar las operaciones realizadas y obtener un estudio de la precisión de los resultados. Aunque el primer prototipo no debe interactuar con ningún otro sistema, se espera que el producto este preparado para una futura integración con diversos sistemas en versiones posteriores. Se desea que el producto tenga un nivel específico de funcionamiento aún en casos de fallas de software o de algún servicio específico. También debe permitir recuperar datos y trabajos en caso de ciertos errores. Oportunidad para adaptar el producto de software a diferentes entornos sin dificultad. El sistema también debe ser sencillo de instalar o desinstalar. 4.1 DOCUMENTACIÓN REQUERIMIENTOS NO FUNCIONALES Por favor referirse a la documentación de los requerimientos y sus modelos asociados en el siguiente vínculo:

9 5 FUNCIONES Y CARACTERÍSTICAS DEL PRODUCTO 5.1 CREAR UN PROYECTO NUEVO El sistema brindará una interfaz para crear proyectos nuevos. Un proyecto puede tener asociados varios sistema y dentro de cada sistema pueden existir varios isométricos con listados de materiales. El sistema manejará información básica de cada proyecto, tal como identificación, clientes asociados, fechas, número de sistemas e isométricos, etc. 5.2 ASOCIAR SISTEMAS Y SUBSISTEMAS A ALGÚN PROYECTO ESPECÍFICO Se debe poder asociar sistemas a cada proyecto. Por ejemplo, se podría desear asociar a un proyecto cualquiera los sistemas de aguas lluvias, aditivos, vapor y condensados, o más si es necesario. Cada sistema tendrá su respectivo nombre, identificación y proyecto al cual pertenece. 5.3 ASOCIAR ISOMÉTRICOS A UN SISTEMA ESPECÍFICO El sistema permitirá asociar isométricos a cada sistema. Cada isométrico tendrá información básica como proyecto y sistema al cual pertenece, su respectiva numeración, isométricos de los cuales depende, y lo más importante, la lista de materiales asociada a él. 5.4 ASOCIAR LISTADO DE MATERIALES A UN ISOMÉTRICO ESPECÍFICO El sistema permitirá asociar materiales de tubería a los diferentes isométricos, cada material cuenta con diferentes propiedades, entre las cuales no pueden faltar: nombre, tamaño principal, tamaño secundario, detalles, precios y cantidad. 5.5 ADMINISTRAR MATERIALES DE TUBERÍA Administrar materiales de tubería se refiere a todo lo relacionado con creación, eliminación y modificación de los elementos y componentes de la tubería como tal. Debe ser sencillo ver listados de estos materiales, hacer búsquedas y utilizarlos dentro de los diferentes listados de cada isométrico. 5.6 ADMINISTRAR CANTIDADES DE OBRA DE LOS MATERIALES DE TUBERÍA El sistema tendrá una interfaz para manipular las cantidades de obra asociadas a cada sistema o isométrico si se desea. Entiéndase cantidades de obra todo lo complementario a los elementos de tubería, tal como pintura, tornillería, soldadura, etc. 5.7 GENERAR REPORTES DE DIFERENTES TIPOS La funcionalidad principal del sistema. Se sea obtener reportes de diferentes tipos, entre los cuales no puede faltar: consolidado de materiales por proyecto, por sistema o por isométrico, también debe generar consolidados de la unión de dos subsistemas, generar consolidados de la diferencia entre dos

10 isométricos o dos subsistemas, y debe obtener los isométricos o sistemas en los cuales se está usando un material específico (búsqueda inversa).

11 6 ESTÁNDARES APLICABLES La aplicación está basada completamente en estándares, pues los estándares son fundamentales dentro de cualquier aplicación. A través de la historia se han creado muchos estándares para facilitar la comunicación y el intercambio de información: desde monedas, manejo del tiempo, hasta lenguajes de programación y protocolos de redes. Java Empresarial: Java Empresarial maneja muchos estándares abiertos que son implementados por frameworks comerciales (web logic, websphere, MQSeries, etc) y open source (GlassFish, JBoss, Hibernate, Open JPA, Jersey, etc). PostgreSQL: Es un sistema open source de bases de datos relacionales, el motor es muy poderoso y tiene más de quince años de desarrollo y de experiencia. Tiene una arquitectura probada que ha demostrado cumplir requerimientos de integridad y calidad de datos. La mayoria de sistemas operativos la soportan y es fuertemente enfocada a manejar estándares. Por ejemplo su implementación de SQL va de acuerdo con el ANSI-SQL:2008. La mayor importancia de manejar estándares, dentro de la aplicación empresarial, es su facilidad para integrar los sistemas con sistemas de terceros o delegados, otra gran ventaja es que permite desarrollar aplicaciones in-house e integrarlas sin complicación. 7 REQUERIMIENTOS DE DOCUMENTACIÓN El programa deben contar con un manual de usuario, totalmente documentado.

12 8 INTERFACES A continuación se describen las interfaces con las que el sistema AMT tendrá interacción de algún tipo. 8.1 INTERFACES DE USUARIO Teclado: El usuario tendrá una alta interacción con el teclado para interactuar con la aplicación. Todo el ingreso de información se realizará por este medio. Ratón: Al igual que el teclado, el ratón es una interfaz fundamental para el ingreso de datos, manipulación de la información y uso de la aplicación. Es una interfaz necesaria e indispensable. Pantalla: Toda la interacción gráfica y visual se realizará por medio de una pantalla o monitor. Este debe soportar mínimo una resolución de 1024 x 768 con una profundidad de color de mínimo 32 bits. Sistema Operativo: La máquina de los clientes puede contar con cualquier sistema operativo que soporte los navegadores web más populares dentro del mercado. En la máquina de servidor se puede usar cualquier distribución de Linux, pero también se puede usar Windows Xp o Superior. En general cualquier sistema operativo de soporte instalación de glassfish. Red: La compañia debe contar con requerimientos básicos de red, tal como un red de área local. Los computadores y servidores deben contar con tarjetas de red fast ethernet. Interfaz Gráfica de Usuario: La aplicación contará con una interfaz web de usuario, altamente personalizable. Desarrollada en HTML y con hojas de estilo adaptables. 8.2 INTERFACES DE SOFTWARE GlassFish Aplication Server: El servidor de aplicación JavaEE que acogerá las aplicaciónes web y empresariales. El sistema esta implementado basado en estándares y es indispensable para que la aplicación se ejecute y esté disponible día a día. Navegador Web: Programa que debe estar instalado en todas las maquinas de los clientes. Software indispensable para interactuar con la aplicación. 8.3 INTERFACES DE COMUNICACIÓN El protocolo de comunicación principal será TCP/IP, un protocolo orientado a la conexión, conocido y arraigado en las redes y entornos globales. Un protocolo de comunicación probado y que brinda muchas facilidades.