Los cortes IRIS también pasan a data/ajustes_clinicos.json

Cierra lo que quedaba de §4.6 en el motor: `CORTES_IRIS_CREAT`, `CORTES_IRIS_SDMA`
y `CORTES_IRIS_UPC` eran las últimas reglas clínicas incrustadas en el código.

No había duplicación que eliminar —el estadiaje es sólo del cliente, no hay
contraparte en Python— así que el motivo aquí es únicamente el que dio origen a
todo esto: son decisiones clínicas que un veterinario debería poder revisar y
ajustar sin desarrollador ni build. Los cortes de la guía IRIS se revisan
periódicamente (la tabla vigente es la modificada en 2026); tenerlos en
TypeScript convertía una actualización de guía en un cambio de código.

Viaja con ellos su procedencia (guía IRIS 2026 / Fundamentals 3.a ed., p. 573,
Tabla 8.4) y, en `_limitacion`, la nota de por qué el motor sólo estadia cuando
creatinina o SDMA salen de rango: la guía estadia pacientes YA diagnosticados de
ERC sobre muestras seriadas, y aquí sólo hay una analítica suelta.

Los 5 tests dorados del bloque IRIS —estadiaje por creatinina, escalada por SDMA
discrepante, subestadiaje de proteinuria por especie y gravedad por estadio en vez
de por ancho de rango— pasan sin cambiar expectativas: la extracción no alteró
nada. Se añade el test que muta los cortes y exige que el estadio cambie.

Co-Authored-By: Claude Opus 5 <noreply@anthropic.com>

data/ajustes_clinicos.json

