Flussonic Watcher v2

{toc:maxLevel=3}

h2. Как работает интеграция

Интеграция делалась на максимальное упрощение работы для инженера и абонента: помогите абоненту освоиться с Флюссоником, покажите как пользоваться приложением, проконсультируйте по тарифам и услугам, дайте абоненту самостоятельно их выбрать при подключении. Дальнейшее управление происходит полностью через личный кабинет оператора связи.

По шагам бизнес-процесс подключения абонента к телевидению следующий:

# Получите заявку от абонента на видеонаблюдение
#* Добавьте ему учётную запись Flussonic в биллинге
#* Биллинг сразу создаст на Watcher [организацию|https://flussonic.ru/doc/watcher/upravlenie-organizatsiyami/] и [пользователя|https://flussonic.ru/doc/watcher/upravlenie-polzovatelyami/] для абонента
#* Назначьте инженера
# Отправьте инженера на подключение
#* Установите камеру
#* Добавьте камеры [через мобильное приложение|https://flussonic.ru/doc/watcher/upravlenie-kamerami/#watcher-manage-cameras-add_cam_agent] ([Android|https://play.google.com/store/apps/details?id=com.flussonic.watcher] или [iPhone|https://apps.apple.com/ru/app/flussonic-watcher/id1233594294])
#* Или [вручную в интерфейсе Watcher|https://flussonic.ru/doc/watcher/upravlenie-kamerami/#watcher-manage-cameras-add_camera]
#* При добавлении камеры, {color:#cc0055}{*}укажите настройки, какие захочет абонент{*}{color}
# В течение 5 минут биллинг заберёт параметры новых камер из Watcher, и подключит пользователю услуги в системе
# Если абонент захочет сменить тариф видеонаблюдения, он сделает это в [личном кабинете оператора связи|CarbonBilling:Локальный сайт. Личный кабинет.], вместе с прочими услугами.

h3. Какими параметрами камеры управляет биллинг

!Watcher Камера, управляемые параметры.png|border=0,width=600!

h4. Пресет и "Глубина DVR"

Это связанные параметры - глубина DVR всегда определяется через пресет.

В настройках услуг в биллинге, пресеты определяются парамтером *preset_id*, например:
{code}preset_id=1{code}

h4. Лимит DVR в днях для записи по движению и "Получать события"

Этот параметр определяется отдельно. Его нельзя задавать в пресете. В Watcher предустановлено 16 возможных вариантов этого параметра

В настройках услуг в биллинге, лимит DVR в днях определяются парамтером *dvr_lock_days*, например:
{code}dvr_lock_days=7{code}

Опция камеры "Получать события" должна быть включена, чтобы работало сохранения записи по движению, поэтому если задать параметры лимита DVR, то опция "Получать события" будет включена автоматический.

h4. PTZ

PTZ определяет возможность удалённого управлять камерой. Вы можете включить взимать за это дополнительную плату, но можете и предоставлять эту опцию бесплатно.

В настройках услуг в биллинге, PTZ определяются парамтером *onvif_ptz*, нужно создать только услугу для включения PTZ:
{code}onvif_ptz=True{code}

Если PTZ на камере выключено, биллинг считает это параметром "по-умолчанию", создавать для этого отдельной услуги не нужно.

h4. Состояние (включена/выключена)

Камера будет включена пока оплачены услуги. Если абонента заблокировать, его камеры будут выключены биллингом.

h3. Что будет если поменять эти параметры прямо в Watcher?

В течение пяти минут пройдёт синхронизация и параметры камеры вернутся к тем, что указаны в биллинге.

Например, если абонент заблокирован по балансу, но зайдёт в Watcher и включит камеру - биллинг её выключит.

Если изменит пресет - то вернётся тот пресет, что настроен услугами в биллинге.

h2. Настройка Flussonic

h3. Создайте пресеты

