En este respositorio se encuentran todos los archivos necesarios para llevar a cabo la ejecución de un estudio exploratorio enfocado en la verificación de la utilidad de una herramienta Software basada en anotaciones de código fuente Java, como una forma rápida y efectiva de documentar las razones de las decisiones arquitecturales, más conocidas como Rationale Arquitectónico.
El objetivo de este experimento es analizar la documentación del rationale arquitectónico a través de anotaciones de código, con el propósito de determinar el valor de las anotaciones de código como herramienta para documentar el rationale arquitectónico con respecto a la mantenibilidad de la arquitectura en términos de eficiencia y efectividad.
-
Efectividad
-
La efectividad al realizar un cambio arquitectural en un sistema con la documentación del Rationale arquitectónico en anotaciones de código, es menor o igual a la efectividad de realizar el cambio sin anotaciones de código.
-
La efectividad al realizar un cambio arquitectural en un sistema con la documentación del Rationale arquitectónico en anotaciones de código, es mayor a la efectividad de realizar el cambio sin anotaciones de código.
-
-
Eficiencia
-
La eficiencia al realizar un cambio arquitectural en un sistema con la documentación del Rationale arquitectónico en anotaciones de código, es menor o igual a la eficiencia de realizar el cambio sin anotaciones de código.
-
La eficiencia al realizar un cambio arquitectural en un sistema con la documentación del Rationale arquitectónico en anotaciones de código, es mayor a la eficiencia de realizar el cambio sin anotaciones de código.
-
-
Varibles independientes:
- Presencia de las anotaciones de código con información del Rationale Arquitectónico(variable categórica)
-
Varibles dependientes:
- Eficiencia: ((Nivel de Correctitud Total)/(Total de tiempo empleado))/(Nivel de Correctitud Total de Referencia)
- Efectividad: (Nivel de Correctitud Total)/(Nivel de Correctitud Total esperado)
- Alguno de estos IDE (Integrated Development Environment):
- El modelador de Software:
-
Las herramientas del Sistema Operativo
- Visor de PDF
- Visor de imágenes
-
Documentación
- Diagramas en imágenes .png
- Diagramas en .mdj(StarUML)
- SAD: Software Architecture Document
-
Código fuente
- Con anotaciones
- com: Paquete con el código fuente y las anotaciones de códgigo
- lib: 7 librerías .jar utilidas para Reflexión y 1 .jar con el modelo de anotaciones ARAT
- Sin anotaciones
- com: Paquete con el código fuente
- lib: 7 librerías .jar utilidas para Reflexión
- Con anotaciones
- Ejemplo de una implementación de Sockets
Sitio web: Santiago Hyun Dorado