¿Qué es la documentación de control de calidad y cómo podemos reducir sus costos de creación y mantenimiento?

Andrii Hilov, líder del equipo de control de calidad de ITRex, ha escrito otro artículo sobre los desafíos y las dificultades de la garantía de calidad en los proyectos de software. Esta vez, Andrii profundiza en la documentación de control de calidad y el papel que desempeña en el desarrollo de software de alto rendimiento, a tiempo, dentro del presupuesto y en línea con sus objetivos comerciales.

Esto es lo que tiene que decir al respecto.

Como líder del equipo de control de calidad en una empresa de desarrollo de software empresarial ITRex, soy perfectamente consciente de las aspiraciones de nuestro cliente de reducir los costos de desarrollo de software mientras lanza un producto completamente funcional a tiempo y con el máximo valor.

Si bien estos objetivos son comprensibles, no aconsejo despedir a su equipo de control de calidad al principio del proyecto, incluso si no encuentran errores a diario, aunque esto puede parecer una opción fácil para reducir el sueldo y acelerar los ciclos de lanzamiento de software.

Además, le recomiendo que siga las mejores prácticas de garantía de calidad a lo largo del proyecto para validar que su solución y todas sus características funcionen como se espera y no comprometan su seguridad cibernética.

Y una de esas prácticas es crear y mantener una documentación de control de calidad adecuada.

¿Qué es exactamente la documentación de control de calidad? ¿Cómo puede ayudarlo a aprovechar al máximo los servicios de prueba y control de calidad? ¿Y hay alguna forma de optimizar los costos y el esfuerzo asociados con la preparación de la documentación de control de calidad y al mismo tiempo minimizar el riesgo de desarrollar una aplicación mal diseñada y llena de errores y tener que reconstruir todo desde cero?

¡Vamos a averiguar!

Introducción a la documentación de control de calidad

La documentación de control de calidad es una colección de documentos y artefactos creados y mantenidos por un equipo de control de calidad durante el proceso de desarrollo y prueba del software.

Puede incluir varios documentos que describen la estrategia de prueba, los planes de prueba, los casos de prueba, los scripts de prueba, los datos de prueba, los registros de prueba, los informes de errores y cualquier otra documentación relacionada con las actividades de control de calidad. Estos documentos facilitan la comunicación entre los miembros del equipo de control de calidad, brindan pautas para las pruebas y ayudan a identificar y resolver problemas de manera eficiente.

Por lo tanto, la documentación de control de calidad juega un papel vital para garantizar la calidad y la confiabilidad de los productos de software, y ese es el principal objetivo que persiguen nuestros clientes.

Qué documentos de control de calidad se utilizan en proyectos de software

Para el propósito de este artículo, le daremos una breve descripción de los documentos de garantía de calidad que forman la columna vertebral de la documentación de prueba en un proyecto de desarrollo de software:

• Un plan de prueba es un documento de control de calidad que describe el enfoque general, los objetivos, el alcance, los recursos y el cronograma de las actividades de prueba de software. En pocas palabras, cubre:

1. El nombre y la descripción de un proyecto, incluidos los tipos de aplicaciones que se están probando y su funcionalidad principal
2. Los métodos de prueba preferidos (manual, automatizado, mixto) y los tipos de prueba (nuevas funciones, integraciones, compatibilidad, regresión, etc.)
3. Las características que deben probarse, junto con un cronograma aproximado para cada actividad de prueba
4. Composición óptima del equipo
5. Una descripción general de los riesgos y problemas que pueden surgir durante el proceso de prueba
6. Una lista de documentos de prueba que su equipo de control de calidad utilizará durante el proyecto

Una regla general es escribir un plan de prueba al comienzo de un proyecto de software cuando su equipo de TI define los requisitos funcionales y no funcionales para una solución de software, elige una pila de tecnología adecuada y una metodología de gestión de proyectos, y crea una hoja de ruta del proyecto.

Normalmente se tarda hasta tres días en configurar y revisar un plan de prueba simple sin casos de prueba.

• Los casos de prueba describen escenarios de prueba específicos, incluidos los datos de entrada, los resultados esperados y los pasos a ejecutar. Los casos de prueba están diseñados para verificar la funcionalidad, el rendimiento u otros aspectos de un producto de software. Tenga en cuenta que los casos de prueba son utilizados tanto por los servicios de pruebas manuales como por los equipos de servicios de automatización de control de calidad. De esta manera, garantizará la máxima cobertura de prueba, lo que significa que no se manifestarán errores en el código de producción.

Aunque un ingeniero de control de calidad capacitado podría escribir un caso de prueba de alto nivel en solo diez minutos, la cantidad de casos de prueba para un proyecto de tamaño mediano podría superar fácilmente los 4000 (y contando). Multiplique ese número por la tarifa media por hora del ingeniero de control de calidad medio ($65 por hora hombre para el mercado norteamericano), y obtendrá una cifra impresionante.

