Роли и пункты меню
| Роль | Разделы меню | Основные задачи |
|---|---|---|
| ADMIN | Главная, Путевые листы, Справка, Водители, Автомобили, Шаблоны, Контроль, Выгрузки, Настройки | Всё: справочники, контроль, шаблоны, роли, удаление листов |
| MODERATOR | Главная, Путевые листы, Справка, Выгрузки, Настройки | Массовые Excel-выгрузки без правки справочников |
| DRIVER | Главная (с контролем), Путевые листы, Справка, Настройки | Свои листы, отметка «на базе» |
| USER | Главная, Путевые листы, Справка, Настройки | Операционная работа с листами без админ-разделов |
Вставьте скриншот
Рекомендуемый файл: public/docs/admin-navbar.png
Назначение ролей — Настройки → таблица пользователей. Учётка по умолчанию при установке: логин admin (см. QUICK_START.md, смените пароль в production).
Водители
/workers — справочник работников (только ADMIN). Данные ФИО и документов хранятся с версионированием: каждое изменение создаёт новую версию, старая закрывается по дате.
Вставьте скриншот
Рекомендуемый файл: public/docs/admin-workers-list.png
Создание
«+ Добавить водителя»:
- Email — уникальный, связывает worker и user;
- ФИО, СНИЛС, номер ВУ;
- Логин и пароль (необязательно) — создаёт учётную запись для входа;
- при создании — версия данных №1, статус «Активен».
Вставьте скриншот
Рекомендуемый файл: public/docs/admin-workers-create.png
Редактирование и статус
- «Редактировать» — новая версия ФИО/документов (email при редактировании не меняется в типовой форме);
- «Деактивировать» — водитель не исчезает, но не должен назначаться на новые листы;
- «Активировать» — возврат в работу.
Дубликат email или логина при создании вернёт ошибку. Для ежедневного контроля водителю нужна роль DRIVER в настройках пользователя.
Автомобили
/cars — парк техники (ADMIN): госномер (уникальный при создании), марка, модель, год, регистрационный номер, объём топливного бака.
Вставьте скриншот
Рекомендуемый файл: public/docs/admin-cars-list.png
Из строки списка — переход к нормам топлива этой машины. Версионирование данных машины аналогично водителям.
Нормы расхода топлива
Страница /cars/[id]/fuel — помесячные нормы л/100 км для расчёта топлива на странице сегментов дня.
- типы топлива: АИ-92, АИ-95, АИ-98, ДТ;
- для каждого месяца: норма в городе и за городом;
- кнопка сохранения заполняет все 12 месяцев выбранного типа;
- Копировать с другого авто — перенос норм с аналогичной машины.
Вставьте скриншот
Рекомендуемый файл: public/docs/admin-car-fuel-norms.png
Без норм за месяц поездки расчёт на странице дня будет неточным. Глобальная страница /fuels (если доступна) — устаревший/общий справочник; основной путь — нормы per car.
Контроль водителей
/admin/compliance — ежедневный мониторинг: кто не отметился «на базе» и не заполнил путевой лист. Учитываются только активные водители с ролью DRIVER(или без учётки — по умолчанию как водитель).
Вставьте скриншот
Рекомендуемый файл: public/docs/admin-compliance-dashboard.png
Показатели на дату
- Активных водителей — в выборке контроля;
- Нарушений — требуют действия;
- В порядке — выполнили условия;
- Исключений — отпуск/болезнь.
Статусы водителя за день
| Статус | Описание |
|---|---|
| Не отметился / не заполнил | Нет ни «на базе», ни заполненного дня |
| Лист не завершён | Есть начатый лист/день, данные неполные |
| На базе | Водитель нажал «Сегодня на базе» на главной |
| Лист заполнен | День за дату полный (сегменты + данные) |
| Исключение | Задан период отпуска/болезни |
| OK | Выходной без открытого путевого листа, либо нет требований |
В таблице нарушений — ссылка на путевой лист водителя, если он есть.
Исключения (отпуск, болезнь)
Блок «Исключения» на той же странице:
- водитель, даты «с» — «по», причина: отпуск / болезнь / другое, комментарий;
- на эти даты контроль не требует отметки и листа;
- удаление исключения — кнопка «Удалить» в списке.
Вставьте скриншот
Рекомендуемый файл: public/docs/admin-compliance-excuse.png
Действия водителя на главной описаны в руководстве пользователя.
Шаблоны Excel
/admin/templates — загрузка и управление .xlsx/.xls шаблонами выгрузки.
Вставьте скриншот
Рекомендуемый файл: public/docs/admin-templates-list.png
- тип шаблона (путевой лист и др.);
- название, версия, описание;
- По умолчанию — подставляется при выгрузке, если другой не выбран;
- скачивание, активация/деактивация, удаление;
- фильтр по типу вверху страницы.
Вставьте скриншот
Рекомендуемый файл: public/docs/admin-templates-upload.png
Массовые выгрузки
/admin/exports — для ADMIN и MODERATOR. Отличие от экспорта на карточке одного листа: выбор типа, параметров и шаблона.
Вставьте скриншот
Рекомендуемый файл: public/docs/admin-exports-page.png
Типы выгрузок
| Тип | Когда использовать | Обязательные параметры |
|---|---|---|
| Один путевой лист | Печатная форма одного ID | ID путевого листа |
| Упрощённый путевой лист | Краткая форма | ID путевого листа |
| Сводка | Отчёт за период | Дата начала и окончания |
| Полный архив | Все листы за период | Дата начала и окончания |
| Переходящий месяц | Листы через границу месяцев | Период |
| По водителю | Все листы водителя | ID водителя |
| По автомобилю | Все листы машины | ID автомобиля |
| По статусу | Например, только завершённые | Статус |
| Настраиваемый | Гибкий фильтр | По необходимости |
Порядок работы
- Выбрать тип выгрузки.
- Заполнить параметры (даты, водитель, машина, ID листа, имя файла).
- Выбрать шаблон (или оставить по умолчанию).
- При необходимости — «Показать подходящие листы» для проверки выборки.
- Создать выгрузку и скачать файл (при S3 — также хранение на сервере).
Дополнительно в форме могут быть: детализация, упаковка в архив, имя файла.
Вставьте скриншот
Рекомендуемый файл: public/docs/admin-exports-matching.png
Сравнение: кнопка на карточке листа — только этот лист, шаблон по умолчанию, доступна любой роли с правом на лист.
Пользователи и роли
/settings → «Управление пользователями» (только ADMIN):
- таблица: ID, имя, email/логин, текущая роль;
- выпадающий список роли для каждого пользователя (кроме себя);
- подтверждение перед сменой роли.
Вставьте скриншот
Рекомендуемый файл: public/docs/admin-users-roles.png
Какую роль выбрать
| Роль | Кому |
|---|---|
| DRIVER | Шофёр, который сам отмечает «на базе» и ведёт листы |
| USER | Офис: создаёт/правит листы за других, без админ-меню |
| MODERATOR | Только отчёты и Excel-выгрузки |
| ADMIN | Полное управление системой |
Путевые листы — действия администратора
Только ADMIN на карточке листа:
- Удалить путевой лист — только в статусе «Черновик», вместе с днями и сегментами;
- Вернуть в черновик — из «Завершён» или «Архив» для полного редактирования.
Остальные операции (дни, сегменты, валидация, завершение) — как в руководстве пользователя.
Вставьте скриншот
Рекомендуемый файл: public/docs/admin-waybill-delete.png
Все административные сценарии
Сценарий 1: Подготовить нового водителя с входом в систему
- /workers → «+ Добавить водителя».
- Email, ФИО, СНИЛС, ВУ.
- Логин + пароль для мобильного входа.
- /settings → найти пользователя по email → роль DRIVER.
- Передать водителю учётные данные и ссылку на /docs/user.
Вставьте скриншот
Рекомендуемый файл: public/docs/scenario-admin-01-driver.png
Сценарий 2: Ввести машину и нормы на год
- /cars → создать авто.
- /cars/[id]/fuel → тип топлива.
- Заполнить 12 месяцев или «Копировать» с эталонной машины.
- Тестовый путевой лист + сегменты — проверить расчёт топлива.
Сценарий 3: Новый шаблон и сводка за месяц
- /admin/templates → загрузить .xlsx, «по умолчанию».
- /admin/exports → тип «Сводка».
- Даты месяца, шаблон, просмотр списка листов.
- Создать и скачать.
Сценарий 4: Архив листов одного водителя за квартал
- ID водителя из /workers.
- /admin/exports → «По водителю».
- Период квартала, шаблон, при необходимости «архив».
- Скачать.
Сценарий 5: Модератор только для выгрузок
- /settings → роль MODERATOR.
- Проверить меню: есть Выгрузки, нет Водители/Шаблоны/Контроль.
Сценарий 6: Исправить завершённый лист
- Карточка листа → «Вернуть в черновик».
- «Вернуть в работу» при необходимости.
- Правки дней → валидация → завершение.
- Новая выгрузка в /admin/exports при необходимости.
Сценарий 7: Оформить отпуск водителя
- /admin/compliance → «Добавить» исключение.
- Водитель, даты отпуска, причина «Отпуск».
- На период отпуска водитель не в списке нарушений.
- После отпуска — удалить или дождаться окончания периода.
Сценарий 8: Утренний контроль нарушений
- /admin/compliance → дата «сегодня».
- Просмотреть блок «Требуют внимания».
- По ссылке открыть лист или связаться с водителем.
- При болезни — добавить исключение.
Вставьте скриншот
Рекомендуемый файл: public/docs/scenario-admin-08-violations.png
Сценарий 9: Офисный сотрудник без контроля «на базе»
- Создать пользователя с ролью USER (не DRIVER).
- Он работает с листами, но не попадает в /admin/compliance.
Сценарий 10: Скопировать нормы топлива на новый парк
- Эталонная машина с заполненными нормами.
- Новая машина → /cars/[id]/fuel → «Копировать с…».
- Скорректировать отличия по месяцам вручную.
Сценарий 11: Деактивировать уволенного водителя
- /workers → «Деактивировать».
- Не назначать на новые листы.
- При необходимости сменить роль в /settings или заблокировать вход.
Сценарий 12: Выгрузка только завершённых листов
- /admin/exports → «По статусу».
- Статус COMPLETED, период, шаблон сводки.
- Проверить список → скачать.
Сценарий 13: Переходящие через месяц листы
- /admin/exports → «Переходящий месяц».
- Указать период, охватывающий границу месяцев.
- Использовать для отчётности, когда дата начала и конца в разных месяцах.
Сценарий 14: Замена шаблона без смены логики выгрузки
- Загрузить новый .xlsx в /admin/templates.
- Старый шаблон — деактивировать.
- Новый — «по умолчанию».
- Повторить типовую выгрузку и сверить файл.
Сценарий 15: Удалить ошибочный черновик
- Открыть лист в DRAFT.
- Кнопка «Удалить путевой лист» (ADMIN).
- Подтвердить — лист и все дни удаляются.
Работа с путевыми листами (для всех ролей)
Создание, дни, сегменты, топливо, валидация, экспорт одного листа, мобильный интерфейс — в руководстве пользователя (13+ сценариев с местами для скриншотов).