Todas las apps de Studio
Visión & CCTV

Perímetro

horario armado · evidencia

Alertá ante cualquiera que entre a una zona restringida mientras el perímetro está armado — con evidencia de captura y clip.

streamhub.studio/studio/perimeter
Perímetro
El problema

Un predio, una línea de cerco, un muelle de carga o una celda de máquina prohibida solo está "restringido" si alguien lo mira — y nadie mira una cámara tranquila a las 3 de la mañana. Perímetro se arma por horario (o a demanda), levanta una alerta en el momento en que una persona está dentro de una zona y guarda la evidencia, para que la respuesta sea actuar sobre la alerta en vez de revisar grabaciones después.

Casos de uso

Seguridad

Intrusión fuera de horario

Armá el predio o depósito de noche y los fines de semana; cualquier persona en una zona restringida dispara perimeter.intrusion con una captura y un clip corto adjunto.

Industrial / HSE

Entrada a zona de peligro

Marcá una celda de máquina o área peligrosa y alertá cada vez que alguien entra, armado durante las horas de operación en vez de solo de noche.

Control de acceso

Muelle y línea de cerco

Una cola de alertas para reconocer permite a un operador trabajar una noche de alertas y marcarlas atendidas; el estado armado y las alertas se leen solo autenticado.

Cómo funciona

Entrada

HLS en vivo + zonas restringidas

Un worker vigila la cámara por HLS. Dibujás las zonas restringidas en el dashboard y fijás el horario de armado (zona horaria IANA, reglas de fin de semana) o accionás un toggle manual de armar/desarmar.

Detección

Persona-en-zona mientras armado

La detección de personas YOLOv8 prueba el punto del pie de cada persona contra las zonas; los aciertos solo disparan mientras está armado. Un cooldown por zona acota la tasa de alertas.

Callback firmado

intrusión + evidencia

perimeter.intrusion hace POST a tu webhook (firmado con HMAC cuando hay secreto) y guarda evidencia en disco: un JPEG más un clip sin re-encodear de los últimos segmentos.

Tu sistema

Cola de alertas + reconocer

Las alertas caen en una cola para reconocer en la pestaña del dashboard; reconocer marca esa alerta y todo lo anterior como atendido.

Eventos que emite

Declarados en el manifiesto del plugin y retransmitidos por los callbacks firmados con HMAC de la app (webhook + MQTT). Cualquier cosa que un worker intente emitir fuera de esta lista se rechaza — sin suplantar eventos del core.

perimeter.intrusion

Alcance y límites

  • Detecta una persona en una zona mientras está armado — no es un VMS completo y no clasifica intención, vehículos ni objetos.
  • Los clips de evidencia necesitan el directorio HLS local; un worker de borde remoto graba evidencia solo de capturas.
  • Configurá la zona horaria — el horario de armado la sigue, y un host Docker por defecto está en UTC.

Requisitos mínimos

  • Solo CPU por defecto: yolov8n a 1–2 fps cuesta ~0,5–1 núcleo por cámara (la intrusión necesita frames recientes, no todos). Presupuestá ~1 núcleo + 2 GB de RAM por sala vigilada.
  • Cajas de borde ARM pequeñas (clase Raspberry Pi) corren yolov8n a 0,3–1 fps — un par de segundos de latencia sigue estando bien dentro de una ventana de respuesta útil.
  • Disco: JPEGs de evidencia ~100–400 KB cada uno; clips -c copy ~1–4 MB por 10 s. El cooldown acota la tasa de escritura. GPU opcional.

Los números son mediciones honestas de los autores del plugin, no marketing. La GPU es opcional en cada plugin de visión salvo donde se indique.

Corre como una app completa

Cada app de Studio es una aplicación de primera clase, no un modal de configuración — y no tiene por qué vivir dentro de StreamHub.

Vista de página completa en el dashboard

Se abre como su propia página dentro de la app tenant — zonas, paneles en vivo, historial y ajustes en una sola superficie, no apretados en un diálogo.

Su propia base de datos

Guarda su estado en una base SQLite dedicada por app — lecturas, alertas, ocupación y filas de evidencia — que es tuya y podés consultar.

Bundle exportable

Descargá la app como un bundle autocontenido — worker, Dockerfile, compose y una plantilla de env — para hostearla en tu propia infra y extenderla, hablando de vuelta por la API REST y los webhooks firmados.

¿Tenés cámaras o streams para poner a trabajar?

Contanos qué estás monitoreando y definimos las apps correctas, las conectamos a tus sistemas y las operamos con vos. El software es open source — el despliegue y la operación es lo que hacemos.