Domains

Diferenciar objetos suele ser sencillo en muchos casos. Por ejemplo, un interruptor digital que abre o cierra una puerta tiene una función completamente distinta a la de un controlador de iluminación, que ajusta el nivel de luz en un espacio. Sus propósitos son fáciles de distinguir.

Pero el caso se vuelve más complejo cuando los objetos pertenecen a una misma categoría pero cumplen funciones diferentes. Por ejemplo, los sensores:

Sensor de temperatura: Mide el calor ambiental.
Sensor de humedad: Detecta la cantidad de vapor de agua en el aire.
Sensor de movimiento: Identifica presencia en un área.

Aunque todos son "sensores", cada uno tiene una utilidad específica y proporciona datos distintos. Para organizarlos y diferenciarlos de manera eficiente, Netsocs utiliza un sistema de clasificación llamado Dominios.

¿Qué es un Dominio?¶

Un dominio es una etiqueta organizativa que agrupa objetos basándose no solo en su categoría general, sino también en su funcionalidad específica. Es el método que utiliza Netsocs para clasificar de manera lógica y precisa cada herramienta en tu arsenal digital.

Imaginemos un ejemplo práctico: una cámara de seguridad avanzada. Este único dispositivo físico puede albergar múltiples capacidades que en Netsocs se representan como objetos individuales:

Un sensor de movimiento integrado.
Tres contadores de línea virtuales, que registran cada vez que una persona o un objeto cruza una línea predefinida en la imagen de la cámara.

En este escenario, tendrías un total de cuatro objetos de tipo "sensor" provenientes de un solo dispositivo. Si quisieras aplicar una regla específica solo a los contadores de línea (por ejemplo, "enviar una alerta si el conteo supera 100"), pero no al sensor de movimiento, necesitarías una forma clara de distinguirlos. Aquí es donde los dominios demuestran su valor, permitiéndote agrupar los tres contadores de línea por separado del sensor de movimiento.

Gracias a los dominios, puedes gestionar objetos por su tipo y su función.

La Estructura de un Dominio¶

Para garantizar la coherencia y facilitar la búsqueda, los dominios en Netsocs siguen una estructura de nomenclatura simple y predecible, compuesta por tres partes separadas por un punto:

marca_dispositivo.tipo_de_objeto.funcionalidad

Analicemos cada componente:

Marca del Dispositivo (`marca_dispositivo`)¶

Identifica el fabricante, la plataforma o la marca del hardware o software. Esto ayuda a diferenciar objetos de distintos ecosistemas.

Ejemplos: netsocs_camera, randombrand_panel, generic_device

Tipo de Objeto (`tipo_de_objeto`)¶

Describe la categoría general a la que pertenece el objeto.

Ejemplos: sensor, switch (interruptor), light (luz), alarm_panel (panel de alarma), button (botón).

Funcionalidad (`funcionalidad`)¶

Esta es la parte más descriptiva. Define la tarea específica que el objeto realiza.

Ejemplos: motion (movimiento), line_counter (contador de línea), temperature (temperatura), humidity (humedad), on_off (encendido/apagado), level (nivel), open_close (abrir/cerrar).

Ejemplos de Dominios en la Práctica¶

Para el sensor de movimiento de nuestra cámara "Netsocs":
```
netsocs_camera.sensor.motion
```
Para los contadores de línea de esa misma cámara:
```
netsocs_camera.sensor.line_counter
```
Para un interruptor de luz simple de un fabricante genérico:
```
generic.switch.on_off
```
Para un controlador que ajusta la intensidad de esa luz:
```
generic.light.level
```
Para un sensor de apertura en una puerta de un panel de acceso:
```
randombrand_panel.sensor.open_close
```

La Utilidad de los Dominios: Agrupar, Filtrar y Buscar¶

Los dominios son la columna vertebral para una gestión eficiente de objetos en Netsocs. Su propósito es simplificar tu trabajo al permitirte:

Agrupar¶

Organiza de forma lógica todos los objetos con funcionalidades similares. Por ejemplo, podrías visualizar todos tus sensores relacionados con el "clima" (_.sensor.temperature, _.sensor.humidity) en un solo lugar, sin importar la marca del dispositivo.

Filtrar¶

Cuando administras cientos de objetos, puedes aislar tu vista para mostrar solo los que te interesan. Por ejemplo, podrías filtrar para ver únicamente los objetos con la funcionalidad motion de todas tus cámaras.

Buscar¶

Encuentra cualquier objeto de manera instantánea. Si necesitas localizar el sensor de temperatura de un área específica, una simple búsqueda por el dominio que contenga .sensor.temperature te llevará directamente a él.

Automatizar¶

Los dominios son fundamentales para crear reglas y acciones automáticas. Podrías, por ejemplo, diseñar una regla que se active para cualquier objeto dentro del dominio _.sensor.motion (sin importar la marca), o una alerta específica que se envíe solo cuando un objeto del dominio _.lock.status reporte un estado "abierto".

Al comprender y utilizar los dominios, aprovecharás al máximo la capacidad de Netsocs para construir un sistema de gestión inteligente, ordenado y altamente automatizado.