<?xml version="1.0" encoding="utf-8"?><?xml-stylesheet type="text/xsl" href="atom.xsl"?>
<feed xmlns="http://www.w3.org/2005/Atom">
    <id>https://desobsesor.github.io/blog</id>
    <title>CCF-Almacen Wiki Blog</title>
    <updated>2026-11-19T00:00:00.000Z</updated>
    <generator>https://github.com/jpmonette/feed</generator>
    <link rel="alternate" href="https://desobsesor.github.io/blog"/>
    <subtitle>CCF-Almacen Wiki Blog</subtitle>
    <icon>https://desobsesor.github.io/img/favicon.ico</icon>
    <entry>
        <title type="html"><![CDATA[POS — datos de la veterinaria en el comprobante y NIT corregido]]></title>
        <id>https://desobsesor.github.io/blog/2026-11-19-pos-datos-veterinaria-impresion</id>
        <link href="https://desobsesor.github.io/blog/2026-11-19-pos-datos-veterinaria-impresion"/>
        <updated>2026-11-19T00:00:00.000Z</updated>
        <summary type="html"><![CDATA[La tirilla del punto de venta salía con el NIT equivocado]]></summary>
        <content type="html"><![CDATA[<p>La tirilla del <strong>punto de venta</strong> salía con el NIT equivocado
(<code>1080931527-1</code>) y repetía la dirección y los teléfonos de la veterinaria: una
vez en la cabecera y otra en el bloque del punto de venta. La clínica es dueña
del almacén, así que sus datos son los mismos —y en una tirilla de 58 mm cada
línea cuenta—.</p>
<h2 class="anchor anchorTargetStickyNavbar_Vzrq" id="qué-se-revisó">Qué se revisó<a href="https://desobsesor.github.io/blog/2026-11-19-pos-datos-veterinaria-impresion#qu%C3%A9-se-revis%C3%B3" class="hash-link" aria-label="Enlace directo al Qué se revisó" title="Enlace directo al Qué se revisó" translate="no">​</a></h2>
<p>Se generó la tirilla real (80 mm) con los datos de la clínica y se comparó con
lo que imprime el código. Los hallazgos:</p>
<table><thead><tr><th>Hallazgo</th><th>Causa</th></tr></thead><tbody><tr><td>NIT <code>1080931527-1</code></td><td><code>vete_configuracion_institucional.legal_digito_verificacion</code> estaba en <code>1</code>; el correcto es <strong>6</strong> (DIAN: 720 mod 11 = 5 → 11 − 5 = 6)</td></tr><tr><td>Dirección impresa dos veces</td><td>La cabecera la toma de la ficha y el punto de venta de <code>almacenes</code>; en las bodegas de la clínica es la misma</td></tr><tr><td>Teléfonos impresos dos veces</td><td>Igual: <code>310 298 7831 · 310 247 7988</code> en la cabecera y uno de ellos otra vez bajo la bodega</td></tr><tr><td>Correo</td><td>Correcto (<code>veterinariasean@gmail.com</code>), en la cabecera</td></tr></tbody></table>
<p>Todo vive en el <strong>mismo PostgreSQL</strong>: la ficha institucional del módulo
<code>veterinaria</code> y la tabla <code>almacenes</code> del almacén. No hay un segundo modelo ni
datos duplicados en otra base.</p>
<h2 class="anchor anchorTargetStickyNavbar_Vzrq" id="qué-cambió">Qué cambió<a href="https://desobsesor.github.io/blog/2026-11-19-pos-datos-veterinaria-impresion#qu%C3%A9-cambi%C3%B3" class="hash-link" aria-label="Enlace directo al Qué cambió" title="Enlace directo al Qué cambió" translate="no">​</a></h2>
<ul>
<li class=""><strong>Migración <code>1792730422579-NitVeterinariaEnAlmacenesPos</code></strong>: corrige el dígito de
verificación en la ficha y deja el NIT <strong><code>1080931527-6</code></strong> en las bodegas
<code>es_veterinaria</code> (Farmacia y Tienda). Solo toca el valor erróneo o vacío: no
pisa un NIT distinto escrito por el Administrador. Es reversible.</li>
<li class=""><strong>Comprobante sin líneas repetidas</strong> (<code>pos-comprobante.pdf.ts</code>): el bloque del
punto de venta imprime la bodega y el NIT, y <strong>omite</strong> la dirección y el
teléfono cuando coinciden con la cabecera. La comparación ignora tildes,
signos y mayúsculas, y compara teléfonos por dígitos. Si la bodega tiene datos
propios (otra sede u otra razón social), sus líneas vuelven a salir.</li>
</ul>
<h3 class="anchor anchorTargetStickyNavbar_Vzrq" id="antes-y-después-tirilla-80-mm">Antes y después (tirilla 80 mm)<a href="https://desobsesor.github.io/blog/2026-11-19-pos-datos-veterinaria-impresion#antes-y-despu%C3%A9s-tirilla-80-mm" class="hash-link" aria-label="Enlace directo al Antes y después (tirilla 80 mm)" title="Enlace directo al Antes y después (tirilla 80 mm)" translate="no">​</a></h3>
<div class="language-text codeBlockContainer_Ckt0 theme-code-block" style="--prism-color:#393A34;--prism-background-color:#f6f8fa"><div class="codeBlockContent_QJqH"><pre tabindex="0" class="prism-code language-text codeBlock_bY9V thin-scrollbar" style="color:#393A34;background-color:#f6f8fa"><code class="codeBlockLines_e6Vv"><div class="token-line" style="color:#393A34"><span class="token plain">Antes                                  Después</span><br></div><div class="token-line" style="color:#393A34"><span class="token plain">------------------------------------   ------------------------------------</span><br></div><div class="token-line" style="color:#393A34"><span class="token plain">SEAN Veterinaria                       SEAN Veterinaria</span><br></div><div class="token-line" style="color:#393A34"><span class="token plain">Cuidamos a tu familia peluda           Cuidamos a tu familia peluda</span><br></div><div class="token-line" style="color:#393A34"><span class="token plain">Tel. 310 298 7831 · 310 247 7988       Tel. 310 298 7831 · 310 247 7988</span><br></div><div class="token-line" style="color:#393A34"><span class="token plain">veterinariasean@gmail.com              veterinariasean@gmail.com</span><br></div><div class="token-line" style="color:#393A34"><span class="token plain">https://sean.cdsmaia.cloud             https://sean.cdsmaia.cloud</span><br></div><div class="token-line" style="color:#393A34"><span class="token plain">Calle 6, No 3-59, Apartamento 201,     Calle 6, No 3-59, Apartamento 201,</span><br></div><div class="token-line" style="color:#393A34"><span class="token plain">El Sanjon, Barrio El Centro,           El Sanjon, Barrio El Centro,</span><br></div><div class="token-line" style="color:#393A34"><span class="token plain">Timana, Huila                          Timana, Huila</span><br></div><div class="token-line" style="color:#393A34"><span class="token plain">Lunes a sábado, 8:30–18:30             Lunes a sábado, 8:30–18:30</span><br></div><div class="token-line" style="color:#393A34"><span class="token plain">Tienda Veterinaria                     Tienda Veterinaria</span><br></div><div class="token-line" style="color:#393A34"><span class="token plain">NIT 1080931527-1          ← erróneo    NIT 1080931527-6</span><br></div><div class="token-line" style="color:#393A34"><span class="token plain">Calle 6, No 3-59, ...     ← repetida</span><br></div><div class="token-line" style="color:#393A34"><span class="token plain">Timana, Huila</span><br></div><div class="token-line" style="color:#393A34"><span class="token plain">Tel. 3102477988           ← repetido</span><br></div></code></pre></div></div>
<h2 class="anchor anchorTargetStickyNavbar_Vzrq" id="cómo-verificarlo">Cómo verificarlo<a href="https://desobsesor.github.io/blog/2026-11-19-pos-datos-veterinaria-impresion#c%C3%B3mo-verificarlo" class="hash-link" aria-label="Enlace directo al Cómo verificarlo" title="Enlace directo al Cómo verificarlo" translate="no">​</a></h2>
<ol>
<li class="">Genere una venta en <strong>Punto de venta</strong> y abra la <strong>tirilla 80 mm</strong>: el NIT debe
decir <code>1080931527-6</code> y la dirección y el teléfono deben aparecer una sola vez.</li>
<li class="">Cambie el NIT de la bodega en <strong>Almacenes → Editar</strong> por uno distinto: la
tirilla vuelve a imprimir su línea de NIT (no se oculta un dato propio).</li>
<li class="">Ponga una dirección distinta en la bodega: vuelve a salir su dirección y su
teléfono bajo el nombre de la bodega.</li>
</ol>
<p>Pruebas: <code>npm test -- src/domains/pos src/domains/almacenes src/domains/empresa</code>
(61 en verde) y <code>npm run build</code> sin errores.</p>]]></content>
        <author>
            <name>Yovany Suárez Silva</name>
            <uri>https://desobsesor.github.io/portfolio-web/</uri>
        </author>
        <category label="POS" term="POS"/>
        <category label="Veterinaria" term="Veterinaria"/>
        <category label="PostgreSQL" term="PostgreSQL"/>
        <category label="Impresión" term="Impresión"/>
    </entry>
    <entry>
        <title type="html"><![CDATA[REQ-DOC-03 — Landing de la versión 2.4]]></title>
        <id>https://desobsesor.github.io/blog/req-doc-03-landing-v2-4-2026-11</id>
        <link href="https://desobsesor.github.io/blog/req-doc-03-landing-v2-4-2026-11"/>
        <updated>2026-11-19T00:00:00.000Z</updated>
        <summary type="html"><![CDATA[La portada y la ruta /v2-4 sirven la landing de la versión 2.4: el mostrador dentro del almacén, la caja que cuadra, los documentos con la identidad de la empresa, la seguridad endurecida y la continuidad sin conexión. La 2.3 pasa a /v2-3 como historial.]]></summary>
        <content type="html"><![CDATA[<p>Implementación del requerimiento <strong>REQ-DOC-03 (Landing y comunicación de versiones)</strong>, dentro de
<strong>Documentación</strong> y con prioridad <strong>Media</strong>. Después de la 2.3 entraron el punto de venta completo
con su administración, la empresa y sus logos en los documentos, las áreas, las banderas de
funcionalidad, el horario por bodega, el endurecimiento de seguridad, la pantalla de continuidad y
el cierre de la solicitud en destino. Faltaba la página de versión que lo contara junto y en
lenguaje de cliente.</p>
<hr>
<h2 class="anchor anchorTargetStickyNavbar_Vzrq" id="-alcance">📋 Alcance<a href="https://desobsesor.github.io/blog/req-doc-03-landing-v2-4-2026-11#-alcance" class="hash-link" aria-label="Enlace directo al 📋 Alcance" title="Enlace directo al 📋 Alcance" translate="no">​</a></h2>
<table><thead><tr><th>Criterio de aceptación</th><th>Entregable</th></tr></thead><tbody><tr><td><strong>CA1</strong> · Inventario verificado de cambios posteriores a la 2.3</td><td>34 cambios con fecha, tipo, frente y respaldo en commits, documentos y manuales</td></tr><tr><td><strong>CA2</strong> · Conserva el sistema visual de la 2.1 a la 2.3</td><td><code>landing-v3.css</code> sin modificar, Figtree, acento brasa y cabecera con progreso e índice</td></tr><tr><td><strong>CA3</strong> · No repite la estructura de la 2.3</td><td>Sin hero de cuatro contadores, sin sección de módulo única y sin tercera tabla comparativa</td></tr><tr><td><strong>CA4</strong> · Cada frente con su pieza</td><td>Riel de cuatro etapas, mesa de caja interactiva, lista numerada, tirilla, banda de confianza, tabla de estructura y matriz</td></tr><tr><td><strong>CA5</strong> · Lenguaje de cliente</td><td>Sin códigos internos, rutas ni endpoints; la trazabilidad técnica queda en el dato, no en la página</td></tr><tr><td><strong>CA6</strong> · Sin datos de una instalación</td><td>Ningún NIT, dirección, teléfono ni nombre de la clínica; las cifras de ejemplo se declaran</td></tr><tr><td><strong>CA7</strong> · Solo lo respaldado</td><td>Ocho límites explícitos en el documento del requerimiento</td></tr><tr><td><strong>CA8</strong> · Versiones anteriores accesibles</td><td><code>/v2-3</code>, <code>/v2-2</code>, <code>/v2-1</code>, <code>/v2</code> y <code>/v1</code> responden 200</td></tr><tr><td><strong>CA9</strong> · Escritorio y móvil sin desbordamientos</td><td>Playwright de 320 a 1440 px: 0 desbordes, 0 errores de consola, también con texto grande</td></tr><tr><td><strong>CA10</strong> · Metadatos y visibilidad</td><td>Título, descripción, Open Graph, Twitter Card, <code>noindex</code> y <code>llms.txt</code> regenerado</td></tr><tr><td><strong>CA11</strong> · Pruebas, tipos y lint</td><td>71/71 en las cinco suites de landing, <code>tsc</code> 0, <code>eslint</code> 0, build 0</td></tr><tr><td><strong>CA12</strong> · Promoción reversible</td><td>El destino de <code>/</code> cambia en una línea de <code>next.config.js</code></td></tr></tbody></table>
<h2 class="anchor anchorTargetStickyNavbar_Vzrq" id="-la-página-en-piezas">🧩 La página, en piezas<a href="https://desobsesor.github.io/blog/req-doc-03-landing-v2-4-2026-11#-la-p%C3%A1gina-en-piezas" class="hash-link" aria-label="Enlace directo al 🧩 La página, en piezas" title="Enlace directo al 🧩 La página, en piezas" translate="no">​</a></h2>
<table><thead><tr><th>Pieza</th><th>Rol</th></tr></thead><tbody><tr><td><code>app/page.tsx</code></td><td><strong>Portada</strong>: sirve la landing 2.4, la misma que <code>/v2-4</code></td></tr><tr><td><code>app/v2-4/page.tsx</code> · <code>loading.tsx</code></td><td>Ruta versionada y carga estándar con acento brasa</td></tr><tr><td><code>app/v2-4/landing-v24.css</code></td><td>CSS aditivo: papel térmico, banda oscura, ficha, mesa, tirilla, arqueo, flujo, estructura y matriz</td></tr><tr><td><code>src/data/landing-v2-4.ts</code></td><td>Contenido único: 34 novedades, etapas, mesa, pantallas, tirilla, controles, continuidad, flujo, estructura, matriz, versiones y accesos</td></tr><tr><td><code>src/components/landing-v2-4/*</code></td><td>Nueve componentes de sección, cada uno con su pieza visual</td></tr><tr><td><code>src/components/selector-versiones.tsx</code></td><td>Añade <code>v2.4</code> y mueve <code>v2.3</code> a <code>/v2-3</code></td></tr></tbody></table>
<h2 class="anchor anchorTargetStickyNavbar_Vzrq" id="-qué-cambia-en-el-diseño">🎨 Qué cambia en el diseño<a href="https://desobsesor.github.io/blog/req-doc-03-landing-v2-4-2026-11#-qu%C3%A9-cambia-en-el-dise%C3%B1o" class="hash-link" aria-label="Enlace directo al 🎨 Qué cambia en el diseño" title="Enlace directo al 🎨 Qué cambia en el diseño" translate="no">​</a></h2>
<ul>
<li class=""><strong>Paleta propia para distinguir la entrega.</strong> La 2.4 deja el coral de las versiones anteriores y
pasa a <strong>violeta para la interfaz y verde para el dinero</strong>: el violeta lleva la identidad, la
acción principal y los controles activos; el verde se reserva a las cifras de venta, los totales,
el arqueo cuadrado y el paso «recibida». El campo animado del fondo arranca en verde, y la 2.3
conserva intactos su lienzo y su acento.</li>
<li class=""><strong>Los cuatro contadores de la 2.3 se retiran.</strong> Con 34 cambios, un número no dice qué pasó. En su
lugar va la <strong>ficha de la entrega</strong>: entrega, recorridos, cambios y continuidad, con las cifras
derivadas del propio listado.</li>
<li class=""><strong>La línea de tiempo se mueve al final y se pliega.</strong> Deja de ser el centro de la página y pasa a
ser el apéndice completo, filtrable por tipo y por frente.</li>
<li class=""><strong>La tabla comparativa se convierte en matriz de madurez por área</strong>, con estado (nuevo, ampliado,
consolidado, sin cambio). Era la tercera versión del mismo widget.</li>
<li class=""><strong>Una banda oscura, una sola.</strong> Es el único lugar de la página donde el estado no es «todo bien»:
seguridad, continuidad y cierre de la solicitud.</li>
<li class=""><strong>La tirilla se dibuja con CSS y texto</strong>, sobre un papel térmico propio. El repositorio no tiene
capturas de producto y no se inventan.</li>
<li class=""><strong>El riel de cuatro etapas</strong> usa clases que existían en el CSS de la 2.1 sin uso.</li>
</ul>
<h2 class="anchor anchorTargetStickyNavbar_Vzrq" id="-lo-que-la-landing-no-dice">🔒 Lo que la landing no dice<a href="https://desobsesor.github.io/blog/req-doc-03-landing-v2-4-2026-11#-lo-que-la-landing-no-dice" class="hash-link" aria-label="Enlace directo al 🔒 Lo que la landing no dice" title="Enlace directo al 🔒 Lo que la landing no dice" translate="no">​</a></h2>
<p>Cuatro afirmaciones quedan fuera por no estar respaldadas: que el login impide enumerar usuarios
(el código responde 404 a una cuenta inexistente, contra lo que afirma el documento de la
auditoría), que el POS emite factura electrónica, que funciona sin conexión vendiendo, y que opera
en cualquier bodega. Los datos de la clínica que aparecen en los manuales del POS tampoco se
trasladan a la página: son de una instalación.</p>
<h2 class="anchor anchorTargetStickyNavbar_Vzrq" id="-verificación">✅ Verificación<a href="https://desobsesor.github.io/blog/req-doc-03-landing-v2-4-2026-11#-verificaci%C3%B3n" class="hash-link" aria-label="Enlace directo al ✅ Verificación" title="Enlace directo al ✅ Verificación" translate="no">​</a></h2>
<table><thead><tr><th>Prueba</th><th>Resultado</th></tr></thead><tbody><tr><td><code>npx jest</code> de las cinco suites de landing</td><td><strong>71/71</strong> (23 de la 2.4 nuevas)</td></tr><tr><td><code>npx tsc --noEmit</code> · <code>npx eslint</code></td><td><strong>0</strong> · <strong>0</strong></td></tr><tr><td><code>npm run build</code></td><td><strong>0</strong>, con el chequeo de build seguro en verde</td></tr><tr><td>Rutas</td><td><code>/</code> y <code>/v2-4</code> con la 2.4 y <code>noindex</code>; <code>/v2-3</code> conserva la 2.3; <code>/v2-2</code>, <code>/v1</code> y <code>/layout</code> en 200</td></tr><tr><td>Playwright 320 / 375 / 768 / 1440 px</td><td>0 desbordes (también con texto grande) y 0 errores de consola</td></tr></tbody></table>
<h2 class="anchor anchorTargetStickyNavbar_Vzrq" id="-pendientes">📌 Pendientes<a href="https://desobsesor.github.io/blog/req-doc-03-landing-v2-4-2026-11#-pendientes" class="hash-link" aria-label="Enlace directo al 📌 Pendientes" title="Enlace directo al 📌 Pendientes" translate="no">​</a></h2>
<ul>
<li class="">Decidir el rechazo del login frente a la enumeración de usuarios: corregir el código o el
documento de la auditoría (D-038).</li>
<li class="">Publicar por HTTPS; si cambia el host, regenerar <code>npm run seo:generar</code>.</li>
<li class="">La telemetría flotante del fondo todavía puede tapar la esquina inferior derecha en escritorio;
en móvil ya se oculta desde el CSS de la 2.4. Corregirlo en escritorio tocaría el comportamiento
compartido con la 2.1 a la 2.3.</li>
</ul>
<hr>
<p><strong>Documentación:</strong> <a class="" href="https://desobsesor.github.io/docs/mejoras/req-doc-03-landing-version-2-4">REQ-DOC-03</a> ·
<a class="" href="https://desobsesor.github.io/docs/mejoras/req-doc-02-landing-version-2-3">REQ-DOC-02</a> ·
<a class="" href="https://desobsesor.github.io/">Landing en la portada</a></p>]]></content>
        <author>
            <name>Yovany Suárez Silva</name>
            <uri>https://desobsesor.github.io/portfolio-web/</uri>
        </author>
        <category label="CCF-Almacén" term="CCF-Almacén"/>
        <category label="Documentación" term="Documentación"/>
        <category label="REQ-DOC-03" term="REQ-DOC-03"/>
        <category label="Novedades" term="Novedades"/>
        <category label="v2-4" term="v2-4"/>
        <category label="POS" term="POS"/>
        <category label="caja" term="caja"/>
        <category label="Seguridad" term="Seguridad"/>
        <category label="continuidad" term="continuidad"/>
        <category label="Landing" term="Landing"/>
        <category label="Frontend" term="Frontend"/>
    </entry>
    <entry>
        <title type="html"><![CDATA[Alertas inteligentes y Alertas de stock — pruebas unitarias de reglas y semáforos]]></title>
        <id>https://desobsesor.github.io/blog/2026-11-13-alertas-inteligentes-y-stock-pruebas-unitarias</id>
        <link href="https://desobsesor.github.io/blog/2026-11-13-alertas-inteligentes-y-stock-pruebas-unitarias"/>
        <updated>2026-11-13T00:00:00.000Z</updated>
        <summary type="html"><![CDATA[Alertas inteligentes (/alertas-inteligentes, REP-008) permite configurar qué vigila el]]></summary>
        <content type="html"><![CDATA[<p><strong>Alertas inteligentes</strong> (<code>/alertas-inteligentes</code>, REP-008) permite configurar qué vigila el
sistema y por dónde avisa; <strong>Alertas de stock</strong> (<code>/stock-alerts</code>, INV-002 + INV-007 + UX-004)
muestra el semáforo del inventario por bodega. Ahora suman <strong>48 casos</strong> de prueba.</p>
<h2 class="anchor anchorTargetStickyNavbar_Vzrq" id="1-qué-se-cubre">1. Qué se cubre<a href="https://desobsesor.github.io/blog/2026-11-13-alertas-inteligentes-y-stock-pruebas-unitarias#1-qu%C3%A9-se-cubre" class="hash-link" aria-label="Enlace directo al 1. Qué se cubre" title="Enlace directo al 1. Qué se cubre" translate="no">​</a></h2>
<h3 class="anchor anchorTargetStickyNavbar_Vzrq" id="alertas-inteligentes--src__tests__alertas-inteligentes-gestiontesttsx-29-casos">Alertas inteligentes — <code>src/__tests__/alertas-inteligentes-gestion.test.tsx</code> (29 casos)<a href="https://desobsesor.github.io/blog/2026-11-13-alertas-inteligentes-y-stock-pruebas-unitarias#alertas-inteligentes--src__tests__alertas-inteligentes-gestiontesttsx-29-casos" class="hash-link" aria-label="Enlace directo al alertas-inteligentes--src__tests__alertas-inteligentes-gestiontesttsx-29-casos" title="Enlace directo al alertas-inteligentes--src__tests__alertas-inteligentes-gestiontesttsx-29-casos" translate="no">​</a></h3>
<table><thead><tr><th>Bloque</th><th>Qué fija</th></tr></thead><tbody><tr><td><strong>Resumen</strong></td><td>Pendientes, severidad alta, resueltas y total del período en las tarjetas</td></tr><tr><td><strong>Reglas</strong></td><td>Condición en lenguaje legible con unidad, canales (Sistema/Correo), programación con anti-repetición, última evaluación, insignias «Del sistema» e «Inactiva» y acciones por fila</td></tr><tr><td><strong>Alta y edición</strong></td><td>Nombre, umbral y canal obligatorios; payload con métrica, operador, umbral numérico, parámetros de la métrica, severidad, destinatarios, periodicidad semanal con día, hora y cooldown; error del servidor y edición precargada</td></tr><tr><td><strong>Activación y baja</strong></td><td>Activar/desactivar con aviso y su error; eliminación solo de reglas propias</td></tr><tr><td><strong>Evaluación</strong></td><td>Regla que dispara (con canales), condición que no se cumple, silenciada por anti-repetición, métrica sin dato y error de red; evaluación global con el resumen de resultados</td></tr><tr><td><strong>Historial</strong></td><td>Valor/umbral, veces detectada, canales entregados y fallidos, estado, quién atendió y notas; filtros por estado, severidad, regla y fechas; limpieza y paginación</td></tr><tr><td><strong>Atención</strong></td><td>Reconocer/Resolver/Descartar con notas, sin notas, error y botones según el estado</td></tr><tr><td><strong>Tour</strong></td><td>Inicia el recorrido de la pantalla</td></tr></tbody></table>
<h3 class="anchor anchorTargetStickyNavbar_Vzrq" id="alertas-de-stock--src__tests__stock-alerts-gestiontesttsx-19-casos">Alertas de stock — <code>src/__tests__/stock-alerts-gestion.test.tsx</code> (19 casos)<a href="https://desobsesor.github.io/blog/2026-11-13-alertas-inteligentes-y-stock-pruebas-unitarias#alertas-de-stock--src__tests__stock-alerts-gestiontesttsx-19-casos" class="hash-link" aria-label="Enlace directo al alertas-de-stock--src__tests__stock-alerts-gestiontesttsx-19-casos" title="Enlace directo al alertas-de-stock--src__tests__stock-alerts-gestiontesttsx-19-casos" translate="no">​</a></h3>
<table><thead><tr><th>Bloque</th><th>Qué fija</th></tr></thead><tbody><tr><td><strong>Carga y transformación</strong></td><td>Producto + presentación + categoría, mensaje derivado, tipos <code>out_of_stock</code> / <code>low_stock</code> / <code>expiring_soon</code> / <code>stock_seguridad</code>, prioridad alta/media/baja, stock, mínimo, seguridad, bodega y ubicación</td></tr><tr><td><strong>Métricas</strong></td><td>Conteos de total, prioridad alta, sin stock y stock bajo; ocultar/mostrar con persistencia en <code>localStorage</code></td></tr><tr><td><strong>Filtros</strong></td><td>Búsqueda por producto, mensaje, categoría y proveedor; tipo y prioridad; rango de fechas de vencimiento que excluye las alertas sin fecha</td></tr><tr><td><strong>Tarjetas como atajo</strong></td><td>Filtran y se alternan, el aviso explica el recorte y «Ver todos» lo quita; «Total alertas» limpia tipo y prioridad</td></tr><tr><td><strong>Paginación y exportación</strong></td><td>Paginación en cliente, CSV deshabilitado sin alertas y exportación de lo filtrado</td></tr><tr><td><strong>Tour</strong></td><td>Disponible o con su aviso de no disponible</td></tr></tbody></table>
<h2 class="anchor anchorTargetStickyNavbar_Vzrq" id="2-patrón-de-las-pruebas">2. Patrón de las pruebas<a href="https://desobsesor.github.io/blog/2026-11-13-alertas-inteligentes-y-stock-pruebas-unitarias#2-patr%C3%B3n-de-las-pruebas" class="hash-link" aria-label="Enlace directo al 2. Patrón de las pruebas" title="Enlace directo al 2. Patrón de las pruebas" translate="no">​</a></h2>
<ul>
<li class=""><strong>Alertas inteligentes</strong>: se mockean los diez hooks de <code>use-alertas-inteligentes</code> y se monta la
página con el formulario de regla <strong>real</strong>, de modo que se prueba también su contrato (canales,
parámetros, periodicidad). Las mutaciones reciben <code>onSuccess</code>/<code>onError</code> desde el mock.</li>
<li class="">Los <code>Select</code> del formulario sin <code>aria-label</code> se localizan por posición dentro del diálogo; los
del historial sí declaran <code>aria-label</code>.</li>
<li class="">Las pestañas de Radix se activan con <code>mouseDown</code> además de <code>click</code>.</li>
<li class=""><strong>Alertas de stock</strong>: se mockean las APIs de producto, almacén, categoría y presentación, el
contexto de pestañas y el tour. Se neutraliza <code>URL.createObjectURL</code> para verificar el CSV.</li>
</ul>
<h2 class="anchor anchorTargetStickyNavbar_Vzrq" id="3-cómo-verificarlo">3. Cómo verificarlo<a href="https://desobsesor.github.io/blog/2026-11-13-alertas-inteligentes-y-stock-pruebas-unitarias#3-c%C3%B3mo-verificarlo" class="hash-link" aria-label="Enlace directo al 3. Cómo verificarlo" title="Enlace directo al 3. Cómo verificarlo" translate="no">​</a></h2>
<div class="language-bash codeBlockContainer_Ckt0 theme-code-block" style="--prism-color:#393A34;--prism-background-color:#f6f8fa"><div class="codeBlockContent_QJqH"><pre tabindex="0" class="prism-code language-bash codeBlock_bY9V thin-scrollbar" style="color:#393A34;background-color:#f6f8fa"><code class="codeBlockLines_e6Vv"><div class="token-line" style="color:#393A34"><span class="token plain">cd ccf-almacen-web</span><br></div><div class="token-line" style="color:#393A34"><span class="token plain">npx jest src/__tests__/alertas-inteligentes-gestion.test.tsx src/__tests__/stock-alerts-gestion.test.tsx</span><br></div><div class="token-line" style="color:#393A34"><span class="token plain"># Test Suites: 2 passed, 2 total</span><br></div><div class="token-line" style="color:#393A34"><span class="token plain"># Tests:       48 passed, 48 total</span><br></div></code></pre></div></div>
<p><code>npx tsc --noEmit</code> y <code>npx eslint</code> pasan sin errores.</p>
<h2 class="anchor anchorTargetStickyNavbar_Vzrq" id="archivos-clave">Archivos clave<a href="https://desobsesor.github.io/blog/2026-11-13-alertas-inteligentes-y-stock-pruebas-unitarias#archivos-clave" class="hash-link" aria-label="Enlace directo al Archivos clave" title="Enlace directo al Archivos clave" translate="no">​</a></h2>
<ul>
<li class=""><code>ccf-almacen-web/src/__tests__/alertas-inteligentes-gestion.test.tsx</code> — suite de reglas e historial.</li>
<li class=""><code>ccf-almacen-web/src/__tests__/stock-alerts-gestion.test.tsx</code> — suite del semáforo de stock.</li>
<li class=""><code>ccf-almacen-web/src/pages/alertas-inteligentes.tsx</code> y <code>src/pages/stock-alerts.tsx</code>.</li>
<li class=""><code>ccf-almacen-web/src/components/alertas/formulario-regla-dialog.tsx</code> — formulario real bajo prueba.</li>
</ul>]]></content>
        <author>
            <name>Yovany Suárez Silva</name>
            <uri>https://desobsesor.github.io/portfolio-web/</uri>
        </author>
        <category label="Alertas" term="Alertas"/>
        <category label="REP-008" term="REP-008"/>
        <category label="Inventario" term="Inventario"/>
        <category label="Frontend" term="Frontend"/>
        <category label="Pruebas frontend" term="Pruebas frontend"/>
    </entry>
    <entry>
        <title type="html"><![CDATA[Almacenes y Áreas — pruebas unitarias de bodegas, permisos y traslados]]></title>
        <id>https://desobsesor.github.io/blog/2026-11-13-almacenes-y-areas-pruebas-unitarias</id>
        <link href="https://desobsesor.github.io/blog/2026-11-13-almacenes-y-areas-pruebas-unitarias"/>
        <updated>2026-11-13T00:00:00.000Z</updated>
        <summary type="html"><![CDATA[Las pantallas Almacenes (/almacenes, INV-002 + REQ-POS-01 + ADR-026) y Gestión de]]></summary>
        <content type="html"><![CDATA[<p>Las pantallas <strong>Almacenes</strong> (<code>/almacenes</code>, INV-002 + REQ-POS-01 + ADR-026) y <strong>Gestión de
Áreas</strong> (<code>/areas</code>, REQ-ADM-03) administran las dos dimensiones físicas y organizativas del
inventario. Ahora suman <strong>69 casos</strong> de prueba entre ambas.</p>
<h2 class="anchor anchorTargetStickyNavbar_Vzrq" id="1-qué-se-cubre">1. Qué se cubre<a href="https://desobsesor.github.io/blog/2026-11-13-almacenes-y-areas-pruebas-unitarias#1-qu%C3%A9-se-cubre" class="hash-link" aria-label="Enlace directo al 1. Qué se cubre" title="Enlace directo al 1. Qué se cubre" translate="no">​</a></h2>
<h3 class="anchor anchorTargetStickyNavbar_Vzrq" id="almacenes--src__tests__almacenes-gestiontesttsx-36-casos">Almacenes — <code>src/__tests__/almacenes-gestion.test.tsx</code> (36 casos)<a href="https://desobsesor.github.io/blog/2026-11-13-almacenes-y-areas-pruebas-unitarias#almacenes--src__tests__almacenes-gestiontesttsx-36-casos" class="hash-link" aria-label="Enlace directo al almacenes--src__tests__almacenes-gestiontesttsx-36-casos" title="Enlace directo al almacenes--src__tests__almacenes-gestiontesttsx-36-casos" translate="no">​</a></h3>
<table><thead><tr><th>Bloque</th><th>Qué fija</th></tr></thead><tbody><tr><td><strong>Listado</strong></td><td>Espera, error con mensaje del servidor, vacío según rol, contador, búsqueda por nombre y dirección, tipo (General/Tienda/Dispensación), teléfono formateado + NIT, responsable, banderas POS / Stock − / Vet, estado y guiones cuando falta el dato</td></tr><tr><td><strong>Usuarios relacionados</strong></td><td>Recuento por bodega (asignados + responsable) solo para Administrador; un rol sin gestión no consulta ni pinta acciones</td></tr><tr><td><strong>Alta y edición</strong></td><td>Nombre obligatorio, payload con todas las columnas, POS bloqueado en bodega general, textos vacíos enviados como <code>null</code>, error del servidor, «Guardando…», edición precargada y cancelación</td></tr><tr><td><strong>Estado y baja</strong></td><td>Inactivar/reactivar con su aviso y recarga, error, eliminación con confirmación, mensaje que sugiere inactivar ante dependencias y cancelación sin efectos</td></tr><tr><td><strong>Accesos por bodega</strong></td><td>Carga de asignados, Administrador no restringible, conceder y revocar acceso con sus avisos, error de carga y de cambio</td></tr><tr><td><strong>Horario y tour</strong></td><td>Solo la dispensación ofrece horario; tours de pantalla, formulario y accesos con su aviso de no disponible</td></tr></tbody></table>
<h3 class="anchor anchorTargetStickyNavbar_Vzrq" id="áreas--src__tests__areas-gestiontesttsx-33-casos">Áreas — <code>src/__tests__/areas-gestion.test.tsx</code> (33 casos)<a href="https://desobsesor.github.io/blog/2026-11-13-almacenes-y-areas-pruebas-unitarias#%C3%A1reas--src__tests__areas-gestiontesttsx-33-casos" class="hash-link" aria-label="Enlace directo al áreas--src__tests__areas-gestiontesttsx-33-casos" title="Enlace directo al áreas--src__tests__areas-gestiontesttsx-33-casos" translate="no">​</a></h3>
<table><thead><tr><th>Bloque</th><th>Qué fija</th></tr></thead><tbody><tr><td><strong>Listado</strong></td><td>Espera, nombre/descripción/estado/usuarios, vacío con y sin invitación a crear, búsqueda con reinicio a página 1, filtro por estado, error de carga, paginación y recarga</td></tr><tr><td><strong>Alta y edición</strong></td><td>Nombre obligatorio (botón deshabilitado), alta con descripción y responsable, alta inactiva, error del servidor, «Guardando…» con acciones bloqueadas, edición precargada y error al cargar</td></tr><tr><td><strong>Detalle</strong></td><td>Información, estado, descripción, dirección, responsable con su rol, tabla de usuarios (documento, correo, rol, estado), textos neutros y refresco al cerrar</td></tr><tr><td><strong>Eliminación</strong></td><td>Confirmación, bloqueo si el área tiene usuarios, error del servidor y cancelación sin consultar</td></tr><tr><td><strong>Asignación de usuarios</strong></td><td>Candidatos con su área actual, selección y alta con <code>addUsersToArea</code>, sin selección deshabilitado, sin candidatos, búsqueda con criterio, error de búsqueda, error al asignar y ausencia para roles sin administración</td></tr></tbody></table>
<h2 class="anchor anchorTargetStickyNavbar_Vzrq" id="2-patrón-de-las-pruebas">2. Patrón de las pruebas<a href="https://desobsesor.github.io/blog/2026-11-13-almacenes-y-areas-pruebas-unitarias#2-patr%C3%B3n-de-las-pruebas" class="hash-link" aria-label="Enlace directo al 2. Patrón de las pruebas" title="Enlace directo al 2. Patrón de las pruebas" translate="no">​</a></h2>
<ul>
<li class="">Se mockean los hooks de almacenes, la API de áreas y permisos, el <code>toast</code> del registro y el
contexto de tour; las páginas se montan completas dentro de un <code>AuthContext.Provider</code> con el
rol que cada caso necesita.</li>
<li class="">El selector de usuario se sustituye por un doble que expone una opción por botón, para probar
que la selección llega al formulario sin depender del <code>Command</code> de Radix en jsdom.</li>
<li class="">Las casillas de permisos se localizan con <code>getByLabelText(/nombre/)</code> porque la etiqueta incluye
también el rol; las acciones por fila, por su <code>aria-label</code> explícito.</li>
<li class=""><code>AlertDialog</code> y <code>Dialog</code> de Radix requieren anular el foco programático (<code>anularFocoProgramatico</code>).</li>
</ul>
<h2 class="anchor anchorTargetStickyNavbar_Vzrq" id="3-cómo-verificarlo">3. Cómo verificarlo<a href="https://desobsesor.github.io/blog/2026-11-13-almacenes-y-areas-pruebas-unitarias#3-c%C3%B3mo-verificarlo" class="hash-link" aria-label="Enlace directo al 3. Cómo verificarlo" title="Enlace directo al 3. Cómo verificarlo" translate="no">​</a></h2>
<div class="language-bash codeBlockContainer_Ckt0 theme-code-block" style="--prism-color:#393A34;--prism-background-color:#f6f8fa"><div class="codeBlockContent_QJqH"><pre tabindex="0" class="prism-code language-bash codeBlock_bY9V thin-scrollbar" style="color:#393A34;background-color:#f6f8fa"><code class="codeBlockLines_e6Vv"><div class="token-line" style="color:#393A34"><span class="token plain">cd ccf-almacen-web</span><br></div><div class="token-line" style="color:#393A34"><span class="token plain">npx jest src/__tests__/almacenes-gestion.test.tsx src/__tests__/areas-gestion.test.tsx</span><br></div><div class="token-line" style="color:#393A34"><span class="token plain"># Test Suites: 2 passed, 2 total</span><br></div><div class="token-line" style="color:#393A34"><span class="token plain"># Tests:       69 passed, 69 total</span><br></div></code></pre></div></div>
<p><code>npx tsc --noEmit</code> y <code>npx eslint</code> pasan sin errores.</p>
<h2 class="anchor anchorTargetStickyNavbar_Vzrq" id="archivos-clave">Archivos clave<a href="https://desobsesor.github.io/blog/2026-11-13-almacenes-y-areas-pruebas-unitarias#archivos-clave" class="hash-link" aria-label="Enlace directo al Archivos clave" title="Enlace directo al Archivos clave" translate="no">​</a></h2>
<ul>
<li class=""><code>ccf-almacen-web/src/__tests__/almacenes-gestion.test.tsx</code> — suite de bodegas.</li>
<li class=""><code>ccf-almacen-web/src/__tests__/areas-gestion.test.tsx</code> — suite de áreas.</li>
<li class=""><code>ccf-almacen-web/src/pages/almacenes.tsx</code> y <code>src/pages/areas.tsx</code> — páginas bajo prueba.</li>
<li class=""><code>ccf-almacen-web/src/models/almacen.entity.ts</code> — formulario y normalización del payload.</li>
<li class=""><code>ccf-almacen-web/src/api/areas.ts</code> — contrato del modelo único <code>oficinas</code>.</li>
</ul>]]></content>
        <author>
            <name>Yovany Suárez Silva</name>
            <uri>https://desobsesor.github.io/portfolio-web/</uri>
        </author>
        <category label="Almacenes" term="Almacenes"/>
        <category label="Inventario" term="Inventario"/>
        <category label="Frontend" term="Frontend"/>
        <category label="Pruebas frontend" term="Pruebas frontend"/>
    </entry>
    <entry>
        <title type="html"><![CDATA[Análisis de consumo y KPIs de gestión — pruebas unitarias de los tableros]]></title>
        <id>https://desobsesor.github.io/blog/2026-11-13-analisis-consumo-y-kpis-pruebas-unitarias</id>
        <link href="https://desobsesor.github.io/blog/2026-11-13-analisis-consumo-y-kpis-pruebas-unitarias"/>
        <updated>2026-11-13T00:00:00.000Z</updated>
        <summary type="html"><![CDATA[Análisis de consumo (/analisis-consumo, REP-005) explica patrones, anomalías y detalle por]]></summary>
        <content type="html"><![CDATA[<p><strong>Análisis de consumo</strong> (<code>/analisis-consumo</code>, REP-005) explica patrones, anomalías y detalle por
producto y área; <strong>KPIs de gestión</strong> (<code>/kpis-gestion</code>, REP-001) compara los cuatro indicadores
operativos con su meta. Ahora suman <strong>42 casos</strong> de prueba.</p>
<h2 class="anchor anchorTargetStickyNavbar_Vzrq" id="1-qué-se-cubre">1. Qué se cubre<a href="https://desobsesor.github.io/blog/2026-11-13-analisis-consumo-y-kpis-pruebas-unitarias#1-qu%C3%A9-se-cubre" class="hash-link" aria-label="Enlace directo al 1. Qué se cubre" title="Enlace directo al 1. Qué se cubre" translate="no">​</a></h2>
<h3 class="anchor anchorTargetStickyNavbar_Vzrq" id="análisis-de-consumo--src__tests__analisis-consumo-gestiontesttsx-23-casos">Análisis de consumo — <code>src/__tests__/analisis-consumo-gestion.test.tsx</code> (23 casos)<a href="https://desobsesor.github.io/blog/2026-11-13-analisis-consumo-y-kpis-pruebas-unitarias#an%C3%A1lisis-de-consumo--src__tests__analisis-consumo-gestiontesttsx-23-casos" class="hash-link" aria-label="Enlace directo al análisis-de-consumo--src__tests__analisis-consumo-gestiontesttsx-23-casos" title="Enlace directo al análisis-de-consumo--src__tests__analisis-consumo-gestiontesttsx-23-casos" translate="no">​</a></h3>
<table><thead><tr><th>Bloque</th><th>Qué fija</th></tr></thead><tbody><tr><td><strong>Resumen</strong></td><td>Las seis métricas del período (unidades, valor, variación, promedio, CV y anomalías) con su formato local</td></tr><tr><td><strong>Calidad de datos</strong></td><td>Aviso del consumo no atribuible a un área, y su ausencia cuando no hay brecha</td></tr><tr><td><strong>Gráficas y desgloses</strong></td><td>Serie por período y su agrupación, consumo por área (incluida «Sin área») y por categoría, con sus mensajes de vacío</td></tr><tr><td><strong>Top y anomalías</strong></td><td>Top de productos con SKU/categoría/participación; anomalías con severidad, pico/caída, observado/esperado, variación, método z-robusto o regla de razón y series con muestra insuficiente</td></tr><tr><td><strong>Detalle</strong></td><td>Tabla por producto y área, paginación de 10 y búsqueda que vuelve a la página 1</td></tr><tr><td><strong>Filtros y exportación</strong></td><td>Fechas, área, clasificación, categoría y agrupación; exportación a Excel y PDF con sus avisos y errores</td></tr><tr><td><strong>Tour</strong></td><td>Disponible o con su aviso de no disponible</td></tr></tbody></table>
<h3 class="anchor anchorTargetStickyNavbar_Vzrq" id="kpis-de-gestión--src__tests__kpis-gestion-gestiontesttsx-19-casos">KPIs de gestión — <code>src/__tests__/kpis-gestion-gestion.test.tsx</code> (19 casos)<a href="https://desobsesor.github.io/blog/2026-11-13-analisis-consumo-y-kpis-pruebas-unitarias#kpis-de-gesti%C3%B3n--src__tests__kpis-gestion-gestiontesttsx-19-casos" class="hash-link" aria-label="Enlace directo al kpis-de-gestión--src__tests__kpis-gestion-gestiontesttsx-19-casos" title="Enlace directo al kpis-de-gestión--src__tests__kpis-gestion-gestiontesttsx-19-casos" translate="no">​</a></h3>
<table><thead><tr><th>Bloque</th><th>Qué fija</th></tr></thead><tbody><tr><td><strong>Indicadores</strong></td><td>Rotación, exactitud, fill rate y tiempo de ciclo con su valor, su meta y su clasificación (En meta / Sobre la línea base / Bajo / Sin datos)</td></tr><tr><td><strong>Avance y desgloses</strong></td><td>Barra de progreso con <code>aria-valuenow</code>, detalles de apoyo de cada tarjeta y guiones cuando el indicador no se pudo medir</td></tr><tr><td><strong>Resumen y tendencias</strong></td><td>Inventario vigente, salidas valorizadas, pedidos evaluados y muestra de tiempo de ciclo; las cuatro gráficas mensuales</td></tr><tr><td><strong>Desgloses</strong></td><td>Rotación por categoría ordenada de menor a mayor, exactitud por categoría y fill rate por área, con sus vacíos</td></tr><tr><td><strong>Filtros y tour</strong></td><td>Fechas, almacén y área; restablecer a los valores iniciales; actualización manual y recorrido guiado</td></tr></tbody></table>
<h2 class="anchor anchorTargetStickyNavbar_Vzrq" id="2-patrón-de-las-pruebas">2. Patrón de las pruebas<a href="https://desobsesor.github.io/blog/2026-11-13-analisis-consumo-y-kpis-pruebas-unitarias#2-patr%C3%B3n-de-las-pruebas" class="hash-link" aria-label="Enlace directo al 2. Patrón de las pruebas" title="Enlace directo al 2. Patrón de las pruebas" translate="no">​</a></h2>
<ul>
<li class="">Se mockean las APIs de reportes, almacenes y oficinas, el <code>toast</code> y el tour; los gráficos de
Recharts se montan reales dentro de jsdom.</li>
<li class="">Las tarjetas de KPI se localizan por su anclaje de tour (<code>[data-tour="kpis-gestion.kpi.*"]</code>)
porque el título «Fill rate» también aparece en otras secciones.</li>
<li class="">Los importes y porcentajes se afirman con <code>Intl</code> en es-CO (<code>1.180</code>, <code>9,5x</code>, <code>96,5%</code>), y los
textos compuestos se buscan con expresiones regulares.</li>
</ul>
<h2 class="anchor anchorTargetStickyNavbar_Vzrq" id="3-cómo-verificarlo">3. Cómo verificarlo<a href="https://desobsesor.github.io/blog/2026-11-13-analisis-consumo-y-kpis-pruebas-unitarias#3-c%C3%B3mo-verificarlo" class="hash-link" aria-label="Enlace directo al 3. Cómo verificarlo" title="Enlace directo al 3. Cómo verificarlo" translate="no">​</a></h2>
<div class="language-bash codeBlockContainer_Ckt0 theme-code-block" style="--prism-color:#393A34;--prism-background-color:#f6f8fa"><div class="codeBlockContent_QJqH"><pre tabindex="0" class="prism-code language-bash codeBlock_bY9V thin-scrollbar" style="color:#393A34;background-color:#f6f8fa"><code class="codeBlockLines_e6Vv"><div class="token-line" style="color:#393A34"><span class="token plain">cd ccf-almacen-web</span><br></div><div class="token-line" style="color:#393A34"><span class="token plain">npx jest src/__tests__/analisis-consumo-gestion.test.tsx src/__tests__/kpis-gestion-gestion.test.tsx</span><br></div><div class="token-line" style="color:#393A34"><span class="token plain"># Test Suites: 2 passed, 2 total</span><br></div><div class="token-line" style="color:#393A34"><span class="token plain"># Tests:       42 passed, 42 total</span><br></div></code></pre></div></div>
<p><code>npx tsc --noEmit</code> y <code>npx eslint</code> pasan sin errores.</p>
<h2 class="anchor anchorTargetStickyNavbar_Vzrq" id="4-nota-sobre-la-ejecución-en-lote">4. Nota sobre la ejecución en lote<a href="https://desobsesor.github.io/blog/2026-11-13-analisis-consumo-y-kpis-pruebas-unitarias#4-nota-sobre-la-ejecuci%C3%B3n-en-lote" class="hash-link" aria-label="Enlace directo al 4. Nota sobre la ejecución en lote" title="Enlace directo al 4. Nota sobre la ejecución en lote" translate="no">​</a></h2>
<p>Los tableros con Recharts consumen bastante memoria de jsdom: al correr las 31 suites de la
carpeta en paralelo, algunas fallan por contención de recursos (no por regresiones). Con
<code>npx jest --maxWorkers=2</code> la corrida completa pasa: <strong>31 suites / 751 pruebas</strong>.</p>
<h2 class="anchor anchorTargetStickyNavbar_Vzrq" id="archivos-clave">Archivos clave<a href="https://desobsesor.github.io/blog/2026-11-13-analisis-consumo-y-kpis-pruebas-unitarias#archivos-clave" class="hash-link" aria-label="Enlace directo al Archivos clave" title="Enlace directo al Archivos clave" translate="no">​</a></h2>
<ul>
<li class=""><code>ccf-almacen-web/src/__tests__/analisis-consumo-gestion.test.tsx</code> — suite del tablero de consumo.</li>
<li class=""><code>ccf-almacen-web/src/__tests__/kpis-gestion-gestion.test.tsx</code> — suite de KPIs de gestión.</li>
<li class=""><code>ccf-almacen-web/src/components/reports/consumo-dashboard.tsx</code> y <code>kpi-dashboard.tsx</code>.</li>
<li class=""><code>ccf-almacen-web/src/models/analisis-consumo.entity.ts</code> y <code>kpi-gestion.entity.ts</code>.</li>
</ul>]]></content>
        <author>
            <name>Yovany Suárez Silva</name>
            <uri>https://desobsesor.github.io/portfolio-web/</uri>
        </author>
        <category label="Reportes" term="Reportes"/>
        <category label="REP-005" term="REP-005"/>
        <category label="REP-001" term="REP-001"/>
        <category label="Frontend" term="Frontend"/>
        <category label="Pruebas frontend" term="Pruebas frontend"/>
    </entry>
    <entry>
        <title type="html"><![CDATA[Auditoría de accesos y Sesiones — pruebas unitarias de trazabilidad y concurrencia]]></title>
        <id>https://desobsesor.github.io/blog/2026-11-13-auditoria-y-sesiones-pruebas-unitarias</id>
        <link href="https://desobsesor.github.io/blog/2026-11-13-auditoria-y-sesiones-pruebas-unitarias"/>
        <updated>2026-11-13T00:00:00.000Z</updated>
        <summary type="html"><![CDATA[Auditoría de accesos (/auditoria-accesos, TEC-008) reconstruye quién entró y qué hizo, y]]></summary>
        <content type="html"><![CDATA[<p><strong>Auditoría de accesos</strong> (<code>/auditoria-accesos</code>, TEC-008) reconstruye quién entró y qué hizo, y
<strong>Sesiones</strong> (<code>/sesiones</code>, TEC-010) controla las sesiones simultáneas. Ahora suman <strong>51 casos</strong>
de prueba.</p>
<h2 class="anchor anchorTargetStickyNavbar_Vzrq" id="1-qué-se-cubre">1. Qué se cubre<a href="https://desobsesor.github.io/blog/2026-11-13-auditoria-y-sesiones-pruebas-unitarias#1-qu%C3%A9-se-cubre" class="hash-link" aria-label="Enlace directo al 1. Qué se cubre" title="Enlace directo al 1. Qué se cubre" translate="no">​</a></h2>
<h3 class="anchor anchorTargetStickyNavbar_Vzrq" id="auditoría-de-accesos--src__tests__auditoria-accesos-gestiontesttsx-16-casos">Auditoría de accesos — <code>src/__tests__/auditoria-accesos-gestion.test.tsx</code> (16 casos)<a href="https://desobsesor.github.io/blog/2026-11-13-auditoria-y-sesiones-pruebas-unitarias#auditor%C3%ADa-de-accesos--src__tests__auditoria-accesos-gestiontesttsx-16-casos" class="hash-link" aria-label="Enlace directo al auditoría-de-accesos--src__tests__auditoria-accesos-gestiontesttsx-16-casos" title="Enlace directo al auditoría-de-accesos--src__tests__auditoria-accesos-gestiontesttsx-16-casos" translate="no">​</a></h3>
<table><thead><tr><th>Bloque</th><th>Qué fija</th></tr></thead><tbody><tr><td><strong>Panel</strong></td><td>Espera, error con reintento, tarjetas por resultado (registros, exitosos, fallidos y denegados) y rankings de eventos y usuarios</td></tr><tr><td><strong>Tabla</strong></td><td>Fecha, nombre con su usuario, rol, evento traducido, resultado, IP y detalle compuesto (motivo · entidad #id · ruta); guiones cuando falta el dato</td></tr><tr><td><strong>Filtros</strong></td><td>Resultado, evento, usuario (recortado), rango de fechas, Enter en el usuario, limpiar y refrescar</td></tr><tr><td><strong>Paginación y exportación</strong></td><td>«Cargar más» por cursor, error al paginar, CSV de lo visible y bloqueo sin registros</td></tr><tr><td><strong>Acciones privilegiadas</strong></td><td>Cambio de pestaña, columna «Entidad», evento sin traducir y rankings propios</td></tr></tbody></table>
<h3 class="anchor anchorTargetStickyNavbar_Vzrq" id="sesiones--src__tests__sesiones-gestiontesttsx-35-casos">Sesiones — <code>src/__tests__/sesiones-gestion.test.tsx</code> (35 casos)<a href="https://desobsesor.github.io/blog/2026-11-13-auditoria-y-sesiones-pruebas-unitarias#sesiones--src__tests__sesiones-gestiontesttsx-35-casos" class="hash-link" aria-label="Enlace directo al sesiones--src__tests__sesiones-gestiontesttsx-35-casos" title="Enlace directo al sesiones--src__tests__sesiones-gestiontesttsx-35-casos" translate="no">​</a></h3>
<table><thead><tr><th>Bloque</th><th>Qué fija</th></tr></thead><tbody><tr><td><strong>Mis sesiones</strong></td><td>Espera, error con reintento, métricas (activas, otras y actual), dispositivo legible (navegador · sistema), oficina, IP y fechas</td></tr><tr><td><strong>Cierre propio</strong></td><td>Nunca la sesión actual, cierre individual con su aviso y recarga, cierre masivo con conteo (y «no había otras»), errores</td></tr><tr><td><strong>Administración</strong></td><td>Pestañas ocultas para roles sin permiso, listado con usuario y rol, filtros por usuario/rol/estado, Enter, limpiar y paginación por cursor</td></tr><tr><td><strong>Cierre y limpieza</strong></td><td>Cierre administrativo auditado, liberación de sesiones huérfanas y sus errores</td></tr><tr><td><strong>Política y límites</strong></td><td>Resumen (activas, usuarios, límite global), guardar máximo y política de exceso, límites por rol y por usuario con validaciones, tabla con «∞ (ilimitado)» y baja de límites</td></tr></tbody></table>
<h2 class="anchor anchorTargetStickyNavbar_Vzrq" id="2-defecto-real-corregido">2. Defecto real corregido<a href="https://desobsesor.github.io/blog/2026-11-13-auditoria-y-sesiones-pruebas-unitarias#2-defecto-real-corregido" class="hash-link" aria-label="Enlace directo al 2. Defecto real corregido" title="Enlace directo al 2. Defecto real corregido" translate="no">​</a></h2>
<p><code>SesionesPanel.altaLimite()</code> validaba el id de usuario con <code>Number.isFinite(Number(idUsuario))</code>:
un campo vacío produce <code>0</code> (que es finito), así que el alta se enviaba con <code>idUsuario: 0</code> y el
backend la rechazaba. Ahora el id debe ser mayor que cero antes de guardar, y el formulario avisa
con «Indica el id del usuario del límite.» — <a class="" href="https://desobsesor.github.io/ccf-almacen-web/src/components/security/sesiones-panel.tsx">sesiones-panel.tsx</a>.</p>
<h2 class="anchor anchorTargetStickyNavbar_Vzrq" id="3-patrón-de-las-pruebas">3. Patrón de las pruebas<a href="https://desobsesor.github.io/blog/2026-11-13-auditoria-y-sesiones-pruebas-unitarias#3-patr%C3%B3n-de-las-pruebas" class="hash-link" aria-label="Enlace directo al 3. Patrón de las pruebas" title="Enlace directo al 3. Patrón de las pruebas" translate="no">​</a></h2>
<ul>
<li class="">Se mockean las APIs de auditoría y sesiones, el <code>toast</code> y el <code>AuthContext</code> (con un proveedor y el
rol que cada caso necesita).</li>
<li class="">Las pestañas Radix se activan con <code>mouseDown</code> + <code>click</code>.</li>
<li class="">En Auditoría los números de las tarjetas se eligen únicos en el resumen para poder afirmarlos sin
ambigüedad; el CSV se verifica por su nombre y su contenido.</li>
<li class="">En Sesiones, la sesión actual va con IP distinta a la otra para distinguirlas en la tabla.</li>
</ul>
<h2 class="anchor anchorTargetStickyNavbar_Vzrq" id="4-cómo-verificarlo">4. Cómo verificarlo<a href="https://desobsesor.github.io/blog/2026-11-13-auditoria-y-sesiones-pruebas-unitarias#4-c%C3%B3mo-verificarlo" class="hash-link" aria-label="Enlace directo al 4. Cómo verificarlo" title="Enlace directo al 4. Cómo verificarlo" translate="no">​</a></h2>
<div class="language-bash codeBlockContainer_Ckt0 theme-code-block" style="--prism-color:#393A34;--prism-background-color:#f6f8fa"><div class="codeBlockContent_QJqH"><pre tabindex="0" class="prism-code language-bash codeBlock_bY9V thin-scrollbar" style="color:#393A34;background-color:#f6f8fa"><code class="codeBlockLines_e6Vv"><div class="token-line" style="color:#393A34"><span class="token plain">cd ccf-almacen-web</span><br></div><div class="token-line" style="color:#393A34"><span class="token plain">npx jest src/__tests__/auditoria-accesos-gestion.test.tsx src/__tests__/sesiones-gestion.test.tsx</span><br></div><div class="token-line" style="color:#393A34"><span class="token plain"># Test Suites: 2 passed, 2 total</span><br></div><div class="token-line" style="color:#393A34"><span class="token plain"># Tests:       51 passed, 51 total</span><br></div></code></pre></div></div>
<p><code>npx tsc --noEmit</code> y <code>npx eslint</code> pasan sin errores.</p>
<h2 class="anchor anchorTargetStickyNavbar_Vzrq" id="archivos-clave">Archivos clave<a href="https://desobsesor.github.io/blog/2026-11-13-auditoria-y-sesiones-pruebas-unitarias#archivos-clave" class="hash-link" aria-label="Enlace directo al Archivos clave" title="Enlace directo al Archivos clave" translate="no">​</a></h2>
<ul>
<li class=""><code>ccf-almacen-web/src/__tests__/auditoria-accesos-gestion.test.tsx</code> — suite de auditoría.</li>
<li class=""><code>ccf-almacen-web/src/__tests__/sesiones-gestion.test.tsx</code> — suite de sesiones.</li>
<li class=""><code>ccf-almacen-web/src/components/auditoria/auditoria-accesos.tsx</code>.</li>
<li class=""><code>ccf-almacen-web/src/components/security/sesiones-panel.tsx</code> (con la validación corregida).</li>
</ul>]]></content>
        <author>
            <name>Yovany Suárez Silva</name>
            <uri>https://desobsesor.github.io/portfolio-web/</uri>
        </author>
        <category label="Seguridad" term="Seguridad"/>
        <category label="TEC-008" term="TEC-008"/>
        <category label="TEC-010" term="TEC-010"/>
        <category label="Sesiones" term="Sesiones"/>
        <category label="Frontend" term="Frontend"/>
        <category label="Pruebas frontend" term="Pruebas frontend"/>
    </entry>
    <entry>
        <title type="html"><![CDATA[Cargas masivas e Intercambio — pruebas unitarias de validación y formatos]]></title>
        <id>https://desobsesor.github.io/blog/2026-11-13-cargas-masivas-e-intercambio-pruebas-unitarias</id>
        <link href="https://desobsesor.github.io/blog/2026-11-13-cargas-masivas-e-intercambio-pruebas-unitarias"/>
        <updated>2026-11-13T00:00:00.000Z</updated>
        <summary type="html"><![CDATA[Solicitudes masivas (/cargas-masivas, SOL-006) carga lotes de solicitudes desde Excel/CSV]]></summary>
        <content type="html"><![CDATA[<p><strong>Solicitudes masivas</strong> (<code>/cargas-masivas</code>, SOL-006) carga lotes de solicitudes desde Excel/CSV
y <strong>Importación / Exportación</strong> (<code>/intercambio</code>, TEC-012) intercambia datos en JSON, XML y EDI.
Ahora suman <strong>47 casos</strong> de prueba entre ambas.</p>
<h2 class="anchor anchorTargetStickyNavbar_Vzrq" id="1-qué-se-cubre">1. Qué se cubre<a href="https://desobsesor.github.io/blog/2026-11-13-cargas-masivas-e-intercambio-pruebas-unitarias#1-qu%C3%A9-se-cubre" class="hash-link" aria-label="Enlace directo al 1. Qué se cubre" title="Enlace directo al 1. Qué se cubre" translate="no">​</a></h2>
<h3 class="anchor anchorTargetStickyNavbar_Vzrq" id="solicitudes-masivas--src__tests__cargas-masivas-gestiontesttsx-23-casos">Solicitudes masivas — <code>src/__tests__/cargas-masivas-gestion.test.tsx</code> (23 casos)<a href="https://desobsesor.github.io/blog/2026-11-13-cargas-masivas-e-intercambio-pruebas-unitarias#solicitudes-masivas--src__tests__cargas-masivas-gestiontesttsx-23-casos" class="hash-link" aria-label="Enlace directo al solicitudes-masivas--src__tests__cargas-masivas-gestiontesttsx-23-casos" title="Enlace directo al solicitudes-masivas--src__tests__cargas-masivas-gestiontesttsx-23-casos" translate="no">​</a></h3>
<table><thead><tr><th>Bloque</th><th>Qué fija</th></tr></thead><tbody><tr><td><strong>Historial</strong></td><td>Archivo, estado, total/creadas/errores, proceso de contratación, fecha y «Ver filas»; vacío cuando no hay cargas y tolerancia a fallos del listado</td></tr><tr><td><strong>Archivo</strong></td><td>Acciones bloqueadas sin archivo, nombre y tamaño en KB al elegirlo, refresco del historial</td></tr><tr><td><strong>Validación previa</strong></td><td>Dry-run con <code>validarArchivoCarga</code>, resumen <code>válidas/total</code>, aviso de filas con error y tabla de errores por fila; error del servidor y bloqueo mientras valida</td></tr><tr><td><strong>Procesamiento</strong></td><td>Carga completada y parcial con su mensaje, proceso de contratación recortado (o indefinido), apertura del detalle, error del servidor</td></tr><tr><td><strong>Detalle y errores</strong></td><td>Resumen por fila (solicitud creada o mensaje de error), descarga de errores solo cuando hay filas fallidas, error al cargar el detalle</td></tr><tr><td><strong>Plantilla y tour</strong></td><td>Descarga de la plantilla oficial con su error; recorrido guiado disponible o no</td></tr></tbody></table>
<h3 class="anchor anchorTargetStickyNavbar_Vzrq" id="intercambio--src__tests__intercambio-gestiontesttsx-24-casos">Intercambio — <code>src/__tests__/intercambio-gestion.test.tsx</code> (24 casos)<a href="https://desobsesor.github.io/blog/2026-11-13-cargas-masivas-e-intercambio-pruebas-unitarias#intercambio--src__tests__intercambio-gestiontesttsx-24-casos" class="hash-link" aria-label="Enlace directo al intercambio--src__tests__intercambio-gestiontesttsx-24-casos" title="Enlace directo al intercambio--src__tests__intercambio-gestiontesttsx-24-casos" translate="no">​</a></h3>
<table><thead><tr><th>Bloque</th><th>Qué fija</th></tr></thead><tbody><tr><td><strong>Carga</strong></td><td>Espera del catálogo, error con reintento y las tres secciones con recursos y formatos del backend</td></tr><tr><td><strong>Importación</strong></td><td>Plantilla por recurso/formato, aviso sin archivo, validación con y sin errores por registro, error de validación y estado «Validando…»</td></tr><tr><td><strong>Procesamiento</strong></td><td>Importación completada o parcial con su mensaje, recarga del historial, descarga de errores de la importación y error del servidor</td></tr><tr><td><strong>Exportación</strong></td><td>Inventario con almacén y «solo bajo mínimo», movimientos con tipo, sin tipo, error y estado «Generando…»</td></tr><tr><td><strong>Historial</strong></td><td>Fila con recurso, formato, resultado <code>n/m</code>, estado y acción de errores; sin archivo ni fallidos; vacío; filtro por estado; paginación por cursor; descarga de errores; error del listado</td></tr></tbody></table>
<h2 class="anchor anchorTargetStickyNavbar_Vzrq" id="2-patrón-de-las-pruebas">2. Patrón de las pruebas<a href="https://desobsesor.github.io/blog/2026-11-13-cargas-masivas-e-intercambio-pruebas-unitarias#2-patr%C3%B3n-de-las-pruebas" class="hash-link" aria-label="Enlace directo al 2. Patrón de las pruebas" title="Enlace directo al 2. Patrón de las pruebas" translate="no">​</a></h2>
<ul>
<li class="">Se mockean las funciones de <code>api/cargas-masivas</code> y <code>api/intercambio</code>, el <code>toast</code> de <code>sonner</code> y el
contexto de tour; el resto de la pantalla se monta real.</li>
<li class="">Los archivos se simulan con <code>File</code> y <code>fireEvent.change</code> sobre el <code>input[type=file]</code>.</li>
<li class="">Hay dos etiquetas «Recurso» y «Formato» en Intercambio (importar y exportar): se distinguen por
posición con <code>getAllByLabelText(...)[0|1]</code>.</li>
<li class="">El detalle de una carga y el historial se comprueban con <code>within(fila)</code> para no confundir textos
repetidos entre tarjetas y tablas.</li>
</ul>
<h2 class="anchor anchorTargetStickyNavbar_Vzrq" id="3-cómo-verificarlo">3. Cómo verificarlo<a href="https://desobsesor.github.io/blog/2026-11-13-cargas-masivas-e-intercambio-pruebas-unitarias#3-c%C3%B3mo-verificarlo" class="hash-link" aria-label="Enlace directo al 3. Cómo verificarlo" title="Enlace directo al 3. Cómo verificarlo" translate="no">​</a></h2>
<div class="language-bash codeBlockContainer_Ckt0 theme-code-block" style="--prism-color:#393A34;--prism-background-color:#f6f8fa"><div class="codeBlockContent_QJqH"><pre tabindex="0" class="prism-code language-bash codeBlock_bY9V thin-scrollbar" style="color:#393A34;background-color:#f6f8fa"><code class="codeBlockLines_e6Vv"><div class="token-line" style="color:#393A34"><span class="token plain">cd ccf-almacen-web</span><br></div><div class="token-line" style="color:#393A34"><span class="token plain">npx jest src/__tests__/cargas-masivas-gestion.test.tsx src/__tests__/intercambio-gestion.test.tsx</span><br></div><div class="token-line" style="color:#393A34"><span class="token plain"># Test Suites: 2 passed, 2 total</span><br></div><div class="token-line" style="color:#393A34"><span class="token plain"># Tests:       47 passed, 47 total</span><br></div></code></pre></div></div>
<p><code>npx tsc --noEmit</code> y <code>npx eslint</code> pasan sin errores.</p>
<h2 class="anchor anchorTargetStickyNavbar_Vzrq" id="archivos-clave">Archivos clave<a href="https://desobsesor.github.io/blog/2026-11-13-cargas-masivas-e-intercambio-pruebas-unitarias#archivos-clave" class="hash-link" aria-label="Enlace directo al Archivos clave" title="Enlace directo al Archivos clave" translate="no">​</a></h2>
<ul>
<li class=""><code>ccf-almacen-web/src/__tests__/cargas-masivas-gestion.test.tsx</code> — suite de solicitudes masivas.</li>
<li class=""><code>ccf-almacen-web/src/__tests__/intercambio-gestion.test.tsx</code> — suite de importación/exportación.</li>
<li class=""><code>ccf-almacen-web/src/pages/cargas-masivas.tsx</code>.</li>
<li class=""><code>ccf-almacen-web/src/components/intercambio/intercambio-dashboard.tsx</code>.</li>
<li class=""><code>ccf-almacen-web/src/api/cargas-masivas.ts</code> y <code>src/api/intercambio.ts</code> — contratos mockeados.</li>
</ul>]]></content>
        <author>
            <name>Yovany Suárez Silva</name>
            <uri>https://desobsesor.github.io/portfolio-web/</uri>
        </author>
        <category label="Solicitudes" term="Solicitudes"/>
        <category label="Importación" term="Importación"/>
        <category label="Exportación" term="Exportación"/>
        <category label="TEC-012" term="TEC-012"/>
        <category label="Frontend" term="Frontend"/>
        <category label="Pruebas frontend" term="Pruebas frontend"/>
    </entry>
    <entry>
        <title type="html"><![CDATA[Firma electrónica y Rate limiting — pruebas unitarias de actas y excesos]]></title>
        <id>https://desobsesor.github.io/blog/2026-11-13-firmas-y-rate-limit-pruebas-unitarias</id>
        <link href="https://desobsesor.github.io/blog/2026-11-13-firmas-y-rate-limit-pruebas-unitarias"/>
        <updated>2026-11-13T00:00:00.000Z</updated>
        <summary type="html"><![CDATA[Firma electrónica (/firmas, TEC-014) conserva las actas firmadas como evidencia y]]></summary>
        <content type="html"><![CDATA[<p><strong>Firma electrónica</strong> (<code>/firmas</code>, TEC-014) conserva las actas firmadas como evidencia y
<strong>Rate limiting</strong> (<code>/rate-limit</code>, TEC-005) audita los excesos de límite de tasa. Ahora suman
<strong>35 casos</strong> de prueba.</p>
<h2 class="anchor anchorTargetStickyNavbar_Vzrq" id="1-qué-se-cubre">1. Qué se cubre<a href="https://desobsesor.github.io/blog/2026-11-13-firmas-y-rate-limit-pruebas-unitarias#1-qu%C3%A9-se-cubre" class="hash-link" aria-label="Enlace directo al 1. Qué se cubre" title="Enlace directo al 1. Qué se cubre" translate="no">​</a></h2>
<h3 class="anchor anchorTargetStickyNavbar_Vzrq" id="firma-electrónica--src__tests__firmas-gestiontesttsx-22-casos">Firma electrónica — <code>src/__tests__/firmas-gestion.test.tsx</code> (22 casos)<a href="https://desobsesor.github.io/blog/2026-11-13-firmas-y-rate-limit-pruebas-unitarias#firma-electr%C3%B3nica--src__tests__firmas-gestiontesttsx-22-casos" class="hash-link" aria-label="Enlace directo al firma-electrónica--src__tests__firmas-gestiontesttsx-22-casos" title="Enlace directo al firma-electrónica--src__tests__firmas-gestiontesttsx-22-casos" translate="no">​</a></h3>
<table><thead><tr><th>Bloque</th><th>Qué fija</th></tr></thead><tbody><tr><td><strong>Historial</strong></td><td>Espera, error del servidor, vacío, tipo/origen/estado/firmas por fila y guion cuando falta el origen</td></tr><tr><td><strong>Acciones por estado</strong></td><td>Firmar solo si faltan firmas (pendiente/parcial), PDF solo si está firmado y ninguna acción en anuladas</td></tr><tr><td><strong>Filtros y paginación</strong></td><td>Tipo y estado con reinicio a página 1, paginación en servidor y recarga</td></tr><tr><td><strong>Detalle</strong></td><td>Metadatos (almacén, oficina, proveedor), hash SHA-256, motivo de anulación, líneas con «Entregado»/«Recibido OK», firmantes con documento/método fecha y «Sin firmas registradas»</td></tr><tr><td><strong>Firma y descarga</strong></td><td>Apertura del diálogo de firma desde la fila y desde el detalle; descarga del PDF y error con el mensaje del servidor</td></tr><tr><td><strong>Verificación</strong></td><td>Botón deshabilitado sin código, consulta con el código recortado, documento auténtico, documento incompleto, estado «Verificando…» y código inexistente</td></tr></tbody></table>
<h3 class="anchor anchorTargetStickyNavbar_Vzrq" id="rate-limiting--src__tests__rate-limit-gestiontesttsx-13-casos">Rate limiting — <code>src/__tests__/rate-limit-gestion.test.tsx</code> (13 casos)<a href="https://desobsesor.github.io/blog/2026-11-13-firmas-y-rate-limit-pruebas-unitarias#rate-limiting--src__tests__rate-limit-gestiontesttsx-13-casos" class="hash-link" aria-label="Enlace directo al rate-limiting--src__tests__rate-limit-gestiontesttsx-13-casos" title="Enlace directo al rate-limiting--src__tests__rate-limit-gestiontesttsx-13-casos" translate="no">​</a></h3>
<table><thead><tr><th>Bloque</th><th>Qué fija</th></tr></thead><tbody><tr><td><strong>Panel</strong></td><td>Espera, error con reintento, excesos del período, ventana en segundos y límite anónimo; límites por rol</td></tr><tr><td><strong>Rankings</strong></td><td>Rutas más afectadas, IPs más frecuentes y por día con su total, y el aviso cuando no hay eventos</td></tr><tr><td><strong>Eventos</strong></td><td>Método, ruta, IP, rol y límite/ventana parseados del JSON; tolerancia a <code>detalles</code> malformados y a IP ausente; vacío</td></tr><tr><td><strong>Filtros y paginación</strong></td><td>Filtros por ruta e IP (recortados), limpieza y paginación por cursor con «Cargar más»; refresco completo</td></tr></tbody></table>
<h2 class="anchor anchorTargetStickyNavbar_Vzrq" id="2-patrón-de-las-pruebas">2. Patrón de las pruebas<a href="https://desobsesor.github.io/blog/2026-11-13-firmas-y-rate-limit-pruebas-unitarias#2-patr%C3%B3n-de-las-pruebas" class="hash-link" aria-label="Enlace directo al 2. Patrón de las pruebas" title="Enlace directo al 2. Patrón de las pruebas" translate="no">​</a></h2>
<ul>
<li class="">Se mockean los hooks de firmas / las funciones de <code>api/rate-limit</code>, el <code>toast</code> y el contexto de
tour; el diálogo de firma se sustituye por un doble que muestra el documento recibido.</li>
<li class="">En Firma electrónica la sección de verificación se identifica por su <code>region</code> accesible
(<code>aria-labelledby</code>), lo que evita confundir el número de acta con el de la tabla.</li>
<li class="">En Rate limiting los rankings y la tabla comparten ruta e IP: se comprueban con <code>getAllByText</code>
o acotando la fila por el límite (<code>30/60 s</code>).</li>
</ul>
<h2 class="anchor anchorTargetStickyNavbar_Vzrq" id="3-cómo-verificarlo">3. Cómo verificarlo<a href="https://desobsesor.github.io/blog/2026-11-13-firmas-y-rate-limit-pruebas-unitarias#3-c%C3%B3mo-verificarlo" class="hash-link" aria-label="Enlace directo al 3. Cómo verificarlo" title="Enlace directo al 3. Cómo verificarlo" translate="no">​</a></h2>
<div class="language-bash codeBlockContainer_Ckt0 theme-code-block" style="--prism-color:#393A34;--prism-background-color:#f6f8fa"><div class="codeBlockContent_QJqH"><pre tabindex="0" class="prism-code language-bash codeBlock_bY9V thin-scrollbar" style="color:#393A34;background-color:#f6f8fa"><code class="codeBlockLines_e6Vv"><div class="token-line" style="color:#393A34"><span class="token plain">cd ccf-almacen-web</span><br></div><div class="token-line" style="color:#393A34"><span class="token plain">npx jest src/__tests__/firmas-gestion.test.tsx src/__tests__/rate-limit-gestion.test.tsx</span><br></div><div class="token-line" style="color:#393A34"><span class="token plain"># Test Suites: 2 passed, 2 total</span><br></div><div class="token-line" style="color:#393A34"><span class="token plain"># Tests:       35 passed, 35 total</span><br></div></code></pre></div></div>
<p><code>npx tsc --noEmit</code> y <code>npx eslint</code> pasan sin errores.</p>
<h2 class="anchor anchorTargetStickyNavbar_Vzrq" id="archivos-clave">Archivos clave<a href="https://desobsesor.github.io/blog/2026-11-13-firmas-y-rate-limit-pruebas-unitarias#archivos-clave" class="hash-link" aria-label="Enlace directo al Archivos clave" title="Enlace directo al Archivos clave" translate="no">​</a></h2>
<ul>
<li class=""><code>ccf-almacen-web/src/__tests__/firmas-gestion.test.tsx</code> — suite de actas firmadas.</li>
<li class=""><code>ccf-almacen-web/src/__tests__/rate-limit-gestion.test.tsx</code> — suite del monitor de límites.</li>
<li class=""><code>ccf-almacen-web/src/pages/firmas.tsx</code> y <code>src/components/security/rate-limit-monitor.tsx</code>.</li>
<li class=""><code>ccf-almacen-web/src/api/firmas.ts</code> y <code>src/models/rate-limit.entity.ts</code> — contratos bajo prueba.</li>
</ul>]]></content>
        <author>
            <name>Yovany Suárez Silva</name>
            <uri>https://desobsesor.github.io/portfolio-web/</uri>
        </author>
        <category label="TEC-014" term="TEC-014"/>
        <category label="TEC-005" term="TEC-005"/>
        <category label="Seguridad" term="Seguridad"/>
        <category label="Frontend" term="Frontend"/>
        <category label="Pruebas frontend" term="Pruebas frontend"/>
    </entry>
    <entry>
        <title type="html"><![CDATA[Informe de cobertura — pruebas unitarias de ccf-almacen-web]]></title>
        <id>https://desobsesor.github.io/blog/2026-11-13-informe-cobertura-web</id>
        <link href="https://desobsesor.github.io/blog/2026-11-13-informe-cobertura-web"/>
        <updated>2026-11-13T00:00:00.000Z</updated>
        <summary type="html"><![CDATA[Cerrar el mapa de pantallas era la condición para medir. Hoy las 77 páginas del dashboard]]></summary>
        <content type="html"><![CDATA[<p>Cerrar el mapa de pantallas era la condición para medir. Hoy las <strong>77 páginas</strong> del dashboard
tienen prueba directa (49) o la reciben a través de sus componentes (28), y la suite completa
suma <strong>221 archivos y 2 659 casos en verde</strong>. Este informe fija el número real de cobertura, dice
dónde está la deuda y qué se corrigió al probar.</p>
<h2 class="anchor anchorTargetStickyNavbar_Vzrq" id="1-resultado-global">1. Resultado global<a href="https://desobsesor.github.io/blog/2026-11-13-informe-cobertura-web#1-resultado-global" class="hash-link" aria-label="Enlace directo al 1. Resultado global" title="Enlace directo al 1. Resultado global" translate="no">​</a></h2>
<p>Medición con <code>npx jest --coverage --maxWorkers=2</code> sobre el árbol completo de <code>ccf-almacen-web</code>:</p>
<table><thead><tr><th>Métrica</th><th style="text-align:right">Cubierto</th><th style="text-align:right">Total</th><th style="text-align:right">Porcentaje</th></tr></thead><tbody><tr><td>Sentencias</td><td style="text-align:right">20 754</td><td style="text-align:right">27 474</td><td style="text-align:right"><strong>75,54 %</strong></td></tr><tr><td>Ramas</td><td style="text-align:right">10 087</td><td style="text-align:right">16 203</td><td style="text-align:right"><strong>62,25 %</strong></td></tr><tr><td>Funciones</td><td style="text-align:right">4 508</td><td style="text-align:right">6 337</td><td style="text-align:right"><strong>71,13 %</strong></td></tr><tr><td>Líneas</td><td style="text-align:right">19 358</td><td style="text-align:right">24 965</td><td style="text-align:right"><strong>77,54 %</strong></td></tr></tbody></table>
<p>Y la suite que produce esos números:</p>
<table><thead><tr><th>Bloque</th><th style="text-align:right">Archivos</th><th style="text-align:right">Casos</th></tr></thead><tbody><tr><td>Módulos (<code>src/__tests__/*-gestion.test.tsx</code>)</td><td style="text-align:right">44</td><td style="text-align:right">1 031</td></tr><tr><td>Componentes (<code>src/components/**/__tests__</code>)</td><td style="text-align:right">123</td><td style="text-align:right">1 079</td></tr><tr><td>Base: configuración, utilidades, hooks, contratos</td><td style="text-align:right">34</td><td style="text-align:right">278</td></tr><tr><td><strong>Total</strong></td><td style="text-align:right"><strong>221</strong></td><td style="text-align:right"><strong>2 659</strong></td></tr></tbody></table>
<p>No hay suites fallidas ni casos omitidos por error. El único ruido en la salida es el aviso
esperado de una pantalla que cae a datos de ejemplo cuando el API no responde.</p>
<h2 class="anchor anchorTargetStickyNavbar_Vzrq" id="2-mapa-de-la-suite-por-módulo">2. Mapa de la suite por módulo<a href="https://desobsesor.github.io/blog/2026-11-13-informe-cobertura-web#2-mapa-de-la-suite-por-m%C3%B3dulo" class="hash-link" aria-label="Enlace directo al 2. Mapa de la suite por módulo" title="Enlace directo al 2. Mapa de la suite por módulo" translate="no">​</a></h2>
<p>Los 44 archivos <code>*-gestion.test.tsx</code> son la capa de módulo: montan la pantalla real y mockean solo
las fronteras (funciones de <code>api/*</code>, hooks de React Query, <code>sonner</code>, tour guiado y el armazón de
autenticación).</p>
<table><thead><tr><th>Módulo</th><th style="text-align:right">Casos</th><th>Módulo</th><th style="text-align:right">Casos</th></tr></thead><tbody><tr><td>Ubicaciones</td><td style="text-align:right">40</td><td>Órdenes de compra</td><td style="text-align:right">24</td></tr><tr><td>Almacenes</td><td style="text-align:right">36</td><td>Análisis de consumo</td><td style="text-align:right">23</td></tr><tr><td>Tickets</td><td style="text-align:right">35</td><td>Carga masiva</td><td style="text-align:right">23</td></tr><tr><td>Sesiones</td><td style="text-align:right">35</td><td>Administración del menú</td><td style="text-align:right">23</td></tr><tr><td>Áreas</td><td style="text-align:right">33</td><td>Firmas</td><td style="text-align:right">22</td></tr><tr><td>Inventario</td><td style="text-align:right">32</td><td>Presupuestos</td><td style="text-align:right">21</td></tr><tr><td>Transferencias</td><td style="text-align:right">32</td><td>Gestión de IPs</td><td style="text-align:right">21</td></tr><tr><td>Plantillas de solicitud</td><td style="text-align:right">31</td><td>Ideas y novedades</td><td style="text-align:right">21</td></tr><tr><td>Lotes y series</td><td style="text-align:right">30</td><td>Personalización</td><td style="text-align:right">20</td></tr><tr><td>Conteos</td><td style="text-align:right">30</td><td>Clasificación ABC</td><td style="text-align:right">20</td></tr><tr><td>Solicitudes</td><td style="text-align:right">29</td><td>Alertas de stock</td><td style="text-align:right">19</td></tr><tr><td>Alertas inteligentes</td><td style="text-align:right">29</td><td>KPIs de gestión</td><td style="text-align:right">19</td></tr><tr><td>Recepciones</td><td style="text-align:right">28</td><td>Proveedores</td><td style="text-align:right">19</td></tr><tr><td>Demanda predictiva</td><td style="text-align:right">27</td><td>Trabajos</td><td style="text-align:right">19</td></tr><tr><td>Devoluciones</td><td style="text-align:right">25</td><td>Auditoría de accesos</td><td style="text-align:right">16</td></tr><tr><td>Obsolescencia</td><td style="text-align:right">25</td><td>Seguridad 2FA</td><td style="text-align:right">15</td></tr><tr><td>Reorden</td><td style="text-align:right">24</td><td>Rate limit</td><td style="text-align:right">13</td></tr><tr><td>Intercambio EDI/XML/JSON</td><td style="text-align:right">24</td><td>Jobs (complemento)</td><td style="text-align:right">12</td></tr><tr><td>Webhooks</td><td style="text-align:right">24</td><td>Políticas de contraseña</td><td style="text-align:right">12</td></tr><tr><td>Ventas del POS</td><td style="text-align:right">28</td><td>Cajas y turnos</td><td style="text-align:right">24</td></tr><tr><td>Reportes del POS</td><td style="text-align:right">22</td><td>Movimientos del POS</td><td style="text-align:right">19</td></tr><tr><td>Pantallas de error</td><td style="text-align:right">6</td><td>Acerca de</td><td style="text-align:right">1</td></tr></tbody></table>
<p>Según el módulo, cada suite recorre el CRUD completo, los filtros y la paginación, los estados de
carga, vacío y error con reintento, las confirmaciones destructivas, la visibilidad por rol y
—cuando existe— el tour guiado.</p>
<h2 class="anchor anchorTargetStickyNavbar_Vzrq" id="3-cobertura-por-capa">3. Cobertura por capa<a href="https://desobsesor.github.io/blog/2026-11-13-informe-cobertura-web#3-cobertura-por-capa" class="hash-link" aria-label="Enlace directo al 3. Cobertura por capa" title="Enlace directo al 3. Cobertura por capa" translate="no">​</a></h2>
<p>Suma ponderada por archivo (no promedio de porcentajes), para que un archivo diminuto no pese
igual que uno grande:</p>
<table><thead><tr><th>Capa</th><th style="text-align:right">Archivos</th><th style="text-align:right">Sentencias</th><th style="text-align:right">Ramas</th><th style="text-align:right">Funciones</th><th style="text-align:right">Líneas</th></tr></thead><tbody><tr><td><code>src/components</code></td><td style="text-align:right">183</td><td style="text-align:right">76,1 %</td><td style="text-align:right">60,5 %</td><td style="text-align:right">75,0 %</td><td style="text-align:right">77,7 %</td></tr><tr><td><code>src/pages</code></td><td style="text-align:right">49</td><td style="text-align:right">86,2 %</td><td style="text-align:right">73,0 %</td><td style="text-align:right">80,9 %</td><td style="text-align:right">87,8 %</td></tr><tr><td><code>src/config</code></td><td style="text-align:right">7</td><td style="text-align:right">91,2 %</td><td style="text-align:right">83,7 %</td><td style="text-align:right">39,4 %</td><td style="text-align:right">92,3 %</td></tr><tr><td><code>src/utils</code></td><td style="text-align:right">24</td><td style="text-align:right">81,9 %</td><td style="text-align:right">73,2 %</td><td style="text-align:right">87,7 %</td><td style="text-align:right">83,6 %</td></tr><tr><td><code>src/registry</code> (shadcn/ui)</td><td style="text-align:right">29</td><td style="text-align:right">84,8 %</td><td style="text-align:right">53,8 %</td><td style="text-align:right">53,8 %</td><td style="text-align:right">87,0 %</td></tr><tr><td><code>src/lib</code></td><td style="text-align:right">5</td><td style="text-align:right">82,8 %</td><td style="text-align:right">76,3 %</td><td style="text-align:right">75,0 %</td><td style="text-align:right">87,4 %</td></tr><tr><td><code>src/models</code></td><td style="text-align:right">26</td><td style="text-align:right">74,0 %</td><td style="text-align:right">57,8 %</td><td style="text-align:right">56,8 %</td><td style="text-align:right">71,9 %</td></tr><tr><td><code>src/services</code></td><td style="text-align:right">13</td><td style="text-align:right">70,4 %</td><td style="text-align:right">50,0 %</td><td style="text-align:right">63,6 %</td><td style="text-align:right">73,5 %</td></tr><tr><td><code>src/hooks</code></td><td style="text-align:right">13</td><td style="text-align:right">65,4 %</td><td style="text-align:right">48,3 %</td><td style="text-align:right">54,8 %</td><td style="text-align:right">67,1 %</td></tr><tr><td><code>src/api</code></td><td style="text-align:right">27</td><td style="text-align:right">33,2 %</td><td style="text-align:right">28,8 %</td><td style="text-align:right">18,6 %</td><td style="text-align:right">36,2 %</td></tr><tr><td><code>scripts</code> / <code>deploy</code></td><td style="text-align:right">2</td><td style="text-align:right">61,0 %</td><td style="text-align:right">30,3 %</td><td style="text-align:right">64,3 %</td><td style="text-align:right">61,0 %</td></tr></tbody></table>
<p>Las páginas y los componentes están por encima del 75 % de líneas; las funciones quedan algo más
bajas porque los manejadores de eventos cortos (<code>onOpenChange</code>, <code>onValueChange</code>) solo se ejecutan
cuando la interacción exacta ocurre.</p>
<p>Por familia funcional (agrupando por nombre de archivo):</p>
<table><thead><tr><th>Familia</th><th style="text-align:right">Archivos</th><th style="text-align:right">Sentencias</th><th style="text-align:right">Líneas</th></tr></thead><tbody><tr><td>Veterinaria (<code>vete_*</code> / <code>veterinaria</code>)</td><td style="text-align:right">23</td><td style="text-align:right"><strong>96,0 %</strong></td><td style="text-align:right"><strong>97,0 %</strong></td></tr><tr><td>Solicitudes, cargas, plantillas, aprobaciones, presupuestos</td><td style="text-align:right">14</td><td style="text-align:right">82,9 %</td><td style="text-align:right">84,9 %</td></tr><tr><td>Seguridad, sesiones, auditoría, contraseñas</td><td style="text-align:right">16</td><td style="text-align:right">79,0 %</td><td style="text-align:right">82,0 %</td></tr><tr><td>Inventario, productos, lotes, stock</td><td style="text-align:right">45</td><td style="text-align:right">77,3 %</td><td style="text-align:right">79,3 %</td></tr><tr><td>POS — componentes</td><td style="text-align:right">4</td><td style="text-align:right">83,3 %</td><td style="text-align:right">90,5 %</td></tr><tr><td>Tablero</td><td style="text-align:right">6</td><td style="text-align:right">72,8 %</td><td style="text-align:right">73,5 %</td></tr><tr><td>POS — pantallas</td><td style="text-align:right">5</td><td style="text-align:right">82,8 %</td><td style="text-align:right">84,8 %</td></tr><tr><td>Sala de continuidad (<code>offline</code>)</td><td style="text-align:right">1</td><td style="text-align:right">58,3 %</td><td style="text-align:right">62,9 %</td></tr><tr><td>Empresa</td><td style="text-align:right">2</td><td style="text-align:right">49,5 %</td><td style="text-align:right">50,5 %</td></tr></tbody></table>
<h2 class="anchor anchorTargetStickyNavbar_Vzrq" id="4-dónde-está-la-deuda">4. Dónde está la deuda<a href="https://desobsesor.github.io/blog/2026-11-13-informe-cobertura-web#4-d%C3%B3nde-est%C3%A1-la-deuda" class="hash-link" aria-label="Enlace directo al 4. Dónde está la deuda" title="Enlace directo al 4. Dónde está la deuda" translate="no">​</a></h2>
<h3 class="anchor anchorTargetStickyNavbar_Vzrq" id="41-pantallas-con-menor-cobertura-de-líneas">4.1 Pantallas con menor cobertura de líneas<a href="https://desobsesor.github.io/blog/2026-11-13-informe-cobertura-web#41-pantallas-con-menor-cobertura-de-l%C3%ADneas" class="hash-link" aria-label="Enlace directo al 4.1 Pantallas con menor cobertura de líneas" title="Enlace directo al 4.1 Pantallas con menor cobertura de líneas" translate="no">​</a></h3>
<table><thead><tr><th>Pantalla</th><th style="text-align:right">Sentencias</th><th style="text-align:right">Líneas</th><th>Por qué</th></tr></thead><tbody><tr><td><code>empresa.tsx</code></td><td style="text-align:right">45,5 %</td><td style="text-align:right">46,8 %</td><td>Subida de logos y datos institucionales</td></tr><tr><td><code>offline.tsx</code></td><td style="text-align:right">58,3 %</td><td style="text-align:right">62,9 %</td><td>Bucle de reconexión con retroceso exponencial</td></tr><tr><td><code>tablero.tsx</code></td><td style="text-align:right">70,5 %</td><td style="text-align:right">70,6 %</td><td>Widgets configurables y sus estados</td></tr><tr><td><code>login-form.tsx</code></td><td style="text-align:right">74,7 %</td><td style="text-align:right">74,3 %</td><td>Errores de credenciales y bloqueo</td></tr><tr><td><code>inventory-movements.tsx</code></td><td style="text-align:right">75,9 %</td><td style="text-align:right">81,2 %</td><td>Estadísticas y exportación CSV</td></tr><tr><td><code>pos.tsx</code></td><td style="text-align:right">79,7 %</td><td style="text-align:right">81,5 %</td><td>Carrito, lote/serie y cobro</td></tr><tr><td><code>stock-alerts.tsx</code></td><td style="text-align:right">82,2 %</td><td style="text-align:right">82,1 %</td><td>Ramas de orden y paginación</td></tr><tr><td><code>solicitudes/page.tsx</code></td><td style="text-align:right">86,4 %</td><td style="text-align:right">88,4 %</td><td>Despacho y aprobación multinivel</td></tr><tr><td><code>firmas.tsx</code></td><td style="text-align:right">87,0 %</td><td style="text-align:right">89,0 %</td><td>Evidencia firmada (TEC-014)</td></tr></tbody></table>
<h3 class="anchor anchorTargetStickyNavbar_Vzrq" id="42-componentes-con-menor-cobertura">4.2 Componentes con menor cobertura<a href="https://desobsesor.github.io/blog/2026-11-13-informe-cobertura-web#42-componentes-con-menor-cobertura" class="hash-link" aria-label="Enlace directo al 4.2 Componentes con menor cobertura" title="Enlace directo al 4.2 Componentes con menor cobertura" translate="no">​</a></h3>
<table><thead><tr><th>Componente</th><th style="text-align:right">Sentencias</th><th style="text-align:right">Líneas</th><th>Riesgo</th></tr></thead><tbody><tr><td><code>requests/request-detail-standalone.tsx</code></td><td style="text-align:right">9,1 %</td><td style="text-align:right">10,0 %</td><td>Detalle de solicitud fuera del armazón</td></tr><tr><td><code>almacenes/horario-panel.tsx</code></td><td style="text-align:right">17,0 %</td><td style="text-align:right">19,6 %</td><td>Ventanas horarias por almacén</td></tr><tr><td><code>devoluciones/devolucion-desde-solicitud.tsx</code></td><td style="text-align:right">17,2 %</td><td style="text-align:right">18,6 %</td><td>Alta de devolución desde una solicitud</td></tr><tr><td><code>requests/approval-timeline.tsx</code></td><td style="text-align:right">17,6 %</td><td style="text-align:right">18,8 %</td><td>Cadena multinivel (SOL-002)</td></tr><tr><td><code>general-dashboard/profile.tsx</code></td><td style="text-align:right">19,7 %</td><td style="text-align:right">20,2 %</td><td>Perfil del usuario</td></tr><tr><td><code>reports/warehouse-reports.tsx</code></td><td style="text-align:right">21,7 %</td><td style="text-align:right">23,2 %</td><td>Reportes de almacén</td></tr><tr><td><code>firmas/signature-pad.tsx</code></td><td style="text-align:right">28,2 %</td><td style="text-align:right">28,2 %</td><td>Evidencia legal (TEC-014)</td></tr><tr><td><code>upload/product-image-upload.tsx</code></td><td style="text-align:right">30,6 %</td><td style="text-align:right">32,6 %</td><td>Imagen de producto</td></tr><tr><td><code>devoluciones/devoluciones-historial.tsx</code></td><td style="text-align:right">42,9 %</td><td style="text-align:right">47,4 %</td><td>Historial de devoluciones</td></tr><tr><td><code>notification/panel-notificaciones.tsx</code></td><td style="text-align:right">56,0 %</td><td style="text-align:right">56,9 %</td><td>Centro de notificaciones (UX-004)</td></tr></tbody></table>
<h3 class="anchor anchorTargetStickyNavbar_Vzrq" id="43-hooks">4.3 Hooks<a href="https://desobsesor.github.io/blog/2026-11-13-informe-cobertura-web#43-hooks" class="hash-link" aria-label="Enlace directo al 4.3 Hooks" title="Enlace directo al 4.3 Hooks" translate="no">​</a></h3>
<table><thead><tr><th>Hook</th><th style="text-align:right">Sentencias</th></tr></thead><tbody><tr><td><code>use-firmas</code></td><td style="text-align:right">8,1 %</td></tr><tr><td><code>use-enhanced-toast</code></td><td style="text-align:right">8,6 %</td></tr><tr><td><code>use-devoluciones</code></td><td style="text-align:right">13,6 %</td></tr><tr><td><code>use-retroalimentacion</code></td><td style="text-align:right">19,0 %</td></tr><tr><td><code>use-tickets</code></td><td style="text-align:right">72,5 %</td></tr></tbody></table>
<h2 class="anchor anchorTargetStickyNavbar_Vzrq" id="5-defectos-reales-corregidos-al-probar">5. Defectos reales corregidos al probar<a href="https://desobsesor.github.io/blog/2026-11-13-informe-cobertura-web#5-defectos-reales-corregidos-al-probar" class="hash-link" aria-label="Enlace directo al 5. Defectos reales corregidos al probar" title="Enlace directo al 5. Defectos reales corregidos al probar" translate="no">​</a></h2>
<p>Probar encontró cuatro defectos que no eran de las pruebas:</p>
<ol>
<li class=""><strong><code>urlEvidencia()</code> rompía fuera de <code>development</code>/<code>production</code>.</strong> El mapa de configuración no
declara otros entornos, así que con cualquier <code>NODE_ENV</code> distinto la entrada era <code>undefined</code> y
el detalle de un ticket con evidencias lanzaba <code>Cannot read properties of undefined (reading 'apiDashboard')</code>. Ahora cae a <code>config.development</code>. Archivo:
<code>src/components/tickets/ticket-catalogos.ts</code>.</li>
<li class=""><strong><code>altaLimite</code> enviaba <code>idUsuario: 0</code>.</strong> En <code>sesiones-panel.tsx</code>, el límite por usuario se
podía crear sin usuario seleccionado porque la validación solo miraba el número de sesiones.
Ahora exige <code>idUsuario &gt; 0</code>. Archivo: <code>src/components/security/sesiones-panel.tsx</code>.</li>
<li class=""><strong>Las plantillas de solicitud guardaban espacios sobrantes.</strong> El payload viajaba con el nombre
y el propósito sin recortar, lo que permitía duplicados visualmente idénticos. Se aplica <code>trim</code>
antes de enviar. Archivo: <code>src/pages/plantillas-solicitud.tsx</code>.</li>
<li class=""><strong>La grid avisaba del cambio de orden durante el render.</strong> <code>DataGrid.cambiarOrden()</code> llamaba a
<code>onCambioOrden</code> dentro del actualizador de <code>setOrden</code>, es decir, actualizaba el estado del padre
mientras el grid se renderizaba: React lo denuncia («Cannot update a component while rendering a
different component») y en <code>StrictMode</code> la consulta se dispara dos veces. Ahora el orden se
calcula con el estado vigente y se avisa después de <code>setOrden</code>. Archivo:
<code>src/components/common/data-grid.tsx</code>.</li>
</ol>
<h2 class="anchor anchorTargetStickyNavbar_Vzrq" id="6-límites-de-esta-medición">6. Límites de esta medición<a href="https://desobsesor.github.io/blog/2026-11-13-informe-cobertura-web#6-l%C3%ADmites-de-esta-medici%C3%B3n" class="hash-link" aria-label="Enlace directo al 6. Límites de esta medición" title="Enlace directo al 6. Límites de esta medición" translate="no">​</a></h2>
<ul>
<li class=""><strong><code>src/api</code> está mockeada por diseño</strong> (36,2 % de líneas). Esto no mide el contrato HTTP: que la
API responda lo que el cliente espera es responsabilidad de las pruebas del backend y de una
capa de contrato que hoy no existe.</li>
<li class=""><strong><code>src/registry</code> (shadcn/ui)</strong> mide 87,0 % de líneas, pero sus funciones quedan en 53,8 %: son
primitivas de Radix cuyos <em>callbacks</em> solo corren con la interacción exacta.</li>
<li class=""><strong>La cobertura es de líneas, no de comportamiento.</strong> Un 100 % no garantiza que una regla de
negocio esté bien; por eso cada suite verifica el payload exacto que llega al API y los textos
que ve el usuario.</li>
<li class=""><strong>No hay E2E en esta medición.</strong> La suite de Playwright (ADR-009) es un nivel aparte y no
levanta aquí.</li>
</ul>
<h2 class="anchor anchorTargetStickyNavbar_Vzrq" id="7-riesgos-y-recomendaciones">7. Riesgos y recomendaciones<a href="https://desobsesor.github.io/blog/2026-11-13-informe-cobertura-web#7-riesgos-y-recomendaciones" class="hash-link" aria-label="Enlace directo al 7. Riesgos y recomendaciones" title="Enlace directo al 7. Riesgos y recomendaciones" translate="no">​</a></h2>
<ol>
<li class=""><strong>POS ya no es la deuda.</strong> Las cuatro pantallas de administración pasaron de 43–60 % a
<strong>89,5–92,5 %</strong> de líneas con 93 casos nuevos (<code>pos-ventas-gestion</code>, <code>pos-cajas-gestion</code>,
<code>pos-movimientos-gestion</code>, <code>pos-reportes-gestion</code>). Lo que queda es <code>pos.tsx</code> (81,5 %), el
carrito, que ya tenía suite propia.</li>
<li class=""><strong><code>signature-pad</code> y <code>approval-timeline</code> son evidencia y control.</strong> El trazo de una firma
(TEC-014) y la cadena de aprobación (SOL-002) tienen cobertura de líneas por debajo del 30 %.
Aunque la defensa real está en el backend, conviene fijar su comportamiento en el cliente.</li>
<li class=""><strong>Fijar <code>--maxWorkers=2</code> en la integración continua.</strong> En paralelo por defecto, jsdom se queda
sin memoria y aparecen fallos espurios que no existen en la ejecución acotada.</li>
<li class=""><strong>Umbral de cobertura por capa, no global.</strong> Un umbral único (por ejemplo 75 %) se cumple o se
incumple por accidente. Es más útil exigir <code>pages</code> ≥ 80 %, <code>components</code> ≥ 75 % y dejar <code>api</code>
fuera del trato hasta que exista la capa de contrato.</li>
<li class=""><strong>Mantener la convención <code>*-gestion.test.tsx</code>.</strong> Un archivo por módulo, montando la pantalla
real, hace evidente qué falta y evita duplicar lo que ya cubren las specs de componentes.</li>
</ol>
<h2 class="anchor anchorTargetStickyNavbar_Vzrq" id="8-cómo-reproducirlo">8. Cómo reproducirlo<a href="https://desobsesor.github.io/blog/2026-11-13-informe-cobertura-web#8-c%C3%B3mo-reproducirlo" class="hash-link" aria-label="Enlace directo al 8. Cómo reproducirlo" title="Enlace directo al 8. Cómo reproducirlo" translate="no">​</a></h2>
<div class="language-bash codeBlockContainer_Ckt0 theme-code-block" style="--prism-color:#393A34;--prism-background-color:#f6f8fa"><div class="codeBlockContent_QJqH"><pre tabindex="0" class="prism-code language-bash codeBlock_bY9V thin-scrollbar" style="color:#393A34;background-color:#f6f8fa"><code class="codeBlockLines_e6Vv"><div class="token-line" style="color:#393A34"><span class="token plain">cd ccf-almacen-web</span><br></div><div class="token-line" style="color:#393A34"><span class="token plain" style="display:inline-block"></span><br></div><div class="token-line" style="color:#393A34"><span class="token plain"># Suite completa (2 workers: jsdom agota memoria en paralelo)</span><br></div><div class="token-line" style="color:#393A34"><span class="token plain">npx jest --maxWorkers=2</span><br></div><div class="token-line" style="color:#393A34"><span class="token plain" style="display:inline-block"></span><br></div><div class="token-line" style="color:#393A34"><span class="token plain"># Con cobertura</span><br></div><div class="token-line" style="color:#393A34"><span class="token plain">npx jest --maxWorkers=2 --coverage</span><br></div><div class="token-line" style="color:#393A34"><span class="token plain" style="display:inline-block"></span><br></div><div class="token-line" style="color:#393A34"><span class="token plain"># Solo la capa de módulos</span><br></div><div class="token-line" style="color:#393A34"><span class="token plain">npx jest --maxWorkers=2 src/__tests__/*-gestion.test.tsx</span><br></div></code></pre></div></div>
<p>Salida esperada de la suite completa:</p>
<div class="language-text codeBlockContainer_Ckt0 theme-code-block" style="--prism-color:#393A34;--prism-background-color:#f6f8fa"><div class="codeBlockContent_QJqH"><pre tabindex="0" class="prism-code language-text codeBlock_bY9V thin-scrollbar" style="color:#393A34;background-color:#f6f8fa"><code class="codeBlockLines_e6Vv"><div class="token-line" style="color:#393A34"><span class="token plain">Test Suites: 221 passed, 221 total</span><br></div><div class="token-line" style="color:#393A34"><span class="token plain">Tests:       2659 passed, 2659 total</span><br></div><div class="token-line" style="color:#393A34"><span class="token plain">Statements   : 75.54% ( 20754/27474 )</span><br></div><div class="token-line" style="color:#393A34"><span class="token plain">Branches     : 62.25% ( 10087/16203 )</span><br></div><div class="token-line" style="color:#393A34"><span class="token plain">Functions    : 71.13% ( 4508/6337 )</span><br></div><div class="token-line" style="color:#393A34"><span class="token plain">Lines        : 77.54% ( 19358/24965 )</span><br></div></code></pre></div></div>
<p><code>npx tsc --noEmit</code>, <code>npx eslint</code> y <code>npm run verificar:etiquetas</code> pasan sin errores.</p>
<h2 class="anchor anchorTargetStickyNavbar_Vzrq" id="archivos-clave">Archivos clave<a href="https://desobsesor.github.io/blog/2026-11-13-informe-cobertura-web#archivos-clave" class="hash-link" aria-label="Enlace directo al Archivos clave" title="Enlace directo al Archivos clave" translate="no">​</a></h2>
<ul>
<li class=""><code>ccf-almacen-web/src/__tests__/</code> — 44 suites de módulo y 20 de inventario, solicitudes y POS.</li>
<li class=""><code>ccf-almacen-web/src/components/**/__tests__/</code> — 123 suites de componentes y tours.</li>
<li class=""><code>ccf-almacen-web/coverage/coverage-summary.json</code> — cobertura por archivo (base de las tablas).</li>
<li class=""><code>ccf-almacen-web/.jest-report.json</code> — resultado por suite y conteo de casos.</li>
<li class=""><code>ccf-almacen-web/jest.config.js</code> — recolección de cobertura y <code>setup</code> de jsdom.</li>
<li class=""><code>ccf-almacen-web/src/components/tickets/ticket-catalogos.ts</code> — corrección de <code>urlEvidencia()</code>.</li>
<li class=""><code>ccf-almacen-web/src/components/security/sesiones-panel.tsx</code> — validación de <code>idUsuario</code>.</li>
<li class=""><code>ccf-almacen-web/src/pages/plantillas-solicitud.tsx</code> — recorte del payload.</li>
<li class=""><code>ccf-almacen-web/src/components/common/data-grid.tsx</code> — cambio de orden fuera del render.</li>
<li class=""><code>ccf-almacen-wiki/blog/2026-11-13-pos-cobertura-pruebas-unitarias.md</code> — detalle del incremento POS.</li>
</ul>]]></content>
        <author>
            <name>Yovany Suárez Silva</name>
            <uri>https://desobsesor.github.io/portfolio-web/</uri>
        </author>
        <category label="Pruebas frontend" term="Pruebas frontend"/>
        <category label="Testing" term="Testing"/>
        <category label="Cobertura" term="Cobertura"/>
        <category label="Frontend" term="Frontend"/>
        <category label="Web" term="Web"/>
    </entry>
    <entry>
        <title type="html"><![CDATA[Jobs y Trabajos — pruebas unitarias de tareas programadas y colas]]></title>
        <id>https://desobsesor.github.io/blog/2026-11-13-jobs-y-trabajos-pruebas-unitarias</id>
        <link href="https://desobsesor.github.io/blog/2026-11-13-jobs-y-trabajos-pruebas-unitarias"/>
        <updated>2026-11-13T00:00:00.000Z</updated>
        <summary type="html"><![CDATA[Jobs (/jobs, TEC-015) administra las tareas programadas y Trabajos (/trabajos,]]></summary>
        <content type="html"><![CDATA[<p><strong>Jobs</strong> (<code>/jobs</code>, TEC-015) administra las tareas programadas y <strong>Trabajos</strong> (<code>/trabajos</code>,
TEC-002) muestra las colas de procesamiento en segundo plano. Se añaden <strong>31 casos</strong> de prueba
en <code>src/__tests__/</code>, que se suman a la batería del grid que ya existía para Jobs.</p>
<h2 class="anchor anchorTargetStickyNavbar_Vzrq" id="1-qué-se-cubre">1. Qué se cubre<a href="https://desobsesor.github.io/blog/2026-11-13-jobs-y-trabajos-pruebas-unitarias#1-qu%C3%A9-se-cubre" class="hash-link" aria-label="Enlace directo al 1. Qué se cubre" title="Enlace directo al 1. Qué se cubre" translate="no">​</a></h2>
<h3 class="anchor anchorTargetStickyNavbar_Vzrq" id="jobs--src__tests__jobs-gestiontesttsx-12-casos">Jobs — <code>src/__tests__/jobs-gestion.test.tsx</code> (12 casos)<a href="https://desobsesor.github.io/blog/2026-11-13-jobs-y-trabajos-pruebas-unitarias#jobs--src__tests__jobs-gestiontesttsx-12-casos" class="hash-link" aria-label="Enlace directo al jobs--src__tests__jobs-gestiontesttsx-12-casos" title="Enlace directo al jobs--src__tests__jobs-gestiontesttsx-12-casos" translate="no">​</a></h3>
<p>Esta suite <strong>complementa</strong> <code>components/__tests__/jobs.test.tsx</code> (que cubre el grid, los filtros,
las tarjetas y la navegación) con lo que no estaba fijado:</p>
<table><thead><tr><th>Bloque</th><th>Qué fija</th></tr></thead><tbody><tr><td><strong>Errores de acción</strong></td><td>Fallo al encender/apagar, fallo al ejecutar y fallo al guardar el cron (conservando la edición)</td></tr><tr><td><strong>Cron</strong></td><td>Guardado con la expresión recortada y cancelación de la edición sin guardar</td></tr><tr><td><strong>Historial</strong></td><td>Ejecuciones con estado, disparador, duración y error; vacío; error de carga; «Cargar más» por cursor; filtro por estado; cierre y anuncio accesible del número de ejecuciones</td></tr></tbody></table>
<h3 class="anchor anchorTargetStickyNavbar_Vzrq" id="trabajos--src__tests__trabajos-gestiontesttsx-19-casos">Trabajos — <code>src/__tests__/trabajos-gestion.test.tsx</code> (19 casos)<a href="https://desobsesor.github.io/blog/2026-11-13-jobs-y-trabajos-pruebas-unitarias#trabajos--src__tests__trabajos-gestiontesttsx-19-casos" class="hash-link" aria-label="Enlace directo al trabajos--src__tests__trabajos-gestiontesttsx-19-casos" title="Enlace directo al trabajos--src__tests__trabajos-gestiontesttsx-19-casos" translate="no">​</a></h3>
<table><thead><tr><th>Bloque</th><th>Qué fija</th></tr></thead><tbody><tr><td><strong>Estado de colas</strong></td><td>Espera, error con reintento, tarjetas por cola con sus cinco conteos y modo degradado («Colas deshabilitadas o Redis no disponible»)</td></tr><tr><td><strong>Listado</strong></td><td>ID, cola, nombre, estado, intentos <code>n/m</code>, creado, motivo del fallo (o «—») y botón de reintento solo en fallidos</td></tr><tr><td><strong>Filtros y refresco</strong></td><td>Filtro por cola y por estado con sus parámetros, y actualización manual</td></tr><tr><td><strong>Reintentos</strong></td><td>Individual y masivo (por cola filtrada o todas), sus avisos y sus errores; botón masivo deshabilitado sin fallidos o sin colas</td></tr><tr><td><strong>Tour</strong></td><td>Disponible o con su aviso de no disponible</td></tr></tbody></table>
<h2 class="anchor anchorTargetStickyNavbar_Vzrq" id="2-patrón-de-las-pruebas">2. Patrón de las pruebas<a href="https://desobsesor.github.io/blog/2026-11-13-jobs-y-trabajos-pruebas-unitarias#2-patr%C3%B3n-de-las-pruebas" class="hash-link" aria-label="Enlace directo al 2. Patrón de las pruebas" title="Enlace directo al 2. Patrón de las pruebas" translate="no">​</a></h2>
<ul>
<li class="">Se mockean las APIs (<code>jobs</code>, <code>colas</code>), el <code>toast</code> y el tour; los paneles se montan completos.</li>
<li class="">En Jobs el historial es un <strong>diálogo superpuesto</strong> (<code>role="dialog"</code> con <code>aria-label</code>
«Historial de ejecuciones de …»): las consultas del historial se acotan a ese diálogo para no
chocar con los filtros del catálogo.</li>
<li class="">Las acciones de fila solo declaran <code>aria-label</code> (<code>Apagar job</code>, <code>Ejecutar ahora</code>, <code>Editar cron</code>,
<code>Guardar cron</code>, <code>Historial</code>), que es su contrato accesible.</li>
<li class="">En Trabajos los conteos se eligen únicos por cola para poder afirmarlos sin ambigüedad.</li>
</ul>
<h2 class="anchor anchorTargetStickyNavbar_Vzrq" id="3-cómo-verificarlo">3. Cómo verificarlo<a href="https://desobsesor.github.io/blog/2026-11-13-jobs-y-trabajos-pruebas-unitarias#3-c%C3%B3mo-verificarlo" class="hash-link" aria-label="Enlace directo al 3. Cómo verificarlo" title="Enlace directo al 3. Cómo verificarlo" translate="no">​</a></h2>
<div class="language-bash codeBlockContainer_Ckt0 theme-code-block" style="--prism-color:#393A34;--prism-background-color:#f6f8fa"><div class="codeBlockContent_QJqH"><pre tabindex="0" class="prism-code language-bash codeBlock_bY9V thin-scrollbar" style="color:#393A34;background-color:#f6f8fa"><code class="codeBlockLines_e6Vv"><div class="token-line" style="color:#393A34"><span class="token plain">cd ccf-almacen-web</span><br></div><div class="token-line" style="color:#393A34"><span class="token plain">npx jest src/__tests__/jobs-gestion.test.tsx src/__tests__/trabajos-gestion.test.tsx</span><br></div><div class="token-line" style="color:#393A34"><span class="token plain"># Test Suites: 2 passed, 2 total</span><br></div><div class="token-line" style="color:#393A34"><span class="token plain"># Tests:       31 passed, 31 total</span><br></div></code></pre></div></div>
<p><code>npx tsc --noEmit</code> y <code>npx eslint</code> pasan sin errores.</p>
<h2 class="anchor anchorTargetStickyNavbar_Vzrq" id="archivos-clave">Archivos clave<a href="https://desobsesor.github.io/blog/2026-11-13-jobs-y-trabajos-pruebas-unitarias#archivos-clave" class="hash-link" aria-label="Enlace directo al Archivos clave" title="Enlace directo al Archivos clave" translate="no">​</a></h2>
<ul>
<li class=""><code>ccf-almacen-web/src/__tests__/jobs-gestion.test.tsx</code> — errores de acción e historial.</li>
<li class=""><code>ccf-almacen-web/src/__tests__/trabajos-gestion.test.tsx</code> — tablero de colas.</li>
<li class=""><code>ccf-almacen-web/src/components/jobs/jobs-panel.tsx</code> y <code>src/components/reports/trabajos-dashboard.tsx</code>.</li>
<li class=""><code>ccf-almacen-web/src/components/__tests__/jobs.test.tsx</code> — batería previa del grid (se conserva).</li>
</ul>]]></content>
        <author>
            <name>Yovany Suárez Silva</name>
            <uri>https://desobsesor.github.io/portfolio-web/</uri>
        </author>
        <category label="TEC-002" term="TEC-002"/>
        <category label="Reportes" term="Reportes"/>
        <category label="Frontend" term="Frontend"/>
        <category label="Pruebas frontend" term="Pruebas frontend"/>
    </entry>
    <entry>
        <title type="html"><![CDATA[Órdenes de compra — pruebas unitarias de estados y cancelación]]></title>
        <id>https://desobsesor.github.io/blog/2026-11-13-ordenes-compra-pruebas-unitarias</id>
        <link href="https://desobsesor.github.io/blog/2026-11-13-ordenes-compra-pruebas-unitarias"/>
        <updated>2026-11-13T00:00:00.000Z</updated>
        <summary type="html"><![CDATA[La pantalla Operaciones › Compras › Órdenes de compra (/ordenes-compra) lista las]]></summary>
        <content type="html"><![CDATA[<p>La pantalla <strong>Operaciones › Compras › Órdenes de compra</strong> (<code>/ordenes-compra</code>) lista las
órdenes generadas por punto de reorden o creadas a mano y permite avanzar su estado hasta
<em>Confirmada</em> para poder recepcionar la mercancía (COM-002). Ahora tiene <strong>24 casos</strong> de prueba.</p>
<h2 class="anchor anchorTargetStickyNavbar_Vzrq" id="1-qué-se-cubre">1. Qué se cubre<a href="https://desobsesor.github.io/blog/2026-11-13-ordenes-compra-pruebas-unitarias#1-qu%C3%A9-se-cubre" class="hash-link" aria-label="Enlace directo al 1. Qué se cubre" title="Enlace directo al 1. Qué se cubre" translate="no">​</a></h2>
<p><code>ccf-almacen-web/src/__tests__/ordenes-compra-gestion.test.tsx</code> (24 casos):</p>
<table><thead><tr><th>Bloque</th><th>Qué fija</th></tr></thead><tbody><tr><td><strong>Listado</strong></td><td>Espera, error con mensaje del servidor (incluido el arreglo de mensajes), vacío, número/proveedor/tipo/estado/monto/fecha, importe omitido por permisos («—»), monto <code>0</code> como importe real y fecha ausente («—»)</td></tr><tr><td><strong>Acciones por estado</strong></td><td>Generada → Enviar + Cancelar; Enviada → Confirmar + Cancelar; Confirmada → solo Cancelar; Recibida → «Recepcionada»; Cancelada → sin acciones</td></tr><tr><td><strong>Filtros y paginación</strong></td><td>Filtro por estado con reinicio a página 1, paginación en servidor por <code>totalItems</code> y recarga</td></tr><tr><td><strong>Confirmación</strong></td><td>Enviar, Confirmar y Cancelar (motivo obligatorio y recortado), éxito con su mensaje, error del servidor, «Volver» sin mutar y botón deshabilitado mientras guarda</td></tr><tr><td><strong>Tour</strong></td><td>Sin proveedor no se pinta; con motor inicia <code>ordenes-compra</code>; aviso si no está listo; tour propio del diálogo de confirmación</td></tr></tbody></table>
<h2 class="anchor anchorTargetStickyNavbar_Vzrq" id="2-patrón-de-las-pruebas">2. Patrón de las pruebas<a href="https://desobsesor.github.io/blog/2026-11-13-ordenes-compra-pruebas-unitarias#2-patr%C3%B3n-de-las-pruebas" class="hash-link" aria-label="Enlace directo al 2. Patrón de las pruebas" title="Enlace directo al 2. Patrón de las pruebas" translate="no">​</a></h2>
<ul>
<li class="">Se mockean los hooks de React Query (<code>useOrdenesCompra</code>, <code>useCambiarEstadoOrdenCompra</code>),
el <code>toast</code> del registro shadcn y el contexto de tour; la página se monta completa.</li>
<li class="">Las mutaciones se resuelven invocando <code>onSuccess</code>/<code>onError</code> desde el mock de <code>mutate</code>,
que es exactamente lo que hace React Query al terminar.</li>
<li class="">Los importes se afirman con expresiones sobre el número (<code>/1\.500\.000/</code>) porque el
espaciado de <code>Intl</code> puede variar; el campo omitido se comprueba por la celda completa.</li>
<li class="">El <code>Select</code> de filtro declara <code>aria-label</code>, así que se localiza por rol y nombre.</li>
</ul>
<h2 class="anchor anchorTargetStickyNavbar_Vzrq" id="3-cómo-verificarlo">3. Cómo verificarlo<a href="https://desobsesor.github.io/blog/2026-11-13-ordenes-compra-pruebas-unitarias#3-c%C3%B3mo-verificarlo" class="hash-link" aria-label="Enlace directo al 3. Cómo verificarlo" title="Enlace directo al 3. Cómo verificarlo" translate="no">​</a></h2>
<div class="language-bash codeBlockContainer_Ckt0 theme-code-block" style="--prism-color:#393A34;--prism-background-color:#f6f8fa"><div class="codeBlockContent_QJqH"><pre tabindex="0" class="prism-code language-bash codeBlock_bY9V thin-scrollbar" style="color:#393A34;background-color:#f6f8fa"><code class="codeBlockLines_e6Vv"><div class="token-line" style="color:#393A34"><span class="token plain">cd ccf-almacen-web</span><br></div><div class="token-line" style="color:#393A34"><span class="token plain">npx jest src/__tests__/ordenes-compra-gestion.test.tsx</span><br></div><div class="token-line" style="color:#393A34"><span class="token plain"># Test Suites: 1 passed, 1 total</span><br></div><div class="token-line" style="color:#393A34"><span class="token plain"># Tests:       24 passed, 24 total</span><br></div></code></pre></div></div>
<p><code>npx tsc --noEmit</code> y <code>npx eslint</code> pasan sin errores.</p>
<h2 class="anchor anchorTargetStickyNavbar_Vzrq" id="archivos-clave">Archivos clave<a href="https://desobsesor.github.io/blog/2026-11-13-ordenes-compra-pruebas-unitarias#archivos-clave" class="hash-link" aria-label="Enlace directo al Archivos clave" title="Enlace directo al Archivos clave" translate="no">​</a></h2>
<ul>
<li class=""><code>ccf-almacen-web/src/__tests__/ordenes-compra-gestion.test.tsx</code> — suite de la página.</li>
<li class=""><code>ccf-almacen-web/src/pages/ordenes-compra.tsx</code> — listado, acciones y confirmación.</li>
<li class=""><code>ccf-almacen-web/src/hooks/use-compras.ts</code> — consultas y mutaciones de la orden.</li>
<li class=""><code>ccf-almacen-web/src/models/compras.entity.ts</code> — estados, etiquetas y contratos.</li>
</ul>]]></content>
        <author>
            <name>Yovany Suárez Silva</name>
            <uri>https://desobsesor.github.io/portfolio-web/</uri>
        </author>
        <category label="Compras" term="Compras"/>
        <category label="Inventario" term="Inventario"/>
        <category label="Frontend" term="Frontend"/>
        <category label="Pruebas frontend" term="Pruebas frontend"/>
    </entry>
    <entry>
        <title type="html"><![CDATA[Solicitudes recurrentes — pruebas unitarias de plantillas, bandeja y cancelación]]></title>
        <id>https://desobsesor.github.io/blog/2026-11-13-plantillas-solicitud-pruebas-unitarias</id>
        <link href="https://desobsesor.github.io/blog/2026-11-13-plantillas-solicitud-pruebas-unitarias"/>
        <updated>2026-11-13T00:00:00.000Z</updated>
        <summary type="html"><![CDATA[La pantalla Solicitudes recurrentes (/plantillas-solicitud, SOL-001) crea plantillas que]]></summary>
        <content type="html"><![CDATA[<p>La pantalla <strong>Solicitudes recurrentes</strong> (<code>/plantillas-solicitud</code>, SOL-001) crea plantillas que
generan pedidos solos y una bandeja donde el encargado los revisa antes de aprobarlos. Ahora
tiene <strong>31 casos</strong> de prueba.</p>
<h2 class="anchor anchorTargetStickyNavbar_Vzrq" id="1-qué-se-cubre">1. Qué se cubre<a href="https://desobsesor.github.io/blog/2026-11-13-plantillas-solicitud-pruebas-unitarias#1-qu%C3%A9-se-cubre" class="hash-link" aria-label="Enlace directo al 1. Qué se cubre" title="Enlace directo al 1. Qué se cubre" translate="no">​</a></h2>
<p><code>ccf-almacen-web/src/__tests__/plantillas-solicitud-gestion.test.tsx</code> (31 casos):</p>
<table><thead><tr><th>Bloque</th><th>Qué fija</th></tr></thead><tbody><tr><td><strong>Listado</strong></td><td>Área, frecuencia, próxima ejecución y estado; id del área cuando no llega el nombre; acciones según estado (pausar / reanudar / cancelar / generar / editar) y el vacío con su acción</td></tr><tr><td><strong>Filtros</strong></td><td>Filtro por estado, búsqueda por nombre con Enter y actualización manual</td></tr><tr><td><strong>Bandeja «Por revisar»</strong></td><td>Solicitudes generadas con su oficina y fecha, envío a aprobación con su aviso, error del servidor y vacío</td></tr><tr><td><strong>Alta</strong></td><td>Obligatoriedad de nombre/área/producto, validación de la línea (producto y cantidad &gt; 0), agregar y quitar líneas, y payload completo con área, frecuencia, propósito, estado <code>activa</code> y líneas</td></tr><tr><td><strong>Edición</strong></td><td>Precarga de nombre y líneas, y actualización con el mismo mapeo</td></tr><tr><td><strong>Errores y cierre</strong></td><td>Mensaje del servidor al guardar y cierre del formulario sin guardar</td></tr><tr><td><strong>Acciones de fila</strong></td><td>Pausar, reanudar, generar ahora, error de acción no permitida y vista previa de próximas ejecuciones (con fechas, sin fechas y con error)</td></tr><tr><td><strong>Cancelación</strong></td><td>Confirmación del sistema con el nombre de la plantilla, cancelación de la modal, cancelación efectiva con su aviso y error que conserva la modal</td></tr><tr><td><strong>Tour</strong></td><td>Pantalla, formulario y aviso de no disponible</td></tr></tbody></table>
<h2 class="anchor anchorTargetStickyNavbar_Vzrq" id="2-defecto-real-corregido">2. Defecto real corregido<a href="https://desobsesor.github.io/blog/2026-11-13-plantillas-solicitud-pruebas-unitarias#2-defecto-real-corregido" class="hash-link" aria-label="Enlace directo al 2. Defecto real corregido" title="Enlace directo al 2. Defecto real corregido" translate="no">​</a></h2>
<p>El alta y la edición enviaban el formulario tal cual: un nombre escrito con espacios
(<code>"  Aseo mensual "</code>) se guardaba con ellos y quedaba visible en la bandeja. Ahora el payload
recorta <code>nombre</code> y <code>proposito</code> antes de llamar al API — <a class="" href="https://desobsesor.github.io/ccf-almacen-web/src/pages/plantillas-solicitud.tsx">plantillas-solicitud.tsx</a>.</p>
<h2 class="anchor anchorTargetStickyNavbar_Vzrq" id="3-patrón-de-las-pruebas">3. Patrón de las pruebas<a href="https://desobsesor.github.io/blog/2026-11-13-plantillas-solicitud-pruebas-unitarias#3-patr%C3%B3n-de-las-pruebas" class="hash-link" aria-label="Enlace directo al 3. Patrón de las pruebas" title="Enlace directo al 3. Patrón de las pruebas" translate="no">​</a></h2>
<ul>
<li class="">Se mockean las diez funciones de <code>api/plantillas-solicitud</code>, las oficinas y los productos
(con su sobre paginado <code>{ data, meta }</code>), el <code>toast</code> y el tour.</li>
<li class="">El selector de producto no tiene etiqueta asociada: se localiza por posición dentro del
diálogo (<code>getAllByRole('combobox')[2]</code>, tras área y frecuencia).</li>
<li class="">Las confirmaciones usan <code>DialogoConfirmacion</code> (<code>AlertDialog</code>): el título y el botón comparten
texto, así que el título se busca por <code>role="heading"</code>.</li>
<li class="">Hay dos «Nueva plantilla» (cabecera y vacío): se usa <code>getAllByRole(...)[0]</code>.</li>
</ul>
<h2 class="anchor anchorTargetStickyNavbar_Vzrq" id="4-cómo-verificarlo">4. Cómo verificarlo<a href="https://desobsesor.github.io/blog/2026-11-13-plantillas-solicitud-pruebas-unitarias#4-c%C3%B3mo-verificarlo" class="hash-link" aria-label="Enlace directo al 4. Cómo verificarlo" title="Enlace directo al 4. Cómo verificarlo" translate="no">​</a></h2>
<div class="language-bash codeBlockContainer_Ckt0 theme-code-block" style="--prism-color:#393A34;--prism-background-color:#f6f8fa"><div class="codeBlockContent_QJqH"><pre tabindex="0" class="prism-code language-bash codeBlock_bY9V thin-scrollbar" style="color:#393A34;background-color:#f6f8fa"><code class="codeBlockLines_e6Vv"><div class="token-line" style="color:#393A34"><span class="token plain">cd ccf-almacen-web</span><br></div><div class="token-line" style="color:#393A34"><span class="token plain">npx jest src/__tests__/plantillas-solicitud-gestion.test.tsx</span><br></div><div class="token-line" style="color:#393A34"><span class="token plain"># Test Suites: 1 passed, 1 total</span><br></div><div class="token-line" style="color:#393A34"><span class="token plain"># Tests:       31 passed, 31 total</span><br></div></code></pre></div></div>
<p><code>npx tsc --noEmit</code> y <code>npx eslint</code> pasan sin errores.</p>
<h2 class="anchor anchorTargetStickyNavbar_Vzrq" id="archivos-clave">Archivos clave<a href="https://desobsesor.github.io/blog/2026-11-13-plantillas-solicitud-pruebas-unitarias#archivos-clave" class="hash-link" aria-label="Enlace directo al Archivos clave" title="Enlace directo al Archivos clave" translate="no">​</a></h2>
<ul>
<li class=""><code>ccf-almacen-web/src/__tests__/plantillas-solicitud-gestion.test.tsx</code> — suite de la pantalla.</li>
<li class=""><code>ccf-almacen-web/src/pages/plantillas-solicitud.tsx</code> — listado, formulario, bandeja y acciones.</li>
<li class=""><code>ccf-almacen-web/src/api/plantillas-solicitud.ts</code> — contrato mockeado.</li>
<li class=""><code>ccf-almacen-web/src/models/plantilla-solicitud.entity.ts</code> — frecuencias y estados.</li>
</ul>]]></content>
        <author>
            <name>Yovany Suárez Silva</name>
            <uri>https://desobsesor.github.io/portfolio-web/</uri>
        </author>
        <category label="Solicitudes" term="Solicitudes"/>
        <category label="SOL-010" term="SOL-010"/>
        <category label="Frontend" term="Frontend"/>
        <category label="Pruebas frontend" term="Pruebas frontend"/>
    </entry>
    <entry>
        <title type="html"><![CDATA[POS — de 43 % a 90 % en ventas, cajas, movimientos y reportes]]></title>
        <id>https://desobsesor.github.io/blog/2026-11-13-pos-cobertura-pruebas-unitarias</id>
        <link href="https://desobsesor.github.io/blog/2026-11-13-pos-cobertura-pruebas-unitarias"/>
        <updated>2026-11-13T00:00:00.000Z</updated>
        <summary type="html"><![CDATA[El punto de venta era la deuda más caras del informe de cobertura: pos-ventas estaba en]]></summary>
        <content type="html"><![CDATA[<p>El punto de venta era la deuda más caras del informe de cobertura: <code>pos-ventas</code> estaba en
<strong>42,9 %</strong> de líneas y las otras tres pantallas de administración entre 53 % y 60 %. Ahora las
cuatro superan el <strong>89 %</strong>, con <strong>93 casos nuevos</strong>, y por el camino apareció un defecto real en
la grid compartida.</p>
<h2 class="anchor anchorTargetStickyNavbar_Vzrq" id="1-antes-y-después">1. Antes y después<a href="https://desobsesor.github.io/blog/2026-11-13-pos-cobertura-pruebas-unitarias#1-antes-y-despu%C3%A9s" class="hash-link" aria-label="Enlace directo al 1. Antes y después" title="Enlace directo al 1. Antes y después" translate="no">​</a></h2>
<table><thead><tr><th>Pantalla</th><th style="text-align:right">Líneas antes</th><th style="text-align:right">Líneas ahora</th><th style="text-align:right">Casos nuevos</th></tr></thead><tbody><tr><td><code>pos-ventas</code></td><td style="text-align:right">42,9 %</td><td style="text-align:right"><strong>89,5 %</strong></td><td style="text-align:right">28</td></tr><tr><td><code>pos-cajas</code></td><td style="text-align:right">55,4 %</td><td style="text-align:right"><strong>91,1 %</strong></td><td style="text-align:right">24</td></tr><tr><td><code>pos-movimientos</code></td><td style="text-align:right">53,1 %</td><td style="text-align:right"><strong>89,6 %</strong></td><td style="text-align:right">19</td></tr><tr><td><code>pos-reportes</code></td><td style="text-align:right">59,8 %</td><td style="text-align:right"><strong>92,5 %</strong></td><td style="text-align:right">22</td></tr></tbody></table>
<p>En sentencias, las cuatro quedan entre <strong>85,8 %</strong> y <strong>91,2 %</strong>; en ramas, entre <strong>71,3 %</strong> y
<strong>89,7 %</strong>. La pantalla de venta (<code>pos.tsx</code>, el carrito) ya venía cubierta por su propia suite y se
mantuvo en 81,5 %.</p>
<p>Efecto en la suite completa:</p>
<table><thead><tr><th>Métrica</th><th style="text-align:right">Antes</th><th style="text-align:right">Ahora</th></tr></thead><tbody><tr><td>Suites</td><td style="text-align:right">217</td><td style="text-align:right"><strong>221</strong></td></tr><tr><td>Casos</td><td style="text-align:right">2 566</td><td style="text-align:right"><strong>2 659</strong></td></tr><tr><td>Sentencias</td><td style="text-align:right">74,83 %</td><td style="text-align:right"><strong>75,54 %</strong></td></tr><tr><td>Ramas</td><td style="text-align:right">61,08 %</td><td style="text-align:right"><strong>62,25 %</strong></td></tr><tr><td>Funciones</td><td style="text-align:right">69,59 %</td><td style="text-align:right"><strong>71,13 %</strong></td></tr><tr><td>Líneas</td><td style="text-align:right">76,81 %</td><td style="text-align:right"><strong>77,54 %</strong></td></tr></tbody></table>
<h2 class="anchor anchorTargetStickyNavbar_Vzrq" id="2-qué-se-cubre">2. Qué se cubre<a href="https://desobsesor.github.io/blog/2026-11-13-pos-cobertura-pruebas-unitarias#2-qu%C3%A9-se-cubre" class="hash-link" aria-label="Enlace directo al 2. Qué se cubre" title="Enlace directo al 2. Qué se cubre" translate="no">​</a></h2>
<h3 class="anchor anchorTargetStickyNavbar_Vzrq" id="ventas--pos-ventas-gestiontesttsx-28-casos">Ventas — <code>pos-ventas-gestion.test.tsx</code> (28 casos)<a href="https://desobsesor.github.io/blog/2026-11-13-pos-cobertura-pruebas-unitarias#ventas--pos-ventas-gestiontesttsx-28-casos" class="hash-link" aria-label="Enlace directo al ventas--pos-ventas-gestiontesttsx-28-casos" title="Enlace directo al ventas--pos-ventas-gestiontesttsx-28-casos" translate="no">​</a></h3>
<table><thead><tr><th>Bloque</th><th>Qué fija</th></tr></thead><tbody><tr><td><strong>Grilla</strong></td><td>Esqueleto, error con reintento, vacío, consecutivo/cliente/documento/ítems/medios/total, «Pagada», «Anulada» y «Fuera de horario», medio sin etiqueta y almacén ausente</td></tr><tr><td><strong>Orden y refresco</strong></td><td>Orden en servidor por total (asc → desc → vuelta a fecha) y recarga manual</td></tr><tr><td><strong>Filtros</strong></td><td>Búsqueda recortada (vuelve a página 1), almacén, cajero, medio de pago, estado y rango de fechas</td></tr><tr><td><strong>Comprobante</strong></td><td>Descarga de la fila con <code>abrirBlob</code>, nombre <code>POS-…-factura.pdf</code> y aviso; error con el mensaje del servidor</td></tr><tr><td><strong>Reenvío</strong></td><td>Correo precargado del cliente, correo obligatorio, recorte del destinatario, éxito que cierra, rechazo del proveedor que deja el diálogo y excepción</td></tr><tr><td><strong>Anulación</strong></td><td>Motivo mínimo de 5 caracteres, motivo recortado en el payload, error del servidor, estado «Anulando…» y botón deshabilitado para una venta ya anulada</td></tr><tr><td><strong>Detalle</strong></td><td>Esqueleto y error con reintento, ítems con lote y serie, subtotal/descuentos/impuestos, saldo de crédito, pago con referencia enmascarada, movimientos generados y su vacío, descarga, reimpresión de tirilla, reenvío y anulación desde el pie</td></tr></tbody></table>
<h3 class="anchor anchorTargetStickyNavbar_Vzrq" id="cajas--pos-cajas-gestiontesttsx-24-casos">Cajas — <code>pos-cajas-gestion.test.tsx</code> (24 casos)<a href="https://desobsesor.github.io/blog/2026-11-13-pos-cobertura-pruebas-unitarias#cajas--pos-cajas-gestiontesttsx-24-casos" class="hash-link" aria-label="Enlace directo al cajas--pos-cajas-gestiontesttsx-24-casos" title="Enlace directo al cajas--pos-cajas-gestiontesttsx-24-casos" translate="no">​</a></h3>
<table><thead><tr><th>Bloque</th><th>Qué fija</th></tr></thead><tbody><tr><td><strong>Grilla</strong></td><td>Carga, error, vacío, turno/almacén/responsable con «Cerró:», arqueo, diferencia, semáforo (abierta, cerrada con diferencia) y conteo de ventas en singular/plural</td></tr><tr><td><strong>Orden y filtros</strong></td><td>Orden por base inicial y vuelta a apertura; almacén, estado y rango, siempre reiniciando a página 1</td></tr><tr><td><strong>Comprobantes</strong></td><td>Reimpresión del cierre y del detalle (apertura y cierre) con <code>abrirBlob</code>; error con mensaje del servidor</td></tr><tr><td><strong>Detalle</strong></td><td>Esqueleto, error con reintento, arqueo con resultado, medios de pago, ventas incluidas (<code>Mostrador</code> cuando no hay cliente), observaciones y envíos (con registros y vacío)</td></tr><tr><td><strong>Envío</strong></td><td>Sin correo usa el del responsable, recorte del correo, cambio de tipo y formato de comprobante, rechazo del proveedor, excepción, «Enviando…» y cancelación</td></tr></tbody></table>
<h3 class="anchor anchorTargetStickyNavbar_Vzrq" id="movimientos--pos-movimientos-gestiontesttsx-19-casos">Movimientos — <code>pos-movimientos-gestion.test.tsx</code> (19 casos)<a href="https://desobsesor.github.io/blog/2026-11-13-pos-cobertura-pruebas-unitarias#movimientos--pos-movimientos-gestiontesttsx-19-casos" class="hash-link" aria-label="Enlace directo al movimientos--pos-movimientos-gestiontesttsx-19-casos" title="Enlace directo al movimientos--pos-movimientos-gestiontesttsx-19-casos" translate="no">​</a></h3>
<table><thead><tr><th>Bloque</th><th>Qué fija</th></tr></thead><tbody><tr><td><strong>Grilla</strong></td><td>Carga, error, vacío, inventario vs. caja, cantidad como unidades o dinero, saldo y documento ausentes</td></tr><tr><td><strong>Orden y filtros</strong></td><td>Orden por fecha y cantidad; búsqueda, almacén, producto, tipo, origen y rango</td></tr><tr><td><strong>Documento de venta</strong></td><td>Consecutivo directo y el de una anulación (<code>ANULACION POS-…</code>), esqueleto, error con reintento, ítems y medios de pago</td></tr><tr><td><strong>Documento de turno</strong></td><td>Turno extraído de <code>TURNO 7</code>, esqueleto, error, arqueo y ventas del turno</td></tr><tr><td><strong>Sin documento</strong></td><td>Un movimiento sin documento no abre ninguna ventana</td></tr></tbody></table>
<h3 class="anchor anchorTargetStickyNavbar_Vzrq" id="reportes--pos-reportes-gestiontesttsx-22-casos">Reportes — <code>pos-reportes-gestion.test.tsx</code> (22 casos)<a href="https://desobsesor.github.io/blog/2026-11-13-pos-cobertura-pruebas-unitarias#reportes--pos-reportes-gestiontesttsx-22-casos" class="hash-link" aria-label="Enlace directo al reportes--pos-reportes-gestiontesttsx-22-casos" title="Enlace directo al reportes--pos-reportes-gestiontesttsx-22-casos" translate="no">​</a></h3>
<table><thead><tr><th>Bloque</th><th>Qué fija</th></tr></thead><tbody><tr><td><strong>Historial</strong></td><td>Carga, error, vacío, etiqueta del reporte, formato, turno, resultado, error del último intento, reintento deshabilitado para enviados, paginación y refresco</td></tr><tr><td><strong>Generación</strong></td><td>El turno solo se pide en reportes de caja; payload completo con almacén, rango y formato; reporte sin caja sin turno; «Generando…» bloqueado; error con mensaje</td></tr><tr><td><strong>Envío</strong></td><td>Turno antes que correo, correo obligatorio, recorte del destinatario, éxito que cierra, rechazo del proveedor y excepción</td></tr><tr><td><strong>Reintento</strong></td><td>Reintento sin regenerar el documento, fallo que conserva el registro y excepción</td></tr></tbody></table>
<h2 class="anchor anchorTargetStickyNavbar_Vzrq" id="3-un-defecto-real-en-la-grid-compartida">3. Un defecto real en la grid compartida<a href="https://desobsesor.github.io/blog/2026-11-13-pos-cobertura-pruebas-unitarias#3-un-defecto-real-en-la-grid-compartida" class="hash-link" aria-label="Enlace directo al 3. Un defecto real en la grid compartida" title="Enlace directo al 3. Un defecto real en la grid compartida" translate="no">​</a></h2>
<p>Al probar el ordenamiento de Cajas, React avisó:</p>
<div class="language-text codeBlockContainer_Ckt0 theme-code-block" style="--prism-color:#393A34;--prism-background-color:#f6f8fa"><div class="codeBlockContent_QJqH"><pre tabindex="0" class="prism-code language-text codeBlock_bY9V thin-scrollbar" style="color:#393A34;background-color:#f6f8fa"><code class="codeBlockLines_e6Vv"><div class="token-line" style="color:#393A34"><span class="token plain">Warning: Cannot update a component (`PosCajasPage`) while rendering a</span><br></div><div class="token-line" style="color:#393A34"><span class="token plain">different component (`DataGrid`).</span><br></div></code></pre></div></div>
<p><code>DataGrid.cambiarOrden()</code> llamaba a <code>onCambioOrden</code> <strong>dentro</strong> del actualizador de <code>setOrden</code>:</p>
<div class="language-tsx codeBlockContainer_Ckt0 theme-code-block" style="--prism-color:#393A34;--prism-background-color:#f6f8fa"><div class="codeBlockContent_QJqH"><pre tabindex="0" class="prism-code language-tsx codeBlock_bY9V thin-scrollbar" style="color:#393A34;background-color:#f6f8fa"><code class="codeBlockLines_e6Vv"><div class="token-line" style="color:#393A34"><span class="token function" style="color:#d73a49">setOrden</span><span class="token punctuation" style="color:#393A34">(</span><span class="token punctuation" style="color:#393A34">(</span><span class="token plain">previo</span><span class="token punctuation" style="color:#393A34">)</span><span class="token plain"> </span><span class="token arrow operator" style="color:#393A34">=&gt;</span><span class="token plain"> </span><span class="token punctuation" style="color:#393A34">{</span><span class="token plain"></span><br></div><div class="token-line" style="color:#393A34"><span class="token plain">  </span><span class="token comment" style="color:#999988;font-style:italic">// …</span><span class="token plain"></span><br></div><div class="token-line" style="color:#393A34"><span class="token plain">  </span><span class="token function" style="color:#d73a49">onCambioOrden</span><span class="token punctuation" style="color:#393A34">(</span><span class="token plain">siguiente</span><span class="token punctuation" style="color:#393A34">)</span><span class="token punctuation" style="color:#393A34">;</span><span class="token plain"> </span><span class="token comment" style="color:#999988;font-style:italic">// setState del padre en fase de render</span><span class="token plain"></span><br></div><div class="token-line" style="color:#393A34"><span class="token plain">  </span><span class="token keyword" style="color:#00009f">return</span><span class="token plain"> siguiente</span><span class="token punctuation" style="color:#393A34">;</span><span class="token plain"></span><br></div><div class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token punctuation" style="color:#393A34">}</span><span class="token punctuation" style="color:#393A34">)</span><span class="token punctuation" style="color:#393A34">;</span><br></div></code></pre></div></div>
<p>Eso actualiza el estado del padre mientras el grid se está renderizando. En desarrollo React lo
denuncia y, en <code>StrictMode</code>, el actualizador puede ejecutarse dos veces: <strong>la pantalla vuelve a
consultar el mismo orden dos veces</strong>. Ahora el siguiente orden se calcula con el estado vigente y
se avisa después de <code>setOrden</code>, fuera de la fase de render
(<code>src/components/common/data-grid.tsx</code>). Afecta a todas las grids con orden en servidor.</p>
<h2 class="anchor anchorTargetStickyNavbar_Vzrq" id="4-una-trampa-del-entorno-select-dentro-de-dialog">4. Una trampa del entorno: Select dentro de Dialog<a href="https://desobsesor.github.io/blog/2026-11-13-pos-cobertura-pruebas-unitarias#4-una-trampa-del-entorno-select-dentro-de-dialog" class="hash-link" aria-label="Enlace directo al 4. Una trampa del entorno: Select dentro de Dialog" title="Enlace directo al 4. Una trampa del entorno: Select dentro de Dialog" translate="no">​</a></h2>
<p>Radix monta el contenido del <code>Select</code> en un portal. Cuando el <code>Select</code> vive dentro de un <code>Dialog</code>
modal, en jsdom la trampa de foco del diálogo y el autofoco de la opción se devuelven el foco en
bucle y la prueba <strong>nunca termina</strong> (no falla: cuelga). En navegador no ocurre.</p>
<p>La suite de Cajas sustituye el primitivo por un <code>select</code> plano con la misma API (<code>value</code> →
<code>onValueChange</code>), que es lo que la pantalla ejercita. El resto de suites siguen usando Radix real
para filtros y selects fuera de diálogos.</p>
<h2 class="anchor anchorTargetStickyNavbar_Vzrq" id="5-cómo-verificarlo">5. Cómo verificarlo<a href="https://desobsesor.github.io/blog/2026-11-13-pos-cobertura-pruebas-unitarias#5-c%C3%B3mo-verificarlo" class="hash-link" aria-label="Enlace directo al 5. Cómo verificarlo" title="Enlace directo al 5. Cómo verificarlo" translate="no">​</a></h2>
<div class="language-bash codeBlockContainer_Ckt0 theme-code-block" style="--prism-color:#393A34;--prism-background-color:#f6f8fa"><div class="codeBlockContent_QJqH"><pre tabindex="0" class="prism-code language-bash codeBlock_bY9V thin-scrollbar" style="color:#393A34;background-color:#f6f8fa"><code class="codeBlockLines_e6Vv"><div class="token-line" style="color:#393A34"><span class="token plain">cd ccf-almacen-web</span><br></div><div class="token-line" style="color:#393A34"><span class="token plain" style="display:inline-block"></span><br></div><div class="token-line" style="color:#393A34"><span class="token plain">npx jest src/__tests__/pos-ventas-gestion.test.tsx \</span><br></div><div class="token-line" style="color:#393A34"><span class="token plain">         src/__tests__/pos-cajas-gestion.test.tsx \</span><br></div><div class="token-line" style="color:#393A34"><span class="token plain">         src/__tests__/pos-movimientos-gestion.test.tsx \</span><br></div><div class="token-line" style="color:#393A34"><span class="token plain">         src/__tests__/pos-reportes-gestion.test.tsx --runInBand</span><br></div><div class="token-line" style="color:#393A34"><span class="token plain"># Test Suites: 4 passed, 4 total</span><br></div><div class="token-line" style="color:#393A34"><span class="token plain"># Tests:       93 passed, 93 total</span><br></div><div class="token-line" style="color:#393A34"><span class="token plain" style="display:inline-block"></span><br></div><div class="token-line" style="color:#393A34"><span class="token plain">npx jest --maxWorkers=2</span><br></div><div class="token-line" style="color:#393A34"><span class="token plain"># Test Suites: 221 passed, 221 total</span><br></div><div class="token-line" style="color:#393A34"><span class="token plain"># Tests:       2659 passed, 2659 total</span><br></div></code></pre></div></div>
<p>Cobertura de las cuatro pantallas:</p>
<div class="language-bash codeBlockContainer_Ckt0 theme-code-block" style="--prism-color:#393A34;--prism-background-color:#f6f8fa"><div class="codeBlockContent_QJqH"><pre tabindex="0" class="prism-code language-bash codeBlock_bY9V thin-scrollbar" style="color:#393A34;background-color:#f6f8fa"><code class="codeBlockLines_e6Vv"><div class="token-line" style="color:#393A34"><span class="token plain">npx jest src/__tests__/pos-*-gestion.test.tsx --runInBand --coverage \</span><br></div><div class="token-line" style="color:#393A34"><span class="token plain">  --collectCoverageFrom="src/pages/pos-{ventas,movimientos,cajas,reportes}.tsx"</span><br></div></code></pre></div></div>
<p><code>npx tsc --noEmit</code> y <code>npx eslint</code> pasan sin errores.</p>
<h2 class="anchor anchorTargetStickyNavbar_Vzrq" id="archivos-clave">Archivos clave<a href="https://desobsesor.github.io/blog/2026-11-13-pos-cobertura-pruebas-unitarias#archivos-clave" class="hash-link" aria-label="Enlace directo al Archivos clave" title="Enlace directo al Archivos clave" translate="no">​</a></h2>
<ul>
<li class=""><code>ccf-almacen-web/src/__tests__/pos-ventas-gestion.test.tsx</code> — historial, detalle, comprobante, reenvío y anulación.</li>
<li class=""><code>ccf-almacen-web/src/__tests__/pos-cajas-gestion.test.tsx</code> — turnos, arqueo, comprobantes y envío.</li>
<li class=""><code>ccf-almacen-web/src/__tests__/pos-movimientos-gestion.test.tsx</code> — libro unificado y documentos de origen.</li>
<li class=""><code>ccf-almacen-web/src/__tests__/pos-reportes-gestion.test.tsx</code> — generación, historial y reintento.</li>
<li class=""><code>ccf-almacen-web/src/components/common/data-grid.tsx</code> — corrección del aviso de orden en servidor.</li>
<li class=""><code>ccf-almacen-wiki/blog/2026-11-13-informe-cobertura-web.md</code> — informe actualizado con estas cifras.</li>
</ul>]]></content>
        <author>
            <name>Yovany Suárez Silva</name>
            <uri>https://desobsesor.github.io/portfolio-web/</uri>
        </author>
        <category label="POS" term="POS"/>
        <category label="Ventas" term="Ventas"/>
        <category label="Pruebas frontend" term="Pruebas frontend"/>
        <category label="Testing" term="Testing"/>
        <category label="Cobertura" term="Cobertura"/>
        <category label="Frontend" term="Frontend"/>
        <category label="REQ-POS-03" term="REQ-POS-03"/>
    </entry>
    <entry>
        <title type="html"><![CDATA[Recepción de mercancía — pruebas unitarias de cantidades y acta]]></title>
        <id>https://desobsesor.github.io/blog/2026-11-13-recepciones-pruebas-unitarias</id>
        <link href="https://desobsesor.github.io/blog/2026-11-13-recepciones-pruebas-unitarias"/>
        <updated>2026-11-13T00:00:00.000Z</updated>
        <summary type="html"><![CDATA[La pantalla Operaciones › Compras › Recepciones (/recepciones) registra la llegada]]></summary>
        <content type="html"><![CDATA[<p>La pantalla <strong>Operaciones › Compras › Recepciones</strong> (<code>/recepciones</code>) registra la llegada
física contra una orden de compra confirmada, separa lo recibido en buen estado de lo dañado
o rechazado y genera el acta para firma (COM-005, TEC-014). Ahora tiene <strong>28 casos</strong> de prueba.</p>
<h2 class="anchor anchorTargetStickyNavbar_Vzrq" id="1-qué-se-cubre">1. Qué se cubre<a href="https://desobsesor.github.io/blog/2026-11-13-recepciones-pruebas-unitarias#1-qu%C3%A9-se-cubre" class="hash-link" aria-label="Enlace directo al 1. Qué se cubre" title="Enlace directo al 1. Qué se cubre" translate="no">​</a></h2>
<p><code>ccf-almacen-web/src/__tests__/recepciones-gestion.test.tsx</code> (28 casos):</p>
<table><thead><tr><th>Bloque</th><th>Qué fija</th></tr></thead><tbody><tr><td><strong>Listado</strong></td><td>Espera, error con mensaje del servidor, vacío, aviso y bloqueo cuando no hay órdenes confirmadas, número/orden/proveedor/líneas/estado/fecha y referencias de respaldo (<code>OC 21</code>, <code>—</code>)</td></tr><tr><td><strong>Filtros y paginación</strong></td><td>Filtro por estado con reinicio a página 1, paginación en servidor y recarga</td></tr><tr><td><strong>Detalle</strong></td><td>Datos de la entrega (estado, fecha, guía, transportista, placa, quién registró), observaciones, líneas con OK/dañado/rechazado e inspección, «Excede lo ordenado» y ausencias con «—»</td></tr><tr><td><strong>Nueva recepción</strong></td><td>Órdenes confirmadas en el selector, precarga de líneas desde la orden, error al cargar, orden sin productos, validación de cantidades (total &gt; 0 y ≤ ordenado) y payload completo con guía, transporte, observaciones y resultado de inspección</td></tr><tr><td><strong>Cierre del formulario</strong></td><td>Éxito con su mensaje y cierre, error del servidor conservando el diálogo, botón deshabilitado mientras registra y «Cancelar» sin mutar</td></tr><tr><td><strong>Cambio de estado</strong></td><td>Estado por defecto <em>Completada</em>, nuevo estado con motivo recortado, éxito, error y «Volver»</td></tr><tr><td><strong>Acta</strong></td><td>Genera el acta y abre el diálogo de firma, error del servidor y botón deshabilitado mientras genera</td></tr><tr><td><strong>Tour</strong></td><td>Sin proveedor no se pinta; con motor inicia <code>recepciones</code></td></tr></tbody></table>
<h2 class="anchor anchorTargetStickyNavbar_Vzrq" id="2-patrón-de-las-pruebas">2. Patrón de las pruebas<a href="https://desobsesor.github.io/blog/2026-11-13-recepciones-pruebas-unitarias#2-patr%C3%B3n-de-las-pruebas" class="hash-link" aria-label="Enlace directo al 2. Patrón de las pruebas" title="Enlace directo al 2. Patrón de las pruebas" translate="no">​</a></h2>
<ul>
<li class="">Se mockean los hooks de compras y de firmas, <code>getOrdenCompraById</code>, el diálogo de firma
(con un doble que solo muestra el documento recibido), el <code>toast</code> y el contexto de tour.</li>
<li class="">Las mutaciones se resuelven invocando <code>onSuccess</code>/<code>onError</code> desde el mock de <code>mutate</code>.</li>
<li class="">Las cantidades se localizan por sus <code>aria-label</code> (<code>Cantidad recibida OK de GUA-1</code>,
<code>Cantidad dañada de …</code>, <code>Resultado de inspección de …</code>), que es el contrato accesible
real de la tabla editable.</li>
<li class="">El cuerpo de las líneas se comprueba celda a celda para no depender del orden del DOM.</li>
</ul>
<h2 class="anchor anchorTargetStickyNavbar_Vzrq" id="3-cómo-verificarlo">3. Cómo verificarlo<a href="https://desobsesor.github.io/blog/2026-11-13-recepciones-pruebas-unitarias#3-c%C3%B3mo-verificarlo" class="hash-link" aria-label="Enlace directo al 3. Cómo verificarlo" title="Enlace directo al 3. Cómo verificarlo" translate="no">​</a></h2>
<div class="language-bash codeBlockContainer_Ckt0 theme-code-block" style="--prism-color:#393A34;--prism-background-color:#f6f8fa"><div class="codeBlockContent_QJqH"><pre tabindex="0" class="prism-code language-bash codeBlock_bY9V thin-scrollbar" style="color:#393A34;background-color:#f6f8fa"><code class="codeBlockLines_e6Vv"><div class="token-line" style="color:#393A34"><span class="token plain">cd ccf-almacen-web</span><br></div><div class="token-line" style="color:#393A34"><span class="token plain">npx jest src/__tests__/recepciones-gestion.test.tsx</span><br></div><div class="token-line" style="color:#393A34"><span class="token plain"># Test Suites: 1 passed, 1 total</span><br></div><div class="token-line" style="color:#393A34"><span class="token plain"># Tests:       28 passed, 28 total</span><br></div></code></pre></div></div>
<p><code>npx tsc --noEmit</code> y <code>npx eslint</code> pasan sin errores.</p>
<h2 class="anchor anchorTargetStickyNavbar_Vzrq" id="archivos-clave">Archivos clave<a href="https://desobsesor.github.io/blog/2026-11-13-recepciones-pruebas-unitarias#archivos-clave" class="hash-link" aria-label="Enlace directo al Archivos clave" title="Enlace directo al Archivos clave" translate="no">​</a></h2>
<ul>
<li class=""><code>ccf-almacen-web/src/__tests__/recepciones-gestion.test.tsx</code> — suite de la página.</li>
<li class=""><code>ccf-almacen-web/src/pages/recepciones.tsx</code> — listado, registro, detalle y estados.</li>
<li class=""><code>ccf-almacen-web/src/hooks/use-compras.ts</code> — consultas y mutaciones de la recepción.</li>
<li class=""><code>ccf-almacen-web/src/models/compras.entity.ts</code> — estados, inspección y <code>totalLineaRecepcion</code>.</li>
</ul>]]></content>
        <author>
            <name>Yovany Suárez Silva</name>
            <uri>https://desobsesor.github.io/portfolio-web/</uri>
        </author>
        <category label="Compras" term="Compras"/>
        <category label="Recepción" term="Recepción"/>
        <category label="Inventario" term="Inventario"/>
        <category label="Frontend" term="Frontend"/>
        <category label="Pruebas frontend" term="Pruebas frontend"/>
    </entry>
    <entry>
        <title type="html"><![CDATA[Seguridad — 2FA, IPs y políticas de contraseña bajo pruebas unitarias]]></title>
        <id>https://desobsesor.github.io/blog/2026-11-13-seguridad-2fa-ips-password-pruebas-unitarias</id>
        <link href="https://desobsesor.github.io/blog/2026-11-13-seguridad-2fa-ips-password-pruebas-unitarias"/>
        <updated>2026-11-13T00:00:00.000Z</updated>
        <summary type="html"><![CDATA[Las tres pantallas de configuración de seguridad —Seguridad 2FA (/seguridad-2fa,]]></summary>
        <content type="html"><![CDATA[<p>Las tres pantallas de configuración de seguridad —<strong>Seguridad 2FA</strong> (<code>/seguridad-2fa</code>,
TEC-006), <strong>Gestión de IPs</strong> (<code>/seguridad-ips</code>, REQ-SEC-18) y <strong>Políticas de contraseñas</strong>
(<code>/politicas-password</code>, TEC-009)— suman ahora <strong>48 casos</strong> de prueba.</p>
<h2 class="anchor anchorTargetStickyNavbar_Vzrq" id="1-qué-se-cubre">1. Qué se cubre<a href="https://desobsesor.github.io/blog/2026-11-13-seguridad-2fa-ips-password-pruebas-unitarias#1-qu%C3%A9-se-cubre" class="hash-link" aria-label="Enlace directo al 1. Qué se cubre" title="Enlace directo al 1. Qué se cubre" translate="no">​</a></h2>
<h3 class="anchor anchorTargetStickyNavbar_Vzrq" id="seguridad-2fa--src__tests__seguridad-2fa-gestiontesttsx-15-casos">Seguridad 2FA — <code>src/__tests__/seguridad-2fa-gestion.test.tsx</code> (15 casos)<a href="https://desobsesor.github.io/blog/2026-11-13-seguridad-2fa-ips-password-pruebas-unitarias#seguridad-2fa--src__tests__seguridad-2fa-gestiontesttsx-15-casos" class="hash-link" aria-label="Enlace directo al seguridad-2fa--src__tests__seguridad-2fa-gestiontesttsx-15-casos" title="Enlace directo al seguridad-2fa--src__tests__seguridad-2fa-gestiontesttsx-15-casos" translate="no">​</a></h3>
<table><thead><tr><th>Bloque</th><th>Qué fija</th></tr></thead><tbody><tr><td><strong>Política</strong></td><td>Espera, valores guardados (roles obligatorios, intentos, vigencia y emisor), última actualización y aviso si no hay política</td></tr><tr><td><strong>Guardado</strong></td><td>Payload con roles marcados, números y emisor; valores vacíos como <code>undefined</code>; respuesta nula y error</td></tr><tr><td><strong>Usuarios</strong></td><td>Nombre con <code>@usuario</code>, rol, estado «Activada/Desactivada», insignia «Obligatoria», fechas, códigos restantes y botón deshabilitado sin 2FA</td></tr><tr><td><strong>Listado</strong></td><td>Vacío, búsqueda con Enter, refresco y paginación</td></tr><tr><td><strong>Reinicio</strong></td><td>Confirmación con el texto de advertencia, reinicio efectivo con recarga, cancelación y respuesta sin confirmación</td></tr></tbody></table>
<h3 class="anchor anchorTargetStickyNavbar_Vzrq" id="gestión-de-ips--src__tests__seguridad-ips-gestiontesttsx-21-casos">Gestión de IPs — <code>src/__tests__/seguridad-ips-gestion.test.tsx</code> (21 casos)<a href="https://desobsesor.github.io/blog/2026-11-13-seguridad-2fa-ips-password-pruebas-unitarias#gesti%C3%B3n-de-ips--src__tests__seguridad-ips-gestiontesttsx-21-casos" class="hash-link" aria-label="Enlace directo al gestión-de-ips--src__tests__seguridad-ips-gestiontesttsx-21-casos" title="Enlace directo al gestión-de-ips--src__tests__seguridad-ips-gestiontesttsx-21-casos" translate="no">​</a></h3>
<table><thead><tr><th>Bloque</th><th>Qué fija</th></tr></thead><tbody><tr><td><strong>Bloqueadas</strong></td><td>Espera, error con reintento, tabla (IP, motivo, intentos, fechas, estado), vacío, filtro por IP y liberación deshabilitada si ya no está activa</td></tr><tr><td><strong>Detalle de IP</strong></td><td>Diálogo con riesgo, ubicación, red e indicadores (Proxy/VPN/Tor/Datacenter/Móvil) y su error</td></tr><tr><td><strong>Liberación</strong></td><td>Confirmación con la IP en el texto, aviso de éxito y error</td></tr><tr><td><strong>Confianza</strong></td><td>Tabla con razón, quién la registró, riesgo y estado; vacío con su acción</td></tr><tr><td><strong>Alta</strong></td><td>Validación previa por la API con su detalle, error de validación, exigencia de IP, alta con razón recortada (o indefinida) y error; baja con confirmación</td></tr></tbody></table>
<h3 class="anchor anchorTargetStickyNavbar_Vzrq" id="políticas-de-contraseñas--src__tests__politicas-password-gestiontesttsx-12-casos">Políticas de contraseñas — <code>src/__tests__/politicas-password-gestion.test.tsx</code> (12 casos)<a href="https://desobsesor.github.io/blog/2026-11-13-seguridad-2fa-ips-password-pruebas-unitarias#pol%C3%ADticas-de-contrase%C3%B1as--src__tests__politicas-password-gestiontesttsx-12-casos" class="hash-link" aria-label="Enlace directo al políticas-de-contraseñas--src__tests__politicas-password-gestiontesttsx-12-casos" title="Enlace directo al políticas-de-contraseñas--src__tests__politicas-password-gestiontesttsx-12-casos" translate="no">​</a></h3>
<table><thead><tr><th>Bloque</th><th>Qué fija</th></tr></thead><tbody><tr><td><strong>Política</strong></td><td>Espera, error con reintento, longitud, rotación, intentos, minutos, historial, interruptores de complejidad y de recuperación, reglas visibles y origen</td></tr><tr><td><strong>Guardado</strong></td><td>Payload completo con los cambios, aviso de guardado y error con <code>role="alert"</code>; refresco</td></tr><tr><td><strong>Cuentas</strong></td><td>Resumen de bloqueadas y vencidas, estados (Bloqueada con hora / Activa), contraseña (Vencida / días / sin rotación) y desbloqueo habilitado solo para bloqueadas</td></tr><tr><td><strong>Desbloqueo y filtros</strong></td><td>Desbloqueo con aviso y recarga, error, filtro por texto y por «solo bloqueadas» / «solo vencidas», y vacío</td></tr></tbody></table>
<h2 class="anchor anchorTargetStickyNavbar_Vzrq" id="2-patrón-de-las-pruebas">2. Patrón de las pruebas<a href="https://desobsesor.github.io/blog/2026-11-13-seguridad-2fa-ips-password-pruebas-unitarias#2-patr%C3%B3n-de-las-pruebas" class="hash-link" aria-label="Enlace directo al 2. Patrón de las pruebas" title="Enlace directo al 2. Patrón de las pruebas" translate="no">​</a></h2>
<ul>
<li class="">Se mockean las tres APIs (<code>two-factor</code>, <code>seguridad-ips</code>, <code>passwords</code>) y el <code>toast</code>; las pantallas
se montan completas.</li>
<li class="">Los interruptores Radix se localizan por <code>role="switch"</code> y su etiqueta.</li>
<li class="">En Gestión de IPs los botones de acción de la tabla solo declaran <code>title</code> (no <code>aria-label</code>), así
que se localizan por su <code>title</code> cuando hace falta o se comprueba el número de botones de la fila.</li>
<li class="">En Políticas de contraseñas los filtros de cuentas vuelven a consultar al cambiar: el panel
muestra el estado de carga mientras tanto, por lo que se espera a que reaparezca el control antes
de tocar el siguiente.</li>
</ul>
<h2 class="anchor anchorTargetStickyNavbar_Vzrq" id="3-cómo-verificarlo">3. Cómo verificarlo<a href="https://desobsesor.github.io/blog/2026-11-13-seguridad-2fa-ips-password-pruebas-unitarias#3-c%C3%B3mo-verificarlo" class="hash-link" aria-label="Enlace directo al 3. Cómo verificarlo" title="Enlace directo al 3. Cómo verificarlo" translate="no">​</a></h2>
<div class="language-bash codeBlockContainer_Ckt0 theme-code-block" style="--prism-color:#393A34;--prism-background-color:#f6f8fa"><div class="codeBlockContent_QJqH"><pre tabindex="0" class="prism-code language-bash codeBlock_bY9V thin-scrollbar" style="color:#393A34;background-color:#f6f8fa"><code class="codeBlockLines_e6Vv"><div class="token-line" style="color:#393A34"><span class="token plain">cd ccf-almacen-web</span><br></div><div class="token-line" style="color:#393A34"><span class="token plain">npx jest src/__tests__/seguridad-2fa-gestion.test.tsx src/__tests__/seguridad-ips-gestion.test.tsx src/__tests__/politicas-password-gestion.test.tsx</span><br></div><div class="token-line" style="color:#393A34"><span class="token plain"># Test Suites: 3 passed, 3 total</span><br></div><div class="token-line" style="color:#393A34"><span class="token plain"># Tests:       48 passed, 48 total</span><br></div></code></pre></div></div>
<p><code>npx tsc --noEmit</code> y <code>npx eslint</code> pasan sin errores.</p>
<h2 class="anchor anchorTargetStickyNavbar_Vzrq" id="archivos-clave">Archivos clave<a href="https://desobsesor.github.io/blog/2026-11-13-seguridad-2fa-ips-password-pruebas-unitarias#archivos-clave" class="hash-link" aria-label="Enlace directo al Archivos clave" title="Enlace directo al Archivos clave" translate="no">​</a></h2>
<ul>
<li class=""><code>ccf-almacen-web/src/__tests__/seguridad-2fa-gestion.test.tsx</code>.</li>
<li class=""><code>ccf-almacen-web/src/__tests__/seguridad-ips-gestion.test.tsx</code>.</li>
<li class=""><code>ccf-almacen-web/src/__tests__/politicas-password-gestion.test.tsx</code>.</li>
<li class=""><code>ccf-almacen-web/src/components/security/</code> — los tres paneles bajo prueba.</li>
</ul>]]></content>
        <author>
            <name>Yovany Suárez Silva</name>
            <uri>https://desobsesor.github.io/portfolio-web/</uri>
        </author>
        <category label="Seguridad" term="Seguridad"/>
        <category label="TEC-006" term="TEC-006"/>
        <category label="TEC-009" term="TEC-009"/>
        <category label="REQ-SEC-18" term="REQ-SEC-18"/>
        <category label="Frontend" term="Frontend"/>
        <category label="Pruebas frontend" term="Pruebas frontend"/>
    </entry>
    <entry>
        <title type="html"><![CDATA[Tickets y Webhooks — pruebas unitarias de soporte e integraciones salientes]]></title>
        <id>https://desobsesor.github.io/blog/2026-11-13-tickets-y-webhooks-pruebas-unitarias</id>
        <link href="https://desobsesor.github.io/blog/2026-11-13-tickets-y-webhooks-pruebas-unitarias"/>
        <updated>2026-11-13T00:00:00.000Z</updated>
        <summary type="html"><![CDATA[Tickets de soporte (/tickets, REQ-SUP-01) y Webhooks (/webhooks, TEC-011) son los]]></summary>
        <content type="html"><![CDATA[<p><strong>Tickets de soporte</strong> (<code>/tickets</code>, REQ-SUP-01) y <strong>Webhooks</strong> (<code>/webhooks</code>, TEC-011) son los
dos módulos de comunicación del sistema: uno recibe solicitudes de las áreas, el otro las emite
hacia sistemas de terceros. Ahora suman <strong>59 casos</strong> de prueba entre ambos, además del humo que
ya existía del panel.</p>
<h2 class="anchor anchorTargetStickyNavbar_Vzrq" id="1-qué-se-cubre">1. Qué se cubre<a href="https://desobsesor.github.io/blog/2026-11-13-tickets-y-webhooks-pruebas-unitarias#1-qu%C3%A9-se-cubre" class="hash-link" aria-label="Enlace directo al 1. Qué se cubre" title="Enlace directo al 1. Qué se cubre" translate="no">​</a></h2>
<h3 class="anchor anchorTargetStickyNavbar_Vzrq" id="tickets--src__tests__tickets-gestiontesttsx-35-casos">Tickets — <code>src/__tests__/tickets-gestion.test.tsx</code> (35 casos)<a href="https://desobsesor.github.io/blog/2026-11-13-tickets-y-webhooks-pruebas-unitarias#tickets--src__tests__tickets-gestiontesttsx-35-casos" class="hash-link" aria-label="Enlace directo al tickets--src__tests__tickets-gestiontesttsx-35-casos" title="Enlace directo al tickets--src__tests__tickets-gestiontesttsx-35-casos" translate="no">​</a></h3>
<table><thead><tr><th>Bloque</th><th>Qué fija</th></tr></thead><tbody><tr><td><strong>Listado</strong></td><td>Espera con esqueleto, columnas y datos (área, tipo, prioridad, estado, solicitante, asignado, tiempo, SLA, post-atención), vacío, error con reintento</td></tr><tr><td><strong>Filtros</strong></td><td>Búsqueda por botón y Enter, estado/área/tipo/prioridad, «Solo míos» (solo Administrador), SLA excedido, post-atención y «Limpiar filtros»</td></tr><tr><td><strong>Indicadores</strong></td><td>Cada tarjeta filtra su estado y se alterna; «Críticos» resuelve el código del catálogo; paginación y tamaño de página; refresco</td></tr><tr><td><strong>Alta</strong></td><td>Título y descripción obligatorios, área y tipo obligatorios, payload con prioridad/observaciones, registro post-atención con canal/fecha/atendido/estado inicial, error y visibilidad por rol</td></tr><tr><td><strong>Detalle</strong></td><td>Carga por id, información y tiempos/SLA, hilo de respuestas con evidencias, respuesta pública y nota interna con cambio de estado, error al responder, cambio de estado con confirmación, asignación, alta y baja de evidencias, estado final sin acciones y estados de carga/error</td></tr><tr><td><strong>Eliminación y tour</strong></td><td>Borrado con confirmación y error; recorrido guiado disponible o no</td></tr></tbody></table>
<h3 class="anchor anchorTargetStickyNavbar_Vzrq" id="webhooks--src__tests__webhooks-gestiontesttsx-24-casos">Webhooks — <code>src/__tests__/webhooks-gestion.test.tsx</code> (24 casos)<a href="https://desobsesor.github.io/blog/2026-11-13-tickets-y-webhooks-pruebas-unitarias#webhooks--src__tests__webhooks-gestiontesttsx-24-casos" class="hash-link" aria-label="Enlace directo al webhooks--src__tests__webhooks-gestiontesttsx-24-casos" title="Enlace directo al webhooks--src__tests__webhooks-gestiontesttsx-24-casos" translate="no">​</a></h3>
<table><thead><tr><th>Bloque</th><th>Qué fija</th></tr></thead><tbody><tr><td><strong>Panel</strong></td><td>Espera, error con reintento, resumen de la integración (activa/deshabilitada, activos, enviadas, fallidas), tabla con eventos y estado, vacío con su acción</td></tr><tr><td><strong>Entregas</strong></td><td>Filas con estado, intentos <code>n/m</code> y código HTTP; sin entregas; filtros por evento y estado; paginación por cursor con «Cargar más» y su error</td></tr><tr><td><strong>Alta y edición</strong></td><td>Al menos un evento, payload recortado con timeouts e intentos, secreto mostrado una sola vez, «Entendido» para ocultarlo, error al crear y edición precargada sin alterar eventos</td></tr><tr><td><strong>Acciones</strong></td><td>Envío de prueba, desactivación con confirmación, rotación de secreto con confirmación, reintento de entrega, «Actualizar» y cancelaciones sin efectos</td></tr></tbody></table>
<h2 class="anchor anchorTargetStickyNavbar_Vzrq" id="2-un-defecto-real-corregido">2. Un defecto real corregido<a href="https://desobsesor.github.io/blog/2026-11-13-tickets-y-webhooks-pruebas-unitarias#2-un-defecto-real-corregido" class="hash-link" aria-label="Enlace directo al 2. Un defecto real corregido" title="Enlace directo al 2. Un defecto real corregido" translate="no">​</a></h2>
<p>Al abrir el detalle de un ticket con evidencias, <code>urlEvidencia()</code> leía <code>config[environment]</code> y
el mapa solo declara <code>development</code> y <code>production</code>: con cualquier otro <code>NODE_ENV</code> (las pruebas,
por ejemplo) la entrada es <code>undefined</code> y el render del detalle rompía con
<code>Cannot read properties of undefined (reading 'apiDashboard')</code>. Ahora cae a <code>config.development</code>
cuando el entorno no está declarado, de modo que la URL de la evidencia se resuelve igual que
en desarrollo.</p>
<h2 class="anchor anchorTargetStickyNavbar_Vzrq" id="3-patrón-de-las-pruebas">3. Patrón de las pruebas<a href="https://desobsesor.github.io/blog/2026-11-13-tickets-y-webhooks-pruebas-unitarias#3-patr%C3%B3n-de-las-pruebas" class="hash-link" aria-label="Enlace directo al 3. Patrón de las pruebas" title="Enlace directo al 3. Patrón de las pruebas" translate="no">​</a></h2>
<ul>
<li class=""><strong>Tickets</strong>: se mockean los hooks de React Query (<code>use-tickets</code>), el <code>toast</code>, el tour y la
configuración de API; el panel se monta con sus hijos reales (indicadores, rejilla, alta y
detalle) dentro de un <code>QueryClientProvider</code>.</li>
<li class="">Las mutaciones se resuelven invocando lo que devuelve <code>mutateAsync</code> y se comprueba el cuerpo
exacto que llega al API.</li>
<li class=""><strong>Webhooks</strong>: se mockean las funciones de <code>api/webhooks</code> y <code>sonner</code>; las confirmaciones pasan
por el modal del sistema (<code>AlertDialog</code>).</li>
<li class="">Los estados de carga de los esqueletos se localizan por <code>role="status"</code> y su <code>aria-label</code>
(«Cargando tickets…», «Cargando webhooks…»), no por texto visible.</li>
</ul>
<h2 class="anchor anchorTargetStickyNavbar_Vzrq" id="4-cómo-verificarlo">4. Cómo verificarlo<a href="https://desobsesor.github.io/blog/2026-11-13-tickets-y-webhooks-pruebas-unitarias#4-c%C3%B3mo-verificarlo" class="hash-link" aria-label="Enlace directo al 4. Cómo verificarlo" title="Enlace directo al 4. Cómo verificarlo" translate="no">​</a></h2>
<div class="language-bash codeBlockContainer_Ckt0 theme-code-block" style="--prism-color:#393A34;--prism-background-color:#f6f8fa"><div class="codeBlockContent_QJqH"><pre tabindex="0" class="prism-code language-bash codeBlock_bY9V thin-scrollbar" style="color:#393A34;background-color:#f6f8fa"><code class="codeBlockLines_e6Vv"><div class="token-line" style="color:#393A34"><span class="token plain">cd ccf-almacen-web</span><br></div><div class="token-line" style="color:#393A34"><span class="token plain">npx jest src/__tests__/tickets-gestion.test.tsx src/__tests__/webhooks-gestion.test.tsx</span><br></div><div class="token-line" style="color:#393A34"><span class="token plain"># Test Suites: 2 passed, 2 total</span><br></div><div class="token-line" style="color:#393A34"><span class="token plain"># Tests:       59 passed, 59 total</span><br></div></code></pre></div></div>
<p><code>npx tsc --noEmit</code> y <code>npx eslint</code> pasan sin errores.</p>
<h2 class="anchor anchorTargetStickyNavbar_Vzrq" id="archivos-clave">Archivos clave<a href="https://desobsesor.github.io/blog/2026-11-13-tickets-y-webhooks-pruebas-unitarias#archivos-clave" class="hash-link" aria-label="Enlace directo al Archivos clave" title="Enlace directo al Archivos clave" translate="no">​</a></h2>
<ul>
<li class=""><code>ccf-almacen-web/src/__tests__/tickets-gestion.test.tsx</code> — suite del panel de soporte.</li>
<li class=""><code>ccf-almacen-web/src/__tests__/webhooks-gestion.test.tsx</code> — suite de administración de webhooks.</li>
<li class=""><code>ccf-almacen-web/src/components/tickets/</code> — panel, rejilla, alta, detalle y catálogos.</li>
<li class=""><code>ccf-almacen-web/src/components/webhooks/webhooks-dashboard.tsx</code> — CRUD, secreto y entregas.</li>
<li class=""><code>ccf-almacen-web/src/components/tickets/ticket-catalogos.ts</code> — corrección de <code>urlEvidencia()</code>.</li>
</ul>]]></content>
        <author>
            <name>Yovany Suárez Silva</name>
            <uri>https://desobsesor.github.io/portfolio-web/</uri>
        </author>
        <category label="Tickets" term="Tickets"/>
        <category label="Soporte" term="Soporte"/>
        <category label="Webhooks" term="Webhooks"/>
        <category label="TEC-011" term="TEC-011"/>
        <category label="Frontend" term="Frontend"/>
        <category label="Pruebas frontend" term="Pruebas frontend"/>
    </entry>
    <entry>
        <title type="html"><![CDATA[Agenda de la clínica — pruebas de la pantalla completa (42 casos nuevos)]]></title>
        <id>https://desobsesor.github.io/blog/2026-11-12-agenda-veterinaria-pruebas-unitarias</id>
        <link href="https://desobsesor.github.io/blog/2026-11-12-agenda-veterinaria-pruebas-unitarias"/>
        <updated>2026-11-12T00:00:00.000Z</updated>
        <summary type="html"><![CDATA[La pantalla Agenda de la clínica (veterinaria-agenda) solo tenía cubierto su]]></summary>
        <content type="html"><![CDATA[<p>La pantalla <strong>Agenda de la clínica</strong> (<code>veterinaria-agenda</code>) solo tenía cubierto su
<strong>tour guiado</strong>: se verificaban los anclajes y los guiones, pero nada de lo que la
pantalla hace. Un cambio en los filtros, en la paginación, en las transiciones de
una cita o en el alta podía romperse sin que ninguna prueba lo detectara. Se añade
una suite de comportamiento que recorre la pantalla completa.</p>
<h2 class="anchor anchorTargetStickyNavbar_Vzrq" id="qué-cambió">Qué cambió<a href="https://desobsesor.github.io/blog/2026-11-12-agenda-veterinaria-pruebas-unitarias#qu%C3%A9-cambi%C3%B3" class="hash-link" aria-label="Enlace directo al Qué cambió" title="Enlace directo al Qué cambió" translate="no">​</a></h2>
<ul>
<li class=""><strong>Nueva suite</strong> <code>ccf-almacen-web/src/components/__tests__/veterinaria-agenda.test.tsx</code>
con <strong>42 casos</strong> agrupados en cinco bloques (carga y estados, filtros y
paginación, detalle de la cita, nueva cita y ruta <code>/veterinaria-agenda</code>).</li>
<li class="">Se suman al <code>veterinaria-agenda-tour.test.tsx</code> que ya existía: el tour sigue
cubierto por su propia suite y la funcionalidad por la nueva.</li>
</ul>
<h2 class="anchor anchorTargetStickyNavbar_Vzrq" id="qué-queda-fijado">Qué queda fijado<a href="https://desobsesor.github.io/blog/2026-11-12-agenda-veterinaria-pruebas-unitarias#qu%C3%A9-queda-fijado" class="hash-link" aria-label="Enlace directo al Qué queda fijado" title="Enlace directo al Qué queda fijado" translate="no">​</a></h2>
<table><thead><tr><th>Bloque</th><th>Qué se comprueba</th></tr></thead><tbody><tr><td><strong>Carga y estados</strong></td><td>Columnas y formatos del sistema (fecha y hora, valor en pesos, teléfono <code>(300)-123-4567</code>), la carga con su indicador, la lista vacía, el error de consulta y el aviso cuando la base de la clínica no responde</td></tr><tr><td><strong>Filtros y paginación</strong></td><td>La consulta inicial (fecha del día, 20 por página, sin filtros), el filtro por fecha y por estado, la búsqueda libre, el botón <strong>Buscar</strong> (vuelve a la página 1), <strong>Limpiar filtros</strong>, <strong>Refrescar</strong>, el paginador (avance, retroceso y botones deshabilitados) y el contador de citas de la fecha</td></tr><tr><td><strong>Detalle de la cita</strong></td><td>Datos del cliente, la mascota y el médico; hora, duración y valor; pagos; motivo de cancelación; <strong>solo</strong> las transiciones que autoriza el servidor; confirmar, anular con motivo, marcar inasistencia, reprogramar (con y sin fecha/hora), los errores de cada acción y el cierre</td></tr><tr><td><strong>Nueva cita</strong></td><td>Carga de médicos y servicios <strong>sin los inactivos</strong>, búsqueda de cliente (mínimo 2 caracteres, Enter, resultados y error), carga de las mascotas del cliente, las validaciones del alta, el alta completa con su pago de precio y nota, el alta sin valor ni nota, el error del servidor y el cierre</td></tr><tr><td><strong>Ruta</strong></td><td>Que la página monte la agenda y que sin sesión redirija al armazón</td></tr></tbody></table>
<p>Las fronteras se mockean como en el resto de las suites del módulo
(<code>api/veterinaria</code> y <code>sonner</code>); no se depende del API ni de la base de datos.</p>
<h2 class="anchor anchorTargetStickyNavbar_Vzrq" id="detalle-técnico">Detalle técnico<a href="https://desobsesor.github.io/blog/2026-11-12-agenda-veterinaria-pruebas-unitarias#detalle-t%C3%A9cnico" class="hash-link" aria-label="Enlace directo al Detalle técnico" title="Enlace directo al Detalle técnico" translate="no">​</a></h2>
<p>Los <code>Select</code> de shadcn/Radix que viven <strong>dentro</strong> de un diálogo hacían desbordar la
pila en jsdom: el diálogo y el <code>Select</code> montan cada uno un <code>FocusScope</code> y, al venir
de copias distintas del paquete (<code>@radix-ui/react-select/node_modules/…</code>), los dos
ámbitos se reenfocan mutuamente. La suite usa la utilidad compartida
<code>src/test-utils/radix.ts</code> (<code>anularFocoProgramatico</code>), que anula el foco programático
y deja el motivo escrito una sola vez para todo el módulo.</p>
<h2 class="anchor anchorTargetStickyNavbar_Vzrq" id="cómo-verificarlo">Cómo verificarlo<a href="https://desobsesor.github.io/blog/2026-11-12-agenda-veterinaria-pruebas-unitarias#c%C3%B3mo-verificarlo" class="hash-link" aria-label="Enlace directo al Cómo verificarlo" title="Enlace directo al Cómo verificarlo" translate="no">​</a></h2>
<div class="language-bash codeBlockContainer_Ckt0 theme-code-block" style="--prism-color:#393A34;--prism-background-color:#f6f8fa"><div class="codeBlockContent_QJqH"><pre tabindex="0" class="prism-code language-bash codeBlock_bY9V thin-scrollbar" style="color:#393A34;background-color:#f6f8fa"><code class="codeBlockLines_e6Vv"><div class="token-line" style="color:#393A34"><span class="token plain">cd ccf-almacen-web</span><br></div><div class="token-line" style="color:#393A34"><span class="token plain">npx jest src/components/__tests__/veterinaria-agenda.test.tsx</span><br></div></code></pre></div></div>
<p>Resultado esperado: <code>Tests: 42 passed, 42 total</code>. <code>npx tsc --noEmit</code> y
<code>npx eslint src/components/__tests__/veterinaria-agenda.test.tsx</code> siguen limpios.</p>
<h2 class="anchor anchorTargetStickyNavbar_Vzrq" id="archivos-clave">Archivos clave<a href="https://desobsesor.github.io/blog/2026-11-12-agenda-veterinaria-pruebas-unitarias#archivos-clave" class="hash-link" aria-label="Enlace directo al Archivos clave" title="Enlace directo al Archivos clave" translate="no">​</a></h2>
<ul>
<li class=""><code>ccf-almacen-web/src/components/__tests__/veterinaria-agenda.test.tsx</code> — suite
nueva (42 casos).</li>
<li class=""><code>ccf-almacen-web/src/components/veterinaria/veterinaria-agenda.tsx</code> — pantalla
bajo prueba (sin cambios).</li>
<li class=""><code>ccf-almacen-web/src/pages/veterinaria-agenda.tsx</code> — ruta con la guarda de sesión
(sin cambios).</li>
</ul>]]></content>
        <author>
            <name>Yovany Suárez Silva</name>
            <uri>https://desobsesor.github.io/portfolio-web/</uri>
        </author>
        <category label="Veterinaria" term="Veterinaria"/>
        <category label="Agenda" term="Agenda"/>
        <category label="Frontend" term="Frontend"/>
        <category label="Pruebas frontend" term="Pruebas frontend"/>
    </entry>
    <entry>
        <title type="html"><![CDATA[Arnés de pruebas — las lecciones dejan de ser prosa y pasan a ser código]]></title>
        <id>https://desobsesor.github.io/blog/2026-11-12-arnes-lecciones-a-codigo</id>
        <link href="https://desobsesor.github.io/blog/2026-11-12-arnes-lecciones-a-codigo"/>
        <updated>2026-11-12T00:00:00.000Z</updated>
        <summary type="html"><![CDATA[Al escribir las nueve suites del módulo de veterinaria quedaron siete lecciones]]></summary>
        <content type="html"><![CDATA[<p>Al escribir las nueve suites del módulo de veterinaria quedaron siete lecciones
apuntadas en los changelogs. Este ajuste las convierte en <strong>código compartido y
aplicado</strong>: un solo módulo de utilidades, un helper por lección, las suites de tour
migradas y una suite que verifica el propio arnés.</p>
<h2 class="anchor anchorTargetStickyNavbar_Vzrq" id="1-un-helper-por-lección">1. Un helper por lección<a href="https://desobsesor.github.io/blog/2026-11-12-arnes-lecciones-a-codigo#1-un-helper-por-lecci%C3%B3n" class="hash-link" aria-label="Enlace directo al 1. Un helper por lección" title="Enlace directo al 1. Un helper por lección" translate="no">​</a></h2>
<p><code>ccf-almacen-web/src/test-utils/radix.ts</code> es ahora la fuente única. Su cabecera
enumera las siete reglas y cada una tiene su utilidad:</p>
<table><thead><tr><th>Lección</th><th>Utilidad</th></tr></thead><tbody><tr><td><code>FocusScope</code> de Radix entre diálogo y <code>Select</code> desborda la pila en jsdom</td><td><code>anularFocoProgramatico()</code></td></tr><tr><td>Radix activa la pestaña en <code>mouseDown</code> y desmonta el contenido inactivo</td><td><code>abrirPestana()</code></td></tr><tr><td>Abrir un <code>Select</code> y elegir opción del portal</td><td><code>combo()</code> / <code>elegirEnCombo()</code></td></tr><tr><td>Acceso a formularios y anclajes <code>data-tour</code></td><td><code>campo()</code> / <code>elementosConAncla()</code></td></tr><tr><td>Textos y cabeceras duplicados entre bloques y tablas</td><td><code>elementoConAncla()</code> + <code>within(...)</code></td></tr><tr><td>El aviso se publica una microtarea después del <code>await</code> del API</td><td><code>esperarToast()</code></td></tr><tr><td>Los helpers no pueden vivir bajo <code>__tests__/</code></td><td>El módulo está en <code>src/test-utils/</code></td></tr></tbody></table>
<p><code>getByText</code> (solo nodos de texto directos) y los nombres accesibles repetidos
(anclar la expresión, <code>/^Luna/</code>) no se resuelven con una función, así que quedan
escritos como regla en la cabecera del módulo.</p>
<h2 class="anchor anchorTargetStickyNavbar_Vzrq" id="2-aplicado-en-el-trabajo-existente">2. Aplicado en el trabajo existente<a href="https://desobsesor.github.io/blog/2026-11-12-arnes-lecciones-a-codigo#2-aplicado-en-el-trabajo-existente" class="hash-link" aria-label="Enlace directo al 2. Aplicado en el trabajo existente" title="Enlace directo al 2. Aplicado en el trabajo existente" translate="no">​</a></h2>
<ul>
<li class=""><strong><code>elementoConAncla</code></strong> sustituye a los tres <code>kpi()</code>/<code>tarjeta()</code> escritos a mano
(cartera, calificaciones y tablero).</li>
<li class=""><strong><code>esperarToast</code></strong> reemplaza las aserciones que podían ver cero llamadas por
llegar antes que el aviso: cartera (abono y cobro de servicio), documentos
(envío y reintentos), personal (alta, edición, contraseña y baja) y calificaciones
(publicar y retirar la respuesta).</li>
<li class=""><strong><code>abrirPestana</code></strong> reemplaza las cuatro copias locales del gesto de pestaña: las
tres suites de tour (cartera, catálogo, sanidad) y la de pacientes, que lo hacía
en línea.</li>
</ul>
<h2 class="anchor anchorTargetStickyNavbar_Vzrq" id="3-el-arnés-tiene-su-propia-suite">3. El arnés tiene su propia suite<a href="https://desobsesor.github.io/blog/2026-11-12-arnes-lecciones-a-codigo#3-el-arn%C3%A9s-tiene-su-propia-suite" class="hash-link" aria-label="Enlace directo al 3. El arnés tiene su propia suite" title="Enlace directo al 3. El arnés tiene su propia suite" translate="no">​</a></h2>
<p><code>ccf-almacen-web/src/components/__tests__/test-utils-radix.test.tsx</code> (7 casos)
ejercita las utilidades con los componentes reales:</p>
<ul>
<li class="">un <strong>diálogo con <code>Select</code></strong> dentro (el caso que desbordaba la pila) se abre y se
elige una opción;</li>
<li class="">una pestaña cambia y <strong>desmonta</strong> la anterior;</li>
<li class=""><code>elementoConAncla</code> devuelve el primer nodo y falla nombrando el ancla ausente;</li>
<li class=""><code>esperarToast</code> aguarda el aviso de la microtarea siguiente y acepta expresión
regular.</li>
</ul>
<p>Si Radix cambia de comportamiento o alguien toca el módulo, falla aquí una vez, no
en las nueve pantallas.</p>
<h2 class="anchor anchorTargetStickyNavbar_Vzrq" id="cómo-verificarlo">Cómo verificarlo<a href="https://desobsesor.github.io/blog/2026-11-12-arnes-lecciones-a-codigo#c%C3%B3mo-verificarlo" class="hash-link" aria-label="Enlace directo al Cómo verificarlo" title="Enlace directo al Cómo verificarlo" translate="no">​</a></h2>
<div class="language-bash codeBlockContainer_Ckt0 theme-code-block" style="--prism-color:#393A34;--prism-background-color:#f6f8fa"><div class="codeBlockContent_QJqH"><pre tabindex="0" class="prism-code language-bash codeBlock_bY9V thin-scrollbar" style="color:#393A34;background-color:#f6f8fa"><code class="codeBlockLines_e6Vv"><div class="token-line" style="color:#393A34"><span class="token plain">cd ccf-almacen-web</span><br></div><div class="token-line" style="color:#393A34"><span class="token plain">npx jest src/components/__tests__/test-utils-radix.test.tsx</span><br></div><div class="token-line" style="color:#393A34"><span class="token plain"># Tests: 7 passed, 7 total</span><br></div><div class="token-line" style="color:#393A34"><span class="token plain">npx jest src/components/__tests__/veterinaria src/components/__tests__/test-utils-radix.test.tsx</span><br></div><div class="token-line" style="color:#393A34"><span class="token plain"># 26 suites, 458 pruebas en verde</span><br></div><div class="token-line" style="color:#393A34"><span class="token plain">npx jest --listTests | grep "src/test-utils/"   # no debe devolver nada: el helper no es una suite</span><br></div></code></pre></div></div>
<p><code>npx tsc --noEmit</code> y <code>npx eslint</code> siguen limpios.</p>
<h2 class="anchor anchorTargetStickyNavbar_Vzrq" id="archivos-clave">Archivos clave<a href="https://desobsesor.github.io/blog/2026-11-12-arnes-lecciones-a-codigo#archivos-clave" class="hash-link" aria-label="Enlace directo al Archivos clave" title="Enlace directo al Archivos clave" translate="no">​</a></h2>
<ul>
<li class=""><code>ccf-almacen-web/src/test-utils/radix.ts</code> — utilidades y las siete reglas.</li>
<li class=""><code>ccf-almacen-web/src/components/__tests__/test-utils-radix.test.tsx</code> — red de seguridad del arnés.</li>
<li class=""><code>ccf-almacen-web/src/components/__tests__/veterinaria-cartera.test.tsx</code>,
<code>veterinaria-calificaciones.test.tsx</code>, <code>veterinaria-dashboard.test.tsx</code>,
<code>veterinaria-documentos.test.tsx</code> y <code>veterinaria-personal.test.tsx</code> — consumen
<code>elementoConAncla</code> y <code>esperarToast</code>.</li>
<li class=""><code>ccf-almacen-web/src/components/__tests__/veterinaria-*-tour.test.tsx</code> — usan
<code>abrirPestana</code> en lugar de su copia local.</li>
</ul>]]></content>
        <author>
            <name>Yovany Suárez Silva</name>
            <uri>https://desobsesor.github.io/portfolio-web/</uri>
        </author>
        <category label="Frontend" term="Frontend"/>
        <category label="Pruebas frontend" term="Pruebas frontend"/>
        <category label="Documentación" term="Documentación"/>
    </entry>
    <entry>
        <title type="html"><![CDATA[Arnés de pruebas — utilidades de Radix y taxonomía del blog al día]]></title>
        <id>https://desobsesor.github.io/blog/2026-11-12-arnes-pruebas-radix-y-taxonomia-blog</id>
        <link href="https://desobsesor.github.io/blog/2026-11-12-arnes-pruebas-radix-y-taxonomia-blog"/>
        <updated>2026-11-12T00:00:00.000Z</updated>
        <summary type="html"><![CDATA[Dos ajustes que salieron de escribir las suites de veterinaria: los detalles del]]></summary>
        <content type="html"><![CDATA[<p>Dos ajustes que salieron de escribir las suites de veterinaria: los detalles del
entorno de Radix dejan de repetirse en cada archivo de pruebas, y la taxonomía del
blog vuelve a pasar su verificador, que llevaba doce avisos acumulados.</p>
<h2 class="anchor anchorTargetStickyNavbar_Vzrq" id="1-utilidades-de-prueba-compartidas">1. Utilidades de prueba compartidas<a href="https://desobsesor.github.io/blog/2026-11-12-arnes-pruebas-radix-y-taxonomia-blog#1-utilidades-de-prueba-compartidas" class="hash-link" aria-label="Enlace directo al 1. Utilidades de prueba compartidas" title="Enlace directo al 1. Utilidades de prueba compartidas" translate="no">​</a></h2>
<p>Nuevo módulo <code>ccf-almacen-web/src/test-utils/radix.ts</code>, usado ya por las suites de
<strong>Agenda</strong> y de <strong>Clientes y mascotas</strong>:</p>
<table><thead><tr><th>Utilidad</th><th>Qué resuelve</th></tr></thead><tbody><tr><td><code>anularFocoProgramatico()</code></td><td>El ciclo de <code>FocusScope</code> entre diálogo y <code>Select</code> en jsdom (dos copias del paquete que se reenfocan mutuamente hasta desbordar la pila)</td></tr><tr><td><code>abrirPestana(nombre)</code></td><td>Radix activa la pestaña en <code>mouseDown</code>; dispara el gesto y espera a <code>data-state="active"</code></td></tr><tr><td><code>elegirEnCombo(modal, indice, nombre)</code> y <code>combo(...)</code></td><td>Abrir un <code>Select</code> y elegir una opción del portal</td></tr><tr><td><code>campo(id)</code> y <code>elementosConAncla(ancla)</code></td><td>Acceso a los formularios y a los anclajes <code>data-tour</code></td></tr></tbody></table>
<p>Antes, el bloqueo del foco programático vivía copiado en cada suite, con el mismo
comentario. Ahora el motivo está escrito una sola vez y la próxima pantalla del
módulo lo hereda sin redescubrirlo.</p>
<blockquote>
<p>Estas utilidades no sustituyen a las pruebas de accesibilidad: la navegación por
teclado necesita foco real y se valida con Playwright (ADR-009).</p>
</blockquote>
<h2 class="anchor anchorTargetStickyNavbar_Vzrq" id="2-taxonomía-del-blog">2. Taxonomía del blog<a href="https://desobsesor.github.io/blog/2026-11-12-arnes-pruebas-radix-y-taxonomia-blog#2-taxonom%C3%ADa-del-blog" class="hash-link" aria-label="Enlace directo al 2. Taxonomía del blog" title="Enlace directo al 2. Taxonomía del blog" translate="no">​</a></h2>
<p><code>npm run verificar:etiquetas</code> volvía con <strong>12 problemas</strong>: posts que usaban
etiquetas no declaradas o variantes de una ya existente (<code>POS</code> frente a <code>pos</code>,
<code>menú</code> frente a <code>menu</code>, <code>panel lateral</code> frente a <code>panel-lateral</code>).</p>
<ul>
<li class=""><strong>Seis etiquetas nuevas declaradas</strong> en <code>blog/tags.yml</code>: <code>REQ-DOC-02</code>, <code>TEC-010</code>,
<code>TEC-016</code>, <code>estadisticas</code>, <code>offline</code>, <code>panel-lateral</code>, <code>pwa</code>, <code>service-worker</code> y
<code>v2-3</code>, con su <code>label</code> en la grafía correcta y su <code>permalink</code>.</li>
<li class=""><strong>Tres posts corregidos</strong> para usar la clave existente: <code>2026-11-06-almacenes-formulario-completo</code>
(<code>POS</code> → <code>pos</code>), <code>2026-11-11-menu-solicitudes-listado</code> (<code>menú</code> → <code>menu</code>, <code>panel lateral</code>
→ <code>panel-lateral</code>) y <code>2026-11-11-tooltip-solicitudes-se-cierra</code> (<code>panel lateral</code> →
<code>panel-lateral</code>), además de <code>2026-11-11-sala-de-continuidad</code> (<code>PWA</code> → <code>pwa</code>).</li>
<li class=""><strong>Resultado:</strong> <code>Taxonomía del blog correcta: 247 etiquetas en uso, 249 declaradas, 2 autores</code>. Solo quedan dos declaradas sin uso (<code>docusaurus</code>, <code>tecnologia</code>), que el
verificador informa y no consideran error.</li>
</ul>
<h2 class="anchor anchorTargetStickyNavbar_Vzrq" id="cómo-verificarlo">Cómo verificarlo<a href="https://desobsesor.github.io/blog/2026-11-12-arnes-pruebas-radix-y-taxonomia-blog#c%C3%B3mo-verificarlo" class="hash-link" aria-label="Enlace directo al Cómo verificarlo" title="Enlace directo al Cómo verificarlo" translate="no">​</a></h2>
<div class="language-bash codeBlockContainer_Ckt0 theme-code-block" style="--prism-color:#393A34;--prism-background-color:#f6f8fa"><div class="codeBlockContent_QJqH"><pre tabindex="0" class="prism-code language-bash codeBlock_bY9V thin-scrollbar" style="color:#393A34;background-color:#f6f8fa"><code class="codeBlockLines_e6Vv"><div class="token-line" style="color:#393A34"><span class="token plain">cd ccf-almacen-web</span><br></div><div class="token-line" style="color:#393A34"><span class="token plain">npx jest src/components/__tests__/veterinaria-agenda.test.tsx src/components/__tests__/veterinaria-pacientes.test.tsx</span><br></div><div class="token-line" style="color:#393A34"><span class="token plain"># Tests: 94 passed, 94 total</span><br></div><div class="token-line" style="color:#393A34"><span class="token plain" style="display:inline-block"></span><br></div><div class="token-line" style="color:#393A34"><span class="token plain">cd ../ccf-almacen-wiki</span><br></div><div class="token-line" style="color:#393A34"><span class="token plain">npm run verificar:etiquetas</span><br></div><div class="token-line" style="color:#393A34"><span class="token plain"># Taxonomía del blog correcta</span><br></div></code></pre></div></div>
<p><code>npx tsc --noEmit</code> y <code>npx eslint</code> siguen limpios en el web.</p>
<h2 class="anchor anchorTargetStickyNavbar_Vzrq" id="archivos-clave">Archivos clave<a href="https://desobsesor.github.io/blog/2026-11-12-arnes-pruebas-radix-y-taxonomia-blog#archivos-clave" class="hash-link" aria-label="Enlace directo al Archivos clave" title="Enlace directo al Archivos clave" translate="no">​</a></h2>
<ul>
<li class=""><code>ccf-almacen-web/src/test-utils/radix.ts</code> — utilidades nuevas.</li>
<li class=""><code>ccf-almacen-web/src/components/__tests__/veterinaria-agenda.test.tsx</code> y
<code>veterinaria-pacientes.test.tsx</code> — usan las utilidades (sin los bloques copiados).</li>
<li class=""><code>ccf-almacen-wiki/blog/tags.yml</code> — etiquetas declaradas.</li>
<li class=""><code>ccf-almacen-wiki/blog/2026-11-06-almacenes-formulario-completo.md</code>,
<code>2026-11-11-menu-solicitudes-listado.md</code>,
<code>2026-11-11-tooltip-solicitudes-se-cierra.md</code>,
<code>2026-11-11-sala-de-continuidad.md</code> — claves corregidas.</li>
</ul>]]></content>
        <author>
            <name>Yovany Suárez Silva</name>
            <uri>https://desobsesor.github.io/portfolio-web/</uri>
        </author>
        <category label="Frontend" term="Frontend"/>
        <category label="Pruebas frontend" term="Pruebas frontend"/>
        <category label="Documentación" term="Documentación"/>
    </entry>
    <entry>
        <title type="html"><![CDATA[Calificaciones y NPS — la fecha local, el aviso de error y dos correcciones más]]></title>
        <id>https://desobsesor.github.io/blog/2026-11-12-calificaciones-nps-pruebas-unitarias</id>
        <link href="https://desobsesor.github.io/blog/2026-11-12-calificaciones-nps-pruebas-unitarias"/>
        <updated>2026-11-12T00:00:00.000Z</updated>
        <summary type="html"><![CDATA[La pantalla Calificaciones y NPS ya tenía cubierto el recorrido principal (24 casos).]]></summary>
        <content type="html"><![CDATA[<p>La pantalla <strong>Calificaciones y NPS</strong> ya tenía cubierto el recorrido principal (24 casos).
Al completar lo que faltaba —semáforos, fecha, estrellas, estados del diálogo y fallos de
carga— aparecieron tres defectos reales: la fecha de una reseña podía saltar de día, una
carga fallida se disfrazaba de «no hay reseñas» y el botón de responder se anunciaba «de el
cliente».</p>
<h2 class="anchor anchorTargetStickyNavbar_Vzrq" id="1-qué-se-añadió-14-casos">1. Qué se añadió (14 casos)<a href="https://desobsesor.github.io/blog/2026-11-12-calificaciones-nps-pruebas-unitarias#1-qu%C3%A9-se-a%C3%B1adi%C3%B3-14-casos" class="hash-link" aria-label="Enlace directo al 1. Qué se añadió (14 casos)" title="Enlace directo al 1. Qué se añadió (14 casos)" translate="no">​</a></h2>
<p><code>ccf-almacen-web/src/components/__tests__/veterinaria-calificaciones-nps.test.tsx</code>:</p>
<table><thead><tr><th>Bloque</th><th>Qué fija</th></tr></thead><tbody><tr><td><strong>Fecha y estrellas</strong></td><td>La reseña de las 21:00 en Colombia conserva su día (no salta al siguiente por el instante UTC); una reseña sin fecha deja el guion; las estrellas rellenas coinciden con la calificación (2 de 5 → 2 rellenas, 5 de 5 → 5)</td></tr><tr><td><strong>Semáforos</strong></td><td>NPS negativo en rojo y críticas pendientes en ámbar; NPS en cero y sin pendientes en verde</td></tr><tr><td><strong>Fallo de carga</strong></td><td>No se muestra «No hay reseñas con los filtros seleccionados» cuando el API falló; falla el listado o el resumen, en los dos casos hay aviso propio; <strong>Refrescar</strong> recupera el listado</td></tr><tr><td><strong>Respuesta</strong></td><td>El texto se limita a 800 caracteres; una reseña sin comentario deja el guion; mientras guarda el botón queda bloqueado y el diálogo abierto; reabrir el diálogo carga la respuesta de la reseña elegida</td></tr><tr><td><strong>Filtros</strong></td><td>Desmarcar «Solo críticas» retira el parámetro; «Sin responder» vuelve a la página 1</td></tr></tbody></table>
<h2 class="anchor anchorTargetStickyNavbar_Vzrq" id="2-defecto-corregido-la-fecha-de-la-reseña-podía-saltar-de-día">2. Defecto corregido: la fecha de la reseña podía saltar de día<a href="https://desobsesor.github.io/blog/2026-11-12-calificaciones-nps-pruebas-unitarias#2-defecto-corregido-la-fecha-de-la-rese%C3%B1a-pod%C3%ADa-saltar-de-d%C3%ADa" class="hash-link" aria-label="Enlace directo al 2. Defecto corregido: la fecha de la reseña podía saltar de día" title="Enlace directo al 2. Defecto corregido: la fecha de la reseña podía saltar de día" translate="no">​</a></h2>
<p>La celda recortaba el instante ISO (<code>creado.slice(0, 10)</code>), así que una reseña de las 21:00
en Colombia —02:00 UTC del día siguiente— aparecía con la fecha equivocada. Se añadió
<code>formatoFechaZona</code> a <code>veterinaria-ui.tsx</code>: pinta la fecha en <code>America/Bogota</code> cuando recibe
un instante y deja intactas las fechas de calendario.</p>
<p>El mismo patrón estaba en la <strong>cartera</strong> (fecha de los pagos, dos sitios) y en el <strong>personal</strong>
(fecha de alta), así que se aplicó allí también: un pago de las 20:00 ya no se muestra con el
día siguiente.</p>
<h2 class="anchor anchorTargetStickyNavbar_Vzrq" id="3-defecto-corregido-una-carga-fallida-se-veía-como-no-hay-reseñas">3. Defecto corregido: una carga fallida se veía como «no hay reseñas»<a href="https://desobsesor.github.io/blog/2026-11-12-calificaciones-nps-pruebas-unitarias#3-defecto-corregido-una-carga-fallida-se-ve%C3%ADa-como-no-hay-rese%C3%B1as" class="hash-link" aria-label="Enlace directo al 3. Defecto corregido: una carga fallida se veía como «no hay reseñas»" title="Enlace directo al 3. Defecto corregido: una carga fallida se veía como «no hay reseñas»" translate="no">​</a></h2>
<p>Cuando el API no respondía, la pantalla caía en el vacío del listado —«No hay reseñas con los
filtros seleccionados»—, que es falso y confunde al operador. Ahora hay un estado de error
propio: «No se pudieron cargar las reseñas. Revisa la conexión y pulsa Refrescar», y el botón
<strong>Refrescar</strong> recupera el listado cuando la conexión vuelve.</p>
<h2 class="anchor anchorTargetStickyNavbar_Vzrq" id="4-defecto-corregido-responder-la-reseña-de-el-cliente">4. Defecto corregido: «Responder la reseña de el cliente»<a href="https://desobsesor.github.io/blog/2026-11-12-calificaciones-nps-pruebas-unitarias#4-defecto-corregido-responder-la-rese%C3%B1a-de-el-cliente" class="hash-link" aria-label="Enlace directo al 4. Defecto corregido: «Responder la reseña de el cliente»" title="Enlace directo al 4. Defecto corregido: «Responder la reseña de el cliente»" translate="no">​</a></h2>
<p>El nombre accesible del botón se componía con un artículo suelto. Ahora una reseña sin cliente
se anuncia «Responder la reseña del cliente», y con cliente se mantiene «Responder la reseña de
Ana Pérez».</p>
<h2 class="anchor anchorTargetStickyNavbar_Vzrq" id="cómo-verificarlo">Cómo verificarlo<a href="https://desobsesor.github.io/blog/2026-11-12-calificaciones-nps-pruebas-unitarias#c%C3%B3mo-verificarlo" class="hash-link" aria-label="Enlace directo al Cómo verificarlo" title="Enlace directo al Cómo verificarlo" translate="no">​</a></h2>
<div class="language-bash codeBlockContainer_Ckt0 theme-code-block" style="--prism-color:#393A34;--prism-background-color:#f6f8fa"><div class="codeBlockContent_QJqH"><pre tabindex="0" class="prism-code language-bash codeBlock_bY9V thin-scrollbar" style="color:#393A34;background-color:#f6f8fa"><code class="codeBlockLines_e6Vv"><div class="token-line" style="color:#393A34"><span class="token plain">cd ccf-almacen-web</span><br></div><div class="token-line" style="color:#393A34"><span class="token plain">npx jest src/components/__tests__/veterinaria-calificaciones</span><br></div><div class="token-line" style="color:#393A34"><span class="token plain"># Tests: 42 passed, 42 total (3 suites)</span><br></div></code></pre></div></div>
<p><code>npx tsc --noEmit</code>, <code>npx eslint</code> y las suites de veterinaria (26 suites, 465 pruebas) siguen en
verde; la suite completa del web también.</p>
<h2 class="anchor anchorTargetStickyNavbar_Vzrq" id="archivos-clave">Archivos clave<a href="https://desobsesor.github.io/blog/2026-11-12-calificaciones-nps-pruebas-unitarias#archivos-clave" class="hash-link" aria-label="Enlace directo al Archivos clave" title="Enlace directo al Archivos clave" translate="no">​</a></h2>
<ul>
<li class=""><code>ccf-almacen-web/src/components/__tests__/veterinaria-calificaciones-nps.test.tsx</code> — suite nueva.</li>
<li class=""><code>ccf-almacen-web/src/components/veterinaria/veterinaria-ui.tsx</code> — <code>formatoFechaZona</code> (y <code>partesEnZonaNegocio</code>).</li>
<li class=""><code>ccf-almacen-web/src/components/veterinaria/veterinaria-calificaciones.tsx</code> — fecha local, estado de error y nombre accesible.</li>
<li class=""><code>ccf-almacen-web/src/components/veterinaria/veterinaria-cartera.tsx</code> y <code>veterinaria-personal.tsx</code> — misma fecha local en pagos y altas.</li>
<li class=""><code>ccf-almacen-wiki/docs/manuales/veterinaria/administracion-veterinaria.md</code> — apartado 8 actualizado.</li>
</ul>]]></content>
        <author>
            <name>Yovany Suárez Silva</name>
            <uri>https://desobsesor.github.io/portfolio-web/</uri>
        </author>
        <category label="Veterinaria" term="Veterinaria"/>
        <category label="NPS" term="NPS"/>
        <category label="Frontend" term="Frontend"/>
        <category label="Pruebas frontend" term="Pruebas frontend"/>
        <category label="Bugfix" term="Bugfix"/>
    </entry>
</feed>