Инструкция — ИГС lksoftGwebsrv

Роли пользователей и ограничения

Права зависят от роли пользователя. Если кнопки/действия недоступны — это обычно связано с ролью.

Роль	Что доступно	Ключевые ограничения
Администратор	Полный доступ к объектам, справочникам, настройкам и администрированию.	Ограничений по функционалу нет (кроме системных правил объектов).
Пользователь	Ежедневная работа: карта, объекты, кабели, отчёты, большинство настроек и персональные дефолты.	Часть “системных” настроек доступна только администратору.
Только чтение	Просмотр карты и объектов, подсказки/легенды, открытие карточек, списки кабелей.	Запрещены создание/редактирование/удаление. Инвентаризация недоступна. Некоторые фильтры отключены. Контракты к выбору ограничиваются собственником пользователя.

Важно: у роли “Только чтение” может быть задан “собственник пользователя”. Тогда в системе отображаются только кабели этого собственника (для всех типов кабелей). Если собственник не назначен — кабели могут не отображаться.

Интерфейс системы

Шапка (верхняя панель): кнопки режимов карты, переключение систем координат, служебные действия.
Боковая панель слева: слои, фильтры, списки объектов, отчёты, справочники, настройки.
Карта (центр): отображение объектов и выполнение операций (выбор, создание, редактирование).
Панель доп. информации (справа): карточка выбранного объекта и связанные действия.

Скрыть интерфейс

В шапке карты доступна кнопка “Скрыть интерфейс” (иконка ). Она скрывает все панели и оставляет только карту.

Esc — вернуть интерфейс.

Карта

Карта — основной рабочий экран для просмотра объектов ИГС и работы с ними.

Навигация: колесо мыши — масштаб, зажатая левая кнопка — перемещение.
Координаты курсора: отображаются в левом нижнем углу в WGS84.
Информация об объекте: клик по объекту открывает карточку справа.
Спутник (WMTS): кнопка “Спутник (WMTS)” в верхней панели включает/выключает спутниковый слой.

Примечание: отображение объектов зависит от выбранных слоёв и фильтров.

Инструменты карты

Добавить направление (): выберите 2 колодца на карте.
Добавить колодец (): кликните на карте и заполните форму.
Набить колодец (): кликните по направлению и следуйте подсказкам.
Добавить столбик (): кликните на карте и заполните форму.
Добавить кабель в канализации (выбор каналов) (): выберите направления/каналы маршрута и создайте кабель.
Создать кабель в канализации по кратчайшему пути ():

Выберите 1-й и 2-й колодец — система предложит маршрут (кратчайший путь).
Если в направлении несколько каналов — потребуется выбрать канал(ы).
Далее можно выбирать 3-й, 4-й… колодцы — кабель будет достраиваться сегмент за сегментом (от предыдущего колодца к новому).
Ограничение: маршрут не может содержать повтор одного и того же направления. Если без повторов пройти нельзя — будет сообщение “Выбранный объект недостижим.”
После успешного создания кабеля режим автоматически выключается и очищает временные данные.

Переложить кабель в канализации (): переназначение маршрута кабеля по выбранным направлениям/каналам.
Добавить кабель в грунте (ломаная) (): кликайте точки на карте, затем нажмите “Создать”.
Добавить воздушный кабель (ломаная) (): кликайте точки на карте, затем нажмите “Создать”.
Переместить точечный объект (): для колодцев/столбиков — выберите объект и укажите новую позицию.
Подсказки: номера колодцев () и Подсказки: длина направления ().
Показать координаты (): выводит широту/долготу рядом с точечными объектами (если включено).
Легенда по собственникам (): отображение по цвету собственника + легенда.
Настройки по умолчанию (): персональные дефолты (в т.ч. контракт по умолчанию для кабелей).
Режим ТУ (): выбор ТУ для автоматической привязки создаваемых объектов.
Режим инвентаризация (): ввод количества кабелей по направлениям выбранного колодца (см. раздел “Инвентаризация”).
Обновить карту (): перезагружает слои карты без изменения текущего масштаба и центра.

Поддерживается отмена режимов и подсветок клавишей Esc.

Слои

