You are on page 1of 12

[Nombre del Proyecto Asociado]

Arquitectura del Sistema [v1.1.1]


Grupo de Ingeniera

Control del Documento


Proyecto
[Nombre del Proyecto al que se refiere este documento]
Ttulo
Arquitectura del Sistema [v1.1.1 al 1 de enero de 2007.]
Generado por
Grupo de Ingeniera: [Fulanito de Tal y Menganito de Cual.]
Aprobado por
[Persona de la Organizacin del Cliente que da la conformidad con el
documento]
Alcance de la distribucin
[Definir en forma general a las personas que pueden o deben leer
este documento.
Ejemplos:
Documento Interno alcance a toda la cooperativa.
Documento Secreto Grupos de Gestin y Supervisin.
Documento Pblico Distribucin irrestricta.
entre otras posibilidades.]

Pgina 1 de 12

[Nombre del Proyecto Asociado]


Arquitectura del Sistema [v1.1.1]
Grupo de Ingeniera

ndice
Control del Documento................................................................................................................................1
ndice.............................................................................................................................................................2

SOBRE ESTE DOCUMENTO..............................................................................4


DESCRIPCIN GENERAL..................................................................................5
Posicionamiento y Alcance..........................................................................................................................5
Objetivos del diseo.....................................................................................................................................5
Caractersticas Principales..........................................................................................................................5
Restricciones y limitaciones........................................................................................................................5

REQUISITOS ATENDIDOS.................................................................................6
Requisitos Funcionales................................................................................................................................6
Requisitos Suplementarios..........................................................................................................................6

VISTAS Y PLANOS..............................................................................................7
Resumen de Vistas.......................................................................................................................................7
Vista Lgica..................................................................................................................................................7
Vista de Componentes.................................................................................................................................7
Vista de Despliegue......................................................................................................................................8
Vista de Datos...............................................................................................................................................8

DETALLES DE IMPLEMENTACIN...................................................................9
Plataformas y Lenguajes.............................................................................................................................9
Organizacin del proyecto........................................................................................................................10
Obtencin e instalacin del paquete de fuentes......................................................................................10
Contenido del paquete de fuentes...........................................................................................................10
Instrucciones de compilacin..................................................................................................................10
Estructuras de implementacin................................................................................................................10

ANEXOS.............................................................................................................11
Ttulo del primer anexo.............................................................................................................................11
Historial del Documento............................................................................................................................11

Pgina 2 de 12

[Nombre del Proyecto Asociado]


Arquitectura del Sistema [v1.1.1]
Grupo de Ingeniera

Referencias a otros documentos...............................................................................................................11


Insumos...................................................................................................................................................11
Documentos derivados............................................................................................................................12
Glosario de trminos..................................................................................................................................12
Significado de los elementos de la notacin grfica................................................................................12
Estereotipado UML utilizado..................................................................................................................12
Significado de los elementos No UML...................................................................................................12

Pgina 3 de 12

[Nombre del Proyecto Asociado]


Arquitectura del Sistema [v1.1.1]
Grupo de Ingeniera

Sobre este Documento

El presente documento contiene el diseo elaborado para el proyecto


[Nombre del Proyecto Asociado], el cual es producto de un anlisis
minucioso de los requisitos del sistema, segn estos pueden ser
satisfechos con las tecnologas y caractersticas discutidas con los
clientes y usuarios.
El documento esta organizado alrededor de tres ideas principales:
1. Las caractersticas generales del diseo
1. Los requisitos atendidos por el diseo
2. Los modelos y vistas que lo detallan
Al contrario de muchas otras actividades tcnicas, el desarrollo de
sistemas intensivos en software dedica la mayora de sus esfuerzos
a la especificacin y modelado.
Los modelos son utilizados tanto para el anlisis de requisitos, como
para el diseo de la solucin, as como para la especificacin,
construccin y despliegue del sistema en su ambiente de
explotacin.
Los modelos son presentados por medio de vistas o diagramas,
generalmente utilizando notaciones grficas como el UML.
Por otro lado, los programas de computadora son construidos por
medio del uso de herramientas de traduccin automticas llamados
compiladores1, para los cuales es construida la forma final y ms
detallada del software del sistema: el cdigo fuente.
La ultima seccin del documento indica la forma en que se puede
obtener el cdigo fuente del proyecto, as como las instrucciones de
compilacin necesarias para lograr la ejecucin de los componentes
que este cdigo detalla.

Con el perdn de los interpretes que tambin son muy importantes

Pgina 4 de 12

[Nombre del Proyecto Asociado]


Arquitectura del Sistema [v1.1.1]
Grupo de Ingeniera

Descripcin General

Se entiende por arquitectura del software, al conjunto de elementos


