Qué debe entregar un desarrollador de software a medida: código, documentación y accesos

Escena editorial sobre Entrega de un programa personalizado: documentación, código y accesos que debe recibir la empresa

Tabla de contenidos

Imagina que el viernes te entregan la aplicación de pedidos que llevas meses esperando. Entras, haces un pedido de prueba y todo funciona. El lunes, alguien de tu equipo pregunta cómo se despliega una corrección y descubre que el servidor, el repositorio y el correo de alertas están bajo cuentas que no controla la empresa. Has recibido una aplicación que puedes usar. Todavía no está claro si podrías mantenerla.

Yo no esperaría a que llegue ese lunes para hablar de la entrega. Antes de contratar, pondría sobre la mesa qué pasa cuando hay que actualizar una dependencia, recuperar una copia o incorporar a otro equipo. No porque quieras cambiar de proveedor, sino porque una entrega buena te permite seguir trabajando si cambian las personas o las circunstancias.

Usar la aplicación, tener el código y poder modificarlo son tres cosas distintas

La aplicación instalada es lo que usa el equipo. El repositorio es lo que permite entender cómo se construyó y, si está completo, generar otra versión. Los derechos que te permiten usar, modificar o encargar el mantenimiento son otra cuestión. Pagar el proyecto y recibir un ZIP no resuelve automáticamente las tres.

Si el negocio necesita que otro proveedor pueda mantener la aplicación, lo pondría por escrito: qué código y documentación se entregan, qué versiones quedan incluidas y qué licencia o cesión permite ese trabajo. La Ley de Propiedad Intelectual española distingue la titularidad y los derechos de explotación de los programas. No daría por hecho que el contrato transmite todo lo que hay en el repositorio. Puede haber librerías de código abierto, plantillas, componentes reutilizables del desarrollador y servicios externos con condiciones distintas. Para decidir sobre un contrato concreto, revisaría esos términos con asesoramiento jurídico.

Lo que pediría a alguien que no estuvo en el proyecto

Volvamos a la aplicación de pedidos. Le pediría a una persona que no participó en el desarrollo que parta de la versión acordada del repositorio, prepare un entorno de pruebas y despliegue una copia siguiendo la documentación. Si durante la prueba hace falta llamar al desarrollador para averiguar qué migración de base de datos ejecutar o cómo activar el envío de correos, ya sabes qué falta por documentar. Si el contrato incluye el código, prefiero un repositorio accesible por la empresa con versiones identificadas, no una carpeta que no sabes si coincide con lo que está en producción.

El material técnico debería explicar requisitos, compilación, pruebas, despliegue y recuperación. Incluiría los scripts, migraciones y ejemplos de configuración que sean necesarios, pero no secretos reales. También dejaría claro qué integraciones hay, qué datos intercambian y cómo saber si una dejó de funcionar. Un esquema sencillo y la ubicación de las alertas pueden ser más útiles que un manual largo que no se ha probado nunca.

Al equipo de negocio le pediría otra comprobación: que pueda registrar un pedido, resolver una excepción habitual y saber qué funcionalidades quedaron fuera. Esa documentación tiene que explicar los roles, las reglas que no son obvias y las limitaciones conocidas. Para un sistema con muchas dependencias pediría también un inventario de componentes y licencias; una SBOM puede ayudar a localizar qué productos usan una librería cuando hay que actualizarla. Para una app pequeña quizá baste con un inventario mantenido y unas instrucciones reproducibles.

Las cuentas importantes no deberían aparecer en el último correo

Si el dominio, la nube o las cuentas de publicación pueden estar a nombre de la empresa desde el inicio, lo haría así. El proveedor puede tener su acceso de soporte sin ser la única persona capaz de renovar un certificado o restaurar una copia. Haría un inventario con quién controla el repositorio, la infraestructura, el DNS, las bases de datos, las copias, los servicios conectados y los avisos. Lo que no aplique, fuera; lo que sí, con un responsable que pueda entrar de verdad.

Para una transición, daría de alta cuentas nominativas, probaría los permisos y movería las credenciales por los mecanismos de cada plataforma. No enviaría una hoja con contraseñas ni copiaría tokens al repositorio. Los secretos compartidos que dejen de estar justificados se rotan de forma coordinada y se comprueba que las integraciones siguen funcionando. Si se mantiene un acceso del proveedor para soporte, lo dejaría limitado y con un responsable que pueda revisarlo o retirarlo.