@@ -1,107 +1,288 @@
 {
   "_acerca_de": "Reglas clínicas del suelo de seguridad: umbrales de gravedad, categorías de edad y factores de ajuste por edad y raza. ÚNICA FUENTE DE VERDAD: la leen el motor del navegador (frontend/src/analisis.ts) y el del servidor (backend/app/motor/gravedad.py). Antes estaban duplicadas como constantes en ambos, que es lo que de verdad se desincroniza: la lógica de comparar no cambia casi nunca, los umbrales sí. Editar aquí cambia los dos motores a la vez, sin recompilar nada. backend/tests/test_paridad_motor.py compara ambos motores y avisa si un cambio los separa.",
   "_convenciones": "Los factores son MULTIPLICADORES sobre los límites del rango de referencia de data/valores_referencia.json (1.0 = sin cambio); si sólo se declara 'superior', el inferior queda intacto. En los cortes de gravedad, 'moderado_hasta': null significa que ese analito NUNCA llega a 'grave' (no hay corte superior).",
-
   "umbrales_gravedad": {
     "_fuente": "La desviación se mide en múltiplos del ancho del rango de referencia. Ej: rango WBC 6-17 (ancho 11), WBC 28 → 11/11 = 1.0 → moderado.",
     "leve": 0.5,
     "moderado": 1.5
   },
-
   "limites_edad_meses": {
     "_fuente": "Cortes de las categorías que seleccionan los ajustes de edad. Un valor por debajo del límite cae en esa categoría; por encima del último, en la siguiente.",
-    "canino": { "cachorro": 12, "adulto": 84, "senior": 120 },
-    "felino": { "cachorro": 12, "adulto": 120 }
+    "canino": {
+      "cachorro": 12,
+      "adulto": 84,
+      "senior": 120
+    },
+    "felino": {
+      "cachorro": 12,
+      "adulto": 120
+    }
   },
-
   "cortes_gravedad_bajo": {
     "_fuente": "Cortes clínicos explícitos del lado BAJO, en la unidad del analito. La regla genérica de anchos de rango no sabe expresar estos dos: con rango 24-45 un gato necesitaría un hematocrito NEGATIVO para llegar a 'grave', y con 200-500 unas plaquetas de -250. Es decir, ni una anemia felina ni una trombocitopenia disparaban nunca el suelo de derivación. PCV <= 20% es umbral de transfusión en perro y gato, y <= 12% (Hgb < 4 g/dL) potencialmente mortal (Thrall 3.a ed., p. 240); PCV 13 en gato se describe como 'markedly anemic' y 24 como 'mildly anemic' (p. 800-801). El riesgo hemorrágico por trombocitopenia aparece por debajo de 30x10^3/uL (Fundamentals 3.a ed., p. 310). Los cortes interiores del gato (14, 20) siguen la gradación de uso común.",
     "hct": {
-      "canino": { "leve_hasta": 30, "moderado_hasta": 20 },
-      "felino": { "leve_hasta": 20, "moderado_hasta": 14 }
+      "canino": {
+        "leve_hasta": 30,
+        "moderado_hasta": 20
+      },
+      "felino": {
+        "leve_hasta": 20,
+        "moderado_hasta": 14
+      }
     },
     "plt": {
-      "canino": { "leve_hasta": 100, "moderado_hasta": 30 },
-      "felino": { "leve_hasta": 100, "moderado_hasta": 30 }
+      "canino": {
+        "leve_hasta": 100,
+        "moderado_hasta": 30
+      },
+      "felino": {
+        "leve_hasta": 100,
+        "moderado_hasta": 30
+      }
     }
   },
-
   "cortes_gravedad_alto": {
     "_fuente": "Cortes explícitos del lado ALTO. Los renales salen del estadiaje IRIS de ERC (guía modificada en 2026; misma tabla en Fundamentals 3.a ed., p. 573, Tabla 8.4), mapeando los cuatro estadios sobre las tres gravedades del motor: estadio 2 → leve, 3 → moderado, 4 → grave. El estadio 1 queda dentro del rango de referencia y no genera hallazgo.",
     "creat": {
-      "canino": { "leve_hasta": 2.8, "moderado_hasta": 5.0 },
-      "felino": { "leve_hasta": 2.8, "moderado_hasta": 5.0 }
+      "canino": {
+        "leve_hasta": 2.8,
+        "moderado_hasta": 5.0
+      },
+      "felino": {
+        "leve_hasta": 2.8,
+        "moderado_hasta": 5.0
+      }
     },
     "sdma": {
-      "canino": { "leve_hasta": 35, "moderado_hasta": 54 },
-      "felino": { "leve_hasta": 25, "moderado_hasta": 38 }
+      "canino": {
+        "leve_hasta": 35,
+        "moderado_hasta": 54
+      },
+      "felino": {
+        "leve_hasta": 25,
+        "moderado_hasta": 38
+      }
     },
     "upc": {
       "_fuente": "La proteinuria IRIS no se subestadia más allá de 'proteinúrico': nunca llega a grave.",
-      "canino": { "leve_hasta": 0.5, "moderado_hasta": null },
-      "felino": { "leve_hasta": 0.4, "moderado_hasta": null }
+      "canino": {
+        "leve_hasta": 0.5,
+        "moderado_hasta": null
+      },
+      "felino": {
+        "leve_hasta": 0.4,
+        "moderado_hasta": null
+      }
     }
   },
-
   "ajustes_edad": {
     "_fuente": "El fósforo del animal en crecimiento es el hueco que más falsos positivos generaba: sin él, TODO cachorro sale hiperfosforémico y arrastra patrones renales falsos. Fundamentals 3.a ed., p. 831: cachorros < 12 sem 5,7-10,8 mg/dL frente a 2,5-5,5 del adulto; gatitos 5,0-10,0 frente a 1,8-6,4. La FAL del gatito va a x3,0: gatitos de 4 semanas 97-274 U/L frente a 10-80 del adulto (x3,4 el límite superior, Thrall 3.a ed., p. 447), y Fundamentals p. 831 pone el techo general del joven en '< 3 veces el límite superior del adulto'.",
     "canino": {
-      "cachorro": { "fal": { "superior": 3.0 }, "wbc": { "superior": 1.25 }, "fosf": { "superior": 1.8 } },
+      "cachorro": {
+        "fal": {
+          "superior": 3.0
+        },
+        "wbc": {
+          "superior": 1.25
+        },
+        "fosf": {
+          "superior": 1.8
+        }
+      },
       "adulto": {},
-      "senior": { "bun": { "superior": 1.15 }, "creat": { "superior": 1.15 } },
-      "geriatrico": { "bun": { "superior": 1.25 }, "creat": { "superior": 1.25 }, "fal": { "superior": 1.4 } }
+      "senior": {
+        "bun": {
+          "superior": 1.15
+        },
+        "creat": {
+          "superior": 1.15
+        }
+      },
+      "geriatrico": {
+        "bun": {
+          "superior": 1.25
+        },
+        "creat": {
+          "superior": 1.25
+        },
+        "fal": {
+          "superior": 1.4
+        }
+      }
     },
     "felino": {
-      "cachorro": { "fal": { "superior": 3.0 }, "wbc": { "superior": 1.2 }, "fosf": { "superior": 1.3 } },
+      "cachorro": {
+        "fal": {
+          "superior": 3.0
+        },
+        "wbc": {
+          "superior": 1.2
+        },
+        "fosf": {
+          "superior": 1.3
+        }
+      },
       "adulto": {},
-      "senior": { "bun": { "superior": 1.2 }, "creat": { "superior": 1.2 } }
+      "senior": {
+        "bun": {
+          "superior": 1.2
+        },
+        "creat": {
+          "superior": 1.2
+        }
+      }
     }
   },
-
   "ajustes_raza": {
     "_convencion": "Se combinan TODOS los grupos que casan, no sólo el primero: un shiba inu pertenece a la vez al grupo de microcitosis fisiológica y al de plaquetas bajas, y quedarse con el primero perdía el segundo en silencio. El nombre de la raza se compara en minúsculas por SUBCADENA.",
     "canino": [
       {
         "_fuente": "Lebreles. Fundamentals 3.a ed., p. 213-214: los RI de Hct, Hgb y RBC son más altos en greyhounds, afganos, salukis y whippets; plaquetas más bajas en lebreles (p. 307-310). La T4 es la trampa clínica: tT4 y fT4 por debajo del RI canino general en ~90% de los galgos sanos (p. 1065), así que sin este ajuste un galgo sano sale hipotiroideo. Creatinina más alta por masa muscular (Thrall 3.a ed., p. 363).",
-        "razas": ["galgo", "greyhound", "whippet", "lebrel", "afgano", "afghan", "saluki", "sloughi"],
+        "razas": [
+          "galgo",
+          "greyhound",
+          "whippet",
+          "lebrel",
+          "afgano",
+          "afghan",
+          "saluki",
+          "sloughi"
+        ],
         "ajustes": {
-          "rbc": { "inferior": 1.15, "superior": 1.15 },
-          "hgb": { "inferior": 1.12, "superior": 1.12 },
-          "hct": { "inferior": 1.12, "superior": 1.12 },
-          "plt": { "inferior": 0.75, "superior": 0.75 },
-          "t4_total": { "inferior": 0.5, "superior": 0.8 },
-          "t4_libre": { "inferior": 0.5, "superior": 0.8 },
-          "creat": { "superior": 1.15 }
+          "rbc": {
+            "inferior": 1.15,
+            "superior": 1.15
+          },
+          "hgb": {
+            "inferior": 1.12,
+            "superior": 1.12
+          },
+          "hct": {
+            "inferior": 1.12,
+            "superior": 1.12
+          },
+          "plt": {
+            "inferior": 0.75,
+            "superior": 0.75
+          },
+          "t4_total": {
+            "inferior": 0.5,
+            "superior": 0.8
+          },
+          "t4_libre": {
+            "inferior": 0.5,
+            "superior": 0.8
+          },
+          "creat": {
+            "superior": 1.15
+          }
         }
       },
       {
         "_fuente": "Razas asiáticas con microcitosis fisiológica. Fundamentals p. 221: 'some healthy Akitas, shibas, Jindos, chow-chows, and shar-peis have lower MCV' — VCM bajo SIN anemia. Antes se les subía RBC/Hct/Hgb, que generaba falsas anemias; bajar el VCM evita la falsa 'anemia microcítica'.",
-        "razas": ["shiba", "akita", "jindo", "chow", "shar pei", "shar-pei", "sharpei"],
-        "ajustes": { "vcm": { "inferior": 0.85, "superior": 0.92 } }
+        "razas": [
+          "shiba",
+          "akita",
+          "jindo",
+          "chow",
+          "shar pei",
+          "shar-pei",
+          "sharpei"
+        ],
+        "ajustes": {
+          "vcm": {
+            "inferior": 0.85,
+            "superior": 0.92
+          }
+        }
       },
       {
         "_fuente": "El shiba inu además tiene plaquetas sustancialmente más bajas (Fundamentals p. 307-310).",
-        "razas": ["shiba"],
-        "ajustes": { "plt": { "inferior": 0.75, "superior": 0.9 } }
+        "razas": [
+          "shiba"
+        ],
+        "ajustes": {
+          "plt": {
+            "inferior": 0.75,
+            "superior": 0.9
+          }
+        }
       }
     ],
     "felino": [
       {
         "_fuente": "Fundamentals p. 213-214: los límites inferiores de Hgb y Hct del Maine Coon son sustancialmente mayores que los de las razas felinas típicas.",
-        "razas": ["maine coon", "maine"],
-        "ajustes": { "hct": { "inferior": 1.15 }, "hgb": { "inferior": 1.15 } }
+        "razas": [
+          "maine coon",
+          "maine"
+        ],
+        "ajustes": {
+          "hct": {
+            "inferior": 1.15
+          },
+          "hgb": {
+            "inferior": 1.15
+          }
+        }
       },
       {
         "_fuente": "Fundamentals p. 585: la creatinina de gatos Birman clínicamente sanos puede superar el límite superior de los RI felinos de rutina.",
-        "razas": ["birman", "sagrado de birmania"],
-        "ajustes": { "creat": { "superior": 1.2 } }
+        "razas": [
+          "birman",
+          "sagrado de birmania"
+        ],
+        "ajustes": {
+          "creat": {
+            "superior": 1.2
+          }
+        }
       }
     ]
   },
-
   "ajustes_sexo": {
     "_fuente": "VACÍO A PROPÓSITO, no es un olvido. Se retiró el ajuste que subía un 15% el techo de creatinina en el gato MACHO: no aparece en ninguna de las dos obras del corpus. La secreción tubular de creatinina es cosa del perro macho —'cats and ponies do not secrete or reabsorb Ct in their kidneys' (Thrall p. 363)— y se describe como clínicamente intrascendente; tolerar un 15% más de creatinina justo en la población con más ERC era infradetección sin respaldo. Lo único con respaldo por sexo es menor: en perro las plaquetas son hasta un 10% mayores en hembras y en enteros (Fundamentals p. 310), por debajo de la resolución clínica del motor.",
     "canino": {},
     "felino": {}
+  },
+  "iris": {
+    "_fuente": "Estadiaje IRIS de la enfermedad renal crónica. IRIS Staging of CKD (modificado 2026), indexada en el RAG; la misma tabla aparece en Fundamentals 3.a ed., p. 573 (Tabla 8.4). Estadio por creatinina, con la escalada por discrepancia con SDMA que describe la propia guía, y subestadio por proteinuria (UP/C).",
+    "_limitacion": "DELIBERADA: la guía estadia pacientes YA diagnosticados de ERC, en ayunas y sobre muestras seriadas estables. El motor sólo ve una analítica suelta, así que el estadio se emite únicamente cuando la creatinina o la SDMA salen del rango de referencia, y se etiqueta como orientativo. Un perro con creatinina 1,5 (estadio 2 IRIS pero dentro de nuestro rango) no se estadia: haría falta el diagnóstico previo de ERC, que el motor no tiene.",
+    "cortes_creatinina": {
+      "_unidad": "mg/dL. Límite superior de los estadios 1, 2 y 3; por encima del último → estadio 4.",
+      "canino": [
+        1.4,
+        2.8,
+        5.0
+      ],
+      "felino": [
+        1.6,
+        2.8,
+        5.0
+      ]
+    },
+    "cortes_sdma": {
+      "_unidad": "µg/dL. SDMA que hace subir de estadio cuando discrepa con la creatinina (>18 en el estadio 1, >35/25 en el 2, >54/38 en el 3).",
+      "canino": [
+        18,
+        35,
+        54
+      ],
+      "felino": [
+        18,
+        25,
+        38
+      ]
+    },
+    "cortes_upc": {
+      "_unidad": "UP/C. [no proteinúrico por debajo de, proteinúrico por encima de].",
+      "canino": [
+        0.2,
+        0.5
+      ],
+      "felino": [
+        0.2,
+        0.4
+      ]
+    }
   }
 }