В меню "*Пресеты камер*" добавьте "тарифы" телевидения:
В каждом тарифе укажите:
# *Глубина DVR*: этот параметр нужно задать.
# *Лимит DVR в днях...*: этот параметр *всегда* должен быть "не задано"
# *Доступен во всех организациях*: включите

Название задайте каждому пресету любое, удобное Вам.
Опции "Лимит DVR в ГБ" и "Настраиваемый" не определяются интеграцией, укажите любые. Рекомендуется оставить как на скриншоте.

| !Watcher Пресеты список.png|border=0,width=700! | !Watcher Пресет настройки.png|border=0,width=350! |

h3. Настройте пользователя для управления камерами

Добавьте пользователя, например *service* или *support* - это будет служебная учетная запись, от имени него биллинг будет управлять параметрами камер.

!Watcher Пользователи.png|border=0,width=800!

Настройте пользователю "разрешения" как на скриншоте, он должен быть включен и являться администратором.

!Watcher Пользователь, настройки.png|border=0,width=700!

Авторизуйтесь от созданного пользователя в интерфейсе Watcher и зайдите в настройки профиля

!Watcher Пользотватель, кнопка перехода в профиль.png|border=0,width=600!

Сгенерируйте ключ API, если его ещё нет, или скопируйте существующий. Он понадобится при настройке интеграции со стороны биллинга.

!Watcher Пользователь, профиль.png|border=0,width=600!

h3. Настройте интеграцию с биллингом

# Запишите системный "Ключ API" - он используется как резервный при интеграции, если настройка служебного пользователя или доступа к камерам будет нарушена.
# В области "Главная страница" укажите путь к обработчику auth_flussonic.php на биллинге, на него мы ожидаем запросы авторизации, например:
{code}https://169.254.14.43:2443/auth_flussonic.php{code}
169.254.14.43 замените на IP биллинга
# В области "Уведомления о событиях" укажите путь до обработчика integration_flussonic.php, на него мы получаем информацию о появившихся в сети камерах, например:
{code}https://169.254.14.43:2443/integration_flussonic.php{code}
169.254.14.43 так же замените на IP биллинга

!Watcher Системные настройки.png|border=0,width=600!

h2. Настройка Billing

h3. Настройте NAS

Добавьте NAS со схемой Flussonic и версией 2

IP-адрес укажите любой - его заполнить обязательно только чтобы создался NAS.

Каталог OSS заполнится автоматический.

!Watcher NAS описание.png|border=0,width=350!

На вкладке "Управление", инициализируйте схему, откройте закладку "Настройка", файл main.ini и заполните данные доступа к Watcher:
* watcher_url - путь к Flussonic в Вашей сети
* watcher_api_system_key - системный ключ из общих настроек пользователя, он нужен как резервный
* watcher_api_key - ключ API из профиля служебного пользователя
* watchet_api_user - логин этого пользователя

!Watcher NAS main_ini.png|border=0,width=500!

{code:title=Пример main.ini}tmplt=tmplt/main.cfg.tmplt
enabled="1"
watcher_url=https://watcher.provider.ru
watcher_api_system_key=50od9t83-f80o-39i8-okd0-d9k3kd8i0ov
watcher_api_key=p29kbk54gj3eszy2mrdpnw36a
watcher_api_user=service{code}

h3. Настройте услуги

|| Вкладка "Основные" || Вкладка "Дополнительно" || Вкладка "Личный кабинет" ||
| * *Тип*: обязательно "Стандартный"
* *Цена*: укажите размер абонентской платы за период
* *Метод списания*: любой с периодическим списанием
!Watcher услуга пресета, основные.png|border=0,width=300! \\ !Watcher услуга пресета, абонплата.png|border=0,width=300! | * *Строка с доп. параметрами*: ID пресетов и доп. услуг
* *NAS*: укажите NAS Flussonic
!Watcher услуга пресета, дополнительно.png|border=0,width=300! | Настройте возможность включения и отключения услуги
из личного кабинета
!Watcher услуга пресета, личный кабинет.png|border=0,width=300! |

