Поиск ONU

Поиск ONU — главный сценарий ежедневной эксплуатации. Найти конкретное абонентское устройство нужно по самым разным «зацепкам»: жалоба от абонента в биллинге, обрывок MAC-адреса, серийный номер, ФИО, адрес.

По чему можно искать

Критерий	Когда удобно
MAC-адрес	Точная идентификация, можно частично
Серийный номер (SN)	Указан в наряде на подключение
Номер договора	Если работаем из биллинга
ФИО абонента	Жалоба от оператора колл-центра
Адрес	«У дома такого-то нет интернета»
IP OLT	Фильтрация по конкретному узлу
VLAN	Дебаг внутреннего сегмента сети
Статус	Только активные / только проблемные

Все критерии комбинируются по AND-логике. Пустые поля не учитываются.

Где живут данные

• ONU и их история — в локальной БД GetOLT.
• Привязка ONU к абоненту (договор, ФИО, адрес) — подтягивается из интегрированных биллингов.
• Параметр lastSeen — когда устройство в последний раз отвечало OLT.
• Поле health — active / stale / unknown. По умолчанию ONU считается «свежей», если её видели за последние 24 часа.

Как искать через UI

1. Перейти в раздел «ONU» / «Поиск».
2. Заполнить любые известные критерии.
3. Результаты отсортированы по lastSeen DESC — сверху последние «живые» ONU.

Как искать через API

Тот же поиск доступен через onu.find в REST API и в MCP-сервере — это удобно для скриптов и LLM-агентов.

Типичные ошибки

• «ONU не найдено, но абонент жалуется» — проверьте lastSeen. Если устройство офлайн больше суток, оно может попасть только в stale. Снимите фильтр «только активные».
• «Дубликаты ONU» — бывает при перепрошивке/замене абонентского терминала. Старая запись остаётся в БД с тем же договором, но другим MAC. См. Анализ конфигов и регулярный cleanup.