---
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>