Instrumentos, estándares y solventes de referencia
Este módulo gestiona los recursos de referencia propios de ION-target que se usan en las calibraciones y calificaciones: instrumentos de medición (STD), estándares (patrones) y solventes. Cada uso de un recurso en un servicio queda registrado en un logbook, con el certificado y el vencimiento vigentes al momento del uso.
Cada uso de un instrumento, estándar o solvente se registra en el logbook (std_uso_log) con
una copia (snapshot) del número de certificado y el vencimiento vigentes en ese momento. Así queda trazado
qué certificado estaba vigente cuando se usó, aunque después se recalibre.
Las tres pestañas
| Pestaña | Qué contiene | Identidad |
|---|---|---|
| Instrumentos | Equipos de medición ION-target con calibración vigente y certificado. | Código |
| Estándares | Patrones de referencia con lote, ubicación y certificado. | Código |
| Solventes | Solventes de referencia con proveedor y lote. | Nombre (no tienen código) |
Campos por entidad
| Instrumento STD | Estándar | Solvente |
|---|---|---|
| Código *, Nombre * | Código *, Nombre * | Nombre * |
| Marca, Modelo, N° de serie | Lote, Ubicación | Proveedor, N° de parte (PN) |
| Realizó (quién calibró) | — | — |
| Fecha de calibración | Fecha de calibración | Fecha de vigencia |
| Fecha de vencimiento | Fecha de vencimiento | Fecha de vencimiento |
| N° de certificado + URL | N° de certificado + URL | Lote + URL |
Solo Código y Nombre son obligatorios (en solventes, solo el Nombre). El resto es opcional.
Estado de vigencia
El estado se calcula en cada consulta a partir de la fecha de vencimiento; no se guarda.
| Estado | Condición |
|---|---|
| VIGENTE | Fecha de vencimiento ≥ hoy (el día del vencimiento aún cuenta como vigente). |
| FUSO | Fecha de vencimiento < hoy (fuera de uso). |
| SIN FECHA | No tiene fecha de vencimiento cargada. |
El sistema marca el badge FUSO pero no impide técnicamente seleccionar un recurso vencido en un servicio: es responsabilidad del operador. Actualizá el vencimiento tras la recalibración antes de usarlo.
Acciones
Las tres pestañas comparten las mismas rutas, cambiando el segmento (/std/equipos,
/std/estandares, /std/solventes).
| Acción | Endpoint | Condiciones |
|---|---|---|
| Listar / ver archivados | GET /std/{tipo}?incluir_archivados= | Agrega el estado calculado. |
| Crear | POST /std/{tipo} | Código y nombre obligatorios. |
| Editar | PUT /std/{tipo}/{id} | 409 si está archivado. |
| Archivar | PATCH /std/{tipo}/{id}/archivar | Motivo obligatorio (mínimo 5 caracteres en pantalla). |
| Restaurar | PATCH /std/{tipo}/{id}/restaurar | Solo administrador (403 si no). |
| Vencimientos (todos) | GET /std/vencimientos | Unifica los tres tipos con vencimiento cargado. |
| Excel de vencimientos | GET /std/reporte | Botón "Excel" del calendario; genera .xlsx. |
| Logbook de uso | GET /std/uso-log/{tipo}/{id} | Historial de usos de ese recurso. |
Recalificación: "+ Nuevo Certificado"
Si solo cambió el vencimiento del mismo certificado, editá el registro. Si es un certificado distinto (recalificación), usá el botón "+ Nuevo Certificado" en el modal de edición: clona los datos clave y crea un alta nueva, conservando el registro histórico anterior. El sistema ya no lo trata como duplicado (permite mismo código con certificado distinto).
La detección de duplicados solo bloquea cuando coinciden nombre + código/lote + número de certificado. Una recalificación con certificado nuevo no es un duplicado.
El sistema no almacena el archivo del certificado: guarda su URL de SharePoint. La trazabilidad depende de que esa URL apunte al certificado correcto.
Logbook de uso
El botón de historial de cada recurso abre el logbook: cada fila es un uso del recurso en un servicio ITS o una asistencia AT/RB. Muestra 8 columnas:
| Columna | Contenido |
|---|---|
| Origen | Badge ITS / AT / RB. |
| Número | Protocolo/asistencia, con enlace al Historial o a AT/RB. |
| Fecha de uso | Día del servicio. |
| ID Equipo | Identificador del equipo del cliente calibrado. |
| Lab / Sector | Laboratorio y sector. |
| Técnico/s | Quién ejecutó. |
| Certificado vigente | N° de certificado del recurso al momento del uso (snapshot). |
| Vencimiento cert. | Vencimiento del certificado en ese momento. |
Calendario de vencimientos
El calendario lista todos los vencimientos futuros y colorea por días restantes:
Los botones "Exportar" y "Log completo" abren una ventana de impresión (para PDF/papel). El único botón que
descarga un .xlsx es "Excel" del calendario de vencimientos.
Preguntas frecuentes
409). Un administrador debe restaurarlo primero (restaurar es una acción de administrador)..xlsx es el botón "Excel" del calendario de vencimientos.