# Карта системы Принтум

## Описание

Большинство неисправностей в Printum связаны не с отдельным компонентом, а с разрывом потока данных между компонентами.

При диагностике необходимо сначала определить, к какой из областей относится проблема, а затем локализовать участок цепочки, на котором нарушена передача данных.

---

## 1. Путь задания печати

Используется для диагностики:
- не печатает документ;
- задание не появляется в системе;
- задание есть, но не выходит на принтер;
- не работает отложенная печать;
- не работает прямая печать;
- нет статистики по заданию.

### Печать через Клиент ПМ

```
Приложение
→ Локальная очередь печати
→ Клиент ПМ
→ ПринтМенеджер
→ Очередь заданий
→ CUPS
→ МФУ
→ Статистика в ПринтМенеджере
→ Статистика в Мониторинге
```

## Бесклиентская печать

```
Приложение
→ Универсальный драйвер
→ CUPS ПринтМенеджера
→ ПринтМенеджер
→ Очередь заданий
→ CUPS
→ МФУ
→ Статистика в ПринтМенеджере
→ Статистика в Мониторинге
```

## Что проверять по цепочке

**Доходит ли задание до ПринтМенеджера?**

Проверьте:
- появилось ли задание в разделе `Управление → Задания`;
- есть ли задание в очереди пользователя.

Если задания нет, проверьте:
- клиент ПМ;
- локальную очередь печати;
- виртуальный принтер;
- универсальный драйвер;
- входящий CUPS.

**Обработал ли задание ПринтМенеджер?**

Проверьте:
- применились ли правила;
- не удалено ли задание правилом;
- корректно ли определились атрибуты задания.

**Передал ли CUPS задание на устройство?**

Проверьте:
- есть ли задание в CUPS;
- статус задания;
- ошибки доставки;
- доступность устройства.

**Напечатало ли устройство задание?**

Проверьте:
- состояние устройства;
- ошибки устройства;
- наличие бумаги и тонера в устройстве;
- сетевую доступность.

**Обновилась ли статистика?**

Проверьте:
- архив заданий в ПринтМенеджере;
- синхронизацию Мониторинга и ПринтМенеджера.

---

## 2. Пользователи и права

Используется для диагностики:

- пользователь не появился;
- группа не появилась;
- роль не назначилась;
- правило не применилось;
- не выдался принтер прямой печати;
- пользователь не может войти в систему.

### Цепочка

```
Домен
→ Мониторинг
→ Пользователь + Роль + Правила
→ ПринтМенеджер
→ Принтер
```

### Что проверять по цепочке

**Видит ли Мониторинг пользователя?**

Проверьте:
- подключение Мониторинга к домену по LDAP;
- стартовый уровень поиска в домене (Base DN);
- фильтры поиска;
- сопоставление атрибутов;
- результаты синхронизации.

**Попал ли пользователь в ПринтМенеджер?**

Проверьте:
- синхронизацию Мониторинг → ПринтМенеджер;
- наличие пользователя в ПринтМенеджере.

**Назначилась ли роль?**

Проверьте:
- членство пользователя в группах;
- правила назначения ролей через LDAP-группы;
- роль по умолчанию.

**Применились ли правила?**

Проверьте:
- персональные правила;
- групповые правила;
- квоты;
- ограничения.

**Выдались ли принтеры?**

При использовании Клиента ПМ проверьте:
- существует ли принтер в ПринтМенеджере;
- назначен ли пользователю или группе;
- получил ли клиент ПМ на АРМ пользователя изменения после синхронизации.

---

## 3. Мониторинг устройств

Используется для диагностики:

- устройство не найдено;
- нет счётчиков;
- нет расходников;
- нет статусов;
- нет событий;
- данные не попадают в отчёты.

### Цепочка

```
Устройство
→ SNMP
→ Сетевой агент
→ ClickHouse
→ Обработка данных
→ PostgreSQL
→ Личный кабинет
→ Отчёты
```

### Что проверять по цепочке

**Отвечает ли устройство по SNMP?**

Проверьте:
- доступность IP-адреса;
- порты 161/162;
- SNMP Community;
- результаты snmpwalk.

**Нашёл ли устройство агент?**

Проверьте:
- указан ли IP в локации и\или входит ли IP устройства в диапазоны\подсети локаций;
- завершилось ли сканирование;
- есть ли устройство у агента.

**Попали ли данные на сервер?**

