Hols

Basado en el documento homónimo, versión 3, generado por el GCBA (http://www.buenosaires.gov.ar/dgsinf/estandares/pautas_sistemas%203.0.zip) Para agilizar el seguimiento de los proyectos de desarrollo de software, así como para minimizar el impacto del futuro mantenimiento que estos sistemas puedan requerir, se han fijado pautas para su documentación, de modo que haya un aceptable grado deuniformidad en todo el ámbito de la Administración Pública Provincial. La documentación de un desarrollo de sistemas no se puede concebir como una actividad aislada, sino como el resultado esperado de una metodología de trabajo, de un proceso con sus etapas y tareas en cada etapa. Por lo tanto, habrá distintos documentos que se irán generando en cada etapa. Atentos a los desarrollos actuales en materiade Tecnología de la Información y a las tendencias del mercado, se permitirá abordar la documentación desde las dos estrategias de desarrollo más usuales, las denominadas Ciclo de vida Estructurado y Orientación a Objetos. Esta elección no supone negar que existan otros enfoques para el desarrollo de sistemas que estamos dejando de lado, y que se podrán analizar en cada caso. Más allá de queexisten diversas metodologías, recomendamos la adopción de la Orientación a Objetos, ya que este tipo de metodología, además de estar imponiéndose en todos los desarrollos de un par de años a esta parte, incorpora la idea del desarrollo incremental con alta participación de usuarios. Lo que sigue es, entonces, una guía para la documentación, confeccionada con el objetivo de reunir, compatibilizar ysintetizar los planteos más usuales de ambas metodologías utilizando la terminología más habitual para cada una. A continuación describimos: • • • La documentación que, al fin de cada etapa, deberá entregarse según la metodología de Ciclo de Vida Estructurado. La documentación que, al fin de cada etapa, deberá entregarse según la metodología de Orientación a Objetos. Algunas consideraciones sobre laactualización de la documentación en relación a las tareas de mantenimiento de la aplicación, luego de su puesta en producción.

Pautas para documentar desarrollos de sistemas

En todos los casos, la Dirección General de Gobierno Digital puede determinar que cierta documentación es optativa en un determinado proyecto, basándose en el tamaño y grado de complejidad del mismo.

Pág. 1 de 23a.- Ciclo de vida estructurado
ETAPA Definición de Requerimientos DOCUMENTACION Diagnóstico de la situación y necesidad del sistema Modelo del Ambiente: •Declaración de Propósitos •Diagrama de Contexto •Lista de Eventos o Catálogo de Requerimientos Glosario Diagrama de Gantt del proyecto (preliminar) Análisis Modelo de Comportamiento •Diagrama de Flujo de Datos •Especificación de procesos•Diagrama Entidad Relación •Diccionario de Datos •Diagrama de Transición de Estados Diagrama de Gantt del proyecto (actualización) Diseño Modelo del usuario •Modelo del Procesador oDiagrama de hardware oJustificación del entorno tecnológico •Modelo de Tareas: Diagrama de Fronteras •Modelo de implantación de programas: Diagrama estructurado •Interfaces de usuario: Prototipos de pantallas y reportes •Basede datos: estructura Diagrama de Gantt del proyecto (actualización) Desarrollo Normas de programación y estándares de nomenclatura Esquema definitivo de la Base de Datos Código fuente (con documentación incorporada) Diagrama de Gantt del proyecto (definitivo) Testeo e instalación Código fuente definitivo (con documentación incorporada) Documentación sobre las pruebas realizadas Manual de UsuarioPautas para migración de datos Manual de administración y soporte técnico Descripción general para el funcionario no informático Implementación Creación base de datos Codificación e integración de módulos Formalización de objetivos, independiente de la naturaleza de la tecnología a aplicar y de cualquier cuestión de implantación Determinación de entidades, con atributos e interrelaciones...