# Руководство оператора программы «Продажа компьютерной техники»

# Аннотация

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

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

# Введение

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

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

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

Оператору доступны следующие функции в зависимости от его роли:

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

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

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

1. Закройте работающие экземпляры программы.
2. Запустите файл `ComputerSalesSetup.exe`.
3. Разрешите запуск установщика, если Windows выведет системное предупреждение.
4. Выберите папку установки. При отсутствии специальных требований оставьте путь по умолчанию.
5. Выберите создание ярлыка на рабочем столе и в меню «Пуск».
6. Нажмите кнопку начала установки и дождитесь завершения копирования файлов.
7. Завершите работу мастера установки.
8. Запустите приложение через созданный ярлык.

Если приложение требует отдельно установленную среду выполнения, предварительно установите .NET 8 Desktop Runtime. Параметры подключения к PostgreSQL должны быть подготовлены ответственным специалистом.

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

После установки выполните контрольную проверку:

1. Запустите программу.
2. Убедитесь, что открылась форма авторизации.
3. Введите действующие учётные данные.
4. Проверьте, что главное окно открылось без сообщения об ошибке подключения.
5. Откройте любой доступный раздел и убедитесь, что таблица заполнилась данными.
6. Выполните поиск по известному значению и очистите фильтр.
7. Для администратора создайте тестовую запись в разрешённом разделе, измените её и удалите.
8. Откройте журнал аудита и проверьте фиксацию выполненных изменений.
9. Сформируйте тестовый отчёт по покупателю и дате.
10. Для покупателя проверьте открытие личных данных, списка товаров и собственных заказов.

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

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

## 1. Вход в систему

1. Запустите приложение.
2. Введите логин в поле учётной записи.
3. Введите пароль.
4. Нажмите кнопку входа.
5. Дождитесь загрузки главного окна.

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

## 2. Просмотр данных

После входа откройте нужный раздел через главное окно. Записи отображаются в таблице. Для просмотра скрытых столбцов используйте горизонтальную прокрутку, а для просмотра большого списка — вертикальную.

Права пользователя определяют, какие разделы можно открыть и какие действия разрешены.

## 3. Поиск и фильтрация

1. Откройте раздел, в котором требуется найти запись.
2. Введите значение в поле поиска или выберите доступный фильтр.
3. Проверьте полученный список.
4. Для возврата ко всем данным очистите поле поиска или сбросьте фильтр.

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

## 4. Добавление записи администратором

1. Откройте требуемый раздел.
2. Нажмите кнопку добавления.
3. Заполните обязательные поля.
4. Для связанных данных выберите существующие значения из доступных списков.
5. Проверьте количество, цену, дату и другие числовые значения.
6. Сохраните запись.
7. Убедитесь, что новая строка появилась в таблице.

Не создавайте несколько одинаковых записей, если значение должно быть уникальным.

## 5. Изменение записи администратором

1. Выберите запись в таблице.
2. Откройте режим изменения.
3. Исправьте необходимые значения.
4. Сохраните изменения.
5. Обновите таблицу и проверьте результат.

Перед изменением заказа или складского остатка убедитесь, что новое значение соответствует фактическим данным.

## 6. Удаление записи администратором

1. Выберите удаляемую запись.
2. Нажмите кнопку удаления.
3. Проверьте, что выбрана нужная строка.
4. Подтвердите действие.
5. Убедитесь, что запись исчезла из таблицы.

Удаление может быть запрещено базой данных, если запись используется в заказах, остатках или других связанных таблицах.

## 7. Работа с товарами и остатками

Администратор открывает раздел товаров для ведения номенклатуры. Сведения о количестве товара на конкретном складе учитываются в разделе остатков.

При изменении остатка необходимо:

1. выбрать нужный склад;
2. выбрать товар;
3. указать фактическое количество;
4. сохранить запись;
5. проверить отображение нового значения.

## 8. Работа с заказами

Администратор может просматривать заказы и связанные с ними позиции. При обработке заказа следует проверить покупателя, дату и состав заказа.

