# Инструкция — Defendex Telegram-бот

Telegram-бот для получения уведомлений о событиях на охранных объектах и управления охраной прямо из мессенджера.

---

## Подключение к боту

1. Сообщите администратору ваш **Telegram ID**
   (узнать ID можно у бота [@userinfobot](https://t.me/userinfobot))
2. Администратор привяжет ваш ID к учётной записи в системе
3. Найдите бота в Telegram и нажмите **«Старт»** или отправьте команду `/start`

> Если ID не привязан — бот ответит: «Нет регистрации. ID: XXXXXXX»
> Сообщите этот ID администратору.

---

## Команды

| Команда | Описание |
|---------|----------|
| `/start` | Показать список объектов и меню управления |

---

## Управление охраной

### Шаг 1 — выбор объекта

Отправьте `/start`. Бот покажет список ваших объектов:

```
🛡 Выберите объект:

[ 📍 Склад №1    ]
[ 📍 Офис центр  ]
[ 📍 Магазин     ]
```

Нажмите на нужный объект.

### Шаг 2 — управление

После выбора объекта появятся кнопки управления:

```
🎮 Управление объектом:

[ 🔒 ПОСТАВИТЬ ]  [ 🔓 СНЯТЬ ]
```

| Кнопка | Действие |
|--------|----------|
| **🔒 ПОСТАВИТЬ** | Поставить объект на охрану (ARM) |
| **🔓 СНЯТЬ** | Снять объект с охраны (DISARM) |

После нажатия бот подтвердит: **«✅ Команда отправлена»**
или сообщит об ошибке: **«❌ Ошибка: ...»**

---

## Уведомления о событиях

Бот автоматически присылает сообщения при новых событиях на ваших объектах.

### Обычное событие:

```
‼️ СОБЫТИЕ
🏰 Объект: Склад №1
📍 Место: Входная дверь
📝 🚨 ТРЕВОГА зона 1
```

### Нет теста связи (потеря связи с прибором):

```
📵 НЕТ ТЕСТА СВЯЗИ
🏰 Объект: Офис центр
📍 Место: ZONA 0
📝 Нет теста связи
```

> Уведомления о штатных тестах связи (heartbeat) **не отправляются** — только важные события.

### Типы событий которые приходят:

| Событие | Описание |
|---------|----------|
| 🚨 ТРЕВОГА | Сработала зона/шлейф |
| ✅ НОРМА | Тревога снята |
| 🔒 На охране | Объект поставлен на охрану |
| 🔓 Снят с охраны | Объект снят с охраны |
| 📵 Нет теста связи | Прибор не выходит на связь |
| 🔋 Низкий заряд | Разряжена батарея резервного питания |

---

## Важно

- Уведомления приходят только если ваш **Telegram ID привязан** к аккаунту в системе
- Вы получаете уведомления только по **своим объектам**
- Команды управления работают в любое время
- Бот проверяет новые события каждые **2 секунды**

---

## Если бот не отвечает

1. Убедитесь что не заблокировали бота — нажмите **«Разблокировать»** или **«Start»**
2. Отправьте `/start` ещё раз
3. Обратитесь к администратору — возможно бот остановлен или ваш ID не привязан

---

## Для администратора — привязка Telegram ID

В панели администратора (`http://IP:8002`) → раздел **«Персоны (Users)»**:
1. Найдите или создайте пользователя
2. Введите **Telegram ID** в соответствующее поле
3. Сохраните

Или напрямую в БД:
```sql
UPDATE users SET telegram_id = 123456789 WHERE username = 'ivan';
```

---

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