Persona

Un objeto de tipo person es la representación digital de una persona dentro del ecosistema Netsocs. Actúa como entidad de identidad: concentra los atributos que identifican a un individuo y sirve como punto de vinculación para otros objetos (lectores, rastreadores, puertas, notificadores) que necesitan asociar sus eventos o estados a una persona concreta.

Piensa en el objeto person como una ficha de identidad viva dentro del sistema. Por sí solo no genera eventos ni cambia de estado, pero habilita que el resto del ecosistema pueda responder de forma personalizada: conceder acceso a una puerta específica, enviar una notificación al propietario de un vehículo rastreado o registrar quién activó una alarma.

Características principales

• Portador de identidad: Almacena y expone los atributos que identifican a la persona (nombre, credenciales, roles, etc.) mediante propiedades de estado personalizadas.
• Sin estados predefinidos: El objeto no tiene un ciclo de vida propio de estados; su función es ser referenciado por otros objetos y automatizaciones.
• Sin acciones predefinidas: No acepta comandos directos; es un objeto de datos, no de control.
• Extensible: Los drivers pueden añadir propiedades de estado arbitrarias para enriquecer el perfil de la persona según las necesidades del sistema.

Casos de uso comunes

• Control de acceso: Vincular una persona a un lector o puerta para registrar quién entró y cuándo.
• Rastreo personalizado: Asociar un relative_tracker o gps_tracker a una persona para seguir su posición de forma nominal.
• Notificaciones personalizadas: Usar el objeto person como destinatario en automatizaciones que envían alertas diferenciadas por individuo.
• Gestión de identidad: Centralizar los datos de personas (empleados, visitantes, contratistas) provenientes de sistemas externos como directorios LDAP, Active Directory o bases de datos de RRHH.
• Auditoría y trazabilidad: Correlacionar eventos del sistema con la identidad de las personas involucradas para fines de cumplimiento normativo.

Propiedades de estado

El objeto person no define propiedades de estado fijas en el SDK. Las propiedades son gestionadas íntegramente por el driver que lo implementa, adaptándose a los datos disponibles en cada integración.

Ejemplos de propiedades comunes que un driver puede registrar:

Propiedad	Descripción
name	Nombre completo de la persona.
email	Dirección de correo electrónico.
department	Departamento u organización a la que pertenece.
credential_id	Identificador de credencial de acceso (tarjeta, PIN).
role	Rol o perfil de permisos de la persona.