frontend/src/analisis.ts

@@ -158,34 +158,9 @@ const ajustarReferencias = (
   }, {});
 };
 
-// Estadiaje IRIS de la enfermedad renal crónica
-//
-// Fuente: IRIS Staging of CKD (modificado 2026), indexada en el RAG; la misma tabla aparece en
-// Fundamentals 3.a ed., p. 573 (Tabla 8.4). Estadio por creatinina, con la escalada por
-// discrepancia con SDMA que describe la propia guía, y subestadio por proteinuria (UP/C).
-//
-// Limitación deliberada: la guía estadia pacientes YA diagnosticados de ERC, en ayunas y sobre
-// muestras seriadas estables. El motor sólo ve una analítica suelta, así que el estadio se
-// emite únicamente cuando la creatinina o la SDMA salen del rango de referencia, y se etiqueta
-// como orientativo. Un perro con creatinina 1,5 (estadio 2 IRIS pero dentro de nuestro rango)
-// no se estadia: haría falta el diagnóstico previo de ERC, que el motor no tiene.
-const CORTES_IRIS_CREAT: Record<Especie, number[]> = {
-  // Límite superior de los estadios 1, 2 y 3 en mg/dL (por encima del último → estadio 4).
-  canino: [1.4, 2.8, 5.0],
-  felino: [1.6, 2.8, 5.0],
-};
-
-const CORTES_IRIS_SDMA: Record<Especie, number[]> = {
-  // SDMA que hace subir de estadio cuando discrepa con la creatinina (µg/dL).
-  canino: [18, 35, 54],
-  felino: [18, 25, 38],
-};
-
-// UP/C: [no proteinúrico por debajo de, proteinúrico por encima de]
-const CORTES_IRIS_UPC: Record<Especie, [number, number]> = {
-  canino: [0.2, 0.5],
-  felino: [0.2, 0.4],
-};
+// Estadiaje IRIS de la enfermedad renal crónica.
+// Los cortes (creatinina, SDMA y UP/C) viven en data/ajustes_clinicos.json → `iris`, junto a su
+// procedencia bibliográfica y la limitación deliberada del estadiaje sobre una analítica suelta.
 
 type EstadioIris = { estadio: number; subestadio: string; nota: string };
 
