Sellar y aprobar

Cada cambio pasa por dos sellos: la comprobación, de quien ejecuta el cambio, y la aprobación, de quien tiene un rol que aprueba. En los cambios de riesgo alto, el proyecto puede exigir además una aprobación previa, antes de la comprobación. Los tres se hacen en el panel «Lacre» de la incidencia.

Marcar la lista

El panel enseña la lista de comprobación del proyecto. Los puntos obligatorios hay que marcarlos para poder sellar; los opcionales se marcan si se han hecho. Cada marca se guarda en cuanto se hace, con quién la hizo y cuándo: debajo del punto aparece «Marcado por» con el nombre y la fecha en UTC. Quien abra la incidencia después ve las mismas marcas, y si dos personas tocan el mismo punto, cuenta la última.

Elige también el nivel de riesgo del cambio: «Bajo», «Medio» o «Alto». Se elige siempre; no hay un valor por defecto.

Si no puedes marcar, el panel dice por qué: no tienes ninguno de los roles del proyecto que marcan y sellan, Lacre está desactivado en el proyecto o la suscripción del sitio no está activa.

Sellar la comprobación

Con el riesgo elegido y los obligatorios marcados, pulsa «Sellar comprobación». Si falta algo, el panel dice qué: «Para sellar, elige el nivel de riesgo del cambio.» o la lista de los obligatorios que faltan.

El sello guarda, en un registro que ya no cambia:

• quién firma (su cuenta de Atlassian, confirmada con Jira en el momento de sellar) y cuándo, en UTC;
• la lista tal como la veía quien sella, con cada punto marcado o sin marcar y quién marcó cada uno y cuándo;
• el nivel de riesgo;
• el estado de la incidencia en ese momento: clave, proyecto, tipo, título, una huella de la descripción, estado, persona asignada, informador, prioridad, resolución, etiquetas, componentes, versiones y los campos personalizados que el proyecto haya elegido;
• el hash SHA-256 de todo lo anterior y el hash del sello anterior de la incidencia, de modo que los sellos de una incidencia forman una cadena.

Además, Lacre escribe un resumen del sello en una propiedad de la propia incidencia (lacre.seal. seguido del hash), que se queda en Jira aunque se desinstale la app. Al terminar, el panel dice «Evidencia sellada.», la cabecera enseña el identificador del sello y las marcas pasan al sello: la lista queda sin marcar para la próxima comprobación.

Si el panel dice otra cosa

• «Este estado ya estaba sellado: no se ha creado un sello nuevo.»: nada ha cambiado desde el último sello (ni la lista, ni el riesgo, ni la incidencia), así que no hace falta otro.
• «La lista o el nivel de riesgo han cambiado desde que se cargó el panel»: otra persona los ha tocado, o un administrador ha cambiado la lista del proyecto. El panel ya enseña lo actual: revísalo y vuelve a sellar. Lacre solo sella lo que tenías delante.
• «Otro sello de esta incidencia se ha guardado mientras tanto.»: alguien ha sellado a la vez. El panel ya lo enseña; sella otra vez solo si hace falta.
• «Esta incidencia se ha movido a otro proyecto desde que se abrió el panel.»: recarga la página de la incidencia, para sellar con la lista y los roles de su proyecto nuevo.

Sellar otra vez

Si el cambio se rehace o la incidencia se edita después del sello, se sella otra comprobación. La anterior pasa a «Sustituido» y se conserva: Lacre nunca borra un sello. La comprobación nueva necesita su propia aprobación, porque la de la anterior queda sustituida con ella.

Aprobar

Quien tiene uno de los roles del proyecto que aprueban ve, bajo la comprobación vigente, el apartado «Aprobación» con el botón «Sellar aprobación». La aprobación aprueba la comprobación tal como quedó sellada: su registro copia la lista y el riesgo de esa comprobación y guarda el estado de la incidencia al aprobar. Si tienes varios roles de los que aprueban, elige en «Rol con el que apruebas» con cuál lo haces: el rol queda en el sello.

Desde ese momento el panel enseña «Aprobado» con quién, su rol, la fecha y el identificador de la aprobación. Una comprobación tiene una sola aprobación vigente: si ya está aprobada, el panel lo dice y no crea otra.

Si el proyecto no tiene roles que aprueban, nadie puede aprobar y el apartado no aparece. Lacre no impide que una misma persona compruebe y apruebe si tiene los dos roles: para separar las funciones, el administrador da los roles que sellan y los que aprueban a personas distintas.

Aprobación previa en los cambios de riesgo alto

Si el proyecto tiene marcado «Exigir aprobación previa en riesgo ALTO» y eliges el riesgo «Alto», la comprobación no se puede sellar hasta que alguien con un rol que aprueba haya sellado la aprobación previa. El panel lo avisa: «Riesgo ALTO: el proyecto exige la aprobación previa de un aprobador antes de sellar la comprobación.»

1. Quien prepara el cambio marca lo que ya pueda y elige el riesgo «Alto».
2. Quien aprueba pulsa «Sellar aprobación previa»: aprueba el cambio con la lista tal como está en ese momento, aunque falten puntos obligatorios (todavía no se ha ejecutado).
3. Se ejecuta el cambio, se marca el resto de la lista y se pulsa «Sellar comprobación», que ya se puede.

La aprobación previa es la de la siguiente comprobación que se selle. Si entre una y otra cambió algún campo de la incidencia, el panel lo enseña: «Entre la aprobación previa y la comprobación cambió en la incidencia:» y los campos. Si después de la aprobación previa se baja el riesgo, la comprobación la lleva igualmente: lo que se aprobó era un cambio de riesgo alto, y así queda en el registro.