В боковой панели можно включать/выключать слои: Колодцы, Направления, Столбики, Кабели (грунт/воздух/канализация), а также Инвентаризация.

Порядок отображения: подсказки (номера колодцев, длина направления, координаты, “неучтённые кабели”) отображаются поверх подсветок объектов — чтобы подписи всегда были читаемыми.
Инвентаризация: слой для визуализации “неучтённых кабелей” и данных инвентаризации. Для роли “Только чтение” слой/режим недоступен.
Подсказки “неучтённые кабели”: переключатель в строке слоя “Инвентаризация” включает/выключает подписи значений на линиях.
Предполагаемые кабели: управление находится в строке слоя “Инвентаризация” (кнопка “Предполагаемые кабели”, выбор метода 1/2/3 и “Пересчитать”).

Поиск и фильтры

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

Основные фильтры

Собственник: показывает объекты выбранного собственника (где применимо).
Состояние: фильтрация по статусу.
ТУ: показать объекты выбранного ТУ.
Контракт: фильтрация кабелей по контракту.
Сброс: возвращает фильтры/слои к значениям по умолчанию.

Особенности роли “Только чтение”

Фильтры ТУ и Состояние недоступны.
Фильтр Контракт: к выбору доступны только контракты, где арендатор соответствует собственнику пользователя.

Поиск в списках

В списках объектов (раздел “Объекты”) доступен поиск по номеру/названию (в зависимости от вкладки). Если объект не находится — проверьте фильтры и слои.

Инвентаризация

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

Доступ: инвентаризация (слой, режим, инвентарные карточки) недоступна для роли “Только чтение”.

Инвентарные карточки (объект “Инвентарная карточка”)

Инвентарная карточка привязана к одному колодцу и хранит: номер (формат ИНВ‑<КОД собственника>‑<seq>), дату заполнения, теги (бирки/собственники), количества кабелей по направлениям, вложения (файлы).
В “Объекты → Колодцы” в действиях доступны кнопки “Добавить инвентарную карточку” и “Открыть последнюю…” (если карточки есть).

Режим “Инвентаризация” на карте

Нажмите кнопку “Режим инвентаризация” на панели инструментов.
Кликните по колодцу — на серединах линий его направлений появятся инпут‑окна для ввода количества кабелей.
Введите значения и нажмите “Создать” (кнопка появляется сверху по центру) или клавишу Enter — откроется форма создания карточки с предзаполненными данными.
Esc — выход из режима.

Слой “Инвентаризация”

Направления с данными инвентаризации рисуются толще и окрашиваются по градиенту по значению “неучтенные кабели”.
Остальные направления рисуются серым цветом #777777.
Наведение на направление показывает подсказку со списком кабелей, проходящих по его каналам.

Предполагаемые кабели (режим слоя)

Включается кнопкой “Предполагаемые кабели” в строке слоя “Инвентаризация” (в боковой панели “Слои”).
Доступно 3 метода расчёта: 1 — По магистральным графам, 2 — По локальным графам, 3 — По суммированным графам собственника.
Кнопка “Пересчитать” запускает построение предполагаемых кабелей и обновляет правую панель со списком.
Правую панель можно закрыть кнопкой ✕ — режим при этом выключится.

Объекты

Раздел содержит вкладки: Колодцы, Направления, Каналы, Столбики, Кабели, ТУ.

Добавить: создаёт объект выбранного типа.
Редактировать: открывает форму редактирования.
Удалить: удаляет запись (если есть права).
Показать на карте: центрирует карту на объекте и подсвечивает его (для поддерживаемых типов).
Фото: если у объекта есть фото — отображается кнопка просмотра миниатюр.

Для каналов удаление доступно только для последнего канала в направлении.

Колодцы: дополнительные функции

Колодцы только с инвентаризационной карточкой: фильтр в верхней части списка колодцев.
Колодцы требующие уточнения координат: фильтр показывает только колодцы с установленной галочкой “Требуется уточнить координаты”.
В форме “Редактирование колодца” есть галочка “Требуется уточнить координаты” (по умолчанию выключена).
Опора (тип `pole`): отображается на карте треугольником; нумерация начинается с 100000.
Ввод в здание (тип `input`): используется для точек ввода; отображается на карте как обычный колодец (стандартный маркер/подпись); нумерация начинается со значения настройки “Начальный номер вводного колодца” (параметр `input_well_number_start`).

