tanpin
Tanpin es un sistema de gestión de inventario por artículo que realiza pronósticos per-SKU, genera órdenes de compra automáticas y envía correos a proveedores con ETAs de entrega. Incluye REST API, servidor MCP, daemon y dashboard en Node.js puro sin dependencias externas.
Ficha actualizada 26 sept 2026, 22:57 · upstream 26 sept 2026, 22:56 · release sin release detectada
Qué es tanpin
Descripción editorial construida a partir del repositorio, su documentación y sus señales de mantenimiento.
Tanpin implementa un enfoque de 'single-item management' donde cada SKU se trata como una unidad de negocio independiente. El sistema codifica el ciclo completo: pronostica la demanda por artículo basándose en ventas recientes, factores estacionales del día de la semana y tendencias a corto plazo; calcula órdenes considerando stock de seguridad, punto de reorden, EOQ y MOQ; gestiona órdenes agrupadas por proveedor con correos automáticos y ETAs de entrega; y elimina productos que no venden mediante clasificación ABC.
La arquitectura utiliza Node.js 22 puro con built-ins del núcleo, sin dependencias de tiempo de ejecución. El almacenamiento se basa en SQLite con soporte WAL para escrituras incrementales compartidas entre servidor y daemon. Incluye un dashboard SPA en vanilla JS, REST API con OpenAPI 3.1, servidor MCP para integración con Claude Code/Cursor, y webhooks firmados HMAC-SHA256.
El sistema opera mediante un daemon que ejecuta cada N minutos (por defecto 15) el ciclo completo: re-pronóstico, reclasificación ABC, generación de borradores de órdenes, envío de correos y recepción automática. Soporta modo demostración con datos inventados y despliegue autoalojado con claves maestras SHA-256.
- Gestión de inventario para tiendas minoristas con pronósticos per-SKU
- Automatización de órdenes de compra agrupadas por proveedor
- Integración con agentes de IA vía servidor MCP (Claude Code, Cursor)
- Dashboard para visualización de stock, pedidos abiertos y entregas
- Webhooks firmados para integración con sistemas externos
- Pronósticos per-SKU con factores estacionales, tendencias y hipótesis del gestor
- Automatización completa: pronóstico → cálculo de orden → envío a proveedor
- Servidor MCP compatible con Claude Code, Codex y Cursor vía JSON-RPC stdio
- Almacenamiento SQLite compartido entre servidor y daemon con WAL
- Seguridad robusta: claves SHA-256, webhooks HMAC-SHA256, idempotencia 24h
- Requiere Node.js 22 o superior para ejecución nativa
- Modo demostración limita escrituras y resemilla cada 30 minutos
- Webhooks no se envían a direcciones privadas, loopback o CGNAT
- Claves API solo visibles una vez al crearlas (modelo write-only)
- Dependencia de SQLite sin soporte nativo para bases de datos distribuidas
Capturas del proyecto
Imágenes reales detectadas en la documentación del repositorio.
Perfil de infraestructura
Estimación inicial derivada del repositorio y de los servicios detectados.
Despliegue detectado
Qué señales reales de instalación hemos encontrado.
Requiere Node.js 22+. Ejecutar con npx github:willykeenan/tanpin serve o docker build. Para producción, establecer TANPIN_ADMIN_KEY y usar reverse proxy con TANPIN_REQUIRE_API_KEY=1. El daemon se ejecuta en proceso separado por defecto. Datos persisten en ./data/inventory.sqlite. Para MCP, configurar INVENTORY_URL e INVENTORY_API_KEY. Modo demo (DEMO_MODE=1) limita escrituras y no requiere claves.
Stack y dependencias
Componentes inferidos a partir de manifests, configuración y documentación.
Puede sustituir a
Relaciones detectadas por el análisis del repositorio y su categoría.
Experiencia real de la comunidad
Ayuda a contrastar la estimación automática con instalaciones reales.
Todavía no hay datos comunitarios para este proyecto.