# Руководство по использованию системы проверки оборудования

## Обзор

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

## Возможности

- ✅ Проверка оборудования по аудиториям или всего подряд
- ✅ Поддержка штрихкод-сканеров (работают как клавиатура)
- ✅ Автоматическое обновление времени при повторном сканировании
- ✅ Сохранение неизвестных номеров
- ✅ Отслеживание прогресса в реальном времени
- ✅ История всех проверок
- ✅ Доступ для всех авторизованных пользователей (включая viewer)

## Как использовать

### 1. Начать новую проверку

1. Войдите в систему
2. Перейдите в раздел "Проверка" в меню
3. (Опционально) Выберите аудиторию для проверки
   - Если аудитория не выбрана, будет проверяться всё оборудование
4. Нажмите "Начать проверку"

### 2. Сканирование оборудования

После начала проверки:

1. Фокус автоматически установлен на поле ввода
2. Отсканируйте штрихкод или введите инвентарный номер вручную
3. Нажмите Enter (или сканер сделает это автоматически)
4. Система покажет результат:
   - ✅ **Зелёное уведомление** - оборудование найдено
   - ❌ **Красное уведомление** - номер не найден (сохранён в неизвестные)
5. Продолжайте сканирование следующих позиций

### 3. Отслеживание прогресса

Во время проверки отображается:

- **Проверено** - количество отсканированных позиций
- **Всего** - ожидаемое количество оборудования
- **Не найдено** - количество неизвестных штрихкодов
- **Прогресс** - процент завершения

### 4. Завершение проверки

1. После завершения сканирования нажмите "Завершить проверку"
2. Подтвердите действие
3. Проверка будет сохранена в историю

### 5. Просмотр истории

1. На главном экране проверок нажмите "Загрузить историю"
2. Выберите нужную проверку
3. Нажмите "Детали" для просмотра отчёта

## Работа со сканером штрихкодов

### Подключение

1. Подключите USB штрихкод-сканер к компьютеру
2. Сканер работает как клавиатура - не требует драйверов
3. Откройте страницу проверки в браузере

### Сканирование

1. Убедитесь, что фокус на поле ввода
2. Наведите сканер на штрихкод
3. Нажмите кнопку сканирования
4. Сканер введёт номер и нажмёт Enter автоматически

### Советы

- После каждого сканирования фокус автоматически возвращается на поле ввода
- Можно сканировать штрихкоды быстро один за другим
- Уведомления о результатах исчезают автоматически через 3 секунды

## Особенности

### Повторное сканирование

- При повторном сканировании одного и того же оборудования обновляется только время проверки
- В таблице остаётся одна запись на единицу оборудования

### Неизвестные номера

- Если номер не найден в базе данных, он сохраняется в список неизвестных
- Неизвестные номера отображаются отдельным списком
- Это помогает выявить ошибки маркировки или новое оборудование

### Доступ

- Все авторизованные пользователи могут проводить проверки
- Проверки можно просматривать, но нельзя удалять
- Каждая проверка привязана к пользователю, который её создал

## API Endpoints

Система предоставляет следующие API эндпоинты:

- `POST /inspections/sessions` - Начать новую проверку
- `POST /inspections/sessions/{id}/check` - Сканировать штрихкод
- `GET /inspections/sessions/{id}` - Получить статистику проверки
- `POST /inspections/sessions/{id}/complete` - Завершить проверку
- `GET /inspections/sessions` - Список всех проверок
- `GET /inspections/sessions/{id}/records` - Детальный отчёт

Полная документация доступна по адресу: http://localhost:8000/docs

## Устранение неполадок

### Сканер не работает

1. Проверьте USB подключение
2. Убедитесь, что фокус на поле ввода
3. Попробуйте отсканировать в текстовый редактор для проверки
4. Проверьте настройки сканера (должен добавлять Enter в конце)

### Оборудование не находится

1. Проверьте инвентарный номер в базе данных
2. Убедитесь, что штрихкод читается правильно
3. Проверьте список неизвестных штрихкодов

### Прогресс не обновляется

1. Нажмите кнопку "Обновить данные"
2. Проверьте подключение к серверу
3. Обновите страницу браузера

## База данных

Система использует три новые таблицы:

1. **inspection_sessions** - Сессии проверок
2. **inspection_records** - Записи о проверенном оборудовании
3. **unknown_barcodes** - Неизвестные штрихкоды

Таблицы создаются автоматически при запуске скрипта `create_inspection_tables.py`.