tech-service-portal/app/assistant_kb.txt

# Портал технической службы — справка для помощника

Ссылки на разделы пишутся в виде [Название](#/путь). Навигация — боковое меню слева (на телефоне — кнопка ☰).

## Разделы (путь — кто видит — что там)
- Задачи (общая вкладка) — #/work — все, открывается первой. Вверху шапка: быстрые действия (новая задача, новый наряд, зафиксировать аварию, сообщить о неисправности, заявка на инструмент, мой инструмент) и сводка (мои наряды, просрочено, ждут проверки, мои задачи, открытые аварии и неисправности). Ниже четыре блока. Наряды (мне / на проверку / все доступные, просроченные, статус, поиск), задачи и поручения (мои / поставил я / все, сегодня или все дни, активные или с завершёнными), отказы и сообщения о неисправности — два одинаковых блока (открытые / все, зафиксированные мной, источник, оборудование или краны, поиск; вид «Список» или «На карте» — машины на карте завода и карте кранов).
- Наряды — #/ — все: список нарядов, фильтры «Мои», «Просроченные», «Ждут моей проверки», поиск.
- Наряд — #/order/<номер> — участники наряда: заполнение чек-листа, фото, комментарии, «Взять в работу», «Сдать наряд»; проверяющий — «Принять» / «Вернуть на доработку» (комментарий обязателен).
- Новый наряд — #/new-order — инженер, модератор, админ.
- Расписание нарядов — #/templates — инженер+: автосоздание нарядов (ежедневно, по дням недели, раз в месяц, каждые N дней), «Создать сейчас».
- Чек-листы — #/checklists — инженер+: задачи с типом ответа (статус, список, число с нормой, текст), фото (нет / по желанию / обязательно). Тип «Регламентное обслуживание» — в наряд подставляются узлы машины.
- Задачи и поручения (бывшие «суточные задания») — #/tasks — все: простые поручения на день; общая вкладка «Задачи» #/work собирает наряды, задачи и отказы на одном экране. Статусы: назначен, в работе, приостановлен, выполнен, отменён. Для «приостановлен», «выполнен», «отменён» комментарий обязателен. Фото, привязка к машине или узлу, необязательная трудоёмкость (норма, ч) — идёт в отчёт «По сотрудникам». Ставить задания другим — инженер, модератор, админ; техник — только себе. «+ Задание» — #/new-task.
- Передать задание — в карточке задания #/task/<номер>, блок «Передать задание»: исполнитель, кто поставил, или инженер; причина обязательна.
- Оборудование — #/equipment — все смотрят, правят инженер+. Карточка машины #/equipment/<id>: состояние (Авария / Требуется ТО / Скоро ТО / В норме), иконка, наработка (моточасы), обслуживаемые узлы и их сброс, отказы, история машины с фильтрами. Оборудование можно закрепить за отделом (Оборудование → «Изменить» → «Закреплено за отделом»): его видят только сотрудники этого отдела и вложенных, инженеры вышестоящих отделов, модераторы и админы; оборудование без отдела видят все. Если машину не видно — она закреплена за другим отделом или это кран.
- Отказ (авария) — в карточке машины кнопка «Зафиксировать отказ»: что произошло, затронутые узлы, была ли замена (замена сбрасывает ресурс узла). Открытый отказ = состояние «Авария». Закрывает автор или инженер. Все отказы — #/incidents.
- Закрытие отказа — в карточке машины «✔ Закрыть отказ» (автор или инженер): обязательно «что сделано» (ремонт, замена узла, регулировка, перезапуск) и «характер» (внезапный или постепенный); время начала работ, ввода в эксплуатацию, наработка и причина подставлены — их можно поправить; заменённые узлы отмечаются там же (ресурс сбросится). Инженер уточняет закрытый отказ кнопкой «✎ Данные отказа». В приложении для Android отказ пока называется «Инцидент».
- Анализ надёжности — #/reliability — инженеры и руководители (включает администратор в настройках сервера): наработка на отказ θ и её граница при доверии 90 %, интенсивность отказов, время восстановления, коэффициент готовности, простой, прогноз отказа на период, причины и узлы-причины, признаки заранее; вкладка «Дрейф параметров» #/reliability/drift — числовые пункты чек-листов, которые приближаются к границе нормы; выгрузки CSV по отказам и по обслуживанию узлов.
- Сообщение о неисправности — в карточке машины кнопка «⚠ Сообщить о неисправности»: неисправность замечена, но оборудование работает (шум, вибрация, подтекание). Машина получает состояние «Неисправность» (оранжевый значок ⚠ на карте и в карточке), инженеры получают уведомление. Замены узлов здесь нет. «Неисправность устранена» — закрыть; «Перевести в отказ» — если оборудование остановилось (машина станет «Авария»). Все сообщения — #/faults (по кранам — #/faults/cranes). Публичная форма /report тоже спрашивает: работает с неисправностью или остановлено.
- Карты масштабируются: кнопки «+ − ⤢», Ctrl + колесо, двойной щелчок, щипок двумя пальцами на телефоне.
- Карта завода — #/map — все: «!» — авария, оранжевый «⚠» — неисправность (работает), жёлтое свечение — пора/скоро ТО. Картинку и расстановку меняет администратор («Редактировать карту»).
- Краны — #/cranes — появляется, если администратор включил «Краны — отдельная служба» в настройках сервера #/server: список кранов (оборудование с отметкой «Кран»), карта кранов #/map/cranes (своя картинка или план завода), отказы по кранам #/incidents/cranes. Краны при этом убираются из «Оборудования» и с карты завода. Отметку «Кран» ставит инженер в карточке оборудования.
- Карта складов — #/map/warehouses — зоны складов, нажатие показывает содержимое (содержимое видят склад, инженеры, модераторы).
- Мой инструмент — #/my-tools — все: что выдано лично мне.
- Заявки на инструмент — #/requests — все: «что купить», «зачем» (обязательно), ссылка на товар, количество; ответ и статус приходят автору. Рассматривают администратор склада, модератор, админ.
- Склады и учёт — #/inventory — администратор склада (правка), инженер/модератор (просмотр): склады, каталог, выдано сотрудникам, журнал; операции: выдача, возврат, поступление, перемещение, списание.
- Сотрудники — #/people — все: поиск, фильтр по отделу; карточка #/user/<id>: ФИО, фото, должность, отдел, график, «что умею», задания, инструмент (инструмент коллеги видят только склад и инженеры). Своё фото, телефон и навыки — в своей карточке (нажать своё имя вверху меню).
- Отчёты — #/reports — инженер+: «Выполненные наряды», «Текущее состояние» узлов, «Выполнение работ» (% по машинам, отклонения), «По сотрудникам» #/reports/people (сколько и как качественно выполнено за период: в срок, просрочки, возвраты с проверки, отклонения, трудоёмкость; списком и календарём по дням); PDF и CSV.
- Администрирование — #/admin — модератор, админ: пользователи #/users, должности #/positions, графики #/schedules (конструктор), отделы #/departments, места #/locations.
- Документация машины (если подключён Nextcloud): блок «📁 Документация» в карточке машины, кнопка «Открыть» — #/docs/<id машины>. PDF, картинки и текст открываются в портале, Word/Excel/PowerPoint — после перевода в PDF (ONLYOFFICE), любой файл можно скачать. Привязывают папку администратор или модератор: «Привязать папку» в том же блоке, выбор в проводнике. Видно документацию только тех машин, которые видит сотрудник.
- Только администратор портала: настройки сервера #/server (фото, публичная форма, «Краны — отдельная служба», ключи API, документация из Nextcloud, AI-помощник и его опция «Работа с документацией») и обратная связь #/feedback. Только администратор: резервные копии #/backups, мастер первичной настройки #/setup, демонстрационный режим #/demo.
- Демонстрационный режим — личный: включается только у того, кто нажал «Войти в демо», остальные работают с рабочими данными. Пока он включён, вверху жёлтая полоса «ДЕМО-РЕЖИМ (только у вас)» с кнопкой «Выйти из демо». Администратор на странице #/demo может включить или выключить демо любому сотруднику.
- Обратная связь по порталу — ссылка «Предложить улучшение портала или сообщить об ошибке» внизу каждой страницы (в мобильной версии и приложении — внизу бокового меню): идея, ошибка или другое. Ответы видят только администраторы портала — #/feedback.
- Администратор портала — право администратора на настройки сервера и обратную связь. У admin оно есть всегда; другим администраторам его включает admin в карточке пользователя («Администратор портала»).
- Публичная форма «Сообщить о неисправности» — /report — без входа (для подрядчиков и т. п.).
- Мобильная версия — /m — наряды работают без связи. Внизу бокового меню и на странице входа: инструкция /guide.pdf, приложение для Android /app.apk, презентация /presentation.pdf, форма для заявки /report.

## Роли
- Техник: свои наряды и задания, отказы, заявки, свой инструмент.
- Инженер (тип должности): + создание нарядов и чек-листов, расписание, оборудование и узлы, проверка нарядов, отчёты, задания другим.
- Администратор склада: каталог, склады, выдача/возврат, зоны складов, заявки.
- Модератор: пользователи, должности, графики, отделы; наряды сам не выполняет.
- Администратор: всё, включая настройки сервера, копии, демо-режим.

## Частые вопросы
- Не вижу наряд: наряд на должность виден только сотрудникам этой должности, которые сейчас на смене по своему графику; проверьте график в своей карточке.
- График работы задаётся сотруднику (#/users → «Изменить» → «График работы»), не должности. Одну должность могут занимать сменщики: наряды и уведомления должности получает только тот, кто на смене. Без графика — всегда на смене.
- Фото к пункту чек-листа или к заданию можно отметить «хранить более года» (в конструкторе чек-листа рядом с режимом фото, в форме задания) — такие фото не удаляются автоочисткой. Автоочистку (удалять фото старше N дней) включает администратор портала в #/server.
- Мониторинг сервера — #/monitor (администратор портала): загрузка процессора, память, место на дисках.
- Фильтр «Место» над списком оборудования #/equipment и кранов: показывает машины места и вложенных мест.
- Мастер первичной настройки: «Завершить и проверить» открывает проверку готовности #/setup/done — что мешает работе и где поправить.
- Не могу сдать наряд: не заполнены обязательные пункты или нет обязательного фото.
- Нет связи: в мобильной версии и приложении ответы сохраняются на телефоне и уйдут сами.
- Не вижу машину или кран: оборудование закреплено за другим отделом, или краны вынесены в раздел «Краны».
- Жёлтая полоса «ДЕМО-РЕЖИМ», моих данных нет: нажать «Выйти из демо»; если не получается — попросить администратора выключить демо.
- Забыли пароль: обратиться к администратору или модератору (раздел «Пользователи»).