hbox-docs/docs/inventario/index.md

---
title: "Política de inventario por sitio"
date: 2026-10-23
tags: [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 →](../tableros/inventario.md)** · por sitio: [ICAVE](../tableros/inventario.md?sitio=icave) · [TIMSA](../tableros/inventario.md?sitio=timsa) · [EIT](../tableros/inventario.md?sitio=eit) · [LCT](../tableros/inventario.md?sitio=lzc) · [Querétaro](../tableros/inventario.md?sitio=qro)

## Qué hay aquí

| Página | Para qué |
|---|---|
| [Inventario](../tableros/inventario.md) | **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](../tableros/instalaciones.md) | 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](../tableros/produccion.md) | Lo que el inventario tiene que cubrir: 113 V5.6 · 327 V5.7 · 130 v6 |
| [Pendientes, pista Compras](../tableros/pendientes.md?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](../tableros/actas.md) por su acta, y en [Instalaciones](../tableros/instalaciones.md) 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 { #por-sitio }

- **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](../formularios/envio.html)) | **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](../formularios/instalacion.html) | **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 { #kit }

- 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](../formularios/envio.html) e [instalación](../formularios/instalacion.html): 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 { #conteo-inicial }

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](../tableros/produccion.md). 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.