Recepción de un proyecto informático: cómo documentar defectos y observaciones
Qué comprobar antes de firmar el acta y qué materiales son útiles para el perito.
Qué materiales se necesitan
- contrato, especificaciones técnicas generales y particulares, anexos y actas;
- correspondencia entre las partes y observaciones sobre la recepción;
- registros, exportaciones, capturas de pantalla, enlaces y documentación técnica;
- preguntas formuladas para el especialista o el tribunal.
Qué se evalúa
Se evalúan el estado real del resultado, su conformidad con los requisitos técnicos, la existencia de defectos, las causas de los fallos, el volumen de trabajo realizado y la relación de las circunstancias detectadas con los documentos de la controversia.
Por qué debe comprobarse antes de firmar el acta
Después de firmar el acta, al cliente le resulta más difícil invocar deficiencias evidentes. La recepción técnica permite comprobar con antelación los escenarios principales, la integridad de la documentación y la entrega de los accesos necesarios.
Qué incluir en el programa de comprobación
- las funciones expresamente previstas en las especificaciones técnicas;
- los escenarios de carga y los escenarios de usuario críticos;
- el intercambio de datos con sistemas externos;
- las copias de seguridad y la restauración;
- el código fuente, las instrucciones, los accesos y la documentación.
Cómo se documentan las observaciones
Conviene describir cada defecto con los pasos para reproducirlo, el resultado esperado y el real, la fecha, la versión del sistema y los materiales que lo acrediten.
Resultado del acompañamiento
El cliente recibe una lista estructurada de observaciones, una evaluación de la conformidad con los requisitos y una base técnica para tomar una decisión fundamentada sobre la recepción.
Cómo se trabaja con el especialista
Primero se estudian de forma preliminar la tarea y los materiales disponibles. Después se acuerdan el objeto del estudio, las preguntas técnicamente adecuadas, los accesos necesarios y el formato del resultado. Si los datos iniciales son insuficientes, el especialista indica de antemano qué archivos, documentos o exportaciones adicionales deben conservarse.
El informe final separa la información aportada, las actuaciones realizadas, los indicios establecidos, las limitaciones y las conclusiones. Esta organización permite comprobar la lógica del estudio y utilizar el documento en una reclamación, en negociaciones o en un procedimiento judicial.
Cuándo conviene consultar con antelación
Cuanto antes se conserven los datos originales, menor será el riesgo de que se pierdan o modifiquen. Antes de reinstalar un sistema, actualizar un programa, borrar registros o entregar un dispositivo para su reparación, conviene acordar cómo documentar los materiales.
Haga que el defecto sea reproducible en las condiciones acordadas
En cada observación indique la versión, el entorno, el rol del usuario, los datos iniciales, la secuencia de acciones y el resultado esperado y real. La indicación «no funciona» no permite comprobar el alcance del problema. Una prueba en otra versión de la aplicación puede corresponder a un estado diferente del proyecto.
Vincule la observación con un requisito
Indique el apartado de las especificaciones acordadas, el cambio u otro documento del que se desprenda el comportamiento esperado. Si el contenido del requisito es objeto de controversia, debe indicarse; la comprobación técnica no puede elegir de forma implícita una de las versiones contractuales.
- Conserve los registros y las grabaciones originales, además de los mensajes recortados.
- Documente las correcciones, las comprobaciones posteriores y el contenido de la entrega.
- No incluya secretos vigentes en la descripción pública de un error.
- Distinga entre un defecto, una petición y una hipótesis que no puede comprobarse.
Antes de actualizar o reconfigurar conviene conservar el estado pertinente. Esto ayuda a estudiar la versión controvertida y evita atribuir a lo entregado anteriormente los resultados de la comprobación de un producto corregido.
Sobre el tema: Registros y copias de seguridad: qué conservar antes de modificar un sistema informático.
Haga que el defecto sea reproducible en las condiciones acordadas
En cada observación indique la versión, el entorno, el rol del usuario, los datos iniciales, la secuencia de acciones y el resultado esperado y real. La indicación «no funciona» no permite comprobar el alcance del problema. Una prueba en otra versión de la aplicación puede corresponder a un estado diferente del proyecto.
Vincule la observación con un requisito
Indique el apartado de las especificaciones acordadas, el cambio u otro documento del que se desprenda el comportamiento esperado. Si el contenido del requisito es objeto de controversia, debe indicarse; la comprobación técnica no puede elegir de forma implícita una de las versiones contractuales.
- Conserve los registros y las grabaciones originales, además de los mensajes recortados.
- Documente las correcciones, las comprobaciones posteriores y el contenido de la entrega.
- No incluya secretos vigentes en la descripción pública de un error.
- Distinga entre un defecto, una petición y una hipótesis que no puede comprobarse.
Antes de actualizar o reconfigurar conviene conservar el estado pertinente. Esto ayuda a estudiar la versión controvertida y evita atribuir a lo entregado anteriormente los resultados de la comprobación de un producto corregido.
Sobre el tema: Registros y copias de seguridad: qué conservar antes de modificar un sistema informático.
Cuéntenos
en qué consiste su caso.
Describa la situación y adjunte los materiales. Tras estudiar la solicitud, acordaremos el formato del estudio, las preguntas, los plazos y el precio.