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

El objetivo final de cualquier software es resolver un problema. Ya sea simple (corrector ortográfico) o complejo (sistema de bases de datos), si no aborda eficazmente la necesidad del usuario, falla. Un buen software comienza con un documento de análisis y diseño que capture requisitos y planifique la solución.

Fase 1: Definir el problema

Paso 1: Evaluar la solicitud globalmente

Entiende qué pide realmente el usuario. Haz preguntas de sondeo: quién, qué, dónde, cuándo, por qué, cómo para llegar a la raíz del problema.

Paso 2: Definir alcance y restricciones

Ejemplo: si piden informatizar pedidos de libros, analiza el proceso actual de principio a fin. Establece límites del proyecto e identifica restricciones: hardware existente, plazos, presupuesto, normativas.

Paso 3: Analizar al usuario final

Entrevista y observa a quienes usarán el software a diario. Determina cómo debe funcionar para cubrir la necesidad y cómo diseñar el sistema para su comodidad. Identifica factores como nivel de habilidad (afecta a formación necesaria).

Paso 4: Evaluar factibilidad y presentar recomendaciones

Entrega un informe escrito con: estimación de costes, beneficios, cronograma, y tu recomendación sobre si el software resolverá efectivamente el problema.

Fase 2: Preparar el documento de análisis y diseño

Paso 1: Diagrama de flujo de datos y descripción de procesos

El diagrama de flujo de datos explica qué hará el programa; el diagrama de procesos muestra cómo. Ejemplo: para pedidos de libros, documenta paso a paso desde la selección del libro hasta su entrada en inventario.

Paso 2: Crear diccionario de datos

Define y describe cada elemento de dato necesario y agrúpalos en registros. Ejemplo: en pedidos de libros, elementos son título, ISBN, autor, precio → forman un registro de libro; proveedor, cuenta, comercial → registro de proveedor.

Paso 3: Integrar en paquete documental

Combina diagrama de flujo, descripciones de procesos y diccionario de datos en un documento lógico y escrito que sirva para crear un prototipo del software.

💡 Consejos adicionales

  • Un alcance bien definido evita el scope creep (crecimiento incontrolado del proyecto).
  • Para captar requisitos, diseña encuestas con preguntas abiertas, cerradas y de escala. Ejemplos: "¿Qué funciones quiere en el sistema de pedidos?", "¿Cuántos pedidos hace al mes?", "Del 1 al 10, ¿qué ineficiencia tiene el sistema actual?".
  • Complementa el documento escrito con una presentación gráfica del nuevo sistema (diagramas UML, maquetas, wireframes).