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