| Objectiu | ||
| Realitzar una verificació o revisió dels lliurables d’un Sistema d’Informació, tant des de la seva vessant interna (documentació, codi font, …) com des de la seva vessant externa (ús de l’aplicació o sistema en execució) | ||
| Qui ho fa | Qui ho valida | |
| Cap de Projecte (Proveïdor) | Responsable funcional de sistema d'informació | |
| Entrades | Sortides | |
|
|
||
La revisió de lliurables es realitzarà sempre des de les vessants:
- Revisió de la qualitat externa (solució)
- Revisió de la qualitat interna (lliurables). Existeix un cas especial que és la revisió del codi font.
Revisió de la qualitat externa
La revisió de la qualitat externa es realitza mitjançant l’avaluació dels diferents criteris de qualitat en el sistema ja en producció. Aquesta avaluació es realitzarà tenint en compte diferents entrades d’informació:
- El qüestionari d’avaluació
- Indicadors objectius (incidències, mesures de disponibilitat, …)
Realitzar una revisió amb el responsable de solució i els diferents implicats per valorar la qualitat percebuda
Omplir el qüestionari d’avaluació de la qualitat amb la plantilla Assumpte_Q_AVQ_V1.1.xlsx
Revisió de la qualitat interna
Definir els criteris de la revisió
Es recomana l’ús de checklists per establir els criteris de la revisió, així com els requisits i criteris d’acceptació.
Usar per defecte les següents checklists:
- Checklist de l’especificació dels requisits
- Checklist de descripció d’arquitectura
- Checklist del pla (mestre) de proves
- Checklist de les especificacions de les proves
- Checklist dels resultats de les proves
- Checklist del codi font. Complementar la revisió manual amb una revisió automàtica amb l’eina Sonarqube
Si es disposa d’una checklist diferent o una checklist per algun lliurable que no estigui inclòs en aquestes checklists, utilitzar-la com a criteri de la revisió.
En qualsevol cas tenir en compte:
- Què esperem trobar? Errors, compliment de format, cobertura funcional i correctesa, comprensió fàcil, compliment d’estàndards (noms, convencions, …)
- Adaptar la checklist. Adaptar o afegir les verificacions que es realitzaran.
- Establir quines eines de suport s’usaran per recolzar la checklist o altres mètodes de revisió (per exemple, en el cas de checklist del codi font, recolzar l’avaluació amb l’ús de l’eina Sonarqube)
- Determinar amb quin mètode s’informaran les disconformitats trobades durant la revisió (columna extra al checklist, registre en alguna eina, …)
Preparar entorn per realitzar revisions
Realitzar els passos necessaris per preparar la infraestructura necessària per a realitzar les revisions. Això inclou, entre d’altres:
- Preparar les checklists que serviran per realitzar les revisions
- Preparar les eines de suport a les revisions, com és el cas de l’eina Sonarqube per les revisions de codi
Realitzar una revisió
Realitzar la revisió amb els criteris de revisió establerts, verificar els lliurables i donar feedback.
La periodicitat de les revisions s’ha d’establir en el Pla de Qualitat.
Generar l’informe de revisió i compartir els resultats
Elaborar l’informe de revisió amb la plantilla Assumpte_IN_REV_V2.0.docx i les instruccions que consten en ella
Ser constructiu en proporcionar la informació, mai des d’un punt de vista crític. Obtenir el compromís de l’autor del lliurable per efectuar els canvis requerits.
Establir les accions de millora que s’han de realitzar, tot tenint en compte la revisió realitzada i les incidències o defectes a corregir. S’han d’indicar les dates compromeses per la seva execució.
Elaborar el pla de millora amb la plantilla Assumpte_PLA_MIL_V1.0.docx
Realitzar millores i correccions
Realitzar les accions establertes al pla.
Revisió del codi font
La revisió del codi font és un cas especial de revisió de lliurables, en el que veurem com aplica el procés anteriorment descrit.
Es pot fer ús de la versió de l’eina que es consideri més idònia segons les tecnologies i versions acceptades.
Definir els criteris de la revisió
S’usaran els criteris de revisió que l’eina Sonarqube porta per defecte.
Preparar entorn per realitzar revisions
Cal preparar l’entorn de l’eina Sonarqube AIP seguint la guia Sonarqube
Realitzar una revisió
Realitzar la revisió de codi seguint la guia Sonarqube
Generar l’informe de revisió i compartir els resultats
Generar l’informe de resultats seguint la guia Sonarqube
Realitzar l’avaluació dels resultats seguint la guia Sonarqube
Enviar l’informe a la bústia ‘qualitat.solucions@gencat.cat’
Establir accions millora
Incloure la proposta de millores dins el Pla d’Accions de Millora
Usar la plantilla Pla Accions Millora