Si el proveedor trata datos personales por cuenta de la empresa, también hay que acordar qué pasa con ellos al acabar. El artículo 28 del RGPD contempla su devolución o supresión según la elección del responsable, salvo las obligaciones legales de conservación. Conviene revisar el encargo y el tratamiento concreto, incluidas las copias y quién presta los servicios implicados. El cierre de accesos no sustituye ese acuerdo.

La entrega termina cuando puedes demostrar qué has recibido

Antes de aceptar el proyecto, anotaría qué versión está entregada, en qué entorno funciona, qué activos se han transferido y qué queda pendiente. Para una herramienta interna de bajo impacto puede bastar con probar el acceso y el procedimiento de despliegue. Si el sistema sostiene la facturación o el almacén, querría probar una restauración controlada y hacer al menos una sesión de traspaso en la que el equipo receptor ejecute las tareas, no solo vea una presentación.

Separaría también los defectos que quedan por corregir, el mantenimiento contratado y las nuevas mejoras. Si no se distinguen, la primera petición después de la entrega empieza con una discusión sobre qué se había incluido. Esto conviene hablarlo cuando comparas presupuestos de software a medida, no después de firmar la aceptación.

Para mí, la prueba es aquel lunes: ¿puede el equipo encontrar la versión correcta, ponerla en un entorno de pruebas y saber a quién llamar si falla? Si la respuesta depende de encontrar a una sola persona, todavía queda una parte de la entrega por hacer.

Preguntas frecuentes

¿Siempre tienen que entregarme el código fuente?

No necesariamente. Depende de la titularidad, las licencias y lo pactado. Si lo necesitas para mantener el producto, concreta el acceso al repositorio, las versiones y los derechos desde el principio.

¿Pagar el proyecto me convierte en propietario de todo el software?

No por sí solo. Revisa qué se cede o licencia y separa el código específico, la documentación y los componentes o servicios de terceros.

¿Qué accesos debería controlar la empresa?

Los que sean esenciales para operar y recuperar su sistema: repositorio, infraestructura, dominio, cuentas de publicación, copias, alertas y servicios externos, según la arquitectura.

¿Es buena idea recibir las claves por correo?

No. Prioriza cuentas nominativas y los mecanismos seguros de cada plataforma. Coordina la rotación cuando cambie el acceso y verifica que las integraciones no se interrumpen.

¿Qué diferencia hay entre código, documentación y derechos?

El código permite construir y revisar el sistema; la documentación explica cómo usarlo y mantenerlo; los derechos determinan qué puedes hacer legalmente con esos materiales.

¿Qué ocurre con los datos personales al acabar la relación?

Revisa el encargo de tratamiento y cómo se hará la devolución o supresión que corresponda, con el tratamiento de copias y las posibles obligaciones legales de conservación.

¿Hace falta una SBOM en cualquier proyecto?

No. Un inventario formal de componentes aporta más cuando hay muchas dependencias, riesgo o varios equipos de mantenimiento. En un proyecto sencillo puede bastar un inventario bien documentado.

¿Con el código ya puede mantener la aplicación otro proveedor?

No necesariamente. Necesita dependencias, accesos autorizados, documentación operativa, pruebas y los derechos necesarios. La mejor comprobación es que pueda desplegar una versión en un entorno de pruebas.

¿Vas a recibir una aplicación y no sabes si podrás mantenerla después?

En Soulvi podemos revisar contigo qué código, accesos y documentación están incluidos, y qué prueba de entrega te ayudaría a comprobarlo antes de dar el proyecto por cerrado.

Revisar mi entrega de software

Comparte esta entrada en:
Entradas Relacionadas
WhatsApp
Soulvi
Resumen de privacidad

Esta web utiliza cookies para que podamos ofrecerte la mejor experiencia de usuario posible. La información de las cookies se almacena en tu navegador y realiza funciones tales como reconocerte cuando vuelves a nuestra web o ayudar a nuestro equipo a comprender qué secciones de la web encuentras más interesantes y útiles.