estticos, propios del diseo intelectual del sistema, que definen y
dan forma tanto al cdigo fuente, como al comportamiento del
software en tiempo de ejecucin.
Naturalmente este diseo arquitectnico ha de ajustarse a las
necesidades y requisitos del proyecto. Esta seccin describe en
trminos generales, las ideas principales detrs de la arquitectura
escogida para el mismo.

Posicionamiento y Alcance
[Diga aqu en trminos tcnicos que tipo de software se ha
diseado.]

Objetivos del diseo


[Exprese los objetivos del diseo.]

Caractersticas Principales
[Exprese aqu las principales caractersticas del diseo: orientado a
objeto, modular, basado en procedimientos, de tiempo real,
interactivo y facilidad de uso, nombre de los patrones de diseo
utilizados, etc.]

Restricciones y limitaciones
[Indique aqu las limitaciones de diseo y las restricciones impuestas,
que aplican y han dado forma al diseo.]

Pgina 5 de 12

[Nombre del Proyecto Asociado]


Arquitectura del Sistema [v1.1.1]
Grupo de Ingeniera

Requisitos Atendidos

La motivacin y el fundamento de todo lo hecho en el proyecto, no


son otros sino los requisitos y necesidades, tanto del cliente como de
los futuros usuarios del sistema.
Es por esto, que en esta seccin se indican los requisitos atendidos
por el diseo o arquitectura que se describir en las prximas
secciones.

Requisitos Funcionales
[Indique aqu, el grupo de diagramas de casos de uso ms
relevantes para la arquitectura del sistema. O en todo caso, ha de
indicarse aqu los requisitos funcionales cubiertos por el diseo.]

Requisitos Suplementarios
[Indique aqu, por medio de ttulos 3, los requisitos suplementarios
que se atienden con el presente diseo. Otra presentacin apropiada
es con una tabla.]

Pgina 6 de 12

[Nombre del Proyecto Asociado]


Arquitectura del Sistema [v1.1.1]
Grupo de Ingeniera

Vistas y Planos

Los sistemas intensivos en software, se encuentran formados por un


conjunto de componentes, que no son ms que los elementos listos
para ser ejecutados producidos por el proyecto.
Dichos componentes se distribuyen sobre los distintos equipos segn
lo que se detalla en la vista de despliegue.
Por otro lado, la vista lgica presenta al sistema como un todo,
indicando en trminos propios de la tecnologa utilizada, las partes
que lo forman y las relaciones principales entre ellas.
Finalmente se presenta el llamado modelo de datos, que contiene la
estructura de almacenamiento de informacin requerida por el
sistema aqu descrito.

Resumen de Vistas
El Vista

Contiene

Se relaciona con

Comentarios

[Nombre de la
vista: lgica, de
componentes, etc.]

[Indicaciones sobre
el tipo de
informacin que se
representa en la
vista]

[Indicaciones sobre
como se ha de
entender a la vista
dentro del conjunto
de la descripcin]

[Segn sea
oportuno.]

Vista Lgica
[La vista lgica es una presentacin de la arquitectura diseada en
sus propios trminos: paquetes, pginas, clases, mdulos, etc.]

Vista de Componentes
[Un componente es un elemento software preparado para su
ejecucin. Entre otros: programas de lnea de comando, integrantes
de una suite de aplicaciones, objetos CORBA o DCOM listos para su
uso, etc.]

Pgina 7 de 12

[Nombre del Proyecto Asociado]


Arquitectura del Sistema [v1.1.1]
Grupo de Ingeniera

Vista de Despliegue
[El despliegue es la planificacin de que componentes se ejecutarn
en los distintos computadores (nodos) relacionados con el sistema.]

Vista de Datos
[Se refiere al modelo de datos. Puede presentarse, si se estima
conveniente como un modelo E/R o bien, con algn perfil de UML
apropiado.]

Pgina 8 de 12

[Nombre del Proyecto Asociado]


Arquitectura del Sistema [v1.1.1]
Grupo de Ingeniera

Detalles de Implementacin

La especificacin de un sistema intensivo en software tiene como


ultima representacin al cdigo fuente de los componentes. Este
cdigo indica los ms finos detalles del software, por medio de un
lenguaje preciso, capaz de ser traducido automticamente a
instrucciones de la maquina.
Acompaa al cdigo, las llamadas previsiones de compilacin,
constituidos por todos los elementos de soporte necesarios para
realizar la construccin de los componentes a partir del conjunto de
cdigos.
Esta seccin detalla la obtencin y uso del paquete de cdigo fuente
para el proyecto. De manera de facilitar el uso de este, para la
futuras ampliaciones o correcciones del sistema.

Plataformas y Lenguajes
[Detalles sobre la plataforma utilizada: sistema operativo, bibliotecas
reutilizadas, lenguajes y compiladores, etc.]
Se requiere

Versin

