Ir al contenido
Entender

Averigüe qué posee realmente

Casi todos los propietarios heredan el software en lugar de diseñarlo. Antes de poder juzgar o cambiar nada, alguien tiene que escribir qué hay, con precisión, a partir del código y no de la memoria.

Qué hay en esta categoría

Acciones que producen una descripción de la realidad

Todas ellas inspeccionan sin modificar nada y se niegan a afirmar lo que no pueden señalar.

Reconocimiento de arquitectura

De qué está hecho el sistema, cómo fluyen las peticiones por él y dónde están las fronteras de verdad, y no dónde dijo un diagrama que estaban.

Inventario del sistema

Servicios, tareas, procesos programados, colas, llamadas externas y las cosas que están funcionando sin que nadie recuerde haberlas arrancado.

Generación de modelos C4

Vistas de contexto y de contenedores construidas a partir del código, con cada elemento trazable hasta el lugar del que salió.

Análisis de secuencias

Qué ocurre de principio a fin en los flujos que importan: alta, pago, el proceso nocturno al que todo el mundo teme.

Mapa de dependencias

Dependencias internas y externas, cuáles sostienen la estructura y qué fallo único deja el producto fuera de servicio.

Análisis de deuda técnica

Dónde se concentra el coste del cambio, con una estimación de lo que le está costando ahora en lugar de un sermón genérico.

Cómo se ejecuta una acción de reconocimiento

  1. Inspección de solo lectura

    No se modifica nada, no se refactoriza nada «ya que estamos». El procedimiento lo prohíbe expresamente, porque un reconocimiento que cambia el código deja de ser fiable.

  2. Inventario antes que opinión

    Los hechos se recogen y se escriben antes de formar ningún juicio, para que después se puedan contrastar las conclusiones con ellos.

  3. Una prueba para cada afirmación

    Un hallazgo sin archivo y línea se descarta. Ésta es la única regla que separa una auditoría real de un resumen seguro de sí mismo.

  4. Un resultado comparable la próxima vez

    El resultado tiene una forma fija, así que ejecutar la misma acción dentro de seis meses le dice qué ha cambiado.

Cuándo empezar por aquí

Empiece por otro sitio si

Ya tiene documentación actual y fiable

Sabe exactamente qué componente es el problema

Necesita una decisión hoy, no una descripción

El sistema tiene dos semanas y lo escribió usted entero

Empiece por aquí si

Heredó el sistema de alguien que se fue

Distintas personas describen la arquitectura de forma distinta

Va a contratar, sustituir o dar instrucciones a un desarrollador

Le proponen una reescritura y no puede juzgarla

Elija la categoría que corresponde a su preocupación

Describa la situación con sus palabras y vea el procedimiento —y su coste— antes de gastar nada.