# Руководство оператора программы «Автошкола»

# Аннотация

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

Операции с сервером PostgreSQL, резервным копированием и изменением структуры базы данных в обязанности обычного оператора не входят.

# Введение

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

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

Администратор ведёт справочники и контролирует данные. Обычный пользователь просматривает собственную информацию через личный кабинет.

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

Программа позволяет:

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

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

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

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

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

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

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

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

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

## 1. Авторизация

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

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

## 2. Выбор раздела

После входа откройте требуемый раздел. Администратору могут быть доступны:

- автошколы;
- инструкторы;
- водители;
- маршруты экзамена;
- инспекторы;
- экзамены;
- водительские удостоверения;
- пользователи приложения;
- журнал операций.

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

## 3. Просмотр таблицы

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

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

## 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. Экспорт в CSV

1. Откройте таблицу, данные которой требуется сохранить.
2. При необходимости выполните поиск или фильтрацию.
3. Нажмите кнопку экспорта.
4. Выберите доступную папку и имя файла.
5. Сохраните файл.
6. Откройте его в программе для работы с таблицами и проверьте содержимое.

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

## 10. Просмотр журнала операций

Журнал доступен администратору и используется для контроля действий в системе.

1. Откройте раздел журнала.
2. Найдите запись по времени, пользователю или виду действия, если такие фильтры предусмотрены.
3. Сопоставьте запись с выполненной операцией.

Журнал не предназначен для ручного исправления рабочих данных.

## 11. Личный кабинет пользователя

Обычный пользователь может:

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

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

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

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

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

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

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

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

| Термин | Определение |
|---|---|
| Оператор | Пользователь информационной системы |
| Администратор | Оператор с расширенными правами |
| Личный кабинет | Раздел с данными текущего пользователя |
| БД | База данных |
| PostgreSQL | СУБД, обеспечивающая хранение данных программы |
| Справочник | Таблица с относительно постоянными данными |
| Водитель | Обучающийся, сведения о котором зарегистрированы в системе |
| Инструктор | Сотрудник автошколы, осуществляющий обучение |
| Инспектор | Участник процесса проведения экзамена |
| Экзаменационный маршрут | Маршрут, используемый для проверки навыков вождения |
| Результат экзамена | Итог прохождения экзамена водителем |
| Водительское удостоверение | Документ о праве управления транспортным средством |
| CSV | Формат текстового файла с табличными данными |
| Экспорт | Сохранение данных программы во внешний файл |
| Журнал операций | История действий пользователей в системе |