Направления: описание объекта и связи

Направление — линейный объект, который соединяет два колодца: начальный и конечный.

Связь с колодцами: у направления всегда есть начальный и конечный колодец. Номер направления формируется автоматически как <номер начального колодца>-<номер конечного колодца> и обновляется при изменении номеров колодцев.
Каналы: внутри направления есть объекты “Канал” (обычно 1…16), каждый канал — отдельный под‑объект с номером канала и состоянием/типом (если применимо).
Длина: длина направления рассчитывается из геометрии и используется в расчётах длины кабелей в канализации.

Направления: дополнительные функции — статус “по зданию”

Для направлений со статусом “по зданию” (задаётся в настройках, по умолчанию это код inbuilding) действуют жёсткие правила:

Линия отображается пунктиром (цвет не меняется).
Собственник принудительно “Не указан” (даже если выбран другой при создании/редактировании).
Количество каналов всегда 1; добавление дополнительных каналов запрещено.

Кабели

В системе есть типы кабелей: в грунте, воздушные (перетяжка), в канализации. Все они отображаются отдельными слоями.

Создание кабеля на карте

Кабель в грунте: инструмент “Кабель в грунте (ломаная)” — кликайте точки трассы, затем нажмите “Создать”.
Воздушный кабель: инструмент “Кабель воздухом (ломаная)” — аналогично, кликайте точки и создавайте.
Кабель в канализации: выбирайте направления/каналы маршрута вручную или используйте режим “по кратчайшему пути”.
Точка по объекту: при активном построении (грунт/воздух) клик по существующему объекту (колодец/направление/кабель) добавляет точку в его координату, а не открывает карточку объекта.

Списки кабелей

В панели слоёв у слоёв кабелей есть кнопки списков:

Список — Кабели в грунте
Список — Воздушные кабели
Список — Кабели в канализации

Кнопка активна, когда соответствующий слой включён.
Список учитывает текущие фильтры и ограничения по роли (для “Только чтение” — доступные к просмотру кабели ограничены собственником пользователя).
В шапке списка отображается количество кабелей и суммарная протяжённость.
Сортировка: по длине кабеля.
Клик по строке списка фокусирует карту на выбранном объекте и подсвечивает кабель.

ТУ (карточки)

ТУ — карточка, объединяющая объекты (колодцы, направления, кабели, столбики и т.д.).

Поля ТУ: Номер (авто), Дата (необяз.), Основание (Запрос) (необяз.), Название, Тип ТУ, Описание.
Вложения: можно прикреплять документы/изображения к ТУ (загрузка/скачивание/удаление).
Режим ТУ на карте: выберите ТУ → создаваемые объекты получают статус planned и автоматически прикрепляются к выбранному ТУ.

Инциденты

Создание: заполните карточку инцидента, при необходимости привяжите объекты.
История: можно добавлять записи в историю.
Вложения: документы/фото инцидента отображаются в карточке и доступны для скачивания.

Контракты

Контракты — отдельный раздел (не в справочниках).

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

Импорт и экспорт данных

Экспорт (выгрузка)

В таблицах объектов и отчётах доступны кнопки “Выгрузить/Экспорт” (CSV).
Экспорт учитывает текущие фильтры и ограничения прав.

Импорт (загрузка)

Импорт доступен только пользователям с правом записи (не для роли “Только чтение”).
Перед загрузкой используйте режим предпросмотра (если доступен), затем подтверждайте импорт.
Если после импорта объекты “не видны” — проверьте фильтры, включённые слои, систему координат и масштаб.

Отчёты

Доступны отчёты по объектам, контрактам, собственникам, инцидентам.
Отчёты прокручиваются внутри панели.
Кнопка Выгрузить позволяет скачать отчёт (где доступно) с выбором разделителя.
Отчёт по инвентаризации: список направлений из сводной таблицы инвентаризации, действия “Показать на карте” и “Редактировать направление”, доступна выгрузка.
Отчёт по контрактам: для кабелей доступны действия “Показать на карте”, “Добавить в контракт”/“Исключить из контракта” (где применимо).

