hbox-docs/docs/inventario/index.md

title	date	tags
Política de inventario por sitio	2026-10-23	project-drogheda hbox inventario produccion compras instalacion

Inventario de materiales

Qué hay en cada sitio —Querétaro (taller) y los cuatro puertos: ICAVE, TIMSA, EIT y LCT— para producir e instalar HBOX: tarjetas, módulos, gabinetes, cajas, fuentes, packs, antenas, cables, el material de instalación (soportes, tornillería, cable de potencia) y los componentes de entrega larga. No es una lista de BOM: aquí solo entra lo que se cuenta a mano.

Abrir el inventario → · por sitio: ICAVE · TIMSA · EIT · LCT · Querétaro

Qué hay aquí

Página	Para qué
Inventario	Una pestaña por sitio: lo que hay ahí, lo que va en camino hacia ese sitio y, con el kit, cuánto falta para instalar las unidades que pongas. Todo: el total de cada ítem y dónde está. Movimientos (entrada, salida, conteo físico, envío y recibir), alta de ítem y exportar CSV con una columna por sitio
Instalaciones	Cuántas unidades van instaladas y probadas en cada sitio. Su botón Material abre la pestaña de ese sitio en el inventario
Tablero de producción	Lo que el inventario tiene que cubrir: 113 V5.6 · 327 V5.7 · 130 v6
Pendientes, pista Compras	Pedidos en curso (SD-15B-05 ×113, paquetes LFP, gabinetes, cajas HBOX, antenas, ferretería de EIT y TIMSA)

Qué se registra y qué no

Sí	No
Tarjetas EinarBoard por versión (V5.5, V5.6, V5.7, v6)	Resistencias, capacitores y componentes de la BOM normal
Módulos: ArduSimple simpleRTK2B Pro, 4G NTRIP Master	Herramienta y consumibles del banco
Gabinetes IP67, cajas plásticas HBOX, fuentes SD-15B, packs LFP	Unidades ya ensambladas (esas viven en el tablero por su acta, y en Instalaciones cuando ya están en un puerto)
Antenas GNSS y LTE, cable Ethernet, conectores GX16, fusibles DIN	—
Material de instalación (categoría Instalación): soportes y herrería (los de las RTG de LCT), tornillería, cinchos, cable de potencia	—
Componentes críticos de entrega larga: LTC4040, TPS54360B, SRP1265A	—

Dónde está cada cosa

• Cada movimiento pasa en un sitio. Lo que hay en un sitio es la suma de sus movimientos; nadie escribe el número a mano.
• El total de un ítem es lo de todos los sitios más lo que va en camino. El mínimo y la alerta se comparan contra el total.
• Lo que se registró antes del 23-oct no tenía sitio: cuenta como Querétaro. El total de cada ítem no cambió.
• En camino: un envío sale de un sitio y no está en ningún lado hasta que el sitio que lo recibe le da Recibir. Si llegó menos de lo enviado, se recibe lo que llegó: la diferencia baja del total y queda anotada con el nombre de quien recibió.
• Proveedor o fuera del inventario: una compra que ya viene en camino, o material que salió de un puerto antes de que ahí se contara (como el material que salió de Manzanillo hacia EIT), se registra como envío que sale de «Proveedor o fuera del inventario». No descuenta de ningún sitio y entra al total desde que se registra.

Quién registra y cuándo

Qué pasó	Quién	Movimiento
Llega material de un proveedor (paquetería, Aldair, Mouser)	Quien recibe en ese sitio (en Querétaro, Jesús Romero o Leo)	Entrada en ese sitio, con la orden o guía como referencia, el mismo día
Se manda material a otro sitio (de Querétaro a un puerto, o entre puertos)	Quien empaca (si va con una unidad, al llenar su acta de envío)	Envío: elige de dónde sale y a qué sitio va, con la guía como referencia. Queda en camino
Llega un envío al puerto	El responsable del sitio: Alán (ICAVE), Jesús Honorato (TIMSA), Miguel (EIT), Antonio (LCT)	Recibir en la pestaña de su sitio, con lo que llegó de verdad, el mismo día
Se arma una unidad	Quien ensambla, al cerrar el acta de ensamble	Salida en Querétaro de cada pieza, con el número de unidad HBOX5-Exx-Axxx-Rxxxx como referencia
Se instala una unidad	Quien instala, al cerrar el acta de instalación	Salida en ese puerto del material del kit, con la unidad o el vehículo como referencia
El conteo no cuadra	Quien cuenta en ese sitio	Conteo físico en ese sitio: queda exactamente en el número que contaste, con el motivo («conteo mensual», «se encontró en el otro anaquel»)
Pieza dañada o de baja	Quien llena el acta de daño	Salida en el sitio donde estaba, con el motivo y la serie

