Руководство пользователя — DEC Web

Цифровая электрическая схема (ЦЭС): веб-версия. Работа со схемой, рабочей документацией, отчётами и контролем качества в браузере.

Версия документа соответствует приложению v1.3+. Открывается из меню Файл → Руководство пользователя или по кнопке «?» в шапке.

1. О приложении

DEC Web — браузерная версия настольной программы «Цифровая электрическая схема». Работает с теми же файлами проектов .db (SQLite): открыв базу в браузере, вы видите ту же схему, версии и листы, что и в desktop-версии. Формат БД не меняется — данные можно переносить между настольной и веб-версиями.

Назначение: построение и ведение однолинейных электрических схем, привязка к ним рабочей документации (РД), формирование кабельных журналов, перечней оборудования и работ, ведомостей и технических актов, расчёт трудозатрат по этапам ПНР, контроль качества и сравнение версий.

2. Вход и роли

Доступ к приложению — по логину и паролю. Предусмотрены две роли:

Пароли выдаёт администратор сервера (в браузере на общем ПК сохранять не рекомендуется). Текущий пользователь и роль показаны в правом верхнем углу.

• Сессия действует ограниченное время (по умолчанию 1 час). По истечении любой запрос вернёт «Требуется авторизация», и приложение покажет экран входа — войдите заново.
• Выход — кнопка «Выход» в шапке. Кнопка «⟲ Сброс» / «Сбросить сессию» — аварийный сброс входа (если что-то зависло).
• В режиме «Просмотр» интерфейс помечается, а попытки записи возвращают «Недостаточно прав».

3. Открытие проекта

В шапке приложения справа:

1. БД — выпадающий список файлов проектов на сервере (с размером). Выберите нужный — проект откроется автоматически.
2. Версия — список сохранённых версий схемы (имя и дата). По умолчанию открывается последняя. Смена версии перезагружает схему и все вкладки.
3. Листы — вкладки листов внизу рабочей области. Клик переключает лист.

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

4. Интерфейс

4.1 Шапка

• Меню: Файл, Правка, Вид, Данные проекта, Экспорт, ИИ (см. раздел 5).
• «⛶ На весь экран» — разворачивает холст схемы, скрывая боковые панели.
• Пользователь и кнопка «Выход».
• БД / Версия — выбор проекта и версии.
• Поиск по схеме — поле атрибута и значения (см. раздел 21).

4.2 Левая панель (навигация)

Вертикальная панель значков слева — быстрый переход между модулями: Схема, БД, РД, Кабели, Оборуд., Работы, Ведом., Труд, ПНД, Анализ, Качество, Версии, Аудит admin, Доп. Активный модуль подсвечен.

4.3 Рабочая область и панель листов

Центральная область отображает текущий модуль. Для схемы внизу — панель листов с кнопками «+» (новый лист) и «▾» (действия с листом).

4.4 Строка состояния

Внизу окна — статус операций («Загрузка…», «Готово», тексты ошибок). Всплывающие уведомления (тосты) в углу сообщают об успехе/ошибке действий.

5. Главное меню

Файл

Правка admin

Отменить (Ctrl+Z), Повторить (Ctrl+Y), Копировать (Ctrl+C), Вставить (Ctrl+V), Удалить (Del), выравнивание (по левому краю, центрирование по горизонтали/вертикали, по верху) и распределение элементов.

Вид

Показать всё, Вписать по ширине (Ctrl+9), В центр проекта (Ctrl+0), Отобразить наложения (подсветка перекрывающихся элементов), Увеличить/Уменьшить.

Данные проекта

Открывает любой из модулей-вкладок (разделы 7–19).

Экспорт

PDF схемы (выбранные листы), Текущий лист в Excel, Текущий лист в CSV (см. раздел 22).

ИИ admin

«Задание для Cursor (оркестр РД)» — формирует файл reports/cursor_transfer_task.json с контекстом проекта для последующего автоматического переноса рабочей документации на схему средствами оркестра Cursor (запускается вне браузера). Поля: страницы PDF и примечание.

6. Модуль «Схема» (редактор)

Главный модуль — векторный редактор однолинейной схемы. Отрисовывает все типы элементов (шины, выключатели 0,4/10/400 кВ с положением контакта, двигатели, трансформаторы 2/3-обмоточные, выпрямители, инверторы, батареи, розетки, лампы, ящики, порты перехода, текст, линии) с цветами статусов поставки/монтажа/ПНР.

6.1 Навигация по холсту

6.2 Выделение и перемещение admin

