Documentos de Académico
Documentos de Profesional
Documentos de Cultura
Nombre del Documento: DOCUMENTO DE DISEÑO DETALLADO DE SOFTWARE SDD Versión: 1.1
Página: 1
Proyecto: xxxx
Versión Producto: x.x Cliente: xxxxx
Tabla de contenido
1. INTRODUCCIÓN............................................................................................................................................... 3
1.1. OBJETIVO.......................................................................................................................................................... 3
1.2. DEFINICIONES, ACRÓNIMOS Y ABREVIATURAS...........................................................................................................3
1.3. AUDIENCIA.........................................................................................................................................................4
1.4. ALCANCE........................................................................................................................................................... 5
2. PRESENTACIÓN DEL PRODUCTO...................................................................................................................... 5
2.1. PROPÓSITO DEL SISTEMA......................................................................................................................................5
2.2.1. Planteamiento del problema........................................................................................................................5
2.2.2. Objetivo........................................................................................................................................................6
2.2.3. Alcance.........................................................................................................................................................6
2.2.4. El Sistema no contempla..............................................................................................................................7
2.2. RIESGOS............................................................................................................................................................ 7
3. DESCRIPCIÓN GENERAL................................................................................................................................... 8
3.1. CONTEXTO DEL PRODUCTO...................................................................................................................................8
3.2. PERSPECTIVAS FUTURAS DEL PRODUCTO...................................................................................................................9
3.3. REGLAS Y FUNCIONES DE NEGOCIO.........................................................................................................................9
4. REQUISITOS.................................................................................................................................................... 9
4.1. FUNCIONALES.....................................................................................................................................................9
4.2. NO FUNCIONALES..............................................................................................................................................10
4.2.1. Tamaño y rendimiento...............................................................................................................................11
4.2.2. Calidad........................................................................................................................................................11
4.2.3. Otros...........................................................................................................................................................11
5. ARQUITECTURA DEL PRODUCTO/SISTEMA..................................................................................................... 11
5.1. VISTA DE CASOS DE USO....................................................................................................................................11
5.1.1. Actores........................................................................................................................................................11
5.1.2. Modelo de casos de Uso.............................................................................................................................12
5.1.3. Lista de casos de Uso..................................................................................................................................13
5.1.4. Descripción de los Casos de Uso.................................................................................................................14
5.2. VISTA FUNCIONAL.............................................................................................................................................16
5.2.1. Modelo de Análisis......................................................................................................................................16
5.2.2. Interfaces con el usuario.............................................................................................................................18
5.3. VISTA LÓGICA...................................................................................................................................................19
5.3.1. Descripción.................................................................................................................................................19
5.3.2. Paquetes de Diseño Arquitectónicamente Significativos...........................................................................21
5.3.3. Vista de Implementación - Componentes...................................................................................................24
5.4. VISTA DE DESPLIEGUE - AMBIENTE FÍSICO..............................................................................................................25
5.5. VISTA DE DATOS...............................................................................................................................................26
5.5.1. Definiciones................................................................................................................................................26
5.5.2. Diseño de Base de Datos............................................................................................................................27
5.6. REQUISITOS DE SOFTWARE/HARDWARE................................................................................................................27
6. CALIDAD....................................................................................................................................................... 28
7. Observaciones...........................................................................................................................................................28
Nombre del Documento: DOCUMENTO DE DISEÑO DETALLADO DE SOFTWARE SDD Versión: 1.1
Página: 2
Proyecto: xxxx
Versión Producto: x.x Cliente: xxxxx
1. Introducción
1.1. Objetivo
<Esta sección define el rol o propósito del Documento de Arquitectura, en el contexto de la
documentación general del proyecto, y describe brevemente la estructura del documento.
El texto sugerido es el que se describe a continuación, puede ser ampliado o modificado.>
Ejemplo
Nombre del Documento: DOCUMENTO DE DISEÑO DETALLADO DE SOFTWARE SDD Versión: 1.1
Página: 3
Proyecto: xxxx
Versión Producto: x.x Cliente: xxxxx
1.3. Audiencia
<Esta sección identifica la audiencia específica esperada para el Documento de
Arquitectura. Para cada uno de los participantes se debe indicar los niveles de
participación.>
Ejemplo:
Competencias
Criterios de técnicas/
Stakeholder Rol Responsa- Intereses éxito Preocupación Relación de
bilidad ambiente de
trabajo
Nombre del Documento: DOCUMENTO DE DISEÑO DETALLADO DE SOFTWARE SDD Versión: 1.1
Página: 4
Proyecto: xxxx
Versión Producto: x.x Cliente: xxxxx
1.4. Alcance
<Una breve descripción del alcance de este Documento de Arquitectura; que proyecto (s)
están asociados, y cualquier otra cosa que es afectada o influenciada por este documento.
El texto sugerido es el que se describe a continuación, puede ser ampliado o modificado.>
Texto Sugerido:
Ejemplo
Nombre del Documento: DOCUMENTO DE DISEÑO DETALLADO DE SOFTWARE SDD Versión: 1.1
Página: 5
Proyecto: xxxx
Versión Producto: x.x Cliente: xxxxx
2.2.2. Objetivo
<En esta sección deberá indicar de manera general lo que se pretende lograr con el
desarrollo del sistema. No se incluyen puntos referentes al proyecto, sino especificar el
objetivo del producto a desarrollarse>
Ejemplo
2.2.3. Alcance
<Se indica en términos generales las funciones que el sistema deberá realizar o los
módulos que contendrá. No se incluye puntos referentes al proyecto, si no especificar el
alcance del producto>
Nombre del Documento: DOCUMENTO DE DISEÑO DETALLADO DE SOFTWARE SDD Versión: 1.1
Página: 6
Proyecto: xxxx
Versión Producto: x.x Cliente: xxxxx
Ejemplo
2.2. Riesgos
<Se indica cualquier aspecto que debe ser considerado para el desarrollo, que puede afectar
al cumplimiento de los requerimientos y que viene dado desde el ambiente del negocio o
acordado con anterioridad. Fundamentalmente se debe destacar cuestiones políticas o
legales del entorno de la organización que puede afectar el éxito del proyecto si no se le
brinda un adecuado tratamiento.>
Estrategia de
Factor de riesgo Probabilidad Impacto mitigación Responsable
Ejemplo:
Estrategia de
Factor de riesgo Probabilidad Impacto mitigación Responsable
Nombre del Documento: DOCUMENTO DE DISEÑO DETALLADO DE SOFTWARE SDD Versión: 1.1
Página: 7
Proyecto: xxxx
Versión Producto: x.x Cliente: xxxxx
3. Descripción General
3.1. Contexto del Producto
<Esta sección debería poner al producto en perspectiva con otros productos relacionados.
Si el producto es independiente y totalmente auto contenido, debería ser especificado aquí.
Si esta especificación de requerimientos define un producto que es un componente de un
sistema más grande, entonces deberían relacionarse los requerimientos de ese sistema
mayor con la funcionalidad de este software y deberían identificarse las interfaces de
comunicación entre el sistema y el software>.
Ejemplo:
A diferencia del proceso actual que requiere que los trámites existentes tienen que enviarse
de forma física a la universidad, no existe un flujo de actividades debidamente controlado
para cada trámite y tanto el estudiante como los involucrados en el trámite no conocen a
ciencia cierta sobre el estado del mismo.
Nombre del Documento: DOCUMENTO DE DISEÑO DETALLADO DE SOFTWARE SDD Versión: 1.1
Página: 8
Proyecto: xxxx
Versión Producto: x.x Cliente: xxxxx
Ejemplo:
Proceso de GESTIÓN DE FONDOS BIBLIOTECARIOS: Situación propuesta (TO BE)
4. REQUISITOS
4.1. Funcionales
<Los requerimientos funcionales definen las acciones fundamentales que realiza el software
al recibir información, procesarla y producir resultados. Normalmente se listan en
afirmaciones del tipo “el sistema debe...”.
En ellas se incluye:
o Comprobación de la validez de las entradas.
o Secuencia exacta de las operaciones.
o Respuesta a situaciones anormales (desbordamientos, comunicaciones,
recuperación de errores).
o Parámetros.
o Relaciones entre entradas y salidas, incluyendo:
Secuencias de entradas y salidas.
Nombre del Documento: DOCUMENTO DE DISEÑO DETALLADO DE SOFTWARE SDD Versión: 1.1
Página: 9
Proyecto: xxxx
Versión Producto: x.x Cliente: xxxxx
<Se debe mostrar la lista de los requisitos funcionales, describir el detalle necesario. Se debe
seguir el siguiente formato de ejemplo>
4.2. No funcionales
Nombre del Documento: DOCUMENTO DE DISEÑO DETALLADO DE SOFTWARE SDD Versión: 1.1
Página: 10
Proyecto: xxxx
Versión Producto: x.x Cliente: xxxxx
revisión y Versión1.0
versión:
Prioridad: <Alta, media o baja>
4.2.2. Calidad
<Contiene las dimensiones de calidad clave del sistema que forma la arquitectura. La
información presentada puede incluir: Requisitos de rendimiento operativo, como
tiempo medio entre anomalías (MTBF), Destinos de calidad, como "tiempo de
inactividad no planificado", Destinos ampliables, como "el software se podrá actualizar
mientras en sistema se esté ejecutando". Destinos con portabilidad, como plataformas
de hardware, sistemas operativos, lenguajes.>
4.2.3. Otros
<Describe como la arquitectura da soporte a cualquier otro requisito no funcional que
exista.>
5.1.1. Actores
<Se describen los roles, entidades, otros sistemas, dispositivos y cualquier otro “Actor”
con el que el sistema en desarrollo debería interactuar >.
Número: ACT-#
Nombre del Documento: DOCUMENTO DE DISEÑO DETALLADO DE SOFTWARE SDD Versión: 1.1
Página: 11
Proyecto: xxxx
Versión Producto: x.x Cliente: xxxxx
Número: ACT-1
Actor: Profesor
Descripción: Persona responsable de dictar la materia y de ad-
ministrar sus cursos. Es un actor primario.
Responabilidades: El profesor puede realizar lo siguiente:
• Publicar información del curso, tal como: anun-
cios, actividades, tareas, recursos, información ge-
neral, políticas del curso, políticas de calificacio-
nes, etc.
• Agregar o eliminar alumnos al curso y definir sus
ayudantes académicos.
• Publicar las calificaciones de sus estudiantes a tra-
vés de archivos existentes o mediante el ingreso di-
recto al sistema.
• Entre otros.
Fuentes: Gestoría de personal docente
<Las imágenes deben tener un tamaño que permitan al menos ser entendibles a la
vista del lector, sin mayor esfuerzo (zoom).>
Nombre del Documento: DOCUMENTO DE DISEÑO DETALLADO DE SOFTWARE SDD Versión: 1.1
Página: 12
Proyecto: xxxx
Versión Producto: x.x Cliente: xxxxx
Ejemplo:
Id Caso de Uso Complejidad Prioridad Prioridad
del cliente Técnica
CU1 Carga de información de Media Alta Alta
medidores
CU2 Carga de información del Alta Alta Alta
CENACE
CU3 Carga de información Web Media Alta Alta
Services
CU4 Calcular diferencia de Alta Alta Media
mediciones
CU5 Calcular factor de participación Baja Media Alta
CU6 Calcular valor de contratos Media Alta Alta
CU7 Calcular energía de contratos Alta Media Media
CU8 Calcular liquidaciones Baja Alta Alta
Nombre del Documento: DOCUMENTO DE DISEÑO DETALLADO DE SOFTWARE SDD Versión: 1.1
Página: 13
Proyecto: xxxx
Versión Producto: x.x Cliente: xxxxx
Nombre del Documento: DOCUMENTO DE DISEÑO DETALLADO DE SOFTWARE SDD Versión: 1.1
Página: 14
Proyecto: xxxx
Versión Producto: x.x Cliente: xxxxx
Nombre del Documento: DOCUMENTO DE DISEÑO DETALLADO DE SOFTWARE SDD Versión: 1.1
Página: 15
Proyecto: xxxx
Versión Producto: x.x Cliente: xxxxx
PROTOTIPO EXPLORATORIO
<Si el Storyboard se trabaja con pantallazos este es el espacio para colocarlo, si se realiza el
storyboard con html se coloca aquí el nombre del html y la forma de llegar a la funcionalidad que
se está describiendo.>
<Esta sección ilustra cómo trabaja realmente el software mostrando los diagramas de
colaboración y/o de secuencia y/o actividades de los casos de uso planteados en la
sección 5.1.4 y explicando cómo los elementos del modelo contribuyen a su
funcionalidad. Puede ser a través de casos de uso (o escenarios)>
<Las imágenes deben tener un tamaño que permitan al menos ser entendibles a la vista
del lector, sin mayor esfuerzo (zoom).>
<Referenciar cada diagrama con el caso de uso y escenario al que hace referencia
siguiendo el siguiente formato:>
ID Ref: DG-# donde # debe ser reemplazado por un nº
Descripción: <Título del caso de uso y escenario>
Reqs. asociados:
CU asociados:
Esc. Asociados:
Ejemplo
ID Ref: DG-1
Descripción: Reserva exitosa de una habitación de hotel.
Reqs. asociados: RF-1
CU asociados: CU-1
Esc. DOCUMENTO
Nombre del Documento: Asociados: DE DISEÑO
ES-1.1DETALLADO DE SOFTWARE SDD Versión: 1.1
Página: 16
Proyecto: xxxx
Versión Producto: x.x Cliente: xxxxx
Diagrama de Colaboración
Diagrama de Secuencia
Nombre del Documento: DOCUMENTO DE DISEÑO DETALLADO DE SOFTWARE SDD Versión: 1.1
Página: 17
Proyecto: xxxx
Versión Producto: x.x Cliente: xxxxx
Diagrama de Actividades
Diagrama de Estados
<Se debe Referenciar cada interfaz con el caso de uso y escenario al que hace referencia
siguiendo el siguiente formato:>
Nombre del Documento: DOCUMENTO DE DISEÑO DETALLADO DE SOFTWARE SDD Versión: 1.1
Página: 18
Proyecto: xxxx
Versión Producto: x.x Cliente: xxxxx
ID Ref:
Descripción:
Reqs. asociados:
CU asociados:
Esc. Asociados:
Ejemplo:
ID Ref: UI-01
Descripción: Consulta de pagos atrasados
Reqs. asociados: RF-1, RN-3
CU asociados: CU-1
Esc. Asociados: ES-1.1
5.3.1. Descripción
<Esta sección describe la descomposición general del modelo de diseño en términos de
jerarquías de paquetes y capas. Se puede hacer referencia al diagrama UML si aplica>
Texto de ejemplo.
El diseño del sistema respeta el Modelo MVC (Model, View, Controller)
Nombre del Documento: DOCUMENTO DE DISEÑO DETALLADO DE SOFTWARE SDD Versión: 1.1
Página: 19
Proyecto: xxxx
Versión Producto: x.x Cliente: xxxxx
Capa de Aplicaciones (View y Controller), Donde se instalan todas las aplicaciones, y son
publicadas tanto para los usuarios internos, como los usuarios que ingresan desde
Internet. Escucha requerimientos de los usuarios, y responde, con una página Web
sencilla, o con una aplicación que se conecta a la base de datos para consultas y/o
modificaciones.
Para esta capa se utilizará Oracle Aplication Server 10g donde se montarán los .jsp que
implementan tanto las interfaces de usuario como las lógicas de control necesarias. Para
la comunicación entre el servidor de aplicaciones y el motor base de datos se utilizará…
con la intención de tener un mejor manejo de las conexiones a la base de datos.
La ventaja de este tipo de arquitecturas es que las aplicaciones están en un sólo punto, lo
que permite que los administradores sólo hagan cambios en el servidor de aplicaciones y
no así en cada uno de los equipos clientes. Asegura la escalabilidad y alta disponibilidad.
Nombre del Documento: DOCUMENTO DE DISEÑO DETALLADO DE SOFTWARE SDD Versión: 1.1
Página: 20
Proyecto: xxxx
Versión Producto: x.x Cliente: xxxxx
<Ejemplo: >
Nombre del Documento: DOCUMENTO DE DISEÑO DETALLADO DE SOFTWARE SDD Versión: 1.1
Página: 21
Proyecto: xxxx
Versión Producto: x.x Cliente: xxxxx
<Para cada paquete significativo, incluir una sección con su nombre, una breve
descripción, y un diagrama con todas las clases y paquetes significativas contenidos en el
paquete.>
<Para cada clase significativa del paquete, incluir su nombre, una breve descripción, y,
opcionalmente una descripción de sus responsabilidades principales, operaciones y
atributos>
Paquete <xxxxx 1>: Clases contenidas: Ver Diagrama de Clase <zzzzzz 1>.
Paquete <xxxxx 2>: Clases contenidas: Ver Diagrama de Clase <zzzzzz 2>.
Paquete <xxxxx ..>: Clases contenidas: Ver Diagrama de Clase <zzzzzz …>.
Ejemplo:
Nombre del Documento: DOCUMENTO DE DISEÑO DETALLADO DE SOFTWARE SDD Versión: 1.1
Página: 22
Proyecto: xxxx
Versión Producto: x.x Cliente: xxxxx
<Para cada diagrama de clases debéis indicar el posible orden de implementación de las
clases (e idealmente, hacer las pruebas de unidad completamente) desde la menos a la
más acoplada (ver siguiente Figura). Por ejemplo, las posibles primeras clases que
podríamos implementar son Pago o EspecificacionDelProducto; a continuación las clases
que sólo dependen de la implementación anterior —Catalogo-DeProductos o
LineaDeVenta>
Nombre del Documento: DOCUMENTO DE DISEÑO DETALLADO DE SOFTWARE SDD Versión: 1.1
Página: 23
Proyecto: xxxx
Versión Producto: x.x Cliente: xxxxx
<Las imágenes deben tener un tamaño que permitan al menos ser entendibles a la vista
del lector, sin mayor esfuerzo (zoom).>
Nombre del Documento: DOCUMENTO DE DISEÑO DETALLADO DE SOFTWARE SDD Versión: 1.1
Página: 24
Proyecto: xxxx
Versión Producto: x.x Cliente: xxxxx
<Las imágenes deben tener un tamaño que permitan al menos ser entendibles a la vista
del lector, sin mayor esfuerzo (zoom).>
Nombre del Documento: DOCUMENTO DE DISEÑO DETALLADO DE SOFTWARE SDD Versión: 1.1
Página: 25
Proyecto: xxxx
Versión Producto: x.x Cliente: xxxxx
5.5.1. Definiciones
<Describe todos los ítems de datos incluidos en el producto o sistema. Puede ser desde
una base de datos hasta archivos de datos como xml, etc. Para ello puedes hacer uso del
siguiente diccionario de datos:>
Nombre del Documento: DOCUMENTO DE DISEÑO DETALLADO DE SOFTWARE SDD Versión: 1.1
Página: 26
Proyecto: xxxx
Versión Producto: x.x Cliente: xxxxx
Columnas:
PK Nombre Tipo No Nulo Único Longitud Precisión Escala Inicial Notas
Relaciones:
Columnas Asociación Notas
<Modelo de datos del sistema con sus respectivas entidades, relaciones y atributos>
<Las imágenes deben tener un tamaño que permitan al menos ser entendibles a la vista
del lector, sin mayor esfuerzo (zoom).>
Nombre del Documento: DOCUMENTO DE DISEÑO DETALLADO DE SOFTWARE SDD Versión: 1.1
Página: 27
Proyecto: xxxx
Versión Producto: x.x Cliente: xxxxx
Equipamiento y Configuración:
Servidor de Aplicaciones
- Sistema Operativo Linux, tenemos el RedHat Enterprise Linux Server 5.4
- Servidor de Aplicaciones Jboss As 6.0.0.final
- JDK 1.6.0_23 o superior
- Intel Xeon x5570 de 2 procesadores
- Memoria 8 GB, 4 GB reservado
- Disco 30 GB]
6. Calidad
<Una descripción de como la arquitectura del software contribuye con todas las capacidades
del sistema (además de la funcionalidad): extensibilidad, confiabilidad, portabilidad, etc.>
Texto sugerido:
7. Observaciones
<Esta sección permite incorporar cualquier información que se considera de importancia, que
no haya sido especificada con anterioridad>
Nombre del Documento: DOCUMENTO DE DISEÑO DETALLADO DE SOFTWARE SDD Versión: 1.1
Página: 28