@@ -194,11 +169,12 @@ const estadificarIris = (
   sdma: number | null,
   upc: number | null,
   especie: Especie,
+  ajustes: AjustesClinicos,
 ): EstadioIris | null => {
   if (creat === null && sdma === null) return null;
 
-  const cortesCreat = CORTES_IRIS_CREAT[especie];
-  const cortesSdma = CORTES_IRIS_SDMA[especie];
+  const cortesCreat = ajustes.iris.cortes_creatinina[especie] ?? [];
+  const cortesSdma = ajustes.iris.cortes_sdma[especie] ?? [];
 
   const porCreatinina = creat === null
     ? 1
@@ -213,7 +189,7 @@ const estadificarIris = (
 
   if (escalado < 2) return null; // estadio 1: sin azotemia ni SDMA alta, nada que informar
 
-  const [noProteinurico, proteinurico] = CORTES_IRIS_UPC[especie];
+  const [noProteinurico, proteinurico] = ajustes.iris.cortes_upc[especie] ?? [0, 0];
   const subestadio = upc === null
     ? ''
     : upc > proteinurico ? 'proteinúrico'
@@ -229,7 +205,12 @@ const estadificarIris = (
 
 // Detección de patrones clínicos
 
-const detectarPatrones = (hallazgos: Hallazgo[], especie: Especie, alt: Alteraciones): Patron[] => {
+const detectarPatrones = (
+  hallazgos: Hallazgo[],
+  especie: Especie,
+  alt: Alteraciones,
+  ajustes: AjustesClinicos,
+): Patron[] => {
   const mapa = hallazgos.reduce<Record<string, Hallazgo>>((acc, h) => { acc[h.clave] = h; return acc; }, {});
 
   const esAlto = (clave: string): boolean => mapa[clave]?.direccion === 'alto';
@@ -398,7 +379,7 @@ const detectarPatrones = (hallazgos: Hallazgo[], especie: Especie, alt: Alteraci
 
   // Estadiaje IRIS. Se emite como patrón aparte de la azotemia porque responde a otra
   // pregunta: la azotemia dice QUÉ está alterado, el estadio dice CUÁNTO y guía el manejo.
-  const estadio = estadificarIris(valor('creat'), valor('sdma'), valor('upc'), especie);
+  const estadio = estadificarIris(valor('creat'), valor('sdma'), valor('upc'), especie, ajustes);
   if (estadio) agregar({
     nombre: `${alt.erc_iris.nombre} — estadio ${estadio.estadio}${estadio.subestadio ? `, ${estadio.subestadio}` : ''}`,
     descripcion: `${alt.erc_iris.descripcion} ${estadio.nota}`,
@@ -962,7 +943,7 @@ export const analizarResultados = (
     }
   }
 
-  return { hallazgos, patrones: detectarPatrones(hallazgos, especie, alteraciones) };
+  return { hallazgos, patrones: detectarPatrones(hallazgos, especie, alteraciones, ajustes) };
 };
 
 // Exportado para pruebas unitarias del cálculo de gravedad de forma aislada.

frontend/src/tipos.ts

@@ -66,4 +66,9 @@ export interface AjustesClinicos {
   ajustes_edad: Partial<Record<Especie, Record<string, TablaAjustes>>>;
   ajustes_raza: Partial<Record<Especie, GrupoRaza[]>>;
   ajustes_sexo: Partial<Record<Especie, Record<string, TablaAjustes>>>;
+  iris: {
+    cortes_creatinina: Partial<Record<Especie, number[]>>;
+    cortes_sdma: Partial<Record<Especie, number[]>>;
+    cortes_upc: Partial<Record<Especie, number[]>>;
+  };
 }

frontend/tests/analisis.test.ts

@@ -383,6 +383,17 @@ describe('las reglas clínicas son datos, no código', () => {
     expect(r.hallazgos.find((h) => h.clave === 'hct')?.gravedad).toBe('leve');
   });
 
+  it('los cortes IRIS salen del JSON', () => {
+    // Se desplaza el estadio 2 canino de 1,4 a 4,0: una creatinina de 2,0 deja de ser estadio 2.
+    const desplazado = conAjustes((a) => {
+      a.iris.cortes_creatinina.canino = [4.0, 6.0, 8.0];
+    });
+    const p = analizarResultados({ creat: 2.0 }, paciente(), referencias, alteraciones, desplazado)
+      .patrones.find((x) => x.nombre.startsWith(alteraciones.erc_iris.nombre));
+    // Estadio 1 con los cortes nuevos → no se informa estadio.
+    expect(p).toBeUndefined();
+  });
+
   it('los límites de edad salen del JSON', () => {
     const adelantado = conAjustes((a) => {
       a.limites_edad_meses.canino!.cachorro = 1;