• Выделение: клик по элементу; рамка по пустому месту — групповое выделение; Ctrl+A — выделить всё на листе.
• Перемещение: перетаскивание выделенного. Действует привязка к сетке (снап). Новые позиции сохраняются автоматически (в размещения листа и базовые координаты элемента).
• Выравнивание/распределение: меню «Правка» или контекстное меню (ПКМ).
• Esc — снять выделение / отменить режим вставки или создания связи.

6.3 Добавление и удаление admin

• Палитра элементов — выбор типа и размещение на холсте кликом.
• Удаление: Del на выделенном (с подтверждением, если включено в настройках). Вместе с элементом удаляются его связи.
• Копировать/Вставить: Ctrl+C / Ctrl+V.
• Отменить/Повторить: Ctrl+Z / Ctrl+Y (история перемещений и выравниваний).

6.4 Панель атрибутов

При выделении элемента или связи открывается панель атрибутов: просмотр и (для администратора) правка значений (KKS, наименование, тип-марка, классы, статусы и т.д.). Изменения сохраняются в текущую версию. У портов перехода доступна кнопка перехода к парному порту на другом листе (по «Коду связи»).

6.5 Связи и кабельные линии admin

• Создание связи: соедините порты двух элементов. По умолчанию связь создаётся как кабельная линия (КЛ).
• Маршрут: автоматический Z-образный с разведением по дорожкам; поддерживаются ручные изгибы — перетаскивание оранжевых точек на выбранной связи.
• Типы: КЛ, Шина, Токопровод, Условное; ширина, стиль, цвет — через панель атрибутов.
• Атрибуты КЛ (марка, число жил и сечение, класс безопасности, KKS кабеля и др.) формируют кабельный журнал и проверяются в контроле качества.

6.6 Контекстное меню

ПКМ по холсту/элементу: копировать, вставить, выравнивание и распределение, «В центр проекта». Доступность пунктов зависит от выделения и буфера обмена.

6.7 Наложения

«Вид → Отобразить наложения» подсвечивает перекрывающиеся элементы — помогает находить случайно совмещённые объекты.

6.8 Совместная работа: оптимистичная блокировка

Каждая версия имеет внутренний номер ревизии. Когда вы открываете лист, клиент запоминает ревизию; при сохранении правки он передаёт её серверу. Если за это время другой пользователь изменил данные версии, сервер вернёт конфликт, появится уведомление «Схема изменена…», и лист автоматически перезагрузится с актуальными данными.

6.9 Листы

Панель листов внизу. Кнопка «+» — новый лист. Кнопка «▾» и ПКМ по вкладке листа открывают действия:

7. Модуль «База данных»

Табличный грид все элементы × все атрибуты текущей версии (служебные/геометрические ключи скрыты). Назначение — массовый просмотр и редактирование атрибутов без захода в схему.

• Правка admin: изменение значений ячеек, сохранение пакетом.
• Импорт из Excel: загрузите файл — элементы сопоставляются по столбцу KKS оборудования, обновляются атрибуты, чьи имена совпадают с заголовками Excel. Сначала показывается предпросмотр изменений (что и где поменяется, какие KKS не найдены), применение — отдельным действием.
• Стандартные операции таблицы: фильтр по столбцам, сортировка, экспорт CSV/Excel (см. раздел 23).

8. Модуль «Рабочая / нормативная документация»

Реестр документов проекта (РД и НД) с привязкой к оборудованию и листам схемы.

• Просмотр файла: PDF открывается прямо в браузере (встроенный просмотрщик). Источник — вложение в БД (blob) либо локальный файл рядом с базой.
• Колонки: KKS объекта, шифр документа, тип, наименование, ревизия, статус, разработчик, даты, примечание, привязанное оборудование, листы.
• admin Добавление/правка карточки документа, прикрепление и открепление файла, «встроить все» файлы в БД.
• Распознавание (РД): проверка текстового слоя PDF и подготовка к переносу содержимого на схему (оркестр Cursor; см. меню «ИИ»).

9. Модуль «Кабельный журнал»

Две части:

• Кабели схемы — формируются автоматически из атрибутов связей КЛ/токопроводов (марка, сечение, класс, «откуда/куда» по KKS и помещениям, длина, номер в журнале).
• Проектный кабельный журнал — табличные данные проекта; поддерживается история загрузок Excel.

Операции таблицы — фильтр, сортировка, экспорт (раздел 23). Журнал также копируется при сохранении новой версии.

10. Модуль «Перечень оборудования»

Сводный перечень оборудования, агрегированный по атрибутам элементов схемы (по KKS оборудования, типу-марке, наименованию и т.д.). Клик по строке может переводить к элементу на схеме. Экспорт в Excel/CSV.

11. Модуль «Перечень работ»

Реестр работ (программа ПНР): п/п, ID ПНР/ПНД, блок, KKS объекта и системы, направление и этап ПНР, наименование работ и программы, шифр документа, даты, согласующая организация, принадлежность к ЯОР, исполнитель. admin Правка/добавление/удаление строк с сохранением.