h4. Услуги для пресетов, примеры

||Название услуги||Стоимость||Строка с дополнительными
параметрами по {color:green}активации{color}||Строка с дополнительными
параметрами по {color:red}деактивации{color}||[Тип услуги|https://docs.carbonsoft.ru/pages/viewpage.action?pageId=50660430#Услуги-Вкладка"Основные"]||[Метод списания|CarbonBilling:Методы списания]||[Тип списания|CarbonBilling:Типы списания]||
|Flussonic: тариф Default (служебный, для сотрудников)|0|preset_id=1|preset_id=1|Стандартный|Ежемесячно|Предоплата|
|Flussonic: тариф без хранения, онлайн|100|preset_id=2|preset_id=2|Стандартный|Ежемесячно|Предоплата|
|Flussonic: тариф Базовый|200|preset_id=3|preset_id=3|Стандартный|Ежемесячно|Предоплата|
|Flussonic: тариф Удобный|500|preset_id=4|preset_id=4|Стандартный|Ежемесячно|Предоплата|

h4. Услуга лимита DVR для записи по движению, примеры

Лимит DVR в днях для записей по движению - количество дней, в течение которых необходимо хранить записи событий движения. Этот лимит устанавливается в дополнение к глубине архива.

В отличие от пресетов, список для выбора глубины лимита записи по движению предустановлен в Watcher. Вы можете создать услуги именно с указанными параметрами по активации и деактивации, выбрав собственные параметры списания и указав своё название.

||Название услуги||Стоимость||Строка с дополнительными
параметрами по {color:green}активации{color}||Строка с дополнительными
параметрами по {color:red}деактивации{color}||[Тип услуги|https://docs.carbonsoft.ru/pages/viewpage.action?pageId=50660430#Услуги-Вкладка"Основные"]||[Метод списания|CarbonBilling:Методы списания]||[Тип списания|CarbonBilling:Типы списания]||
|Flussonic: лимит DVR записи по движению не задано|0|dvr_lock_days=None|dvr_lock_days=None|Стандартный|Ежемесячно|Предоплата|
|Flussonic: лимит DVR записи по движению 1 день|30|dvr_lock_days=1|dvr_lock_days=1|Стандартный|Ежемесячно|Предоплата|
|Flussonic: лимит DVR записи по движению 2 дня|50|dvr_lock_days=2|dvr_lock_days=2|Стандартный|Ежемесячно|Предоплата|
|Flussonic: лимит DVR записи по движению 3 дня|70|dvr_lock_days=3|dvr_lock_days=3|Стандартный|Ежемесячно|Предоплата|
|Flussonic: лимит DVR записи по движению 4 дня|90|dvr_lock_days=4|dvr_lock_days=4|Стандартный|Ежемесячно|Предоплата|
|Flussonic: лимит DVR записи по движению 5 дней|100|dvr_lock_days=5|dvr_lock_days=5|Стандартный|Ежемесячно|Предоплата|
|Flussonic: лимит DVR записи по движению 6 дней|115|dvr_lock_days=6|dvr_lock_days=6|Стандартный|Ежемесячно|Предоплата|
|Flussonic: лимит DVR записи по движению 1 неделя|130|dvr_lock_days=7|dvr_lock_days=7|Стандартный|Ежемесячно|Предоплата|
|Flussonic: лимит DVR записи по движению 10 дней|140|dvr_lock_days=10|dvr_lock_days=10|Стандартный|Ежемесячно|Предоплата|
|Flussonic: лимит DVR записи по движению 2 недели|180|dvr_lock_days=14|dvr_lock_days=14|Стандартный|Ежемесячно|Предоплата|
|Flussonic: лимит DVR записи по движению 1 месяц|360|dvr_lock_days=30|dvr_lock_days=30|Стандартный|Ежемесячно|Предоплата|
|Flussonic: лимит DVR записи по движению 40 дней|480|dvr_lock_days=40|dvr_lock_days=40|Стандартный|Ежемесячно|Предоплата|
|Flussonic: лимит DVR записи по движению 2 месяца|720|dvr_lock_days=60|dvr_lock_days=60|Стандартный|Ежемесячно|Предоплата|
|Flussonic: лимит DVR записи по движению 3 месяца|900|dvr_lock_days=90|dvr_lock_days=90|Стандартный|Ежемесячно|Предоплата|
|Flussonic: лимит DVR записи по движению полгода|1620|dvr_lock_days=180|dvr_lock_days=180|Стандартный|Ежемесячно|Предоплата|
|Flussonic: лимит DVR записи по движению год|2555|dvr_lock_days=365|dvr_lock_days=365|Стандартный|Ежемесячно|Предоплата|

h4. Услуга удалённого управления камерой (PTZ), пример

Включение PTZ позволит абоненту удалённо управлять положением камеры (должно поддерживаться моделью камеры)

||Название услуги||Стоимость||Строка с дополнительными
параметрами по {color:green}активации{color}||Строка с дополнительными
параметрами по {color:red}деактивации{color}||[Тип услуги|https://docs.carbonsoft.ru/pages/viewpage.action?pageId=50660430#Услуги-Вкладка"Основные"]||[Метод списания|CarbonBilling:Методы списания]||[Тип списания|CarbonBilling:Типы списания]||
|Flussonic: PTZ|50|onvif_ptz=True|onvif_ptz=True|Стандартный|Ежемесячно|Предоплата|

h2. Подключению Watcher абоненту

h3. Добавьте учётную привязанную к NAS со схемой Flussonic

!Watcher Учетная запись абонента.png|border=0,width=500!

Добавьте [учётную запись|CarbonBilling:Учетная запись. Создание и изменение.], привязанную к NAS со схемой Flussonic версии 2.

Биллинг сразу создаст на Watcher [организацию|https://flussonic.ru/doc/watcher/upravlenie-organizatsiyami/] и [пользователя|https://flussonic.ru/doc/watcher/upravlenie-polzovatelyami/] для абонента

Остальные поля не важны, в том числе тип авторизации. "Внешний ИД" заполнится автоматический после создания пользователя на Flussonic.

h3. Отправьте инженера подключить абоненту камеру

Установите камеру и авторизуйтесь в Watcher с учётной записью ранее созданной для абонента.
Добавьте абоненту камеры [через мобильное приложение|https://flussonic.ru/doc/watcher/upravlenie-kamerami/#watcher-manage-cameras-add_cam_agent] ([Android|https://play.google.com/store/apps/details?id=com.flussonic.watcher] или [iPhone|https://apps.apple.com/ru/app/flussonic-watcher/id1233594294]).
При добавлении камеры, {color:#cc0055}{*}укажите настройки, какие захочет абонент{*}{color}

Камеру можно настроить в [вручную в интерфейсе Watcher|https://flussonic.ru/doc/watcher/upravlenie-kamerami/#watcher-manage-cameras-add_camera], например если в ней нет агента Watcher, но к ней есть прямой доступ по белому IP-адресу.

h3. Биллинг синхронизирует выбранные настройки

Биллинг автоматический подключит абоненту услуги по каждой добавленной камере

!Watcheh Абонент, вкладка услуги.png|border=0,width=900!

Каждая подключенная услуга привязывается к камере из справочника оборудорвания (тоже синхронизируются биллингом автоматический)

!Watcheh Абонент, подключенная услуга.png|border=0,width=700!

h2. Отладка

h3. Журнал синхронизации

Лог синхронизации всегда по одному пути
{code}tail -f /app/asr_billing/var/log/nas_event_daemon/flussonic.log{code}
Лог отправленных команд по учетным записям абонентов тоже в папке nas_event_daemon, название состоит из наименование NAS и его IP, например:
{code}tail -f /app/asr_billing/var/log/nas_event_daemon/Flussonic_v2_1.1.1.8.log{code}

h3. Команды диагностики учётной записи

Схемой предусмотрена [диагностика учётной записи|CarbonBilling:Команды диагностики пользователей] - эта информация будет полезна инженерам и разработчикам при обращении абонента в техподдержку.


|| Информация для оператора биллинга || Сырые данные для разработчика ||
| !https://docs.carbonsoft.ru/download/attachments/186286637/disgnostic+commands+flussonic+user_info+main.png?version=1&modificationDate=1612859364028|border=0,width=250! | !https://docs.carbonsoft.ru/download/attachments/186286637/disgnostic+commands+flussonic+user_info+dev.png?version=1&modificationDate=1612859498469|border=0,width=200! |

h3. Отчёт со списком всех абонентов

В статье [CarbonBilling:Примеры технических отчётов] мы подготовили несколько отчётов, которые могут быть полезны администраторам:

[Услуги, привязанные к NAS|https://docs.carbonsoft.ru/pages/viewpage.action?pageId=175833127#Примерытехническихотчётов-Услуги%2CпривязанныекNASSUP675790] отразит основные параметры услуг из справочника, привязанных к выбранному NAS

[Количество абонентов с услугами привязанными к NAS-серверам|https://docs.carbonsoft.ru/pages/viewpage.action?pageId=175833127#Примерытехническихотчётов-Услуги%2CпривязанныекNASSUP675790] покажет количество абонентов по NAS - то есть, с подключенным видеонаблюдением.

[Учтетные записи, камеры и услуги по камерам для схемы интеграции Flussonic Watcher v2|https://docs.carbonsoft.ru/pages/viewpage.action?pageId=175833127#Примерытехническихотчётов-Учтетныезаписи%2CкамерыиуслугипокамерамдлясхемыинтеграцииFlussonicWatcherv2SUP675790] покажет важные параметры для техподдержки по всем абонентам с учетными записями и камерами Flussonic

!Watcheh Абонент, в отчёте.png|border=0,width=700!


h2. FAQ

h3. Что будет если абонент поменяет параметры камеры прямо на Watcher?

В течение пяти минут пройдёт синхронизация и параметры камеры вернутся к тем, что указаны в биллинге.

Например, если абонент заблокирован по балансу, но зайдёт в Watcher и включит камеру - биллинг её выключит.

Если изменит пресет - то вернётся тот пресет, что настроен услугами в биллинге.

h3. Что будет, если удалить камеру на Watcher?

Синхронизатор автоматический отключит в биллинге услуги по этой камере в течение 5 минут - этим управляет синхронизация.

h3. Если удалить камеру на Watcher, и добавить вновь, что будет в справочнике оборудования?

Старая камера останется, добавится новая. Услуги абонента будут только по новой камере.

Это связано с тем, что биллинг не имеет представления о ккамере как физическом объекте, потому что Watcher не всегда отражает серийный номер камеры. Поэтому в качестве "серийного номера" в биллинге мы записываем наименование этой камеры, указанное в Watcher - оно всегда уникально для новой камеры, и изменится если камеру удалить и снова добавить тому же или другому абоненту.

h3. Как заново синхронизировать камеру?

Вы можете вручную удалить услуги по этой камере в течение 5 минут между синхронизациями и поменять параметры камеры на Watcher. Тогда биллинг подгрузит услуги по параметрам камеры, указанным в Watcher - для него это будет новая камера.

h3. Если это сделает абонент заблокированный по балансу?

Новые услуги подключатся, но сразу будут заблокированы и камера всё равно выключится.

h3. Как заменить тариф камеры в администраторской панели?

По статье [CarbonBilling:Изменение условий обслуживания]. Привязку оборудования биллинг сохранит в новой услуге.