Cómo escribir un documento de análisis y diseño para un software

El objetivo final de un programa de software es resolver un problema. El problema puede ser simple, como un programa de software que busca palabras mal escritas en un documento de texto, o complejo, como un programa de software utilizado para crear una base de datos. Independientemente del problema, si el programa de software no aborda el problema de manera efectiva y proporciona un medio para que el usuario cree una solución, no es efectivo y no alcanza su objetivo. Escribir un buen software comienza con un documento de análisis y diseño que aborda los requisitos del usuario y crea un plan para brindar soluciones.

Define el Problema

Paso 1

Evalúe la solicitud mirando primero el panorama general. Asegúrate de entender lo que el usuario está pidiendo. Haga preguntas de sondeo de "quién, qué, dónde, cuándo, por qué y cómo" para llegar a la raíz del problema.

Paso 2

Definir el alcance y las restricciones del proyecto. Por ejemplo, si la solicitud es para un programa de software para computarizar un sistema de pedidos de libros, evalúe el sistema de pedidos actual de principio a fin. Defina y establezca los límites del proyecto e identifique las restricciones del proyecto en las que debe trabajar, como el hardware existente o un plazo limitado para la finalización del proyecto.

Paso 3

Mira al usuario final. Entreviste y observe a las personas que usarán el software a diario para determinar cómo debe funcionar el software para adaptarse a la solicitud y cómo puede diseñar el nuevo sistema para que se adapte mejor a las necesidades del usuario. Identifique los factores relacionados con el usuario que pueden afectar el proyecto, por ejemplo, cómo el nivel de habilidad de los usuarios finales puede afectar los requisitos de capacitación.

Paso 4

Determinar la factibilidad y presentar recomendaciones. Proporcione una evaluación por escrito de la solicitud para incluir una estimación de los costos, los beneficios, el cronograma de finalización y su recomendación sobre si el software abordará de manera efectiva el problema planteado.

Preparar el Documento de Análisis y Diseño

Paso 1

Desarrolle un diagrama de flujo de datos y una descripción del proceso. Un diagrama de flujo de datos explica lo que hará el programa y un diagrama de proceso muestra cómo lo hará el programa de software. Por ejemplo, un diagrama de flujo de datos y una descripción del proceso para un sistema de pedido de libros documentaría y describiría el proceso, paso a paso, desde la selección del libro adecuado hasta su ingreso en el inventario.

Paso 2

Cree un diccionario de datos que defina y describa los elementos de datos necesarios y combine estos elementos en registros de datos. Por ejemplo, en el sistema de pedido de libros, los ejemplos de elementos de datos incluyen el nombre del libro, el ISBN, el autor y el precio. Estos elementos luego se combinan para formar un registro de libro; otros elementos, como el nombre del proveedor, el número de cuenta y el representante de ventas, se pueden combinar para formar un registro de proveedor.

Paso 3

Combine el diagrama de flujo de datos, las descripciones del flujo de procesos y el diccionario de datos en un paquete de documentos que describa el programa de software en un formato escrito lógico que pueda usar para crear un prototipo de programa o un modelo de trabajo del programa de software.

Consejo

Un beneficio de definir claramente el alcance del proyecto es que ayuda a evitar el "arrastre del proyecto" que puede ocurrir cuando un proyecto crece más allá de la solicitud inicial.

Otra idea para identificar los requisitos del usuario final es desarrollar una encuesta usando una combinación de preguntas abiertas, preguntas cerradas y preguntas de rango de respuesta. Incluya preguntas como "¿Qué características le gustaría ver en el sistema de pedido de libros?" “¿Cuántos pedidos de libros realiza cada mes?” y "En una escala del 1 al 10, ¿cómo calificaría la ineficiencia del actual sistema de pedidos de libros?"

Además de presentar un análisis escrito y un documento de diseño para un programa de software, a veces es útil usar un software de presentación para agregar una representación gráfica del nuevo sistema de software.