FAQs: Preguntas frecuentes
- ¿Qué es MADEJA?
- ¿Quién define el contenido de MADEJA?
- ¿Cómo se articula el proceso de publicación?
- ¿Hay alguna forma de verificar el cumplimiento de las pautas de MADEJA?
- ¿Qué es una pauta?
- ¿Qué es un libro de pautas?
- ¿Qué es un procedimiento?
- ¿Qué es un recurso?
- ¿Qué indica el carácter de una pauta?
- ¿Cómo está organizado el contenido de MADEJA?
- ¿Cómo acceder a la ayuda del portal MADEJA?
- ¿Cómo realizar búsquedas generales en todo el contenido?
- ¿Están etiquetados los contenidos de MADEJA?
- ¿Cómo consultar todos los contenidos de un determinado tipo?
- ¿Cómo consultar los contenidos que conciernen a un determinado perfil de usuario, a una fase concreta del ciclo de vida o a una tecnología?
- ¿Cómo puedo contactar con un administrador de MADEJA?
- ¿Cómo puedo colaborar en la elaboración de MADEJA?
MADEJA es el Marco de Desarrollo de la Junta de Andalucía. Su misión es proporcionar un entorno que permita a todos los implicados en el desarrollo del software tener una referencia clara de cuáles son las directrices que han de guiar esta actividad, así como dar a conocer los recursos y herramientas que están a su disposición.
Consulta los apartados de definición y objetivos para entender las finalidades que persigue MADEJA y las razones que justifican su necesidad.
El proyecto MADEJA está liderado por el Servicio de Coordinación y Desarrollo de Sistemas Horizontales de la Dirección General de Política Digital de la Consejería de Hacienda y Administración Pública de la Junta de Andalucía. Además participan todas las Consejerías y Organismos de la Junta de Andalucía a través del Grupo de Responsables de MADEJA de la Junta de Andalucía y grupos de usuarios especializados para cada subsistema.
Para la elaboración del contenido se cuenta asimismo con aportaciones de otros colaboradores como profesionales independientes, universidades y empresas.
Es importante destacar que MADEJA tiene un planteamiento independiente y abierto. MADEJA no tiene intención de ser un flujo unidireccional de directrices y normas. Por el contrario, se ha planteado como un producto abierto a la colaboración, que necesita ser realimentado por las aportaciones de los distintos actores implicados para que su validez y cobertura sea la óptima, ajustándose a las necesidades reales de los desarrollos de la Junta de Andalucía.
El proceso de publicación se articula en torno a distintos entornos de trabajo y actores o perfiles que actúan sobre los mismos.
Los entornos son espacios diferenciados que permiten ir evolucionando los contenidos a la vez que se mantienen las versiones estables publicadas. Existen tres entornos diferenciados:
- Entorno de desarrollo o áreas de trabajo. Se utiliza para evolucionar el contenido, en versiones borrador. Sobre él trabajan grupos de trabajo compuestos tanto por personal técnico interno de MADEJA como personal de empresas externas que prestan sus servicios para la generación de nuevos contenidos.
- Entorno corporativo. Las redacciones estables provenientes del entorno de trabajo se van actualizando periódicamente sobre este entorno de pre-publicación para que, de forma previa a la publicación final, se puedan someter a la revisión por parte de los grupos de responsables y usuarios expertos de las Consejerías y Organismos de la Junta de Andalucía. Éstos podrán proponer cambios, realizar comentarios o aportaciones, que serán revisadas y consensuadas entre todos y aprobadas por la dirección del proyecto MADEJA.
- Entorno público. Es el escaparate de MADEJA hacia el exterior, accesible desde Internet a todo el público general. Es el entorno cuyo cumplimiento es vinculante en aquellos contratos de desarrollo de software para la Junta de Andalucía en que así se especifique expresamente.
En el subsistema de Verificación se exponen los mecanismos recomendados para que un equipo de trabajo desarrolle la actividad de "verificación" o "testing" del software de acuerdo a MADEJA. En resumen, la propuesta incluye una estructura para documentar la normativa, mediante la relación pauta-verificación, un modelo de certificación y un catálogo de servicios estructurados en procesos de testing.
Durante la ejecución de los servicios de testing se lleva a cabo la revisión de las verificaciones definidas. Para un conjunto importante de pautas de MADEJA, especialmente aquellas relacionadas con el subsistema de desarrollo y la tecnología JEE, existen reglas automatizadas de verificación; para el resto se definen verificaciones manuales.
La Oficina de Testing de SADESI ofrece estos servicios. Se recomienda que otras oficinas de testing o de calidad alineen su metodología de trabajo con la de dicha oficina. Para más información, consultar el subsistema de Verificación, especialmente el catálogo de servicios de testing actualmente en vigor.
Las pautas son el elemento más importante de MADEJA. La función de las pautas es marcar cada uno de los aspectos que MADEJA considera relevantes en una determinada área en forma de directrices o consejos que se deben aplicar o se recomienda aplicar sobre las materias que se describen.
Existen dos tipos de pauta: Directriz y Consejo.
- Una pauta de tipo “Directriz” es un conjunto de instrucciones o normas generales para la ejecución de alguna cosa. En MADEJA una directriz se encarga de fijar, de entre todas las posibilidades, la forma preferida de hacer algo.
- Una pauta tipo "Consejo" es una recomendación sobre una materia, cuyo fin es facilitar la toma de decisiones.
Una libro de pautas es una agrupación de pautas simples que tienen estrecha interrelación.
Estas pautas expresan distintos matices, consideraciones o escenarios de aplicación sobre un mismo enunciado o temática. El libro de pautas es una agrupación que permite estructurar mejor las pautas y dotarlas de un contexto completo.
Un procedimiento es una formalización y documentación de un proceso sistemático que, mediante la ejecución de una secuencia de actividades o fases claramente definidos y repetibles, persigue la obtención de un resultado.
Cada procedimiento es representado mediante un gráfico o diagrama de flujo de actividades y una descripción detallada de cada una de las actividades lo componen (tareas, responsables, productos...)
Un recurso es contenido de soporte o ayuda para la aplicación o alineamiento con las pautas y procedimientos. Contiene información en detalle, de bajo nivel de abstracción, que tiene relación con las pautas y procedimientos relacionados.
- Obligatoria: El cumplimiento de la directriz especificada en la pauta es obligatorio para que la aplicación que se está desarrollado pueda considerarse como alineada con MADEJA.
- Recomendada: Aunque no se trata de una directriz obligatoria, MADEJA recomienda seguir dicha directriz.
- No Recomendada: La pauta hace referencia a una directriz o herramienta cuyo uso no se recomienda y que supondrá que la aplicación desarrollada no podrá considerarse como alineada con MADEJA.
El contenido de MADEJA está organizado en subsistemas. Cada uno de estos subsistemas se centra en un aspecto concreto del desarrollo software. El contenido de cada uno de los subsistemas es el siguiente:
- Arquitectura: En este subsistema se describe una propuesta de modelo de arquitectura tecnológica de referencia. Se describe la arquitectura de sistemas de información de la Junta de Andalucía, incluyendo recomendaciones acerca de su uso e su integración con sistemas de información, herramientas e infraestructuras horizontales. Incluye también información acerca de la integración de sistemas de información, basados en el concepto de arquitectura orientada a servicios.
- Catálogo: La información contenida en este subsistema se centra en el fomento de la reutilización del código, definiendo un modelo de licencia y promoviendo el uso del Catálogo de Software.
- Entorno: Es este subsistema se recoje la información relativa a aspectos relacionados con los entornos de ejecución, concretamente con la gestión de entregas y la gestión de entornos y despliegues.
- Desarrollo: El objetivo de la información recogida en este subsistema es la normalización de aspectos relacionados con la codificación. En este subsistema se tratan temas como convenios de codificación, tecnologías recomendadas y permitidas, desarrollo de aplicaciones seguras, buenas prácticas para mejorar el rendimiento de aplicaciones, etc.
- Ingeniería: La información incluida en este subsistema se centra en la metodología de ingeniería del software, incluyendo aspectos de ingeniería de requisitos, creación y evolución de sistemas, gestión de proyectos, comunicación y difusión, etc.
- Verificación: En este subsistema se incluye información acerca de mecanismos que permitan evaluar el nivel de excelencia de los desarrollos, en cuanto a nivel de cumplimiento o conformidad con las normas de MADEJA Se incluyen criterios de verificación, sistemas de validación y herramientas automatizadas que guíen y faciliten la realización de pruebas y la verificación del código, de acuerdo a las directrices de MADEJA.
- Interfaz de Usuario: Se incluyen en este subsistema aspectos relacionados con la interacción con los usuarios a nivel de interfaz de las aplicaciones.
Para obtener ayuda de forma casi inmediata puede utilizar el menú AYUDA Y SOPORTE. En este menú puede encontrar ayuda a través de la Guía de Uso para el lector, de la Guía de Uso para el contribuyente o redactor de contenidos o de la Guía de Uso para el validador de contenidos. Otras opciones de las que puede conseguir ayuda son las FAQs y los glosarios de términos.
Para localizar materias de cualquier contenido use el cuadro de búsqueda disponible en la esquina superior izquierda de todas las páginas. Este cuadro permite buscar tanto por el título como por el contenido de los elementos incluidos en el portal de MADEJA.
Si, los contenidos de MADEJA están etiquetados según su contenido. Para acceder a una nube de etiquetas basta con seleccionar la opción “Búsquedas y Consultas” del menú. En la pantalla general de consultas, junto a enlaces a las distintas búsquedas disponible, aparecerá una nube de etiquetas junto a listados de las etiquetas más populares y las más recientes, así como el contenido más descargado.
Mediante la opción “Tabla de Pautas” disponible en el "Búsquedas y Consultas" se puede acceder a una vista resumen con todas las pautas (directrices obligatorias, recomendadas y consejos) de todos los subsistemas de MADEJA. Asimismo, mediante las opciones “Tabla de Procedimientos” y “Tabla de Recursos” se puede tener una vista de todos los procedimientos y todos los recursos que existen en MADEJA.
Utiliza la búsqueda avanzada para filtrar las pautas, procedimientos o recursos que encajen con tus intereses, por ejemplo para obtener el listado de las pautas obligatorias de un determinado subsistema o área.
En el menú “Búsquedas y Consultas” existe una opción denominada “Perfiles” que permite consultar que contenidos de los incluidos en MADEJA están relacionado con un perfil concreto de los implicados en el desarrollo de una aplicación.
Mediante la opción “Fases del ciclo de vida” del mismo menú es posible consultar que contenidos están implicados en cada una de las fases del ciclo de vida de una aplicación.
Por último, la opción “Tecnologías” nos permite consultar los contenidos de MADEJA que están relacionados con una tecnología concreta.
Para obtener ayuda de una administrador de MADEJA o realizar consultas, comentarios, aportaciones, etc. puede utilizar el formulario de contacto definido en el menú arriba a la derecha del portal. Será necesario indicar su Nombre, dirección de correo electrónico, asunto y mensaje.
Grupos de Expertos
Para la elaboración y revisión ágil de los subsistemas de MADEJA se fomenta la creación de grupos de expertos para cada uno de ellos, de forma que se pueda consensuar de forma ágil el contenido de los mismos y que los organismos puedan participar según su especialización y conocimiento en las distintas áreas que cubren.
Los grupos de expertos por subsistemas constituyen un mecanismo de colaboración de la comunidad TIC de la Junta de Andalucía para aunar esfuerzos en la elaboración y evolución de las pautas de MADEJA. Serán convocados por la dirección del proyecto y en las reuniones de seguimiento se debatirán y expondrán las distintas alternativas.
Colaboraciones Específicas de Consejerías u Organismos
Mediante las colaboraciones específicas aquellas Consejerías u Organismos especialmente avanzados en ciertas áreas podrán realizar una aportación más integrada con la producción de contenidos.
En estos casos, se acordarán con la dirección los mecanismos de colaboración más adecuados, que podrán consistir en la habilitación de un espacio de contenidos con los permisos necesarios así como la incorporación de los expertos en el flujo de edición y validación de contenidos.