12. Модуль «Ведомости и тех. акты»

Вкладка с двумя разделами (переключатель вверху): Ведомости и Технические акты. Данные опираются на оборудование, тип-марки и объёмы работ проекта.

12.1 Ведомости объёмов работ (ВОР)

• Формирование по ID ПНР: подбор оборудования, расценок и объёмов; предпросмотр перед записью в базу.
• Нумерация и ревизии ведомости, запись в базу admin.
• Просмотр сохранённых, удаление, выгрузка в Excel (одной ведомости и массово).
• Шаблон ВОР настраивается (заголовки/реквизиты).

12.2 Технические акты (ТА): версии, перенос прошлого, ограничения

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

Структура акта

Дерево KKS оборудования → Подтип → строки расценок. По каждой строке — шифр, наименование, измеритель, количество, коэффициент, трудозатраты и 5 этапов: ПНД, ПНР с ЭМР, ИИ, КО, Отчёт. Колонки «Накопительно» и «Остаток» (%) считаются автоматически по весам этапов (10/40/30/15/5).

Создание и версии (ревизии)

• admin «+ Новый тех. акт по ПНР» — укажите ID ПНР. Строки собираются по оборудованию ПНР и его тип-маркам из реестра подтипов.
• Каждый новый акт — новая ревизия с номером вида {префикс по «Блоку»}-{KKS объекта}-1-2-1-{ID ПНР}/TA_C{NN}, где C{NN} — C01, C02, … (следующий номер вычисляется автоматически).
• Все ревизии видны в списке актов (колонки «Номер», «Ревизия», «Создан»).

Заполнение и ограничение

• Этапы редактируются прямо в дереве admin; проценты пересчитываются на лету. Кнопка «Заполнить ПНД» проставляет в этап ПНД значения из колонки «Количество» для всех строк.
• Ограничение «нельзя уменьшать». При сохранении значение любого этапа не может быть меньше, чем в предыдущей ревизии (прогресс монотонен). Если значение уменьшено — сохранение отклоняется, и показывается список нарушений в виде «этап — было → стало». Увеличить или оставить равным — можно.
• Просмотр, удаление, выгрузка акта в Excel; полноэкранный режим дерева.

13. Модуль «Трудозатраты и сравнение»

Расчёт трудозатрат ПНР по пяти этапам с весами:

• Дерево трудозатрат — по оборудованию/типам-маркам и объёмам.
• Реестр актов — выполненные этапы.
• Сравнение — план/факт и проценты выполнения.

14. Модуль «Разработка ПНД»

Реестр и анализ программ наладочных работ (ПНД): сопоставление KKS на схеме по ID ПНР со сметным оборудованием, контроль покрытия. Разработка/OCR документов Word — в настольной версии.

15. Модуль «Анализ схемы»

Проверка заполненности атрибутов и базовая валидация. Для каждой версии:

• По полям: сколько единиц оборудования и КЛ имеют пустое значение по каждому ключевому атрибуту (блок, направление, KKS объекта, помещение, ID ПНР, наименование, вид/тип оборудования, исполнитель, статус, тип-марка, номер ведомости, РД, KKS кабеля). Кнопка «Подсветить на схеме».
• Кириллица в KKS: элементы, где в KKS оборудования встречается кириллица (частая ошибка), с разбивкой по листам.
• Правила РД для КЛ (*1001 / *1002): нарушения правил кабельных линий — список замечаний с переходом к связи на схеме.

16. Модуль «Контроль качества» (DRC)

Инженерные проверки целостности схемы, дополняющие «Анализ». Сводка вверху: число ошибок и предупреждений. Каждая находка кликабельна — переход к элементу/связи на схеме.

Кнопка «Обновить» пересчитывает проверки. Результаты можно выгрузить в Excel/CSV.

17. Модуль «Сравнение версий»

Сравнивает две версии схемы и показывает различия по элементам и связям.

1. Выберите версии A (база) и B (с чем сравнить). По умолчанию B — текущая, A — предыдущая.
2. Нажмите «Сравнить». Сводка: +добавлено / −удалено / ✎изменено отдельно по элементам и связям.

• Добавлены / Удалены — элементы/связи, появившиеся или исчезнувшие между версиями.
• Изменены — с перечнем конкретных атрибутов в виде «ключ: было → стало».
• Перемещения и служебная геометрия в «изменения» не попадают — только содержательные правки и смена типа.
• Клик по строке — переход к объекту на схеме. Экспорт в Excel/CSV.

18. Модуль «Журнал аудита» только admin

