equipment-accounting/OperatorGuide.md

Руководство оператора программы «Учёт компьютерного оборудования»

Аннотация

Настоящий документ содержит информацию, необходимую для работы с программой «Учёт компьютерного оборудования». Программа предназначена для ведения партионного учёта компьютерной техники: регистрации закупок, списаний и контроля текущих остатков на складе. Документ адресован конечным пользователям системы – сотрудникам отдела снабжения, кладовщикам и системным администраторам.

Введение

Область применения

Программа предназначена для использования на предприятиях и в организациях, где ведётся учёт компьютерного оборудования. Система позволяет:

• вести учёт оборудования по типам (моделям) с партионным методом;
• регистрировать поступление (закупки) и выбытие (списания) оборудования;
• получать актуальную информацию об остатках на складе.

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

Основные возможности

• Отображение текущих остатков оборудования с автоматическим расчётом количества на складе.
• Ведение журнала закупок с указанием поставщика, склада, количества, цены и даты.
• Ведение журнала списаний с указанием ответственного сотрудника, причины и даты.
• Добавление, редактирование и удаление записей о закупках и списаниях.
• Поиск по названию оборудования, производителю, поставщику или фамилии сотрудника.
• Экспорт любой таблицы в CSV-файл для формирования отчётов.
• Логирование всех изменений для аудита.

Подготовка к работе

Порядок установки

Для работы с программой не требуется сложной установки. Достаточно выполнить следующие шаги:

1. Скачайте исполняемый файл programm.exe из репозитория или из папки dist архива с программой.
2. Сохраните файл в любую папку на вашем компьютере (например, на рабочий стол или в папку «Программы»).
3. Убедитесь, что ваш компьютер имеет доступ к интернету – программа подключается к удалённому серверу базы данных.
4. Запустите файл двойным щелчком левой кнопки мыши.

Примечание: Если антивирус блокирует запуск, добавьте файл в исключения – программа безопасна и не содержит вредоносного кода.

Для администратора: Если база данных ещё не создана или требуется развернуть систему на новом сервере, выполните следующие шаги. Вся структура БД описана в файле init_db.sql, который поставляется вместе с программой.

Порядок проверки работоспособности

Для проверки правильности установки и настройки выполните следующие тесты:

1. Тест 1. Запуск программы.
   Запустите programm.exe. Должно открыться главное окно с тремя вкладками. Если окно не появилось – проверьте, что у вас установлен .NET Framework или обратитесь к системному администратору.

2. Тест 2. Загрузка данных.
   На вкладке «Остатки оборудования» должна отобразиться таблица с перечнем оборудования. Если таблица пуста – проверьте подключение к интернету.

3. Тест 3. Добавление записи.
   Перейдите на вкладку «Закупки», нажмите кнопку «Добавить закупку», заполните любые поля и сохраните. Если запись появилась в таблице – программа работает корректно.

4. Тест 4. Обновление остатков.
   После добавления закупки перейдите на вкладку «Остатки оборудования» и нажмите «Обновить». Количество выбранного оборудования должно увеличиться.

5. Тест 5. Экспорт.
   На любой вкладке нажмите «Экспорт CSV». В папке с программой должен появиться файл с именем, содержащим дату и время.

Если все тесты пройдены успешно, программа готова к использованию.

Описание операций

Главное окно программы

Главное окно содержит три вкладки, между которыми можно переключаться. В верхней части окна находится панель поиска, в нижней – таблица с данными, а также кнопки управления.

Вкладка	Назначение
Остатки оборудования	Показывает список типов оборудования с текущим количеством на складе. Обновляется автоматически после изменения закупок или списаний.
Закупки	Предназначена для учёта поступлений. Содержит журнал всех закупок с детальной информацией.
Списания	Предназначена для учёта выбытия. Содержит журнал списаний с указанием причин.

Поиск информации

Для поиска данных:

1. Введите ключевое слово в поле поиска на нужной вкладке.
2. Нажмите кнопку «Найти».
3. Таблица отфильтруется, отображая только те записи, в которых название оборудования, производитель, поставщик или фамилия сотрудника начинаются с введённого текста.
4. Чтобы снять фильтр, нажмите кнопку «Сброс».

Примечание: Поиск выполняется по началу строки. Например, чтобы найти ноутбуки Lenovo, введите «Lenovo».

Добавление записи

Добавление закупки

1. Перейдите на вкладку «Закупки».
2. Нажмите кнопку «Добавить закупку».
3. В открывшейся форме заполните все поля:
   • Оборудование – выберите из выпадающего списка.
   • Поставщик – выберите из списка.
   • Склад – выберите склад, на который поступило оборудование.
   • Количество – укажите целое число больше нуля.
   • Цена за единицу – укажите цену в рублях (можно с копейками).
   • Дата закупки – введите в формате ГГГГ-ММ-ДД.
   • Примечание – необязательное поле для комментариев.
4. Нажмите «Сохранить».

