16
Documento de Arquitectura de Software KunaySoft Autores: Juan Camilo González Vargas Javier Leonardo Parra Laguna Pontificia Universidad Javeriana Bogotá, Colombia Noviembre 2014
Documento de Arquitectura de Software
KunaySoft
Autores:
Juan Camilo González Vargas
Javier Leonardo Parra Laguna
Pontificia Universidad Javeriana
Bogotá, Colombia
Noviembre 2014
Tabla de contenido
1. Introducción ........................................................................................................... 3
1.1. Propósito .......................................................................................................... 3
1.2. Alcance ............................................................................................................ 3
1.3. Definiciones, acrónimos y abreviaturas ........................................................... 3
1.4. Referencias ...................................................................................................... 4
1.5. Vista general del documento ............................................................................ 4
2. Representación arquitectural ............................................................................... 4
3. Restricciones arquitecturales .............................................................................. 5
3.1. Restricciones técnicas ..................................................................................... 5
3.2. Restricciones de integración ............................................................................ 5
3.3. Restricciones de interoperabilidad ................................................................... 5
4. Vista de casos de uso ........................................................................................... 5
4.1. Realización de casos de uso ........................................................................... 6
5. Vista lógica .......................................................................................................... 13
5.1. Vista general ................................................................................................... 13
6. Vista de despliegue ............................................................................................. 13
7. Vista de implementación .................................................................................... 14
Tabla de ilustraciones
Ilustración 1: Modelo 4+1[2] ........................................................................................... 3 Ilustración 2: Diagrama de casos de uso ....................................................................... 6 Ilustración 3: Diagrama EBC de realizar registro ........................................................... 6 Ilustración 4: Diagrama EBC realizar login ..................................................................... 7 Ilustración 5: Diagrama EBC informar detalles aplicación .............................................. 7 Ilustración 6: Diagrama EBC realizar pruebas ............................................................... 8 Ilustración 7: Diagrama EBC generar recomendaciones ............................................... 9 Ilustración 8: Diagrama EBC calificar aplicación .......................................................... 10 Ilustración 9: Diagrama EBC ver información carrera .................................................. 10 Ilustración 10: Enviar recomendaciones al correo ........................................................ 11 Ilustración 11: modificar información carreras .............................................................. 11 Ilustración 12: consultar resultados .............................................................................. 12 Ilustración 13: Modificar información instituciones ....................................................... 12 Ilustración 14: vista lógica ............................................................................................ 13 Ilustración 15: diagrama de despliegue ........................................................................ 14 Ilustración 16: Diagrama de implementación ............................................................... 15
1. Introducción En este documento se hace la descripción de la arquitectura que se utiliza para el desarrollo del sistema KunaySoft. En las siguientes secciones se realiza una descripción de los elementos que se tuvieron en cuenta para el desarrollo y funcionamiento del sistema. Se muestra un resumen general de la arquitectura planteada, se describen los casos de uso más importantes y actores que son afectados por cada caso de uso, se hace una explicación de la arquitectura que se utilizó y se describe cada uno de los elementos por los que se encuentra compuesto.
1.1. Propósito El propósito de este documento, es mostrar la vista general de la arquitectura que se utilizó para el sistema KunaySoft. Se describe cada uno de los elementos utilizados a partir del modelo “4+1”, en donde se especifican cada una de las vistas utilizadas para la realización del sistema.
Ilustración 1: Modelo 4+1[2]
1.2. Alcance
Realizar una arquitectura lógica y física que especifique las características principales y las necesidades de los usuarios finales del sistema KunaySoft
1.3. Definiciones, acrónimos y abreviaturas
• KunaySoft, sistema de recomendaciones para la orientación vocacional
• HTTP, protocolo de transferencia de hipertexto. • Jdk, librería de desarrollo de java (java development kit) • SRS, Especificación de requerimientos de software.
• Diagrama EBC, entidades, límites y controles. • CSS, hojas de estilo en cascada. • GlassFish, servidor virtual de java. • Java, lenguaje de programación orientado a objetos.
1.4. Referencias • [2]“Modelo 4+1”,Tomado de,
http://www.ibm.com/developerworks/ibm/library/it-booch_web/booch_view2.jpg
1.5. Vista general del documento
• Sección 2: se describe cada una de las vistas • Sección 3: se describe las restricciones del sistema • Sección 4: se describe la vista de casos de uso
arquitecturalmente significantes. • Sección 5: Describe la vista general de la arquitectura, la
arquitectura candidata y las especificación de los elementos que la conforman.
• Sección 6: Describe la vista de datos donde se ve la organización de los datos utilizados en el sistema.
• Sección 7: Describe de la vista de implementación, donde se especifican las interfaces de los componentes y los correspondientes componentes que tiene la arquitectura.
2. Representación arquitectural
En este documento se especifican 4 vistas de las cuales 3 pertenecen al modelo “4+1” y una vista más la cual es la vista de datos.
• Vista lógica: describe los requerimientos de negocio más relevantes para el sistema y el modelo de objetos del diseño
• Vista de casos de uso: describe los escenarios y casos que representan la funcionalidad principal del sistema. Se describe los actores y los casos de uso que los afectan.
• Vista de implementación: describe los componentes del software, las capas y subsistemas de la aplicación.
• Vista de datos: describe las entidades de los datos persistentes, en software y sus relaciones, las relaciones con los demás elementos del diagrama EBC y en sus respetivos componentes.
• Vista de física: describe de forma en que se encuentran los componentes como elementos físicos en una arquitectura.
3. Restricciones arquitecturales
El sistema tiene unas restricciones para que el funcionamiento y el uso del sistema KunaySoft se realice de forma correcta.
3.1. Restricciones técnicas
• El sistema usa una base de datos Oracle versión 11g. • El sistema usa un servidor web. • El sistema debe hacer uso del servidor virtual GlassFish versión
4.0 • El sistema debe usar el jdk 1.7 de Java • El lenguaje de programación es Java. • El sistema hace uso de Java Empresarial • La interfaz debe ser manejada con JavaScript, CSS y XHTML. • El sistema hace uso de librerías de PDF y de correos. • El sistema debe correr en Windows.
3.2. Restricciones de integración
• El sistema debe ser compatible en Internet Explorer 7 o mayor, Firefox 3 o mayor y Safari 4 o mayor.
3.3. Restricciones de interoperabilidad
• El sistema debe ser manejado por entidades • El sistema debe ser usado en navegadores web
4. Vista de casos de uso
En esta vista se listan los casos de uso arquitecturalmente significantes, los cuales se encuentran en el siguiente diagrama.
Ilustración 2: Diagrama de casos de uso
4.1. Realización de casos de uso
4.1.1. Realizar registro
4.1.1.1. Diagrama EBC
Ilustración 3: Diagrama EBC de realizar registro
• Formulario realizar registro: una vez el usuario ingresa a la opción de registrarse se le da un formulario en donde se le piden sus datos personales (nombre, colegio, grado, edad, documento de identidad)
• Realizar registro: una vez el usuario termina de desarrollar el registro se obtienen los datos personales y se mandan al manejador de la base de datos
• Base de datos: este componente almacena la información del sistema, en este caso guarda los datos básicos del estudiante.
• Manejador de base de datos: maneja la comunicación entre el sistema y la base de datos para persistir o consultar información.
4.1.2. Realizar login
4.1.2.1. Diagrama EBC
Ilustración 4: Diagrama EBC realizar login
• Formulario realizar login: una vez el usuario va a la opción login
éste ingresa su documento de identidad. • Base de datos: este componente consulta el documento de
identidad del estudiante • Manejador de base de datos: envía documento de identidad a la
base de datos y comprueba si el usuario existe, si no existe se envía al usuario a registrarse.
4.1.3. Consultar herramientas
4.1.3.1. Diagrama EBC
Ilustración 5: Diagrama EBC informar detalles aplicación
• Mostrar detalles: si el estudiante quiere conocer los detalles de los test que se utilizan, éste puede informarse de lo que se le está mostrando y de cómo se obtienen los resultados
• Usuario: es un estudiante de colegio que se encuentre realizando grado noveno, décimo u once.
4.1.4. Realizar test
4.1.4.1. Diagrama EBC
Ilustración 6: Diagrama EBC realizar pruebas
• Usuario: Para nuestro caso el usuario es un estudiante de grados noveno, décimo u once
• Ingresar al sistema: Una vez el usuario se registra o ingresa puede empezar las pruebas
• Formulario test SDS: una vez el usuario ya se encuentre registrado, el usuario puede dar inicio al test para la orientación vocacional.
• Formulario Instrumento: una vez el estudiante termina el SDS pasa a realizar el instrumento, en donde se le hacen preguntas acerca de su contexto.
• Formulario test aprendizaje: una vez finaliza el instrumento, pasa a realizar el test de estilo de aprendizaje y una vez termina se mandan los resultados a la base de datos.
• Formulario test personalidad: una vez finaliza el test de estilos de aprendizaje realiza el test de personalidad y se le indica al usuario que ingrese el resultado obtenido.
• Formulario satisfacción: Una vez el usuario termina de ver sus resultados y de realizar los test, éste debe completar el formulario
de satisfacción, que es la que ayuda a medir si al usuario le gustó o no la aplicación
• Base de datos: guarda los resultados obtenidos de cada uno de los test
• Manejador de base de datos: envía la información o resultados obtenidos por el estudiante una vez finaliza cada test realizado
4.1.5. Consultar recomendaciones
4.1.5.1. Diagrama EBC
Ilustración 7: Diagrama EBC generar recomendaciones
• Formulario test SDS: ayuda a conocer la orientación vocacional del estudiante, una vez finaliza pasa a realizar el test del instrumento
• Formulario instrumento: ayuda a conocer a través de unas preguntas el contexto en el que se encuentra el estudiante, una vez finaliza el test del instrumento pasa a realizar el test de estilos de aprendizaje
• Formulario test estilo aprendizaje: ayuda a conocer el estilo de aprendizaje del estudiante, una vez finaliza dicho test pasa a realizar el test de personalidad
• Formulario test de personalidad: ayuda a conocer la personalidad que tiene el estudiante, una vez finaliza se generan los resultados de las carreras que más se ajustan a lo que se obtuvo en los test
• Generar resultados: una vez el usuario termina de realizar todas las pruebas, el sistema genera los resultados obtenidos de la relación entre los test. • Base de datos: consulta las carreras a partir del código SDS,
estilo de aprendizaje, estilo de personalidad e instrumento • Manejador de base de datos: envía los resultados obtenidos en
cada test realizado • Mostrar resultados: el sistema muestra al usuario las carreras
que se le aconsejan estudiar según su contexto, personalidad, aprendizaje y orientación vocacional.
4.1.6. Calificar aplicación
4.1.6.1. Diagrama EBC
Ilustración 8: Diagrama EBC calificar aplicación
• Test satisfacción: una vez el usuario termina de realizar los test y de escoger las carreras de su agrado, éste debe realizar un test de satisfacción de la aplicación
• Enviar resultados: una vez finaliza el test de satisfacción se envía los resultados al manejador de la base de datos
• Base de datos: guarda los votos obtenidos del resultado del test de satisfacción
• Manejador de base de datos: envía los resultados obtenidos del test de satisfacción a la base de datos
4.1.7. Ver información adicional
4.1.7.1. Diagrama EBC
Ilustración 9: Diagrama EBC ver información carrera
• Resultados: una vez el estudiante obtiene los resultados de las carreras que se le aconsejan, éste puede ver información adicional acerca de los programas que se le aconsejan.
• Ver información carrera: si el usuario quiere más detalle acerca de la carrera, el usuario puede ver más información de donde se puede realizar la carrera.
• Base de datos: busca las instituciones a partir del nombre del programa dado por el manejador de la base de datos.
• Manejador base de datos: el manejador de base de datos envía el nombre del programa que el usuario ha seleccionado.
4.1.8 Enviar recomendaciones al correo
Ilustración 10: Enviar recomendaciones al correo
• Estudiante: una vez el estudiante termina los tests y selecciona las carreras de su gusto, éste tiene la posibilidad de que toda la información de sus características y de las carreras que seleccionó sea enviado a un correo electrónico
• Obtener resultados: una vez el estudiante decide que quiere que se le envié un correo se obtienen los resultados y se crea un archivo para luego ser enviado
• Enviar correo: una vez creado el archivo se envía el documento al servidor del correo para enviarlo al estudiante
• Servidor correo: es el encargado del envío del documento de las carreras seleccionadas y sus características al estudiante
4.1.9 Modificar información carreras
}
Ilustración 11: modificar información carreras
• Administrador: es el usuario que maneja toda la información consolidada en la base de datos
• Consultar carreras: el usuario puede consultar las carreras e información de cada una de ellas
• Modificar información carrera: una vez consulta las carreras a modificar el usuario cambia los datos necesarios y actualiza la base de datos
• Manejador base de datos: una vez recibe la petición del usuario envía las modificaciones realizadas a la base de datos
• Base de datos: recibe la información de el manejador y modifica lo que se le pidió
4.1.10 Consultar resultados
Ilustración 12: consultar resultados
• Administrador: es el usuario que puede acceder a la información obtenida de la base de datos
• Consultar resultados: si el usuario desea conocer los resultados obtenidos en los test realizados.
• Manejador base de datos: recibe la solicitud del administrador y se lo envía a la base de datos
• Base de datos: consulta los resultados obtenidos en los test realizados y los devuelve al administrador.
4.1.11 Modificar información instituciones
Ilustración 13: Modificar información instituciones
• Administrador: es el usuario que maneja toda la información consolidada en la base de datos
• Consultar información instituciones: el usuario consulta información adicional de las carreras y encuentra información de las instituciones donde se dicta el programa
• Modificar información institución: una vez obtiene los resultados de las instituciones, el administrador procede a modificar la información de éstas.
• Manejador base de datos: una vez recibe la petición del usuario envía las modificaciones realizadas a la base de datos
• Base de datos: recibe la información de el manejador y modifica lo que se le pidió
5. Vista lógica
5.1. Vista general
La arquitectura lógica del sistema de KunaySoft que se usó fue la arquitectura por capas, en donde se puede ver con mayor detalle en el diagrama. En la arquitectura se tienen 3 capas, la primera es la capa de presentación, la segunda la capa de lógica y la capa de datos. En la capa de presentación se encuentra todo lo relacionado con la página web, la capa de negocio se encuentra la lógica del sistema, donde nos referimos a lógica a las funciones principales que puede desarrollar el sistema y por último la capa de datos, donde encontramos todos los datos obtenidos y guardados en la base de datos.
Ilustración 14: vista lógica
6. Vista de despliegue
Esta vista presenta como el sistema será distribuido en términos de componentes físicos (hardware), exponiendo como cada nodo del diagrama presenta una localización física diferente a las demás y sus respectivos componentes. El siguiente diagrama presenta la distribución del sistema KunaySoft.
Datos
Datos
Lógica
Funciones pincipales
Presentación
Servidor web
Ilustración 15: diagrama de despliegue
7. Vista de implementación Esta vista muestra el sistema de KunaySoft en la forma en que se distribuye los sistemas y mostrando los componentes de cada uno
Ilustración 16: Diagrama de implementación
En cada capa especifica las siguientes responsabilidades:
• Capa de datos, en la capa de datos se encuentra la base de datos y es usada por un manejador de base de datos. En esta base de datos encontramos toda la información acerca de las carreras con sus respectivas características de estilo de personalidad, aprendizaje y orientación vocacional, información de los estudiantes (nombre, colegio, edad, curso, nivel educativo padre, nivel educativo madre, etc.), los resultados obtenidos del test de satisfacción y algunas de las instituciones donde se dicta el programa
• Capa de lógica: la capa lógica es la encargada de las funcionalidades principales del sistema KunaySoft, ésta es la que dependiendo de los resultados obtenidos en los diferentes test genera las recomendaciones y evalúa que el desarrollo de los test de realizan de forma completa.
• Capa de presentación, esta capa provee y usa servicios de la capa lógica, mostrando los resultados que se obtienen desde un navegador web. De igual forma, es la encargada de enviar toda la información obtenida en los formularios y la encargada de mostrar los resultados dados por la capa logica.
