S02 - Evaluación documental

Contenido

CÓDIGO

S02

NOMBRE

Evaluación documental

OBJETIVO

Verificar que los entregables documentales generados durante el ciclo de vida del desarrollo del software incluyen la información mínima exigible, y cumplen unas normas básicas de nomenclatura, formato, contenido y se almacenan en un repositorio corporativo de la Junta de Andalucía.
Cuando el sistema está en integración y despliegue continuo (CI/CD), siempre que sea viable estas evaluaciones se ejecutan como parte del pipeline definido, de forma completa o en parte

ENTRADAS

1) Plan Específico de la Calidad del Sistema (PECS).
2) Documentación en repositorio documental y acceso al mismo.
3) Código fuente en repositorio de código y acceso al mismo.
4) Si las evaluaciones están automatizadas, acceso al pipeline en la plataforma CI/CD y al resto de herramientas en las que se sustenta la automatización.

SALIDAS

1) Informe del resultado con detalle de todas las pautas de evaluación realizadas, incluyendo recomendaciones.
2) Actualización del sistema en la herramienta HRC detallada en el Plan General de Calidad.

RESULTADO

- Superado: Se superan las pautas de evaluación de severidad ALTA y MEDIA. Pueden existir de severidad BAJA no superadas, considerándose recomendaciones para la mejora.
- Superado con reservas: Se superan las pautas de evaluación de severidad ALTA, pero hay al menos una de severidad MEDIA no superada.
- No superado: Al menos una pauta de evaluación de severidad ALTA no ha sido superada, por tanto, requiere subsanación.

CADUCIDAD

12 meses

PAUTAS DE EVALUACIÓN

ID.DESCRIPCIÓNSEVERIDADOBSERVACIONES
C01La información de la documentación del sistema es suficiente y está actualizada, según aplique.ALTASe considera que la información mínima exigible que debe estar presente en la documentación del sistema es:
- Definición del sistema.
- Arquitectura del sistema, incluyendo diagrama,  descripción tecnológica y descripción técnica de interoperabilidad, si procede.
- Modelo de clases, o similar.
- Modelo de datos.
- Estructura del código fuente.
- Plan de prueba, incluidas las de regresión.
- Instrucciones de instalación y de actualización si procede.
- Ayuda al usuario del sistema.
- Ayuda a la administración, si procede.
- Ayuda para interoperar con el sistema, si procede.
C02Los entregables documentales siguen el manual de Identidad corporativa de la Junta de Andalucía.ALTAEl manual de identidad corporativa está disponible en: https://juntadeandalucia.es/identidad
C03Los entregables documentales se almacenan en un repositorio corporativo de la Junta de Andalucía.ALTA 
C04Los entregables documentales se asocian a las versiones del software de forma clara.ALTA 
C05La estructura de los entregables documentales es acorde a la organización del sistema y sus componentes.ALTA 
C06Se siguen las prácticas definidas en la gestión documental que apliquen, aprobadas en la Agencia Digital de Andalucía, y publicadas en este Portal con una norma que las sustenten.ALTAMientras no exista una normativa corporativa en una materia, convivirán con las que puedan existir en las consejerías y entidades, las cuales deberán ir desapareciendo conforme se aprueben y publiquen las correspondientes en este Portal. O en su defecto, las indicadas por el Responsable tecnológico del sistema.
C07En relación al gobierno de arquitectura de soluciones, el contenido de los documentos (arquitectura, uso de plataformas, etc.) sigue las normas que apliquen, aprobadas y publicadas en este Portal.ALTAMientras no exista una normativa corporativa en una materia, convivirán con las que puedan existir en las consejerías y entidades, las cuales deberán ir desapareciendo conforme se aprueben y publiquen las correspondientes en este Portal. O en su defecto, las indicadas por el Responsable tecnológico del sistema.
C08El contenido de los documentos es adecuado a su objeto.ALTA 
C09La trazabilidad entre los documentos y sus contenidos es suficiente y no se detectan inconsistencias.MEDIA 
C10No se detectan errores de formato que dificulten la legibilidad.MEDIA 
C11No se detectan errores ortográficos o gramaticales o son casos puntuales.BAJA 
C12El código fuente se encuentra en un repositorio corporativo de la Junta de Andalucía.ALTA 
C13Existe un control de versiones del código fuente.ALTA 

FECHA DE ACTUALIZACIÓN

21/10/2024

Índice