===== 26.008 Opzetten beveiligingscamera incl. integraties =====
  * **Aangemaakt:** 2026-07-19
  * **Context / Aanleiding:**
    * Imou Bullet 3 5MP-camera (~€40) opgehangen, gericht op de achtertuin.
    * Doel: opname bij beweging, realtime HA-notificatie bij mens-detectie 's nachts/als niemand thuis is, en lampsturing bij mens-detectie met uitzonderingen voor bewust buiten zitten.
    * Camera was al gekoppeld aan Surveillance Station via ONVIF vóór start van dit besluit.
  * **[[resources:metadata:tags:status|Status]]**: {{tag>wip}}
    * Praktijktest van de lamp-automations en definitieve opslaglimiet nog te bevestigen

===== Relaties =====
^ [[homelab:services:start|Services]] ^ [[homelab:devices:start|Devices]] ^ [[homelab:standaarden:netwerk:start|Netwerk]]  ^ [[resources:metadata:tags:start|Tags]]  ^
|              | [[homelab:devices:cam:_bullet_3_5mp_1|Imou Bullet 3 5MP]]           |          | {{tag>camera homeassistant surveillance-station}}    ^

===== Besluit =====
  * **Gekozen optie:**
    * Surveillance Station (via ONVIF) voor opname bij beweging — dekt scenario 1.
    * Twee HA-integraties naast elkaar op dezelfde camera: **imou_life** (HACS) voor lamp/switch-besturing, **ONVIF** (core) voor generieke motion-events — dekt scenario 3.
    * **Scenario 2 (realtime mens-notificatie) is bewust niet gebouwd.** De camera dient primair als afschrikking + bewijsmateriaal via NAS-opnames; een melding voegt weinig toe (opname staat toch al vast, hooguit bruikbaar om buren te bellen).
  * **Motivatie:**
    * Criteria: self-hosted, budgetcamera, betrouwbaarheid boven extra features.
    * Overwogen alternatieven voor scenario 2:
      * Officiële core Imou-integratie — te beperkt, geen motion/human-sensoren.
      * imou_life polling / handmatige refresh / webhook-push — alle drie kapot door dezelfde structurele bug (zie Known Issues).
      * Eigen REST-integratie bouwen (buiten om imou_life) — technisch haalbaar maar te zwaar qua onderhoud (eigen tokenbeheer, signature-berekening).
      * Andere/aanvullende camera (Reolink/Tapo) — apart programma van eisen opgesteld, niet meteen uitgevoerd.
    * Argumenten: extra bouw-/onderhoudsinspanning voor scenario 2 weegt niet op tegen de beperkte meerwaarde t.o.v. wat er al werkt (opname + afschrikking).

===== Gevolgen =====
  * **Technisch:**
    * Twee losse HA-integraties naast elkaar, functioneel gescheiden: imou_life voor switches/lamp/nightvision, ONVIF voor generieke motion.
    * Surveillance Station-opnameresolutie moest gecorrigeerd worden (stond op 720p i.p.v. de native 2880×1620-stream) — zie Known Issues.
    * Archiefopslag: gedeelde NAS-brede limiet van 200 GB, 30 dagen retentie.
  * **Operationeel:**
    * imou_life is community-onderhouden met bekende, niet-opgeloste bugs voor dit cameramodel — geen garantie op toekomstige fix.
    * Geen actieve monitoring; fouten alleen zichtbaar bij handmatig HA-logs checken.
  * **Risico’s / aandachtspunten:**
    * Geen realtime alarmering bij een daadwerkelijke indringer — geaccepteerd risico, expliciet heroverwogen als de situatie verandert.
    * Toekomstige updates van imou_life of Imou's API kunnen dit besluit beïnvloeden (positief of negatief).
    * **Firewall-blokkade Imou-cloud (open punt):** de camera internettoegang blokkeren (self-hosted/privacy-voorkeur) zou de imou_life-integratie stukmaken, en daarmee ook `switch.whitelight` en de twee lamp-automations (scenario 3) — die lopen namelijk via Imou's cloud-API, niet lokaal via ONVIF. ONVIF biedt voor dit model geen losse witte-floodlight-schakelaar (alleen Autofocus/IR-lamp/Wiper). Nog te beslissen: internet open laten, of een lamp-alternatief zoeken (bv. IR-lamp via ONVIF, of floodlight los van HA op de camera's eigen instelling laten).
===== Known issues =====
  * **imou_life "Human detection"-switch**: kan niet op afstand aan/uit worden gezet voor dit cameramodel (HTTP 500 / API-foutcode 40999) — bekend, gemeld, "wontfix" (GitHub user2684/imou_life issue #139).
  * **imou_life alarm-status ophalen** (polling, handmatige "Refresh alarm"-knop, en webhook-push): crasht op `InvalidResponse: time, type, msgType or deviceId not found` — zelfde onderliggende bug, ook gemeld en "wontfix" (issue #107). Treft alle drie de manieren om `binary_sensor.motionalarm` bij te werken.
  * **Push-notificaties/callback-URL**: registreert niet bij Imou's cloud voor dit model — apparaat mist de vereiste "Enable Push Notifications"-schakelaar (zelfde bekende beperking als issue #107).
  * **Imou Open Platform app-aanmaak**: vereist een "App Type" (bv. "PC Client") om te kunnen opslaan — ondanks dat dit veld geen rood sterretje/verplicht-label toont in de UI.
  * **Surveillance Station stream-profielen**: bij ONVIF-toevoeging kunnen alle kwaliteitsniveaus (Hoog/Gebalanceerd/Laag) per ongeluk aan dezelfde onderliggende camera-stream gekoppeld staan — controleer dit expliciet onder Apparaat → Video na het toevoegen van een camera.

===== Evaluatie =====
  * **Ervaring:**
    * Nog in te vullen na praktijkgebruik (lamp-automations nog niet getest in het veld).
  * **Wanneer herbeoordelen:**
    * Na een week echte Surveillance Station-opslagcijfers.
    * Bij aanschaf van een tweede/vervangende camera (zie programma van eisen, apart besproken).
    * Als de behoefte aan realtime notificatie terugkeert (bijvoorbeeld na een daadwerkelijk incident).
  * **Aanleiding voor herziening:**
    * imou_life brengt een fix uit voor dit cameramodel.
    * Een nieuwe camera met werkend mens-detectie-signaal in HA wordt aangeschaft.