Stock del taller

Tutorial paso a paso sobre el módulo Stock del taller en Despiece: administrar el inventario real de materia prima (tableros · herraje · cinta de canto) del taller, con alertas de stock bajo, libro de movimientos y las dos integraciones con el pedido de materiales (¿me alcanza? y pedido recibido). El módulo vive en un panel sheet full-screen que se abre con Shift+T o el botón [T] del topbar, el último del grupo de documentos.

01 Activar y abrir el sheet [T] Stock

Con el módulo prendido hay dos formas de abrir el sheet:

• Atajo Shift+T.
• Botón [T] del topbar, el último del grupo de documentos (Plano de taller · Presupuesto · Cliente · Clientes · Stock).

El botón lleva un badge rojo (#tb-stock-badge) con la cantidad de items bajo el mínimo; si no hay alertas queda oculto. El click abre o cierra el sheet, siempre en la pestaña Tableros.

02 Empty state y las tres pestañas

Se abre un panel sheet full-screen con header Stock del taller. Arriba a la derecha están todas las acciones del módulo:

Debajo: el input de búsqueda, la banner de alertas (si hay) y las tres pestañas con su contador:

• Tableros (n) — melamina/MDF/OSB típico Argentina/México (formato 1830×2750 ARG / 1220×2440 MX / 4'×8' imperial).
• Herraje (n) — unidades de un código del catálogo de herrajería.
• Cinta (n) — rollos de canto por material × espesor × ancho × largo.

La tira de tabs es un tablist WAI-ARIA: las flechas, Home y End mueven y cambian de pestaña. El tab al abrir es siempre Tableros; el sheet no salta a la pestaña con más alertas.

03 Cargar un tablero

Click en + Tablero abre el drawer con un tablero en borrador. Nada se escribe hasta que apretás Guardar: Cancelar o Esc descartan el borrador sin dejar rastro.

El ID interno lleva prefijo stkb: (tablero), stkh: (herraje) o stke: (cinta) más un UUID completo, para no colisionar con identificadores de proyecto.

04 La lista: columnas, alertas y footer

Tras guardar, la fila aparece en una lista de ocho columnas con encabezado: Material (o SKU en Herraje) · Medidas · Cantidad · Mínimo · $ unitario · Proveedor · Ubicación · Acciones.

Cuando Cantidad < Mínimo la fila se marca: Cantidad y Mínimo en rojo, y la celda de mínimo pasa de mín. 5 a mín. 5 faltan 2.

El footer del sheet resume la pestaña activa con tres datos separados por ·:

• 12 filas — o 3 de 12 filas cuando hay un filtro activo.
• 48 en stock — la suma de las cantidades, no el número de filas.
• Valorizado $ 384.000,00 — Σ cantidad × $ unitario. Si alguna fila visible no tiene precio dice Valorizado $ … (parcial: faltan costos): el total es un piso, no el inventario completo.

Si hay alertas, arriba de las pestañas aparece una banner que dice "Hay {n} items bajo el mínimo." con un botón Ver solo los que faltan. Ese botón es el filtro: deja en la lista únicamente las filas bajo el mínimo y cambia a Ver todo el stock. Si te vas a una pestaña sin alertas con el filtro puesto, la lista dice "Ningún item de esta pestaña está bajo el mínimo."; y cuando se cubre la última alerta el filtro se suelta solo, para no dejarte mirando una lista vacía sin salida.

05 Cargar herraje

La pestaña Herraje funciona igual que Tableros, con dos diferencias: el campo principal es SKU y no hay medidas.

El bucket del herraje es el SKU normalizado: dos altas del mismo código suman en la misma fila.

06 Cargar cinta de canto (rollos)

El bucket de la cinta es material + espesor + ancho + largo del rollo. Un 0,45 × 22 en rollos de 50 m es una fila distinta del mismo canto en rollos de 100 m, porque son dos compras distintas.

07 Buscar y ordenar

El input de arriba filtra la pestaña activa en vivo (debounce ~120 ms) y cada pestaña recuerda su propio texto. Busca en:

• el nombre (material o SKU),
• el espesor y el formato — por eso 18 o 1830 encuentran tableros, aunque no sean el nombre,
• proveedor y ubicación,
• el lote (solo tableros).

El matching normaliza acentos (normalizeForSearch: NFD + strip diacríticos + minúsculas), así que "PETIRIBÍ" matchea "petiribi". Es sub-string, no fuzzy.

Cuando la búsqueda no encuentra nada, la lista dice "Ningún item coincide con la búsqueda. Probá con menos letras." — un estado distinto del inventario vacío, para que 200 filas escondidas detrás de un filtro no se lean como "no tenés nada" e invitar a cargarlo dos veces.

Los encabezados Material, Cantidad, Mínimo y $ unitario son botones de orden; Medidas, Proveedor, Ubicación y Acciones no ordenan. El ciclo del click es de tres pasos: ordenar → invertir → volver al orden de carga. Mínimo ordena por déficit y arranca descendente, porque la punta urgente de esa columna son los números grandes. La flecha (▲ / ▼) y el aria-sort se actualizan en el lugar, así que el foco se queda en el encabezado que apretaste.

08 Editar en el drawer

Click en cualquier parte de la fila — o en el botón ✎ — abre el drawer lateral con los campos del item, pre-rellenados. No es un modal: es una región dentro del sheet, con header, cuerpo y un pie con Cancelar / Guardar. Enter dentro de un campo también guarda.

• Los mensajes de error salen en el pie del drawer, con el foco en el campo que los causó. No van a la barra de estado de la app, que queda detrás del sheet y de su scrim.
• Vaciar un campo opcional lo borra de verdad (proveedor, ubicación, lote, notas, $ unitario).
• Guardar persiste a IDB, bumpea stockEpoch y — si cambió la cantidad — anota el movimiento en el libro (paso 9).

El botón × de la fila elimina el item, preguntando "¿Eliminar este item del stock?". No hay selección múltiple: no hay checkbox de fila, ni borrado en lote, ni "asignar mínimo" masivo.

09 Ajuste rápido ± y el libro de movimientos

Cada fila tiene un − y un + que mueven la cantidad de a uno: es la operación de todos los días ("usé dos tableros hoy"), que antes eran cinco interacciones a través del drawer. El − queda deshabilitado en 0 (el taller no puede tener una pila negativa) y el foco se queda en el botón que apretaste, o pasa al + cuando el − se apagó.

Cada escritura del módulo — alta, edición de cantidad, ajuste ±, baja, retazo banqueado, pedido recibido — anota una entrada en el libro de movimientos (store movements de la IDB v3):

10 ¿Me alcanza? — el reporte de faltantes

El botón ¿Me alcanza? del header abre un modal por encima del sheet que compara el pedido de materiales del proyecto abierto contra el inventario del taller. Es una foto del momento en que lo abrís, no una vista viva.

La tabla tiene cinco columnas — Item · Pide · Hay · Falta · Estado — y las filas van tableros → herraje → cinta, con las unidades de cada tipo (tableros, u., m). El estado es uno de tres: Alcanza, Falta o No hay en stock.

Cómo compara cada tipo:

• Tableros — por bucket exacto (material + espesor + formato). Los tableros del mismo material y espesor en otra medida no cuentan como cobertura: aparecen como "{n} en otro formato" al lado de lo que hay, con la aclaración "Puede que sirvan: eso lo decide el nesteo, no el stock."
• Herraje — por SKU.
• Cinta — el pedido pide metros y el stock guarda rollos, así que los metros que hay son cantidad × largo del rollo. Además el pedido no guarda el ancho, así que los rollos de distinto ancho se suman juntos: el reporte lo aclara al pie.

El pie resume: "Alcanza todo: los {n} items del proyecto están cubiertos." o "Falta comprar: {x} incompletos y {y} sin nada en stock.", más lo que cuesta lo que falta. Si algún faltante no tiene precio cargado dice "Lo que falta no se puede valorizar: al menos un item no tiene precio cargado." en lugar de mentir un $ 0,00.

11 Marcar pedido recibido

El botón Pedido recibido lee el mismo pedido del proyecto y lo ofrece para sumarlo al stock. La idea es no volver a tipear catorce líneas de remito en un formulario: "Destildá lo que no llegó y corregí las cantidades antes de confirmar. Cada línea tildada suma al stock y queda registrada como compra."

Arriba dice Pedido: <referencia>. La tabla tiene cuatro columnas:

Una línea que el módulo no puede resolver se muestra igual, sin tildar, con el motivo: "El pedido no trae cantidad para esta línea." o "La línea no trae material ni SKU con el que identificarla.". Al pie se cuenta cuántas son: "{n} líneas necesitan que completés algo antes de poder tildarlas."

Al confirmar, cada línea tildada entra por el camino de merge (suma a la pila que ya existe en lugar de crear una fila gemela), se estampa con la fecha de hoy y con la referencia del pedido en el campo Lote, y anota un movimiento purchase con esa referencia. El resultado sale en el footer del sheet: "Pedido recibido: {líneas} líneas, {unidades} unidades sumadas al stock." Si tildaste algo que no se podía resolver, lo aclara: "{n} líneas tildadas quedaron afuera: les falta el dato que las identifica."

12 Configuración, integraciones y exports

Configuración → Stock vive en el grupo docs del panel de configuración (junto a Plano de taller, Presupuesto, Clientes, Corte, Taller y Catálogo) y tiene cuatro campos:

Retazos del nest → stock

Con el módulo prendido y autoAddOffcuts en true, el botón Sumar al stock del nest banca los retazos en tres lugares, y uno de ellos es este inventario. Cada retazo entra por el camino de merge (suma cuando coinciden material, espesor y formato; otra medida es otra fila), se estampa con la fecha de hoy y anota un movimiento offcut con el proyecto de origen como referencia. La acción es idempotente por resultado de nest: apretar el botón dos veces no duplica nada.

El Mínimo de un retazo queda a propósito en 0: un retazo es scrap que el taller tiene, no una línea que repone, y un piso distinto de cero levantaría una alerta imposible de bajar.

Stock → nest, y por qué el modo Costo lo necesita

En el workbench de nesting, la columna Setup tiene una sección Stock del taller que lista los tableros reales con en stock: {n} y $ {precio} c/u, y un botón Traer que los suma a los formatos de corte (la cantidad se clampea a lo que hay). Traerlos no descuenta stock: un nest es un plan, no un consumo.

Ese camino es el único que le pone precio a un tablero del nest, y por eso es el que hace funcionar Optimizar: Costo (menor precio total). Sin tableros con precio, el modo Costo no tiene con qué comparar y se comporta como Material; el workbench lo dice — "Falta precio en {n} tablero(s)" y "Modo Costo activo pero ningún tablero tiene precio — cayó a Material."

Exports

Los dos botones del header exportan todo el inventario, no la pestaña activa. El nombre del archivo usa el nombre del taller (o taller) y la fecha local: <taller>-stock-<YYYY-MM-DD>.

CSV — un archivo, los tres sub-stores discriminados por la columna kind. UTF-8 con BOM, fin de línea CRLF, separador ; y decimales con coma, que es lo que espera Excel en es-AR. Los encabezados son los nombres de campo (formato de intercambio, no reporte traducido) y son 16, sin id:

kind;materialKey;skuId;thicknessMm;widthMm;formatX;formatY;lengthM;quantity;minQuantity;unitCost;supplier;location;lotRef;receivedAt;notes
board;Melamina MDP · Blanco TX;;18;;1830;2750;;12;5;8200;Masisa;Dep.A-E3;L-2291;2026-08-12;
hardware;;BIS-BLUM-110;;;;;;24;10;1500;Häfele;Est.2;;2026-08-05;
edgeBanding;Melamina Blanco TX;;0,45;22;;;100;5;2;850;Rehau;Dep.B;;;

Cada fila deja vacías las columnas que no le corresponden: un herraje no tiene medidas, un tablero no tiene lengthM.

Excel — un libro con tres hojas (Tableros / Herraje / Cinta de canto), encabezado congelado y en negrita, formatos numéricos por columna y una fila TOTAL con Σ cantidad y Σ cantidad × $ unitario. Acá los encabezados sí están traducidos.

Atajos

Ver también

• Tutorial · Optimización de corte — el nest: traer tableros reales del taller, banquear retazos y el modo Costo.
• Tutorial · Herrajes — el catálogo de herrajería, de donde sale el código que va en el campo SKU.
• Spec 2026-07-26-stock-inventario.md — diseño del módulo, schema, integraciones.
• Plan 2026-08-25-stock-audit-and-sota.md — la auditoría que rehizo el módulo y las enmiendas a la spec.