fix aud search on center

INSPECTION_GUIDE.md

@@ -0,0 +1,142 @@
+# Руководство по использованию системы проверки оборудования
+
+## Обзор
+
+Система проверки оборудования позволяет проводить инвентаризацию с использованием штрихкод-сканера или ручного ввода инвентарных номеров.
+
+## Возможности
+
+- ✅ Проверка оборудования по аудиториям или всего подряд
+- ✅ Поддержка штрихкод-сканеров (работают как клавиатура)
+- ✅ Автоматическое обновление времени при повторном сканировании
+- ✅ Сохранение неизвестных номеров
+- ✅ Отслеживание прогресса в реальном времени
+- ✅ История всех проверок
+- ✅ Доступ для всех авторизованных пользователей (включая 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`.