Добавление списания

1. Перейдите на вкладку «Списания».
2. Нажмите кнопку «Добавить списание».
3. В открывшейся форме заполните:
   • Оборудование – выберите из списка.
   • Сотрудник – ответственный за списание.
   • Количество – укажите количество списываемых единиц.
   • Причина списания – укажите причину (например, «Поломка», «Утилизация»).
   • Дата списания – в формате ГГГГ-ММ-ДД.
4. Нажмите «Сохранить».

Редактирование записи

1. Выберите строку в таблице, щёлкнув по ней мышью (строка подсветится).
2. Нажмите кнопку «Редактировать».
3. В появившемся окне измените нужные поля.
4. Нажмите «Сохранить» для применения изменений.

Важно: Редактирование доступно только для записей в журналах закупок и списаний. На вкладке «Остатки» редактирование невозможно – остатки вычисляются автоматически.

Удаление записи

1. Выберите строку в таблице.
2. Нажмите кнопку «Удалить».
3. Подтвердите удаление в диалоговом окне.

Внимание: Удаление записи о закупке или списании повлияет на расчёт остатков. Убедитесь в правильности действия перед подтверждением.

Экспорт данных в CSV

1. Перейдите на нужную вкладку (Остатки, Закупки или Списания).
2. Нажмите кнопку «Экспорт CSV».
3. Файл будет сохранён в папке с программой с именем stock_ГГГГММДД_ЧЧММСС.csv (или purchases_..., writeoffs_...).
4. Файл можно открыть в Microsoft Excel, LibreOffice Calc или любом текстовом редакторе.

Обновление данных

Нажмите кнопку «Обновить» на любой вкладке, чтобы загрузить актуальные данные из базы. Обычно обновление происходит автоматически после операций добавления/редактирования/удаления, но в некоторых случаях (например, если другой пользователь изменил данные) может потребоваться ручное обновление.

Аварийные ситуации

Не удаётся подключиться к базе данных

Признак: При запуске или обновлении появляется сообщение об ошибке подключения.

Действия:

1. Проверьте подключение к интернету.
2. Подождите несколько минут и попробуйте снова – возможно, сервер временно недоступен.
3. Если проблема повторяется, обратитесь к системному администратору – возможно, изменились параметры подключения.

Программа зависла или не реагирует

Признак: Интерфейс не отвечает на нажатия кнопок или долго загружается.

Действия:

1. Закройте программу (используйте диспетчер задач, если необходимо).
2. Запустите заново.
3. Если проблема повторяется, попробуйте перезагрузить компьютер.
4. Если ситуация не изменяется, свяжитесь с разработчиком (указаны в разделе «Автор»).

Ошибка при добавлении/редактировании записи

Признак: При сохранении формы появляется сообщение «Проверьте введённые данные» или «Ошибка БД».

Действия:

1. Проверьте, что все обязательные поля заполнены.
2. Убедитесь, что дата введена в формате ГГГГ-ММ-ДД.
3. Проверьте, что количество – целое число, а цена – число (с точкой или запятой в качестве разделителя).
4. Если вы используете запятую в цене, замените её на точку (например, 12500.50 вместо 12500,50).
5. Повторите попытку.

Антивирус блокирует запуск

Признак: При запуске programm.exe антивирус сообщает о подозрительной активности и блокирует файл.

Действия:

1. Добавьте файл или папку с программой в исключения антивируса.
2. Либо временно отключите антивирус на время работы (не рекомендуется на постоянной основе).
3. Программа безопасна и не содержит вирусов – это ложное срабатывание из-за того, что исполняемый файл был собран с помощью PyInstaller.

Потеря данных

Признак: При открытии программы таблицы пусты или данные отсутствуют.

Действия:

1. Убедитесь, что вы подключены к правильной базе данных (проверьте настройки у администратора).
2. Нажмите кнопку «Обновить» – возможно, данные просто не загрузились.
3. Если данные действительно потеряны, обратитесь к администратору базы данных для восстановления из резервной копии.

Термины и сокращения

Термин	Описание
БД	База данных, хранилище всей информации о оборудовании, закупках и списаниях. Используется PostgreSQL.
Оборудование	Тип (модель) компьютерной техники, которая учитывается в системе (например, «Ноутбук Lenovo T14»).
Закупка	Операция поступления партии оборудования от поставщика на склад.
Списание	Операция выбытия партии оборудования (утилизация, продажа, передача другому подразделению).
Остаток	Текущее количество оборудования на складе, вычисляемое как сумма закупок минус сумма списаний.
CSV	Формат файла для экспорта данных (Comma-Separated Values). Открывается в Excel и других табличных редакторах.
GUI	Графический интерфейс пользователя (Graphical User Interface).
PostgreSQL	Система управления базами данных, используемая для хранения данных.
СУБД	Система управления базами данных – программное обеспечение для управления БД.

---

Автор документации: [Железков Фёдор]
Дата: 2026 г.