Registrar y asignar un tag NFC¶

Esta guía te lleva paso a paso por la tarea concreta de dejar operativo un tag NFC en blanco: darlo de alta en stock y asignarlo a un sanitario, para que cuando el personal apoye el celular sobre la placa, el tap registre trabajos contra el sanitario correcto.

El ciclo de vida completo del tag (estados, transiciones válidas y auditoría) vive en la referencia Ciclo de vida de los tags NFC. Esta página es la receta operativa; aquella, el porqué.

Prerequisitos¶

El recorrido en una imagen¶

flowchart TD
    A[Tag NFC en blanco] -->|Paso 1 ALTA_STOCK| B[EN_STOCK]
    B -->|Paso 2 ASIGNACION| C[ASIGNADO]
    C -->|Paso 3 verificar resolver| D[Tap registra trabajos]

Y los tres estados posibles del tag, con las transiciones que vas a usar:

stateDiagram-v2
    [*] --> EN_STOCK: ALTA_STOCK
    EN_STOCK --> ASIGNADO: ASIGNACION
    ASIGNADO --> EN_STOCK: DESASIGNACION
    ASIGNADO --> ASIGNADO: REASIGNACION otro sanitario
    EN_STOCK --> BAJA: BAJA
    BAJA --> EN_STOCK: RE_ALTA solo web

Paso 1 — Alta en stock¶

Con la app en la pantalla Gestión NFC, apoyá el celular sobre el tag en blanco. La app resuelve el estado (NO_REGISTRADO) y te ofrece "Dar de alta en stock". Confirmá con un alias descriptivo (ej. tag #14 lote mayo).

La app móvil esperando el tap: "Acercá el celular a un tag". Apoyás el celular sobre el chip para que la app lo lea y resuelva su estado. El campo "DEV — simular tag (UUID)" solo aparece en builds de desarrollo, para simular el tap sin un chip físico.

Esto graba/registra el tag como EN_STOCK en el backend. El endpoint que la app encola y envía por sync es:

POST /api/v1/app/nfc/alta-stock
Authorization: Bearer <jwt-operario-ADMIN>
Content-Type: application/json

{
  "uuid_tag": "aaaa1111-1111-1111-1111-111111111111",
  "alias": "tag #14 lote mayo"
}

Resultado verificable: al resolver el tag, su estado pasa a EN_STOCK.

Paso 2 — Asignar a un sanitario¶

Con el tag ya EN_STOCK, la app te ofrece "Asignar a sanitario". Elegí el sanitario destino del árbol Sucursal›Sector›Sanitario y confirmá. La app encola y sincroniza:

POST /api/v1/app/nfc/asignar
Authorization: Bearer <jwt-operario-ADMIN>
Content-Type: application/json

{
  "uuid_tag": "aaaa1111-1111-1111-1111-111111111111",
  "sanitario_id": 12
}

Esto ejecuta la transición EN_STOCK → ASIGNADO: el tag queda vinculado al sanitario, con asignado_en seteado y activo = true.

Resultado verificable: al resolver el tag, su estado pasa a ASIGNADO y trae los datos del sanitario.

Paso 3 — Verificar¶

Confirmá que el tag quedó operativo resolviéndolo:

GET /api/v1/app/nfc/resolver/aaaa1111-1111-1111-1111-111111111111
Authorization: Bearer <jwt-operario>

Respuesta esperada:

{
  "estado": "ASIGNADO",
  "alias": "tag #14 lote mayo",
  "sanitario": {
    "id": 12,
    "codigo": "AEP-T-B12",
    "nombre": "Baño Hombres Terminal A",
    "sector": "Terminal A",
    "sucursal": "AEP"
  }
}

Prueba final (la que vale): que un operario de limpieza apoye el celular sobre el tag. Debería pasar a estado VERDE y arrancar el timer del trabajo. La app resuelve taps solo contra tags en estado ASIGNADO, así que si llegaste hasta acá, el tag ya está operativo.

Operaciones adicionales¶

Una vez asignado, el tag puede moverse o retirarse. Todas estas mutaciones pasan por el mismo servicio (TagNfcLifecycleService) y dejan auditoría.

Reasignar a otro sanitario¶

Mueve el tag de un sanitario a otro en un solo paso atómico, sin pasar por EN_STOCK:

POST /api/v1/app/nfc/reasignar

{
  "uuid_tag": "aaaa1111-1111-1111-1111-111111111111",
  "sanitario_nuevo_id": 20,
  "notas": "se movió la placa al baño contiguo"
}

Desasignar (devolver a stock)¶

POST /api/v1/app/nfc/desasignar

{ "uuid_tag": "aaaa1111-1111-1111-1111-111111111111" }

Limpia el sanitario y devuelve el tag a EN_STOCK.

Dar de baja¶

La baja (desactivar definitivamente) y la re-alta se hacen desde el BackOffice web, no por la app móvil. Recordá: BAJA solo es posible desde EN_STOCK — un tag asignado hay que desasignarlo primero.

Desde el BackOffice, la pantalla Tags NFC lista todos los tags ya registrados y te deja gestionarlos: filtrarlos por estado (Todos / En stock / Asignados / Baja), y desasignar o reasignar cada uno con los botones de la columna Acciones.

La pantalla Tags NFC del BackOffice: tabla con Alias, UUID, Estado, Sanitario y fecha de asignación, más las acciones Desasignar / Reasignar por fila. El aviso "Alta de tags" recuerda que el alta se hace desde la app móvil (requiere leer el chip onsite); desde acá solo se gestionan los tags ya registrados.

Tabla de transiciones válidas¶

Problemas comunes¶

Para el contrato completo de los endpoints NFC, ver API HTTP — App móvil · gestión NFC. Para entender la máquina de estados en profundidad, Ciclo de vida de los tags NFC. Si todavía no tenés el backend corriendo para probar esto, empezá por Montar el entorno del backend.