Проверьте:
- связь агента с сервером;
- передачу данных;
- ошибки отправки.

**Обработались ли данные?**

Проверьте:
- наличие данных в ClickHouse;
- выполнение фоновой обработки;
- наличие параметров в PostgreSQL.

**Попали ли данные в интерфейс?**

Проверьте:
- настройки интерпретации;
- настройки модели;
- настройки вендора;
- настройки отчётов.

---

## 4. Авторизация на МФУ

Используется для диагностики:

- не работает карта;
- не работает PIN;
- пользователь входит, но не видит задания;
- встроенное приложение не показывает очередь.

### Цепочка авторизации по карте во встроенном приложении

```
Карта
→ Считыватель
→ Embedded App
→ ПринтМенеджер
→ Пользователь
→ Очередь заданий
```
### Цепочка авторизации по карте через внешнее устройство автризации

```
Карта
→ Считыватель
→ TCP-конвертер
→ ПринтМенеджер
→ Пользователь
→ Очередь заданий
```
### Цепочка авторизации по PIN

```
PIN
→ Embedded App
→ ПринтМенеджер
→ Пользователь
→ Очередь заданий
```

### Что проверять по цепочке

**Доходит ли идентификатор пользователя?**

Для карты проверьте:
- номер карты считывается;
- номер карты передаётся в систему;
- номер карты привязан пользователю.

Для PIN проверьте:
- PIN существует;
- PIN принадлежит пользователю.

**Существует ли пользователь?**

Проверьте:
- пользователь есть в ПринтМенеджере;
- пользователь синхронизирован из домена.

**Успешна ли авторизация?**

Проверьте:
- лицензии Embedded App;
- связь приложения с ПринтМенеджером;
- настроен ли TCP-конвертер и привязан ли к нужному принтеру (для внешней авторизации);
- ошибки авторизации.

**Получает ли пользователь очередь печати?**

Проверьте:
- есть ли задания у пользователя;
- принадлежат ли задания этому пользователю;
- может ли Embedded App получить список заданий.

**Выполняется ли Fast Release?**

Проверьте:
- отправляет ли Embedded App запрос на печать;
- получает ли ПринтМенеджер запрос;
- появляется ли задание в CUPS.

---

## 4. Сканирование в почту и сетевую папку

Используется для диагностики:

- файл сканируемого документа не пришёл в почту\сетевую папку пользователя;
- в статистике пользователя не отображается задание сканирования;

### Цепочка сканирования в почту

```
Пользователь
→ Авторизация в Embedded App
→ Сканирование в почту
→ ПринтМенеджер
→ Почтовый сервер
→ Статистика в Мониторинге
```
### Цепочка сканирования в сетевую папку

```
Пользователь
→ Авторизация в Embedded App
→ Сканирование в сетевую папку
→ ПринтМенеджер
→ Сервер сетевого хранилища файлов
→ Статистика в Мониторинге
```

### Что проверять по цепочке

**Существует ли пользователь?**

Проверьте:
- пользователь есть в ПринтМенеджере;
- пользователь синхронизирован из домена.

**Успешна ли авторизация?**

Проверьте:
- лицензии Embedded App;
- связь приложения с ПринтМенеджером;
- настроен ли TCP-конвертер и привязан ли к нужному принтеру (для внешней авторизации);
- ошибки авторизации.

**Есть ли у пользователя доступ к приложению сканирования в почту\сетевую папку?**

Проверьте:
- наличие в ПринтМенеджере правил запрета доступа к приложению сканирования;
- применение правил запрета доступа к приложению сканирования на пользователя и подразделения\группы, в которых он состоит;

**Есть ли сетевая доступность между ПринтМенеджером и почтовым сервером\сервером хранилища файлов?**

Проверьте:
- фактический доступ по сети с сервера ПринтМенеджера до целевых серверов;
- корректность данных для подключения ПринтМенеджера к целевым серверам;

**Есть ли сетевая и ролевая доступность между пользователем и почтовым сервером\сервером хранилища файлов?**

Проверьте:
- сетевую доступность с АРМ пользователя к серверу хранилища файлов;
- наличие прав доступа в сетевую папку на УЗ пользователя;
- отправку других сообщений с целевого почтового сервера на почту пользователя;

**Обновилась ли статистика?**

Проверьте:
- архив заданий в ПринтМенеджере;
- синхронизацию Мониторинга и ПринтМенеджера.