Портал технической службы: наряды и чек-листы, задачи, отказы и неисправности, анализ надёжности, карты, склады, приложение для Android

app/assistant_kb.txt

@@ -0,0 +1,49 @@
+# Портал технической службы — справка для помощника
+
+Ссылки на разделы пишутся в виде [Название](#/путь). Навигация — боковое меню слева (на телефоне — кнопка ☰).
+
+## Разделы (путь — кто видит — что там)
+- Задачи (общая вкладка) — #/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.
+- Только администратор портала: настройки сервера #/server (фото, публичная форма, «Краны — отдельная служба», ключи API, AI-помощник) и обратная связь #/feedback. Только администратор: резервные копии #/backups, мастер первичной настройки #/setup, демонстрационный режим #/demo.
+- Демонстрационный режим — личный: включается только у того, кто нажал «Войти в демо», остальные работают с рабочими данными. Пока он включён, вверху жёлтая полоса «ДЕМО-РЕЖИМ (только у вас)» с кнопкой «Выйти из демо». Администратор на странице #/demo может включить или выключить демо любому сотруднику.
+- Обратная связь по порталу — ссылка «Предложить улучшение портала или сообщить об ошибке» внизу каждой страницы (в мобильной версии и приложении — внизу бокового меню): идея, ошибка или другое. Ответы видят только администраторы портала — #/feedback.
+- Администратор портала — право администратора на настройки сервера и обратную связь. У admin оно есть всегда; другим администраторам его включает admin в карточке пользователя («Администратор портала»).
+- Публичная форма «Сообщить о неисправности» — /report — без входа (для подрядчиков и т. п.).
+- Мобильная версия — /m — наряды работают без связи. Внизу бокового меню и на странице входа: инструкция /guide.pdf, приложение для Android /app.apk, презентация /presentation.pdf, форма для заявки /report.
+
+## Роли
+- Техник: свои наряды и задания, отказы, заявки, свой инструмент.
+- Инженер (тип должности): + создание нарядов и чек-листов, расписание, оборудование и узлы, проверка нарядов, отчёты, задания другим.
+- Администратор склада: каталог, склады, выдача/возврат, зоны складов, заявки.
+- Модератор: пользователи, должности, графики, отделы; наряды сам не выполняет.
+- Администратор: всё, включая настройки сервера, копии, демо-режим.
+
+## Частые вопросы
+- Не вижу наряд: наряд на должность виден только сотрудникам этой должности на смене; проверьте график.
+- Не могу сдать наряд: не заполнены обязательные пункты или нет обязательного фото.
+- Нет связи: в мобильной версии и приложении ответы сохраняются на телефоне и уйдут сами.
+- Не вижу машину или кран: оборудование закреплено за другим отделом, или краны вынесены в раздел «Краны».
+- Жёлтая полоса «ДЕМО-РЕЖИМ», моих данных нет: нажать «Выйти из демо»; если не получается — попросить администратора выключить демо.
+- Забыли пароль: обратиться к администратору или модератору (раздел «Пользователи»).