Регистрация событий безопасности — требование КИИ/УЗ-1 (ФСТЭК). Журнал хранится отдельно от проектных баз и переживает их замену.

Что регистрируется

• Входы и выходы; отказы доступа (неверный пароль, недостаток прав);
• любые изменения данных (создание/удаление/правка элементов, связей, массовая правка, сохранение версии);
• экспорт и скачивание/замена БД (вынос данных).

Перемещения элементов (раскладка) не логируются — это не событие безопасности.

Колонки и фильтры

Время, пользователь, роль, IP, действие (по-русски), метод, путь, БД, версия, статус. Фильтры: пользователь, действие/путь, диапазон дат, «только отказы». Экспорт в Excel/CSV. Строки отказов выделяются.

19. Модуль «Доп. функционал»

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

20. Версии и резервные копии admin

Сохранение версии

«Файл → Сохранить версию» создаёт новую версию — полную копию текущих элементов, связей, атрибутов и листов под новым номером. Перед записью автоматически создаётся резервная копия БД.

Управление версиями

• Список версий с оценкой объёма (число элементов, связей, атрибутов, размещений).
• Удаление версий — отмеченные версии удаляются; должна остаться минимум одна.
• Сжать проект (VACUUM) — уменьшает размер файла БД после удалений.
• Резервные копии — список авто-бэкапов (хранятся последние несколько на каждую БД); восстановление выбранной копии (перед восстановлением делается бэкап текущей).
• Проверка целостности — быстрый PRAGMA quick_check базы.

21. Поиск по схеме

В шапке: поле атрибута (необязательно — можно искать по всем) и поле значения. Поиск подстроки без учёта регистра по атрибутам элементов и кабельных линий. Результаты — выпадающий список с указанием листа; выбор результата переводит к объекту (при необходимости переключая лист). Ctrl+назначенная клавиша может ставить фокус на поиск (см. горячие клавиши).

22. Экспорт

23. Работа с таблицами

Все табличные модули используют единый компонент со стандартными возможностями:

• Фильтр по столбцам — поле «фильтр» под заголовком каждого столбца.
• Сортировка — клик по заголовку столбца.
• Пагинация — постранично (стр. N/М), навигация стрелками.
• Экспорт — кнопки «CSV» и «Excel».
• В редактируемых таблицах — правка ячеек, добавление/удаление строк и кнопка «Сохранить» admin.

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

Фиксированные (редактор схемы)

Настраиваемые

«Файл → Горячие клавиши» — назначьте сочетания Ctrl+буква/цифра на команды: сохранить версию, экспорт PDF, показать всё, в центр, фокус на поиск, открытие любой вкладки. Сочетания Ctrl+C/V/X/Z/Y/A/0 зарезервированы и недоступны для переназначения. Настройки хранятся в браузере (локально).

25. Настройки

«Файл → Настройки» — параметры интерфейса, хранящиеся локально в браузере. В числе прочего — подтверждение удаления элементов/связей. Настройки применяются сразу.

26. Безопасность и КИИ

• Роли и доступ: запись разрешена только администратору; чтение — обеим ролям.
• Сессии: токены с ограниченным сроком; выход аннулирует токен на сервере.
• Журнал аудита: регистрация событий безопасности (раздел 18) — требование ФСТЭК для объектов КИИ (УЗ-1).
• Изоляция данных: внешние (иностранные) сервисы не используются; PDF и распознавание — локальные.
• Рекомендуется доступ к серверу по защищённому каналу (TLS) и хранение паролей вне общего ПК.

27. Частые вопросы

После входа меня сразу «выкидывает» обратно на экран входа

Возможна истёкшая сессия — войдите заново. Если повторяется на сервере — администратору следует задать постоянный секрет подписи токенов (переменная окружения), иначе при нескольких экземплярах сервера сессии не совпадают.

«Недостаточно прав (только просмотр)»

Вы вошли как user. Редактирование доступно только роли admin.

«Схема изменена другим пользователем» и лист перезагрузился

Это оптимистичная блокировка: кто-то сохранил правку в эту же версию. Ваша правка отклонена, показаны актуальные данные — повторите изменение.

Не открывается PDF документа

Файл не вложен в БД и не найден рядом с базой, либо это скан без текстового слоя. Прикрепите файл заново или используйте «встроить все».

Экспорт PDF возвращает ошибку об установке зависимостей

На сервере не установлены библиотеки рендеринга PDF. Экспорт PDF доступен на сервере с диском; Excel/CSV работают всегда.

Изменения в настольной версии не видны в браузере

Обновите страницу (F5) или переключите лист/версию. Не держите одну БД открытой на запись одновременно в desktop и web.

© Цифровая электрическая схема (DEC Web). Документ открывается по адресу /static/help/index.html.