---
title: 'Аудит паспортів'
description: 'Теплова карта повноти паспортів приладів по всьому парку — за типом коректора та полем: Qmax/Qmin, заводські номери, прошивка, батарея, склад газу.'
section: AI Analytics
weight: 9
related:
  - ai-analytics/fleet-reports/fleet-inventory
---

import Alert from '@/components/docs/Alert.astro';

Перевірка по всьому парку: для кожного типу коректора звіт вимірює, наскільки повно заповнено паспорт приладу — максимальна й мінімальна витрата, заводські номери, версія прошивки, склад газу та інші поля. Він потрібен керівникові експлуатації та службі даних, щоб побачити, у яких типів приладів паспорти порожні і куди потрібно відправити бригаду на інвентаризацію.

Це діагностика того, які дані є про прилади, а не перевірка самого обладнання на місці. Звіт показує, що записано в базі, і не підтверджує це фізично.

## Що показує

Зведення вгорі (KPI): скільки вузлів у парку, скільки типів приладів перевірено, скільки вузлів реально вдалося опитати, і середня повнота паспорта у відсотках.

Головний елемент — кольорова таблиця «тип приладу × поле паспорта». Кожна комірка показує, у якої частки перевірених приладів це поле заповнене (від 0 до 100 %). Що червоніше — то гірше. Поля згруповані за змістом:

| Група полів        | Що входить                                    |
| ------------------ | --------------------------------------------- |
| Метрологія         | максимальна й мінімальна витрата (Qmax, Qmin) |
| Ідентифікація      | заводські номери, версія прошивки             |
| Безпека            | заряд батареї, пороги за тиском               |
| Склад газу         | густина, частки азоту, CO₂, метану            |
| Захист від підміни | пороги підстановки тиску                      |

Рядки відсортовані так, що **найгірші типи — нагорі**: саме з них і потрібно починати наведення ладу.

## Як працює

1. Завантажуємо список вузлів парку (можна обмежити однією газорозподільною компанією).
2. Групуємо вузли за типом коректора.
3. Для кожного типу беремо вибірку з кількох вузлів (за замовчуванням 5) і запитуємо їхні паспортні дані (`archive_type=settings` — запит налаштувань приладу).
4. Для кожного поля рахуємо частку приладів, де воно заповнене.

Імена полів у різних виробників пишуться по-різному, тому звіт зводить їх до 14 загальних назв за словником відповідностей. Враховуються лише ті вузли, що реально відповіли на запит; якщо вузол не відповів, він не псує статистику як «порожній».

## Параметри запуску

| Параметр                 | За замовчуванням | Що значить                                                                |
| ------------------------ | ---------------- | ------------------------------------------------------------------------- |
| Вибірка вузлів на тип    | 5                | скільки вузлів опитувати на кожен тип приладу                             |
| Паралельних потоків      | 4                | скільки вузлів опитувати одночасно (швидше, але більше навантажує сервер) |
| Газорозподільна компанія | Усі (весь парк)  | фільтр за однією газорозподільною компанією                               |

## Як читати результат

Дивіться на червоні рядки нагорі таблиці і на стовпець середньої повноти (avg) у кожного типу.

| Середня повнота типу | Що це значить                                          |
| -------------------- | ------------------------------------------------------ |
| 80 % і вище          | паспорт майже повний; розрахунки за цим типом надійні  |
| 50–79 %              | заповнено частково; частина операцій обмежена          |
| менше за 50 %        | потрібен виїзд на інвентаризацію та дозаповнення даних |

Про що пам'ятати:

- **Вибірка з 5 вузлів** дає приблизну оцінку за типом: якщо в групі 200 приладів, ми дивимося лише 5. Це компроміс між швидкістю та точністю.
- **0 % не завжди означає «поля немає».** Можливо, прилад його не віддає, хоча фізично воно присутнє.
- Якщо з'явився новий тип коректора з незвичними іменами полів, словник відповідностей варто доповнити — інакше його поля не розпізнаються.

<Alert type="note" title="Читає лише наявні дані">
  Аудит паспортів відображає те, що записано про кожен прилад, а не справжню конфігурацію приладу на
  місці. Використовуйте його, щоб визначити пріоритети виїздів на інвентаризацію, а потім
  підтвердіть поля фізично там, де повнота низька.
</Alert>