• Las listas de verificación son listas concisas y detalladas de acciones o tareas que deben completarse o verificarse durante el proceso de prueba. Por lo tanto, una lista de verificación en la documentación de control de calidad generalmente incluye un resumen completo de módulos funcionales, secciones, páginas y otros elementos de una aplicación o sistema ciberfísico que requieren la atención de un equipo de control de calidad.

En proyectos más pequeños, las listas de verificación pueden reemplazar con éxito los casos de prueba detallados (más sobre esto más adelante).

• Los scripts de prueba son fragmentos de código escritos con herramientas o marcos de prueba específicos, como Selenium, Appium y Cucumber. Estos scripts automatizan la ejecución de casos de prueba, lo que hace que el proceso de prueba sea más eficiente, específicamente, en proyectos de software grandes y complejos, como sistemas SaaS multiusuario y aplicaciones B2C populares, que se actualizan con frecuencia y donde incluso los errores más pequeños pueden afectar negativamente la experiencia del usuario. .
• Los datos de prueba son los datos utilizados por los ingenieros de control de calidad para evaluar el rendimiento, la funcionalidad, la confiabilidad y la seguridad de una solución de software en diversas condiciones. Puede incluir valores de entrada de muestra, condiciones de contorno y varios escenarios. Por ejemplo, su equipo de control de calidad puede usar datos de prueba positivos y negativos para validar que solo se pueden usar las credenciales de inicio de sesión correctas para ingresar a un sistema de software. De manera similar, los datos de prueba se pueden usar para implementar restricciones de edad en ciertos tipos de aplicaciones o investigar cómo una aplicación maneja cargas de trabajo aumentadas.
• Los registros de prueba documentan el proceso de ejecución de la prueba, incluida la fecha y la hora de la ejecución de la prueba, el resumen de los casos de prueba ejecutados, los resultados que logró su equipo de control de calidad, capturas de pantalla y cualquier problema u observación observado durante la prueba. Un registro de prueba es una fuente vital de información para rastrear el progreso de la prueba, identificar patrones o tendencias en los resultados de la prueba y proporcionar un registro histórico de las actividades de prueba. Ayuda a identificar y resolver problemas de manera eficiente y sirve como referencia para futuras pruebas o auditorías.
• Los informes de defectos o errores son documentos de prueba que detallan los defectos y problemas encontrados durante las actividades de control de calidad. En concreto, describen los errores detectados, su gravedad y prioridad, y las condiciones en las que se producen los defectos. Un gerente de control de calidad utiliza informes de errores para asignar tareas a especialistas en pruebas de software y realizar un seguimiento de su estado.
• Una matriz de trazabilidad mapea la relación entre los casos de prueba y los requisitos u otros artefactos. Ayuda a garantizar que los casos de prueba cubran adecuadamente todos los requisitos, permite realizar un seguimiento de la cobertura de la prueba en todo el proyecto y elimina las actividades de prueba redundantes.
• Un informe de finalización de prueba resume las actividades de prueba realizadas en un proyecto, incluido el estado de ejecución de la prueba, la cantidad de casos de prueba ejecutados, los defectos encontrados y cualquier tarea pendiente.

¿Por qué es importante la documentación de control de calidad?

Tener documentación de control de calidad ayuda a lograr los resultados exactos que esperan el cliente y el equipo de ingeniería de software.

Esto se logra mediante una combinación de factores, incluidos los siguientes:

1. La documentación de control de calidad proporciona instrucciones y pautas claras que los especialistas en pruebas de software pueden seguir para realizar tareas de manera consistente, reduciendo las variaciones y mejorando la calidad general de los productos o servicios.
2. La documentación de control de calidad reduce la probabilidad de detectar defectos y errores críticos en las soluciones de software al final del proceso de desarrollo, por lo que desempeña un papel fundamental en el control del presupuesto. Los expertos en control de calidad sugieren que el costo de corregir errores aumenta exponencialmente con cada etapa del proyecto, desde 3X para la fase de diseño/arquitectura hasta 30X y más para la fase de implementación.
3. La documentación de control de calidad ayuda a garantizar el cumplimiento de los requisitos y estándares reglamentarios que su organización debe cumplir al simplificar las auditorías y proporcionar evidencia de los procesos, procedimientos y controles de calidad establecidos.
4. Al documentar procedimientos, controles y procesos de evaluación de riesgos, la documentación de pruebas de software ayuda a las organizaciones a identificar riesgos potenciales y tomar medidas preventivas para minimizar su impacto en el negocio y la satisfacción del cliente.
5. Los nuevos empleados pueden consultar su documentación de control de calidad para comprender los procesos y procedimientos de calidad en un proyecto de software, lo que reduce la curva de aprendizaje y garantiza una capacitación constante en toda la organización.
6. Al documentar las no conformidades, las acciones correctivas y las lecciones aprendidas, las empresas pueden identificar áreas de mejora e implementar cambios para mejorar la eficiencia y la calidad.
7. Tener procesos y procedimientos de control de calidad bien documentados puede mejorar la confianza del cliente en los productos o servicios de su empresa. La extensa documentación de pruebas de software demuestra un compromiso con la calidad y asegura que la organización cuente con sistemas sólidos para brindar resultados consistentes y confiables.
8. En situaciones en las que surgen disputas legales o retiros de productos, la documentación de control de calidad puede servir como evidencia importante. Puede demostrar que su organización ha seguido los procesos de calidad establecidos, ha tomado las precauciones necesarias y ha cumplido con sus obligaciones.

