Desarrollo ágil: Historias de usuario y criterios de aceptación

Consejo Nacional de Técnicos Electricistas

Enunciado de la historia Criterios de aceptación

Identificador Característica / Número (#) de Criterio de aceptación
(ID) de la Rol Razón / Resultado Contexto Evento
Funcionalidad escenario (Título)
historia
1 Técnico Necesito llenar un Con la finalidad de 1 Subir documento de Al llenar el formulario de solicitud Al subir el archivo del
formulario con los iniciar un tramite de identidad documento de identidad
datos de la matrícula,
solicitud ampliación o
licencia especial

2 Formulario de solicitud Luego de haber subido el documento de Al llenar el formulario de

identidad solicitud, subir los documentos
y elegir un método de pago

3 Validación automática Tramitando una solicitud en la página Mientras se diligencia el

formulario de solicitud
2 Técnico Necesito verificar Con la finalidad de 1 Ver trámite Después de haber iniciado un trámite y Cuando se ingrese el
el estado de mi saber querer saber el estado en el que se documento del técnico
trámite detalladamente el encuentra
estado de mi
proceso

3 Técnico Necesito poder Con la finalidad de 1 Obtener medio de pago Al tener un código de autenticación e Al ingresar el código de
pagar una solicitud continuar con mi ingresar a la página para obtener el medio autenticación y seleccionar un
trámite de pago método de pago

2 Pagar solicitud Al haber autenticado el mecanismo de Al pagar la solicitud creada

notificación del formulario e ingresar a la (Recibo impreso ó PSE)
página para obtener el medio de pago

3 Pagar solicitud vigente Al haber autenticado el mecanismo de Cuando se ingrese el

notificación del formulario e ingresar a la documento del técnico y se
página para obtener el medio de pago seleccione una forma de pago
(Recibo impreso o PSE)

4 Técnico Necesito generar Con la finalidad de 1 Documento certificado Una vez se ha radicado la solicitud en el Cuando se ingrese el
un certificado de dar validez a mi CONTE documento del solicitante
trámite trámite frente a
terceros
4 Técnico Necesito generar Con la finalidad de 1 Documento certificado Una vez se ha radicado la solicitud en el Cuando se ingrese el
un certificado de dar validez a mi CONTE documento del solicitante
trámite trámite frente a
terceros
n

Resultado / Comportamiento esperado

El sistema utilizará un mecanismo OCR para

extraer los siguientes datos:

-Número de cédula
-Nombre completo
-Fecha de nacimiento
-Sexo

Con esta información llenará los campos

correspondientes en el formulario de solicitud.
En caso de que el OCR no reconozca el
documento, dejará los espacios del formulario
en blanco

Una vez validado los datos en el sistema, se

valida que trámites puede hacer el técnico

El sistema creará el flujo de trabajo (sin

asignarlo a ningún rol), generará el formulario
de solicitud, anexandolo junto con los los
documentos adjuntados por el técnico al
expediente del técnico y enviará un código de
autenticación al correo y  al teléfono
(Diferente en cada uno para detectar que
mecanismo se válida)

Esta solicitud tendrá una vigencia de 20 días

(Valor parametrizable) de lo contrario los
documentos y el flujo serán eliminados

Nota: Válidar si el correo rebota para editarlo

El sistema mostrará mensajes de validación

sobre el formulario (Ver documento de
historias de usuario, tabla de obligatoriedad
del documento según tipo de trámite)
El sistema mostrará detalladamente el estado
de la solicitud

El sistema mostrará al técnico el recibo de

pago o redirigirá a el botón PSE, de acuerdo a
la selección del método de pago. El valor del
pago depende del tipo de trámite y si hay
algún descuento que aplique

Nota: Establecer una forma de permitir válidar

tanto el correo como el teléfono

Si es un pago de un valor faltante por un

descuento que no aplica, el sistema asigna un
radicado (se genera uno nuevo para matrícula
y licencia especial por primera vez, de lo
contrario se tomará el radicado asignado
anteriormente), envía notificación al técnico
(mensaje de texto y correo electrónico, al
medio o medios que esten validado) y se
asigna de manera balanceada entre los
usuarios con rol validador

De lo contrario, el sistema asignará el flujo

entre los usuarios con rol verificación de
manera balanceada para verificar los
documentos anexados por el técnico

El sistema responderá dependiendo de la

opción elegida así:

- PSE: Redirigirá al portal de PSE para pagar en

línea

- Recibo impreso: Generará una factura con un

código de barras para realizar el pago

El valor del pago depende del tipo de trámite y

si hay algún descuento que aplique

El sistema generará un documento el cual

certifica que el trámite del solicitante está en
curso
El sistema generará un documento el cual
certifica que el trámite del solicitante está en
curso
 Enunciado de la historia Criterios de aceptación
Identificador Característica / Número (#) de Criterio de aceptación
(ID) de la Rol Razón / Resultado Contexto Evento Resultado / Comportamiento esperado
Funcionalidad escenario (Título)
historia
1 Verificación Necesito verificar Con la finalidad de Realizar verificación Al recibir la notificación y verificar los Al seleccionar un El sistema responderá así dependiendo del
los documentos verificar que cumple documento documentos resultado de la resultado de la verificación elegido:
que el técnico con los requisitos verificación (Aplica o
electricista sube al Subsanar) y en caso - Aplica: El documento se marca como
realizar la solicitud de elegir subsanar, verificado
escribir una
observación del error - Subsanar: Notifica al técnico, la asociación y
en el documento el inspector (si aplica) el error en el
documento y la posibilidad de subsanarlo. A
partir de la primera vez que se encuentre en
este estado se tienen de 5 a 15 días (Valor
parametrizable por cada documento) para
dejar el documento en estado 'Aplica', de lo
contrario quedará en estado 'Inadmitido',
automáticamente después de este tiempo,
además se notificará al técnico cada 3 días
(Valor configurable por cada documento)
transcurridos sin subsanar el documento.
Se anexará la evidencia de la notificación cada
vez que se pida subsanar un documento

- Inadmitido: Notifica al técnico de su

inadmisión y genera la resolución de rechazo y
se anexa al expediente del técnico, luego se
asigna al usuario con rol financiera para la
devolución del dinero. El técnico tendrá X días
(Valor parametrizable) para solicitar la
devolución de su dinero, de lo contrario el
CONTE legalizará el dinero y el flujo se
archivará

Cuando se ha terminado de verificar todos los

documentos y están en estado 'Aplica', el
sistema pedirá una verificación si el trámite
tiene algún descuento
 2 Verificación descuento Cuando el sistema pide una verificación del Al seleccionar aplica o El sistema responderá de la siguiente manera
pago por un descuento y se revisa el
documento con el cual aplica al descuento
no aplica dependiendo de la opción seleccionada:
- Aplica: Se asigna un radicado al flujo de
trabajo (se genera uno nuevo para matrícula
por primera vez, de lo contrario se tomará el
radicado asignado anteriormente), se notifica
al técnico (mensaje de texto y correo
electrónico, al medio o medios que esten
validado) y se asigna el flujo de trabajo entre
los usuarios con rol validación
balanceadamente

- No aplica: Se genera un nuevo formato de

pago con el valor restante de la solicitud, se
envía una notificación al técnico (mensaje de
texto y correo electrónico, el que esté
validado o ambos si están validados) para
realizar el pago del valor restante y el
cambiará el estado del flujo a 'Esperando pago
restante', hasta que se reciba el nuevo pago

2 Verificación Necesito editar los Con la finalidad de 1 Editar campos solicitud Al terminar de verificar todos los Al editar los campos El sistema cambiará los campos editados y
campos de la corregir algún error documentos anexados por el técnico de la solicitud dejará la trazabilidad de los cambios hechos
solicitud de selección (título,
institución) o de
digitación, nombre,
apellido, etc antes
de radicar
Desarrollo ágil: Historias de usuario y criterios de aceptación
Consejo Nacional de Técnicos Electricistas

Enunciado de la historia Criterios de aceptación

Identificador
Característica / Número (#) de Criterio de aceptación
(ID) de la Rol Razón / Resultado Contexto Evento Resultado / Comportamiento esperado
Funcionalidad escenario (Título)
historia
1 Tercero Necesito validar los Con la finalidad de 1 Autenticación de Al recibir un documento de trámite o Al utilizar el El sistema mostrará al tercero la autenticidad
documentos del autenticar dicho documento vigencia mecanismo de o no del documento
técnico documento autenticación (Se
(Certificados de sugiere utilizar
vigencia y trámite) código QR)

2 Familiar Necesito solicitar la Con la finalidad de 1 Enviar documentación Cuanto un técnico electricista ha fallecido y Al cargar la El sistema verificará el estado de la solicitud y
Técnico devolución del interrumpir el algún familiar desea reclamar el dinero documentación responderá de acuerdo a la tarea en la que se
dinero trámite necesaria encuentre:

- Si no se ha evaluado, el sistema asignará el

flujo de trabajo a el rol tesorería

- Si ya fue evaluado, el sistema no permitirá

solicitar la devolución del dinero

El ambos casos el sistema notificará al familiar

de los pasos a seguir o el rechazo de la
solicitud
Desarrollo ágil: Historias de usuario y criterios d
Consejo Nacional de Técnicos Electricistas

Enunciado de la historia
Identificador
Característica / Número (#) de
(ID) de la Rol Razón / Resultado
Funcionalidad escenario
historia
1 Validación Necesito validar los Con la finalidad de 1
documentos que el verificar la
técnico sube al autenticidad del
realizar la solicitud documento
suario y criterios de aceptación
Criterios de aceptación

Criterio de aceptación
Contexto Evento
(Título)

Realizar validación Cuando se ha asignado la tarea y no ha Al elegir un

documento llegado a un estado final método de
validación (Web,
Llamada, email) y
el resultado de la
validación
(Validado,
Pendiente,
Subsanar,
Presunta falsedad
de documento)
ción

Resultado / Comportamiento esperado

El sistema permitirá anexar la evidencia de la

validación cada vez que se cambie de un estado a
otro y responderá así dependiendo del resultado
de la validación elegido:

- Validado: Marca el documento como validado

- Pendiente: Notifica al validador luego de un

tiempo definido por él mismo para finalizar la
validación (de un rango entre 15 minutos a 1 día)

- Subsanar: Notifica al técnico, la asociación y el

inspector (si aplica) que no se pudo validar el
documento y la posibilidad de subsanarlo, a partir
de la primera vez que se encuentre en este estado
se tienen de 5 a 10 días (Valor parametrizable por
cada documento)  para dejar el documento en un
estado final, de lo contrario quedará en estado
inadmitido.

- Inadmitido: Notifica al técnico la razón de su

inadmisión, luego se genera la resolución de
rechazo y se asigna a financiera para la devolución
del dinero, el técnico tendrá X días (Valor
parametrizable) para solicitar la devolución de su
dinero, de lo contrario el CONTE legalizará el
dinero y el flujo se archivará

- Presunta falsedad:El sistema solicitará una

confirmación al rol, de confirmar, el documento se
marca como inadmitido.

Cuando todos los documentos queden en un

estado final: Validado, Inadmitido u Omitido (el
técnico es el único que decide omitir un
documento), el sistema generará un documento
de trazabilidad de la validación. Si ningún
documento queda en estado inadmitido, asignará
de manera balanceada la solicitud a los usuarios
con rol evaluador y asignará una calificación al
expediente acorde a los certificados de estudio
(Precalificación)
rechazo y se asigna a financiera para la devolución
del dinero, el técnico tendrá X días (Valor
parametrizable) para solicitar la devolución de su
dinero, de lo contrario el CONTE legalizará el
dinero y el flujo se archivará

- Presunta falsedad:El sistema solicitará una

confirmación al rol, de confirmar, el documento se
marca como inadmitido.

Cuando todos los documentos queden en un

estado final: Validado, Inadmitido u Omitido (el
técnico es el único que decide omitir un
documento), el sistema generará un documento
de trazabilidad de la validación. Si ningún
documento queda en estado inadmitido, asignará
de manera balanceada la solicitud a los usuarios
con rol evaluador y asignará una calificación al
expediente acorde a los certificados de estudio
(Precalificación)
Desarrollo ágil: Historias de usuario y criterios de aceptación
Consejo Nacional de Técnicos Electricistas

Enunciado de la historia Criterios de aceptación

Identificador Característica / Número (#) de Criterio de aceptación
(ID) de la Rol Razón / Resultado Contexto Evento Resultado / Comportamiento esperado
Funcionalidad escenario (Título)
historia
1 Evaluador Necesito rechazar Con la finalidad de 1 Revisar documentación Cuando se ha asignado un trámite y Al seleccionar un resultado El sistema responderá así dependiendo del
un técnico por notificar al técnico para calificación ha revisado la información del de la revisión (Aplica o resultado de la verificación elegido:
documentación para subsanar los expediente subsanar) y en caso de elegir
que no aporta una documentos subsanar, escribir una - Aplica: Se habilitará el flujo para calificación
calificación pertinentes observación sobre la
documentación. - Subsanar: Notifica al técnico, la asociación y
el inspector (si aplica) las falencias en la
documentación y la posibilidad de subsanar y
agregar nueva documentación. Se tienen 15
días (Valor parametrizable) para subsanar o
agregar nueva documentación que el sistema
remitirá al rol verificación, de lo contrario
quedará en estado 'Inadmitido',
automáticamente después de este tiempo,
además se notificará al técnico cada 3 días
(Valor parametrizable) transcurridos sin
subsanar o agregar nueva documentación.
Se anexará la evidencia de la notificación cada
vez que se pida subsanar.

- Inadmitido: Notifica al técnico de su

inadmisión y genera la resolución de rechazo y
se anexa al expediente del técnico, luego se
asigna al usuario con rol financiera para la
devolución del dinero. El técnico tendrá X días
(Valor parametrizable) para solicitar la
devolución de su dinero, de lo contrario el
CONTE legalizará el dinero y el flujo se
archivará
2 Evaluador Necesito calificar Con la finalidad de 1 Revisar calificación Cuando se ha consultado la Al revisar y corregir (de ser El sistema procederá a crear y anexar al
un expediente asignar las clases información del expediente y esta necesario) una repositorio el documento de resolución
que el técnico habilitado para calificar precalificación o ingresar una  firmado digitalmente con su consecutivo y
llevara en su calificación (cuando no tenga fecha, notifica a la asociación e inspector (si
matrícula precalificación) e ingresa los aplica) de la asignación de clases al técnico
datos faltantes o modifica lo (enviando la resolución) y envia al técnico un
que sea necesario mecanismo para aceptar o rechazar las clases
(Resolución, fecha, asignadas el cual tendrá una vigencia de 10
calificación anterior. días (Valor configurable). Si pasados estos días
Aplica sólo si es una no se ha respondido la notificación, el sistema
ampliación y la matrícula procederá a vencer los términos y aceptar las
profesional fue expedida en clases asignadas, por lo tanto creará y anexará
el anterior sistema. al repositorio el documento de matrícula
Si se realiza una adición o firmado digitalmente, asignar un registro al
modificación de la flujo de trabajo, suministrará los datos para
información debe quedar la impresión del carnet, generará la carta de
trazabilidad) envío junto con el código de activación de la
matrícula y asignará el flujo al rol
carnetización y notificará al rol entrega.

Notas:
- El sistema creará un documento con los
resultados del vencimiento de términos y lo
anexará al repositorio
- El registro cambiará semanalmente cada
martes (valor parametrizable)
2 Revisar calificación Cuando se ha asignado un recurso
recurso (de reposición o apelación) y ha
consultado la información del
recurso y del expediente
Una vez el rol evaluador ha
dado un concepto
(Aprobado o Negado)
El sistema procederá a notificar al técnico,
asociación e inspector (si aplica) la decisión del
evaluador, creará y anexará al repositorio: una
nueva resolución (con su consecutivo y fecha)
y la matrícula, ambos firmados digitalmente.
Asignará un registro al flujo de trabajo,
suministrará los datos para impresión del
carnet, generará la carta de envío junto con el
código de activación de la matrícula y asignará
el flujo al rol carnetización y notificará al rol
entrega
Notas:
- El sistema creará un documento con los
resultados ingresados por el evaluador y lo
anexará al repositorio
- El registro cambiará semanalmente cada
martes (valor parametrizable)
Desarrollo ágil: Historias de usuario y criterios de aceptación
Consejo Nacional de Técnicos Electricistas

Enunciado de la historia Criterios de aceptación

Identificador Característica / Número (#) de Criterio de aceptación
(ID) de la Rol Razón / Resultado Contexto Evento Resultado / Comportamiento esperado
Funcionalidad escenario (Título)
historia
1 Carnetización Necesito ver las Con la finalidad de 1 Registro de impresión Cuando se ha asignado la tarea y se ha Al seleccionar el o El sistema registrará de forma individual en
solicitudes expedir el carnet de finalizada finalizado la impresión de los carnets los trámites a los cada flujo la fecha en que se imprimió el
asignadas a los técnicos cuales se les ha carnet y asignará el flujo al rol de entrega
imprimir impreso el carnet
Desarrollo ágil: Historias de usuario y criterios de aceptación
Consejo Nacional de Técnicos Electricistas

Enunciado de la historia Criterios de aceptación

Identificador Característica / Número (#) de Criterio de aceptación
(ID) de la Rol Razón / Resultado Contexto Evento Resultado / Comportamiento esperado
Funcionalidad escenario (Título)
historia
1 Entrega Necesito enviar los Con la finalidad de 1 Registrar forma de Cuando se ha asignado la tarea y se ha Al seleccionar el o El sistema registrará de forma individual en
documentos al terminar el trámite entrega entregado la matrícula los trámites que cada flujo los datos correspondientes al
técnico electricista con el técnico tienen la misma método de entrega, además notificará al
información de solicitante del despacho de la matrícula y
entrega y activará la matrícula del técnico para consulta
seleccionando el vía web y trámite de vigencia luego de 30 días
tipo de entraga e si el técnico no ha ingresado el código de
ingresando la activación y no se ha registrado ninguna
fecha de entrega devolución
correspondientes
al método de
entrega

2 Registro de devolución Cuando se ha registrado el envío de una Al ingresar los El sistema asignará nuevamente al rol entrega
matrícula y esta no fue entregada datos de la el flujo, para asignar un nuevo método de
satisfactoriamente devolución entrega
Desarrollo ágil: Historias de usuario y criterios de aceptación
Consejo Nacional de Técnicos Electricistas

Enunciado de la historia Criterios de aceptación

Identificador Característica / Número (#) de Criterio de aceptación
(ID) de la Rol Razón / Resultado Contexto Evento Resultado / Comportamiento esperado
Funcionalidad escenario (Título)
historia
1 Tesorería Necesito ver un Con la finalidad de 1 Lista por actas Después de haberse asignado el acta y Al Asignar el acta y El sistema permitirá ver una lista de las
informe por actas pagar a las recibido una notificación resolución solicitudes para pagar a las asociaciones, con
asociaciones valores

2 Tesorería
Necesito devolver Con la finalidad de 1 Verificar respuesta Al recibir la respuesta del técnico y verificar El rol podrá elegir el El sistema responderá de la siguiente manera
el dinero de una terminar la solicitud devolución dinero los documentos anexados resultado de la dependiendo de la opción elegida:
solicitud de un técnico respuesta del técnico
electricista (Aceptar o Subsanar) - Aceptar: El flujo se asignará al usuario con el
rol profesional financiera
Si selecciona subsanar
debe marcar el(los) - Subsanar: Enviará un mecanismo al técnico
documento(s) a para subsanar los documentos necesarios
subsanar

2 Subir egreso de pago Cuando se ha recibido la aprobación del Al subir el documento El sistema subirá el documento al repositorio y
usuario con rol profesional financiera de egreso de pago archivará el flujo

3 Profesional Necesito poder Con la finalidad de 1 Verificar solicitud de Luego de que se ha asignado la tarea El rol podrá elegir el El sistema registrará el resultado elegido y se
Financiera verificar la autorizar la devolución resultado de la primera asignará el trámite al rol tesorería
documentación del devolución del verificación (Aceptar o
técnico dinero Subsanar)
Historias de usuario y criterios de aceptación: Instructivo
Elaborado por: www.pmoinformatica.com
Columna Instrucciones
Identificador (ID) de la historia Código que identifica unívocamente a la historia en el proyecto que se esté desarrollando. El formato
debe ser elegido por el equipo.
Rol Es el rol que está desempeñando el usuario cuando utiliza la funcionalidad que se está describiendo. Debe
ser lo más especifico posible, describiendo el rol o actor que se está desempeñando. El enunciado puede
escribirse como se sigue: Yo como un [Rol], desempeñando el rol de [Rol], como un [Rol], entre otros. Por
ejemplo:

Yo como cliente registrado.

Desempeñando el rol de cliente registrado.
Como un cliente registrado.

Característica / Funcionalidad Representa la función que el rol quiere o necesita hacer en el sistema que se está desarrollando. Puede
diferenciarse entre acciones obligatorias u opcionales, utilizando la palabra puede o necesita para
describir la acción. Por ejemplo:

Necesito realizar búsquedas de productos por categorías.

Puedo seleccionar una categoría para ver el número de productos que tiene asociado.

Razón / Resultado Lo que el rol necesita lograr al ejecutar la acción. Este es el resultado de ejecutar la acción desde el punto
de vista del rol. Este punto puede ser opcional, pues la historia puede documentarse sólo con la definición
del rol y la acción (sin definir la consecuencia).

Número (#) de escenario Número (ejemplo 1, 2, 3 ó 4), que identifica al escenario asociado a la historia.
Criterio de aceptación (título) Describe el contexto del escenario que define un comportamiento. Por ejemplo, si se toma el ejemplo de
búsquedas de productos por categoría, un posible ejemplo pudiera ser: Categoría sin productos
asociados.

Contexto Proporciona mayor descripción sobre las condiciones que desencadenan el escenario.
Evento Representa la acción que el usuario ejecuta, en el contexto definido para el escenario.
Resultado / Comportamiento Dado el contexto y la acción ejecutada por el usuario, la consecuencia es el comportamiento del sistema
esperado en esa situación.
Historias de usuario y criterios de aceptación: Ejemplo
Elaborado por: www.pmoinformatica.com
Enunciado de la historia Criterios de aceptación

Identificador (ID) Rol Característica / Razón / Resultado Número (#) de Criterio de Contexto Evento Resultado / Comportamiento
de la historia Funcionalidad escenario aceptación (Título) esperado

XX-XXXX-XXXX Como un Necesito ver un listado Con la finalidad 1 Categoría con al En caso que una Cuando se despliegue el A continuación del nombre de
cliente. de categorías de de realizar menos un producto. categoría tenga al listado de categorías a la categoría, se mostrará entre
productos y poder busquedas de menos un producto seleccionar. paréntesis el número de
seleccionar una productos por asociado. productos asociados.
categoría. categorías.
2 Categoría sin En caso que una Cuando se despliegue el A continuación del nombre de
productos. categoría no tenga listado de categorías a la categoría, se mostrará entre
productos asociados. seleccionar. paréntesis el siguiente texto
"Sin Productos asociados".

3 Ordenamiento de las N/A Cuando se despliegue el El sistema mostrará las

categorías listado de categorías a categorías en orden alfabetico.
seleccionar.
Desarrollo ágil: Historias de usuario y criterios de aceptación
Consejo Nacional de Técnicos Electricistas

Enunciado de la historia Criterios de aceptación

Identificador Característica / Número (#) de Criterio de aceptación
(ID) de la Rol Razón / Resultado Contexto Evento Resultado / Comportamiento esperado
Funcionalidad escenario (Título)
historia
1 Disciplinario Necesito sancionar con la finalidad de 1 Sancionar un técnico Luego de terminar un proceso disciplinario Al ingresar la cédula, El sistema verificara si el técnico cuenta con
un técnico suspender su a un técnico que cuente con matrícula fecha de inicio, fecha de matrícula profesional, de ser así procedera a
matrícula fin, duración sanción y crear el documento de suspención de
expediente disciplinario matrícula y remplazara la matrícula web por
este documento el tiempo de la sanción,
además , deshabilitara la posibilidad de
generar el certificado de vigencia desde la
página web.
En caso de no tener matrícula mostrara un
mensaje de error.