asuinventory/INSPECTION_GUIDE.md

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

Обзор

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

Возможности

• ✅ Проверка оборудования по аудиториям или всего подряд
• ✅ Поддержка штрихкод-сканеров (работают как клавиатура)
• ✅ Автоматическое обновление времени при повторном сканировании
• ✅ Сохранение неизвестных номеров
• ✅ Отслеживание прогресса в реальном времени
• ✅ История всех проверок
• ✅ Доступ для всех авторизованных пользователей (включая 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.