Позиция заказа должна ссылаться на существующий товар и соответствующий заказ. Количество товара указывается положительным числом.

## 9. Формирование отчёта

1. Откройте раздел формирования отчёта.
2. Выберите покупателя.
3. Укажите дату заказа.
4. Запустите формирование.
5. Проверьте полученные данные.
6. Выберите место сохранения, если программа выводит диалог сохранения.
7. Убедитесь, что итоговый файл создан и открывается.

Пустой отчёт обычно означает, что по выбранным параметрам отсутствуют заказы.

## 10. Просмотр журнала аудита

Журнал аудита доступен администратору. В нём отображаются сведения об изменениях, выполненных в системе. Используйте журнал для проверки факта добавления, изменения или удаления записей.

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

## 11. Работа покупателя

После входа под обычной учётной записью пользователь может:

1. открыть личные сведения и проверить их актуальность;
2. просмотреть доступные товары;
3. открыть список своих заказов;
4. выбрать заказ и просмотреть его позиции;
5. использовать доступный поиск.

Данные других покупателей и административные разделы обычному пользователю недоступны.

## 12. Завершение работы

Закройте открытые формы и завершите приложение штатной кнопкой закрытия окна. Не выключайте компьютер во время сохранения записи или формирования отчёта.

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

| Ситуация | Возможная причина | Действия оператора |
|---|---|---|
| Программа не запускается | Повреждены или удалены файлы приложения; отсутствует требуемая среда выполнения | Перезапустите компьютер, проверьте наличие файлов в папке установки, установите требуемый .NET Runtime или переустановите программу |
| Появляется ошибка подключения к БД | Сервер PostgreSQL недоступен; отсутствует сеть; неверны параметры подключения | Проверьте сетевое подключение, повторите запуск и сообщите ответственному специалисту |
| Данные не загружаются | В БД нет записей или запрос завершился ошибкой | Обновите раздел, откройте другую таблицу, затем обратитесь к администратору |
| Не принимается логин или пароль | Ошибка ввода; неверная раскладка; учётная запись отключена | Проверьте раскладку и регистр символов, повторите ввод один раз, затем обратитесь к администратору |
| Запись не сохраняется | Не заполнено обязательное поле; неверный формат даты или числа; нарушена связь между таблицами | Проверьте все поля, выберите существующие связанные записи и повторите сохранение |
| Запись не удаляется | На неё ссылаются другие данные | Не пытайтесь удалять связанные данные произвольно; обратитесь к администратору БД |
| Остаток или сумма отображаются неверно | Введено ошибочное количество, цена или состав заказа | Сверьте исходные данные и исправьте запись с правами администратора |
| Отчёт пустой | Для выбранного покупателя и даты нет заказов | Измените параметры и повторите формирование |
| Файл отчёта не сохраняется | Нет прав на запись или файл уже открыт другой программой | Выберите доступную папку, закройте ранее открытый файл и повторите операцию |
| Программа перестала отвечать | Длительный запрос, потеря соединения или системная ошибка | Подождите завершения текущей операции, затем закройте приложение средствами Windows и сообщите администратору |

При обнаружении повреждения данных прекратите операции изменения и сообщите ответственному специалисту. Не редактируйте базу данных вручную.

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

| Термин | Определение |
|---|---|
| Оператор | Пользователь, выполняющий действия в программе |
| Клиентское приложение | Установленная на рабочем компьютере программа |
| БД | База данных |
| PostgreSQL | Серверная СУБД, в которой хранятся данные |
| Авторизация | Проверка логина и пароля пользователя |
| Роль | Набор разрешённых пользователю операций |
| Администратор | Оператор с правом управления основными данными |
| Покупатель | Пользователь с доступом к собственным сведениям и заказам |
| Номенклатура | Перечень товаров, учитываемых в системе |
| Складской остаток | Учтённое количество товара на определённом складе |
| Заказ | Оформленная покупка товаров |
| Позиция заказа | Строка заказа с конкретным товаром и количеством |
| Аудит | Регистрация действий, изменяющих данные |
| Отчёт | Сформированный программой документ с выбранными данными |