KB de Insumos — descargables

La base de conocimiento que convierte una línea de factura del proveedor en un insumo identificado. Descarga los datos y el motor, y trabaja sobre ellos directamente.

539ingredientes

105valores de faceta

7ejes ortogonales

15familias

La decisión de diseño que lo sostiene todo: en lugar de una tabla con todas las combinaciones posibles (~39 millones de filas, la mayoría imposibles, como «merluza en pasta tostada»), el KB separa el problema en ejes independientes. Mantienes unos mil registros y el producto cartesiano lo genera el motor.

línea de factura = INGREDIENTE + N facetas independientes + pack

"MERLUZA FILETE S/PIEL CONG. CAJA 6x1KG"
  ingrediente   PB.MERLUZA  (familia pescado_blanco)
  forma         filete
  preparación   sin_piel
  conservación  congelado
  envase        caja
  pack          6 × 1 kg = 6 kg

Paquete completo

Todo lo necesario para levantar el KB en local: datos, motor, herramientas y documentación.

ZIP kb-insumos_completo.zip Repositorio entero: data/, engine/, tools/, Makefile y documentación. Con make all regeneras catálogo, tester y pruebas. 112 KB · ZIP

Datos tabulares

Para cargar en una base, un notebook o una hoja de cálculo sin escribir un parser.

CSV Ingredientes 539 filas: id, familia, nombre ES/EN, científico, alias, abreviaturas y nº de SKU comunes. 64 KB · UTF-8 con BOM CSV Facetas 105 filas: forma, preparación, conservación, procesado, envase, calidad y unidad, con sus sinónimos. 16 KB · UTF-8 con BOM JSON Bundle completo Un solo fichero con ingredientes, facetas, familias y alias regionales. Pensado para embeber en el frontend. 260 KB · JSON

Motor de matching

La misma lógica en dos runtimes, para usarla en el navegador o en el pipeline de facturas.

JS matcher_core.js Motor en JavaScript, sin dependencias. Se alimenta del bundle JSON. 16 KB · JavaScript PY matcher.py Motor en Python con batería de regresión incorporada: python3 matcher.py --test. 24 KB · Python 3 WEB Probador interactivo Pega una línea de factura y mira cómo se descompone. Se abre en el navegador, sin instalar nada. Abrir en el navegador

Documentación

Por qué el KB está diseñado así y cómo se conecta con el Hub de inventario.

MD README El diseño por facetas ortogonales, las 6 facetas y cómo dar de alta insumos nuevos. 12 KB · Markdown MD Guía de integración Cómo enchufar el matcher al flujo de captura de facturas del SII. 8 KB · Markdown

Arranque rápido

Del ZIP a las pruebas verdes en tres comandos.

unzip kb-insumos_completo.zip -d kb-insumos
cd kb-insumos
make all        # build del catálogo + tester + batería de regresión

Los ficheros escritos a mano (frutos_secos.json, pescados.json, carnes.json, vegetales.json, despensa.json, latam.json) llevan common_skus y cortes detallados y no se regeneran: el build solo escribe los *_ext.json. Si añades insumos, edítalos en tools/catalog_data.py.