Справочники

Справочники содержат типы/виды объектов, статусы, собственников, типы кабелей, каталог кабелей и др.

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

Настройки

Настройки делятся на персональные (для пользователя) и глобальные (для всей системы).

Доступ к меню “Настройки” по ролям

Администратор: доступ ко всем разделам настроек (интерфейс, данные, WMTS, ссылки меню, hotkeys и др.).
Пользователь: доступ только к персональным настройкам:
- Настройка интерфейса карты ГИС
- Настройка ссылок меню
- Hotkey (Alt + клавиша) для панели инструментов карты
Только чтение: меню “Настройки” недоступно.

Примеры глобальных настроек (админ/root)

Параметры логики объектов (например, типы/коды “Ввод в здание”, “Опора‑Мачта”, статус направления “по зданию”).
Настройка данных ГИС (глобальные справочные коды и правила).
Настройка WMTS (спутниковый слой).
Админ‑функции: бэкапы БД, аудит‑лог.

Настройки по умолчанию (на карте)

Панель “Настройки по умолчанию” открывается кнопкой на панели инструментов карты. Все значения сохраняются персонально для текущего пользователя и используются для предзаполнения форм добавления/редактирования.

Тип (справочник) по умолчанию по видам объектов: для каждого вида объекта можно выбрать значение “типа/подтипа” из связанного справочника (например, для колодцев/столбиков/каналов — из “Типы объектов”, для кабелей — из “Типы кабелей”).
Состояние по умолчанию: предвыбирается в формах создания объектов (где поле “Состояние” присутствует).
Собственник по умолчанию: предвыбирается в формах создания объектов (где поле “Собственник” присутствует).
Контракт по умолчанию: предвыбирается в формах создания/редактирования кабелей (все типы кабелей).
Кабель (каталог) по умолчанию: предвыбирается в формах кабелей (маркировка/волоконность из каталога).

Важно: для направлений со статусом “по зданию” некоторые поля принудительно переопределяются (собственник “Не указан”, каналов всегда 1), даже если в дефолтах выбрано другое.

Типовые сценарии работы

1) Найти объект и перейти к нему на карте

Откройте “Объекты”, выберите вкладку (Колодцы/Направления/Кабели).
Используйте поиск/фильтры.
В действиях нажмите “Показать на карте” — карта сфокусируется и объект подсветится.

2) Создать направление между колодцами

На панели инструментов выберите “Добавить направление”.
Кликните два колодца (начальный и конечный).
Заполните параметры и сохраните.

3) Создать кабель в грунте/воздухом

Выберите инструмент построения кабеля (ломаная).
Кликайте точки трассы (можно кликать по объектам, чтобы взять их координату).
Нажмите “Создать” и заполните карточку кабеля.

4) Провести инвентаризацию по колодцу

Включите режим “Инвентаризация”.
Кликните по колодцу → введите количества по направлениям.
Нажмите “Создать”/Enter → сохраните инвентарную карточку.

Частые ошибки и как исправить

Ничего не отображается на карте: проверьте включение нужных слоёв, сбросьте фильтры, увеличьте/уменьшите масштаб.
Не удаётся создать/редактировать/удалить: проверьте роль — в “Только чтение” любые изменения запрещены.
Инвентаризация недоступна: функция запрещена для роли “Только чтение”.
Маршрут кратчайшего пути не строится (“недостижим”): маршрут не допускает повтор одного и того же направления — попробуйте другой набор колодцев.
После импорта объекты “пропали”: проверьте фильтры/слои/систему координат и масштаб.

Горячие клавиши

Esc: выход из активного режима инструмента (добавление/перенос/инвентаризация и т.п.) и снятие подсветок.
Ctrl + клик по карте: добавить/убрать объект в множественное выделение (в обычном режиме).
Ctrl + протяжка мышью: прямоугольное выделение объектов на карте (выбираются объекты, полностью попавшие в рамку).
Enter в режиме инвентаризации: открыть создание инвентарной карточки по введённым значениям.
В настройках можно задать hotkey для инструментов карты в формате Alt + клавиша (одна цифра или латинская буква).