Debido a

Comentarios

[Nombre de qu se
requiere: sistema
operativo tal,
compilador del
lenguaje tal, etc.]

[Nmero de
versin y nombre
comercial del
componente]

[Breve explicacin
de la funcin que
cumple el
elemento]

[Segn aplique.]

Pgina 9 de 12

[Nombre del Proyecto Asociado]


Arquitectura del Sistema [v1.1.1]
Grupo de Ingeniera

Organizacin del proyecto


Obtencin e instalacin del paquete de fuentes
[Instrucciones sobre donde conseguir las fuentes del proyecto y de
como instalarlas en el ambiente de compilacin.]

Contenido del paquete de fuentes


[Descripcin de los elementos presentes en el paquete de fuentes y
de como se organiza en el directorio del proyecto. Indicar el
propsito de cada directorio y entrada que sea importante para
entender la organizacin del paquete.]

Instrucciones de compilacin
[Instrucciones sobre como se obtienen los componentes ejecutables
a partir de las fuentes]

Estructuras de implementacin
[Detalles sobre cada clase, mdulo o paquete, segn esto sean
importantes para entender como modificar o dar mantenimiento al
cdigo de las aplicaciones.]

Pgina 10 de 12

[Nombre del Proyecto Asociado]


Arquitectura del Sistema [v1.1.1]
Grupo de Ingeniera

Anexos

Ttulo del primer anexo


[Cualquier anexo al que hubiera lugar.
De preferencia habra que lograr que cada anexo comenzara en su
propia pgina, aunque este requisito queda a criterio del autor del
documento.
Por sencillez esta plantilla coloca los glosarios uno luego del otro, sin
indicar nuevas pginas.]

Historial del Documento


Mircoles 5 de julio de 2006 Segunda versin v1.2.

Actualizacin de los parmetros de tiempo del reactor


qumico.

Modificacin de las guas de diseo de la interfaz de usuario


en el mdulo N 5 del diagrama de despliegue.

Martes 8 de mayo de 2006 Primera versin v1.1.

Versin inicial.

[Fecha de cada versin en negritas y conteo de versin sin estas.


Seguido de un comentario describiendo el cambio hecho al
documento.
Esta seccin es importante para mantener el control sobre las
configuraciones o en otras palabras, para establecer por escrito las
relaciones entre los cambios solicitados a los documentos y la fecha
en que estos se hayan realizado. Esta condicin es crtica para
descubrir ms adelante errores en el contenido de los documentos
derivados.]

Referencias a otros documentos


Insumos
David Esteller Ortega. Manual para organizar cooperativas. Vadell
Hermanos Editores, C.A. Valencia, Venezuela. ISBN: 980-212-099-5
Alberto G. Alexander Servat. Manual para documentar sistemas de
calidad. Prentice Hall, Mxico. 1998. ISBN: 970-17-0185-2

Pgina 11 de 12

[Nombre del Proyecto Asociado]


Arquitectura del Sistema [v1.1.1]
Grupo de Ingeniera

Lus T. Dez de Castro y Joaqun Lpez Pascual. Direccin


Financiera. Prentice Hall, Madrid. 2001. ISBN: 84-205-3066-2

Documentos derivados
Acta constitutiva de la cooperativa. Documento a elaborar.
Manual de Calidad. Documento a elaborar, requerido por ISO 9000.
Manual de Procesos. Documento a elaborar, que describe los
pasos para definir y documentar un proceso especifico. Requerido
por ISO 9000, RUP y CMMi.
Modelo de Maduracin. Documento a elaborar, que describe la
valoracin posiblemente cuantitativa, de las caractersticas de una
organizacin o proyecto a efectos de su tabulacin comparativa.
Requerido por CMMi.
Poltica de Calidad. Documento a elaborar, requerido por ISO 9000.

Glosario de trminos
Anticipos. Denominacin dada en la Ley a los pagos que reciben los
cooperativistas por sus servicios. Hace referencia explicita a la
condicin del asociado con plenos e iguales derechos, a diferencia
de la situacin de dependencia que representan los sueldos y
salarios convencionales.
Calidad. Coincidencia de las caractersticas objetivas de los
productos y entregables de un proyecto y las cualidades generales y
caractersticas concretas que el cliente nos requiri. El logro de la
calidad es nuestra Meta Primordial.

Significado de los elementos de la notacin grfica


Estereotipado UML utilizado
[Si el documento contiene diagramas UML que utilicen algn
estereotipo en particular, se deben indicar aqu su significado y
reglas de uso]

Significado de los elementos No UML


[En ocasiones los documentos hacen uso de notaciones grficas
distintas al UML por ejemplo diagramas E/R
Cuando sea conveniente, se indican aqu las reglas para interpretar
estas convenciones grficas adicionales]

Pgina 12 de 12