Inventario de Gateways (Lista Blanca) ​

1. Dashboard de Inventario ​

Al ingresar a la ruta de "Inventario", te recibirá una tabla principal optimizada (DataTable con paginación desde el servidor) que soporta miles de registros de equipos de radiofrecuencia.

Columnas de la Tabla ​

• Serial Number (SN): El número de serie físico impreso en la carcasa del hardware. Junto a él, se despliega sutilmente el UUID interno.
• Gateway EUI: El identificador global de 16 caracteres hexadecimales (MAC Address estirada). Vital para que el Network Server lo reconozca. Se muestra remarcado como código (code block).
• Distribuidor (Tenant): Muestra el logotipo corporativo y el nombre del mayorista dueño del gateway. Si está en blanco, el equipo pertenece al pool global no asignado.
• Filial (Subsidiaria): Muestra la organización final o sitio específico donde operará el gateway.
• Registro: Fecha exacta en la que el hardware fue ingresado a la base de datos segura.
• Estado: Un indicador (Disponible / Inactivo) que refleja si la antena tiene permisos lógicos para emitir y recibir en la red.
• Acciones:
  • ✏️ Editar: Modifica los metadatos o las asignaciones de Tenant/Filial.
  • 🗑️ Eliminar: Borra el pre-registro de la lista blanca.

2. Registro Manual (Alta Individual) ​

Para registrar un Gateway individualmente, presiona el botón Registro Manual. Se abrirá el siguiente modal táctico:

Inputs de Configuración ​

• Serial Number (SN) *: Input de texto obligatorio. Será el token de canje (Claim Token) que usará el cliente final para adoptar esta antena.
• Gateway EUI *: Input criptográfico. Implementa validación en tiempo real. Debe poseer exactamente 16 caracteres hexadecimales válidos ([0-9A-Fa-f]). El input cuenta con un "check" visual verde que se anima confirmando la integridad del formato.
• Distribuidor (Tenant): Select. [Exclusivo para SuperAdmin]. Permite destinar la propiedad del hardware a una empresa de la plataforma. Si eres un Integrador, tu propio ID será forzado por seguridad y este select estará inactivo.
• Filial (Subsidiaria): Select reactivo. Solo se habilitará si has seleccionado un Tenant previo. Lista dinámicamente los sitios operativos del cliente. Si no lo seleccionas, el equipo quedará en el almacén (pool global) del distribuidor para asignación futura.

3. Carga Masiva (Bulk Upload) ​

Si se acaba de importar un lote de 500 antenas de un fabricante, registrarlas una por una es inviable. Para esto, se utiliza el potente motor de inserción masiva.

Descarga de Plantilla ​

Antes de subir datos, utiliza el botón "Plantilla" en la parte superior. Esto descargará automáticamente el archivo lumiot_gateway_inventory_template.xlsx con la estructura validada que espera el backend.

Columnas a rellenar:

• sn: (Obligatorio). El número de serie de fábrica.
• eui: (Obligatorio). El identificador LoRaWAN de 16 hex.
• tenantId: (Opcional). UUID del distribuidor.
• subsidiaryCompanyId: (Opcional). UUID del sitio operativo.
• enabled: (Opcional). Si lo dejas en blanco asume TRUE (Disponible).

Interfaz de Importación ​

• Dropzone Industrial: Puedes arrastrar y soltar tu Excel directamente al centro del modal. La interfaz reaccionará con un borde remarcado verde y leerá el peso del archivo confirmando que es soportado (Max 5MB).
• Si cometes un error seleccionando el archivo incorrecto, usa la "X" en rojo para abortar.
• Al pulsar "Procesar Carga Masiva", el microservicio ms-devices validará línea por línea.