Cada movimiento queda con usuario, fecha, sitio, cantidad, motivo y referencia; se ven todos tocando el código del ítem. Una salida o un envío no pueden dejar un sitio en negativo: si el sistema dice «No hay stock suficiente», falta la entrada o el conteo físico de ese sitio.

Kit de instalación

• En cada ítem, «Por instalación» dice cuánto lleva una unidad instalada (0 = no es del kit). Se cambia en Editar.
• Con eso, la pestaña de cada puerto calcula para las unidades que pongas arriba («Para instalar N unidades»): Faltan n pza (rojo), Completo al llegar (lo que falta ya va en camino), Completo.
• El kit lo definen Adriana y Leo (pendiente t-kit-instalacion). Punto de partida, tomado de las actas de envío e instalación: gabinete IP67 ×1, antena GNSS con cable ×1, antenas LTE ×2, arnés GX16 ×1, fusible ×1, fuente Mean Well ×1 si la versión la usa, tornillería y cinchos; en LCT, además, soporte para RTG ×1. La unidad HBOX no va en el kit: se sigue por su acta.

Conteo inicial por sitio

Los ítems existen desde el 13-oct; lo registrado hasta hoy cuenta como Querétaro. Para que cada pestaña diga la verdad:

1. Querétaro: Jesús Romero cuenta y registra un conteo físico por ítem con el motivo «conteo inicial» (pendiente t-inventario-inicial).
2. Cada puerto: su responsable de campo cuenta lo que hay ahí y registra un conteo físico por ítem en la pestaña de su sitio (pendiente t-conteo-sitios). Lo que no esté en la lista se da de alta con Nuevo ítem (categoría Instalación si es material de montaje).
3. Lo que ya viene en camino se registra como envío (de Querétaro, de otro puerto o de «Proveedor o fuera del inventario»), para que el sitio que lo espera lo vea y le dé Recibir al llegar.

Mientras no se cuente un sitio, su pestaña dice que no hay material y las alertas pueden no ser reales.

Mínimos y alertas

• El mínimo lo fija quien compra (Leo), pensando en el tiempo de entrega: chips y antenas RTK tardan ~4 semanas; LTC4040 y la fuente a bordo son de entrega larga.
• Para el pedido de 570, la fuente Mean Well SD-15B-05 tiene mínimo 113 (solo la usa V5.6).
• Por debajo del mínimo el ítem se marca en rojo aquí y en el tablero de producción. La alerta no manda correos: hay que mirar el tablero.
• Mínimo 0 = sin alerta (consumibles que no vale la pena vigilar).

Para ingeniería

• Datos en /srv/projects/drogheda/inventario/{items,movimientos}/ (un JSON por registro + _indice.csv).
• API: GET /api/inventario (cada ítem con por_sitio, en_camino y por_instalacion; además sitios y los envios abiertos), POST /api/inventario/movimiento (tipo entrada, salida, ajuste, envio o recepcion; sitio icave, timsa, eit, lzc o qro, y fuera como origen de un envío; destino en el envío; envio_id en la recepción), GET /api/inventario/movimientos?item_id=&sitio=, GET /api/inventario/export.csv (una columna por sitio y otra de en camino). Ejemplos en backend/README.md; pruebas en backend/tests-1023.sh.
• Cada movimiento lleva dos cuentas: delta mueve el total y delta_sitio lo que hay en su sitio. Un envío entre sitios no cambia el total; su recepción sí, si llegó menos.
• Nada se borra. Un ítem que ya no aplica se marca «(obsoleto)» en la descripción y con mínimo 0.