¿Cuánto tiempo se tarda en crear la documentación de control de calidad?

Una respuesta honesta a esta pregunta será: "Depende".

Específicamente, el plazo y los costos asociados dependen de varios factores, como el tamaño de su organización y la complejidad de sus procesos, la industria en la que se encuentra y el tipo de software que está creando.

Si se ha embarcado anteriormente en proyectos de desarrollo de software y tiene un equipo de control de calidad interno, es posible que pueda reutilizar la documentación de control de calidad existente para nuevos proyectos. También es útil usar plantillas y herramientas especializadas para crear y mantener la documentación de prueba de software, como la gestión de proyectos y el software wiki.

¿Siempre necesita documentación de control de calidad y es posible reducir sus costos de creación y mantenimiento?

Por muy útil que sea, la documentación de control de calidad puede aumentar los costos del proyecto de software debido al esfuerzo y al personal adicionales necesarios para su creación y mantenimiento.

Esto podría ser un problema para las nuevas empresas que operan con muy poco dinero o para las empresas que están experimentando una transformación digital en tiempos de recesión.

¿Todo tipo de proyecto de software necesita entonces una documentación de control de calidad súper detallada? ¿Es posible reducir los costos asociados con ella?

Para determinar el mejor enfoque para la creación de documentos de control de calidad, tenga en cuenta los siguientes factores:

• Tamaño y presupuesto del proyecto . En el caso de proyectos de bajo presupuesto y corto plazo (a menos que hablemos de proyectos altamente innovadores y técnicos ejecutados por grandes equipos de TI), no hay necesidad de complicar demasiado el proceso de documentación, por lo que su equipo de control de calidad puede optar por listas de verificación en lugar de detallados. Casos de prueba. En cuanto al documento del plan de pruebas, que determina la estrategia general de pruebas, también podemos prescindir de su redacción en los casos en los que no haya presupuesto para ello o si el proyecto es a corto plazo y no involucra tecnologías de punta.
• Tamaño y experiencia del equipo de control de calidad . Cuantos más ingenieros de control de calidad en el proyecto y menos experiencia tengan en control de calidad, más difícil será controlar el proceso de prueba. Por lo tanto, necesita una extensa documentación de control de calidad para mantener a los miembros del equipo en sintonía. En tales casos, es recomendable inclinarse hacia los casos de prueba en lugar de las listas de verificación para distribuir de manera más efectiva las tareas entre los ingenieros en función de su experiencia y conocimiento, e involucrar a especialistas en control de calidad más experimentados, que normalmente tienen tarifas por hora más altas, en la creación de casos de prueba.
• Enfoque Agile vs. Waterfall para la gestión de proyectos . Si bien el equipo de ITRex ha resumido las diferencias clave entre las metodologías Agile y Waterfall en esta publicación de blog, vale la pena mencionar qué diferencia a los dos enfoques en términos de garantía de calidad. En Waterfall, las pruebas de software se guardan para el final, lo que significa que su equipo de control de calidad realizará las pruebas solo cuando la parte de codificación esté completa al 100 %. Por razones obvias, no pueden hacerlo sin la documentación de garantía de calidad adecuada, que debe prepararse durante la fase de obtención de requisitos. En Agile, donde los equipos de TI tienden a crear piezas de software más pequeñas de manera iterativa y prueban el código al final de cada ciclo, no se prefiere una documentación de control de calidad completa y creativa de antemano. Aún así, le recomiendo que escriba un plan de prueba para alinear mejor la situación actual con las expectativas del cliente y de los ingenieros de software.

En general, tener documentación de control de calidad podría beneficiar a cualquier proyecto de desarrollo de software, sin importar la complejidad y el tamaño.

Sin embargo, como empresa orientada al cliente, siempre estamos listos para sugerir soluciones alternativas teniendo en cuenta sus objetivos y presupuesto.

Si no está seguro de si necesita preparar una extensa documentación de control de calidad para su proyecto y busca ingenieros de control de calidad calificados a quienes confiar la tarea, ¡póngase en contacto con ITRex! ¡Nos aseguraremos de que lance una solución de software libre de errores y de alto rendimiento a tiempo, dentro del presupuesto y de acuerdo con las especificaciones!

Publicado originalmente en https://itrexgroup.com el 30 de junio de 2023.