# Calidad del código

## Qué es

La calidad del código indica en qué medida el código fuente realiza el trabajo previsto y puede
entenderse, comprobarse y modificarse con seguridad. Veamos una función de facturación. Una
versión arroja el importe correcto para el pedido de demostración, porque ese pedido recorre justo
el camino que se tuvo en cuenta al escribirla. Otra identifica la moneda, expresa la regla de
redondeo en un solo sitio y distingue el cálculo de un abono del de una venta. Las dos pueden
superar la prueba habitual. Para averiguar por qué hay una diferencia en una factura, la segunda
ofrece un punto de partida mucho más claro.

La corrección comprende los casos límite, como los datos inválidos, un reintento o un trabajo que
queda a medias. La legibilidad se aprecia cuando otra persona entiende las decisiones relevantes
sin la ayuda del autor. La facilidad de cambio depende de cuánto se altera al incorporar un
requisito y de si se pueden comprobar los efectos. Una función breve puede calcular mal un
impuesto. Otra, más enrevesada, puede acertar hoy y hacer muy difícil verificar un cambio de
moneda mañana.

Una revisión de código permite evaluar esas propiedades en un cambio concreto. Un control de
calidad que condiciona la integración bloquea ciertos fallos detectables. La deuda técnica
describe el coste futuro de determinadas decisiones. La calidad del código es el estado del propio
código. El criterio de revisión de Google lleva esa distinción a la práctica al pedir que se
valore la salud del sistema en conjunto después de cada cambio.

## Por qué importa

La calidad se percibe sobre todo cuando llega un requisito nuevo. Imaginemos que una aplicación
genera presupuestos, emite facturas y tramita devoluciones. Si cada operación calcula por separado
el mismo descuento, la siguiente promoción obliga a localizar todas las copias. La discrepancia
puede aparecer por primera vez al devolver un pedido. En cambio, si la regla común vive en un
lugar conocido y cada operación le pasa sus datos de forma explícita, es más fácil acotar el
cambio y decidir dónde probarlo.

La evidencia útil depende del riesgo. Para el dinero, conviene elegir casos en los que redondear
cada línea y redondear al final produzcan resultados distintos. En una operación que se puede
reintentar, hay que comprobar si una segunda solicitud vuelve a efectuar el cargo. Si un cálculo
se ejecuta en todos los pedidos, sería razonable medir el tiempo de respuesta con la carga
esperada antes de añadir una caché. Cada observación informa una decisión concreta y tiene un
alcance limitado.

También hay un coste de coordinación. Las personas cambian de proyecto y quien revisa una
modificación puede no conocer la historia del módulo. Los nombres precisos, un ejemplo ejecutable
y una explicación breve de una restricción poco evidente permiten verificar el detalle importante
sin depender de la memoria del autor. Esa autonomía ayuda tanto al incorporar a otra persona como
al investigar una incidencia fuera del horario habitual.

## Cómo se aplica en la práctica

Supongamos que una empresa debe redondear el impuesto sobre el total agrupado por tipo impositivo.
En una factura de dos líneas, la cuota de cada una antes del redondeo asciende a 0,005 unidades
monetarias. Si se redondea cada cuota al céntimo más próximo, con los empates al alza, el total da
0,02. Si se suman primero y se redondea una vez, da 0,01. El ejemplo permite comprobar la cuenta a
mano. La regla de una factura real debe salir de los requisitos del producto y de la normativa
aplicable.

El contrato de la función puede indicar en qué unidad trabaja y en qué orden opera. Los importes
intermedios necesitan una representación que conserve la precisión requerida. Conviene que el
código muestre la agrupación y que el redondeo se aplique en el punto acordado. Una prueba con los
importes anteriores distingue las dos reglas. Otra puede mezclar tipos impositivos para evitar que
un cambio futuro reemplace los grupos por una suma global. Si los abonos siguen otra regla, hace
falta un ejemplo separado.

Al revisar el arreglo, seguimos el importe mostrado a la persona compradora, el que se exporta y
el que utiliza la operación de devolución. Las facturas anteriores deben conservar los importes
registrados al emitirse. Una prueba de todo el recorrido verifica que quien llama al cálculo le
pasa las unidades correctas, algo que una prueba aislada de la función no puede demostrar.

En nuestra [nota sobre vender la última entrada una sola
vez](/es/notes/selling-limited-stock-without-overselling/), el mismo enfoque se aplica al
inventario. La nota explicita la relación que deben cumplir las cantidades, propone pruebas con
solicitudes concurrentes y propone vigilar esa relación en funcionamiento. Su fórmula permite
comprobar qué debe conservarse al modificar cualquiera de las operaciones que afectan a las
existencias.

## Dónde surgen los problemas

Una señal medible puede confundirse con una garantía. La cobertura muestra qué líneas o ramas se
ejecutaron. La prueba seguirá pasando si el valor esperado representa la regla de redondeo
equivocada. Una métrica de complejidad ayuda a elegir qué código mirar, pero trocear una
comparación clara en varias funciones opacas puede dificultar el diagnóstico. Antes de imponer un
umbral, identifiquemos qué defecto real ayudaría a detectar y revisemos casos en ambos lados del
umbral.

También se puede invertir tiempo en una limpieza con poco efecto. Un nombre confuso en un informe
poco usado tiene un coste distinto del de una condición ambigua que se aplica a todos los cobros.
Resulta útil fijar qué riesgo se ha observado, qué correcciones son necesarias y qué mejoras
pueden esperar. Una preferencia de formato se puede resolver con una convención compartida y un
formateador.

Por último, reducir la duplicación puede ocultar diferencias legítimas. Quizá los descuentos de
una renovación y los de una promoción obedecen a políticas distintas, aunque ambos resten dinero.
Un método que adivina la política según valores poco relacionados oscurecería ambas operaciones.
Vale la pena compartir la parte estable que se entiende y separar las decisiones divergentes. La
mejora se aprecia en las pruebas y en la capacidad de otra persona para explicar la regla leyendo
el código.

## Lecturas adicionales

- [Criterio de Google para aprobar cambios de
  código](https://google.github.io/eng-practices/review/reviewer/standard.html)
- [Aspectos que Google comprueba en una
  revisión](https://google.github.io/eng-practices/review/reviewer/looking-for.html)
- [Pruebas unitarias en Software Engineering at
  Google](https://abseil.io/resources/swe-book/html/ch12.html)

<https://engineer.company/es/glossary/code-quality/>
