# Инструкция администратора — Defendex Admin Panel

Веб-панель для управления охранными объектами, пользователями, зонами и камерами.

**Адрес:** `http://IP:8002`

---

## Навигация

В левой боковой панели находится меню разделов:

| Раздел | Назначение |
|--------|------------|
| 🏢 Объекты (MTN) | Управление охранными приборами |
| 📍 Настройка зон (HZ) | Названия шлейфов/зон |
| 👥 Персоны (Users) | Пользователи, доступ, Telegram |
| 📷 Камеры | IP-камеры и снимки по тревоге |
| 📜 Архив | Журнал всех событий |
| 🧙 Мастер настройки | Быстрое создание объекта из шаблона |

### Индикатор канала связи (вверху сайдбара)

Показывает состояние соединения TLF-клиента с внешним охранным сервером:

| Индикатор | Состояние |
|-----------|-----------|
| 🟢 ON-LINE | Канал работает, данные поступают |
| 🟡 Молчит | Соединение есть, данных нет |
| 🔴 OFF-LINE | Нет соединения |

Обновляется автоматически каждые 10 секунд. Кнопка **«🔄 Обновить»** — принудительное обновление.

---

## Объекты (MTN)

Список всех охранных приборов в системе.

### Статусы объектов

| Индикатор | Статус | Описание |
|-----------|--------|----------|
| 🟢 Online | Активен | Сигнал поступает в норме |
| 🔴 Offline | Нет связи | Нет сигнала более 15 минут |
| ⚪ Отсутствует | Новый | Ещё ни разу не подключался |

Сводка сверху показывает количество объектов по каждому статусу.

### Добавить объект

Нажмите **«➕ Добавить новый объект»** и заполните форму:

| Поле | Описание |
|------|----------|
| **Номер объекта (NR)** | Уникальный номер (account number) 1–9999 |
| **IMEI / ID прибора** | IMEI GSM-модуля или назначаемый идентификатор |
| **Название** | Произвольное название объекта |
| **Тип панели** | DSC, Paradox, CADDX, Esprit, EVO и др. |

Нажмите **«Создать объект»**.

> Объект автоматически привязывается к пользователю `admin`.

### Изменить тип панели

В строке объекта — выпадающий список **«Панель»**. Выберите нужный тип — сохраняется сразу автоматически.

> ⚠️ Тип панели влияет на парсинг кодов ARM/DISARM и тревог. При неправильном типе события будут обрабатываться некорректно.

### Удалить объект

Кнопка **«🗑 Удалить»** в строке объекта. Удаляет прибор и все его привязки к пользователям.

---

## Настройка зон (HZ)

Названия шлейфов (зон) отображаются в событиях, уведомлениях и мобильном приложении.

### Редактирование зон

1. Выберите объект из выпадающего списка
2. В таблице укажите **номер шлейфа** и **название**
3. Для добавления новой зоны — введите данные в пустую строку внизу таблицы
4. Для удаления — очистите строку
5. Нажмите **«💾 Сохранить изменения в базе»**

**Пример:**

| № Шлейфа | Название зоны |
|----------|---------------|
| 1 | Входная дверь |
| 2 | Окно кухня |
| 3 | Движение коридор |

---

## Персоны (Users)

Управление учётными записями пользователей мобильного приложения и Telegram-бота.

### Создать пользователя

Нажмите **«➕ Зарегистрировать новую персону»**:

| Поле | Описание |
|------|----------|
| **Логин** | Имя для входа в мобильное приложение |
| **Пароль** | Минимум 4 символа. Хранится в зашифрованном виде |
| **Telegram ID** | ID для получения уведомлений от бота |

> Telegram ID узнать: написать боту [@userinfobot](https://t.me/userinfobot)

Нажмите **«Создать аккаунт»**.

### Настроить доступ к объектам

Для каждого пользователя отображается список **«Объекты, доступные этому пользователю»**.

1. В мультиселекте выберите объекты, к которым нужен доступ
2. Нажмите **«💾 Обновить права доступа»**

Пользователь видит в приложении только те объекты, к которым у него есть доступ.

### Удалить пользователя

Кнопка **«🗑 Удалить персону»** в строке пользователя.

---

## Камеры

Управление IP-камерами и просмотр снимков по тревоге.

### Добавить камеру

Нажмите **«➕ Добавить камеру»**:

| Поле | Описание |
|------|----------|
| **Название** | Произвольное название (напр. «Вход офис») |
| **IP-адрес** | IP-адрес камеры в сети |
| **URL снимка** | HTTP-адрес для получения JPEG-кадра |
| **Привязать к объекту** | Камера будет связана с конкретным охранным объектом |
| **Зона** | Номер зоны (0 = вся территория объекта) |
| **Активна** | Включить/выключить камеру |

### Изменить настройки камеры

Нажмите **«⚙️ Настройки камеры»** под нужной камерой, внесите изменения и нажмите **«Сохранить»**.

### Снимки по тревоге

Раздел **«Последние снимки по тревоге»** показывает до 20 последних автоматических снимков с камер — время, название камеры, объект, событие и фотографию.

Снимки делаются автоматически при срабатывании тревоги.

---

## Архив событий

Журнал последних 200 событий по всем объектам.

### Что отображается:

| Колонка | Описание |
|---------|----------|
| **Дата/Время** | Временная метка события |
| **Объект** | Название охранного объекта |
| **Тип** | Тип события (alarm, arm, disarm, communication_test и др.) |
| **Событие** | Текстовое описание |
| **Зона/Место** | Название шлейфа или номер зоны |

### Статус теста связи

Раздел **«📡 Статус теста связи устройств»** (раскрыть) — показывает по каждому объекту:
- Время последнего сигнала
- Статус: 📶 Связь есть / 📵 Нет связи / Нет данных

---

## Мастер настройки

Быстрое создание объекта по шаблону типа панели. Удобно при подключении нового прибора.

### Шаги:

**1. Тип панели** — выберите из списка. Справа появится описание и особенности панели.

**2. Объект** — заполните:
- Номер объекта (NR)
- IMEI / ID прибора
- Название

**3. Коды событий (ContactID)** — таблица с предзаполненными кодами для выбранного типа панели. При необходимости отредактируйте.

**4. Зоны (шлейфы)** — шаблонный список зон. Добавляйте, удаляйте, переименовывайте.

**5. Пользователи пульта** — имена для кодов пользователей охранной панели (User 001, User 002...).

**6. Доступ из приложения / бота** — выберите каким пользователям дать доступ к этому объекту.

Нажмите **«💾 Создать объект из шаблона»** — всё сохраняется атомарно (или ничего).

Кнопка **«🔄 Сбросить шаблон к дефолту»** — вернуть зоны и пользователей к исходному шаблону панели.

---

## Типичные задачи

### Подключить новый прибор
1. **Мастер настройки** → выбрать тип панели → заполнить NR, IMEI, название → проверить зоны → выбрать пользователей → **«Создать»**

### Дать пользователю доступ к объекту
1. **Персоны** → найти пользователя → в мультиселекте выбрать объект → **«Обновить права»**

### Переименовать шлейф
1. **Настройка зон** → выбрать объект → отредактировать название в таблице → **«Сохранить»**

### Добавить Telegram-уведомления пользователю
1. **Персоны** → создать пользователя или открыть существующего → узнать его Telegram ID через [@userinfobot](https://t.me/userinfobot) → ввести ID при создании

### Поменять тип панели у объекта
1. **Объекты** → найти объект → изменить выпадающий список **«Панель»** — сохранится автоматически

---

**Defendex 2.0** | [cortex.eu](https://cortex.eu)