Documentación ágil de arquitecturas de software : Un enfoque basado en anotaciones de código

Abstract

El rationale arquitectónico es el conjunto de razones detrás de las de-cisiones tomadas al diseñar la arquitectura de un sistema o artefacto. Normalmente, dicho rationale se queda en las mentes de los diseñadores y de los demás involucrados en el diseño. Por lo tanto, el razonamiento detrás de las decisiones que sustentan el modelo de arquitectura puede perderse si no se documenta adecuadamente. En la práctica, el rationale no se documenta o se documenta en medio de las descripciones arquitecturales, lo cual dificulta su comprensión y apoyo a las decisiones posteriores dentro del desarrollo y mantenimiento de software. Para abordar este problema, en este trabajo, se propone un enfoque de documentación que combina el modelado del rationale con un modelo de decisiones, con el fin de especificar un lenguaje que expresamos a través de un meta-modelo que hemos denominado DRML (Decisions and Rationale Modeling Language), que fundamenta las bases para generar anotaciones de rationale en el código con la herramienta RADAR (Rationale Architectural Decision Annotations). También, aplicando ingeniería dirigida por modelos el meta-modelo DRML sienta los elementos para la construcción de la herramienta DRMLTool, que permite representar el fundamento arquitectónico de las decisiones de diseño que no se pueden colocar directamente en el código de manera gráfica, generando un modelo de Rationale como un artefacto mas de arquitectura. Este enfoque es aplicable en pequeñas entidades de desarrollo de software que utilizan métodos ágiles en sus procesos. DRML es simple, liviano y adaptable con el fin de hacerlo aplicable en proyectos reales. DRMLTool ha sido definido como un plugin de modelado en EMF con GMF y parcialmente aplicado en un estudio de caso empresarial, RA-DAR es implementado en el lenguaje Java.