Содержание

1. 1.Вход в систему
2. 2.Главная и навигация
3. 3.ФСНБ
4. 4.Импорт ФСНБ
5. 5.Привязка НР и СП
6. 6.Индексы цен
7. 7.Робот загрузки ИЦ
8. 8.Справочники
9. 9.Технологические группы
10. 10.Шаблоны отчётов
11. 11.НПА документы
12. 12.Обращения пользователей
13. 13.Пользователи
14. 14.Тестирование
15. 15.Документация

1. Вход в систему

Административная панель — https://smeta.net.ru (рабочий контур) или https://smeta-admin-test.softlancer.ru (тестовый).

1.1. Форма входа

Кнопка: «Войти» — заблокирована при пустых полях или во время запроса; во время загрузки показывает индикатор. При неверных учётных данных под полем появляется красное сообщение.

1.2. Учётные данные

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

1.3. После входа

Система запоминает вас — повторное открытие сразу попадает в кабинет (если не выходить через «Выйти»).

Открывается главная страница — статистика по системе и быстрые ссылки на разделы. Выход — кнопка «Выйти» в нижней части бокового меню.

1.4. Сессия

Срок жизни сессии — 24 часа. По истечении приложение возвращает на форму входа с сообщением «Сессия истекла».

1.5. Безопасность

• Соединение всегда по HTTPS.
• Передача авторизации защищена и подписана секретным ключом сервера.
• Если у администратора в системе сменился пароль, активные сессии остаются действительными до истечения 24 часов.

2. Главная и навигация

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

2.1. Главная страница

Содержит:

• Заголовок «Администрирование Смета.Нет.Ру».
• Версия приложения (например, 2.2.21).
• Виджеты статистики: количество загруженных ФСНБ, активный ФСНБ, количество пользователей, обращений.
• Быстрые ссылки на основные разделы.

2.2. Боковое меню

Меню структурировано по группам:

Каталог ФСНБ

Справочники

Индексы цен

НР и СП

Загрузка

Управление пользователями и обратной связью

Тестирование

Документация

2.3. Принципы навигации

• Клик по пункту меню — переход в соответствующий раздел.
• Кнопка «← Назад» в шапке (если есть история) — возврат на предыдущий экран.
• При перезагрузке страницы (F5) состояние сбрасывается на главную.

2.4. Шапка приложения

Над содержимым — название текущего раздела + кнопки действий, специфичные для каждой страницы.

В нижней части бокового меню — кнопка «Выйти».

2.5. Доступ

В версии 2.2.21 нет ролей и прав — авторизованный администратор видит весь интерфейс. Разграничение прав запланировано.

3. ФСНБ

«ФСНБ» (Федеральная сметная нормативная база) — корневой справочник системы. Каждая загруженная ФСНБ содержит сборники (ГЭСН, ГЭСНм, ГЭСНр и т. д.), разделы, группы, работы и ресурсы.

3.1. Список ФСНБ

Открывается по пункту меню «ФСНБ».

Колонки таблицы:

Действия в строке:

Кнопки страницы: + Загрузка ФСНБ — переход на форму импорта (см. главу 4).

3.2. Карточка ФСНБ

Открывается из списка по «Открыть».

Шапка

• Название ФСНБ (редактируемое).
• Номер и дата приказа.
• Статус.
• Кнопки: «Сохранить» (после редактирования), «Деактивировать», «Удалить».

Сборники

Таблица: тип, название, дата создания, уровень цен. Клик переходит в карточку сборника.

Привязка НР / СП

Выпадающий список «Привязка НР/СП» — выбор активного маппинга (см. главу 5).

Расчёт НР / СП

Кнопки:

• «Рассчитать НР/СП» — запускает расчёт для всех работ ФСНБ.
• Прогресс — индикатор обновляется автоматически.
• «Список нерассчитанных» — показывает работы без НР / СП.

3.3. Сборник

Список разделов. Колонки: код, название, кол-во групп, кол-во работ. Поиск (для ФСБЦ_Маш, ФСБЦ_Мат) — на сервере, с задержкой ~400 мс.

3.4. Раздел

Список групп и подразделов. Иерархия раскрывается через хлебные крошки.

3.5. Группа

Список работ в группе. Колонки: код, название, единица измерения. Клик по работе открывает её карточку.

3.6. Карточка работы

Полная карточка работы (только просмотр):

• Код, название, единица измерения, сборник.
• Ресурсы — таблица: № / Тип / Код / Название / Кол-во / Ед. Бейдж «П» для ресурсов с количеством из проекта.
• НР / СП — таблица: НР или СП, % от ФОТ, обоснование.
• Технологические группы — список групп с привязкой к абстрактным ресурсам.
• Абстрактные ресурсы — материалы, замещаемые конкретными в калькуляторе через выбираемые материалы.

4. Импорт ФСНБ

Загрузка ZIP-архива с XML-файлами ФСНБ. Источник архивов — официальные публикации Минстроя на ФГИС ЦС.

4.1. Открытие

Меню → «Загрузка ФСНБ».

4.2. Загрузка файла

Поле «Выберите файл ZIP» — стандартный выбор файла, принимаются ZIP-архивы стандартного формата ФСНБ Минстроя (с XLSM-файлами по сборникам и спецификациями XML).

Кнопка «Загрузить» — отправляет архив на сервер. После загрузки запускается фоновый процесс импорта.

4.3. Список загрузок

Прогресс импорта обновляется автоматически. Показывает:

• % выполнения общего импорта;
• Текущий шаг (например, «Импорт ГЭСН: раздел 5 из 67»);
• Количество обработанных строк.

4.4. Обработка ошибок

При ошибке статус меняется на «Ошибка», в детальной строке выводится сообщение. Типичные ошибки:

• «Файл не является ZIP» — неверный формат файла.
• «Не найден файл XLSM» — структура ZIP не соответствует ожидаемой.
• «Конфликт ссылок» — попытка удалить ФСНБ, на которую ссылаются индексы цен.
• «Слишком длинное значение» — поле в XLSM длиннее допустимого.

4.5. После успешного импорта

• Загруженная ФСНБ появляется в списке.
• Статус — «Не активна» по умолчанию. Активировать вручную.
• Расчёт НР / СП — отдельным шагом (см. главу 5).

4.6. Что включено в импорт

4.7. Размер и время

Полный импорт ФСНБ-2022 занимает 5–15 минут на тестовом контуре и до 30 минут на рабочем (зависит от ресурсов сервера). Размер архива — обычно 50–80 МБ.

Во время импорта система остаётся работоспособной, но активный ФСНБ не меняется до явной активации.

5. Привязка НР и СП

«НР / СП» (накладные расходы и сметная прибыль) — нормативные процентные ставки от ФОТ, применяющиеся к каждой работе. В ФСНБ они не приходят в составе работы напрямую — их нужно сопоставить из таблиц приказа Минстроя 812/пр (НР) и 774/пр (СП).

Меню → «Привязка НР и СП» (раздел «Алгоритмы»).

5.1. Открытие

Меню → «Привязка НР и СП».

5.2. Список привязок

Колонки таблицы:

Действия: Открыть / Удалить / Скачать XLSX / Загрузить XLSX.

5.3. Создание новой привязки

Кнопка «+ Новая привязка» открывает форму:

• Название привязки.
• Файл XLSX — таблица с колонками: код работы / процент НР / процент СП / обоснование НР / обоснование СП.

После загрузки система разбирает XLSX и создаёт записи привязки.

5.4. Применение привязки

В карточке ФСНБ (см. главу 3) у каждой ФСНБ — выпадающий список «Привязка НР / СП». Выбор привязки и кнопка «Рассчитать НР/СП» запускает расчёт.

Система проходит по всем работам ФСНБ и для каждой создаёт записи НР и СП с процентами и обоснованиями из привязки.

Прогресс отображается в виде полосы.

5.5. Структура XLSX-файла

Шапка таблицы:

Сопоставление по коду вида работ (первая колонка) — система соотносит с кодом группы или работы в ФСНБ.

5.6. Множественные пары

Одна работа может иметь несколько пар «НР + СП» (например, для разных видов: монтажный + ремонтный). В таком случае в XLSX повторяются строки с одинаковым кодом, и пользователь в калькуляторе выбирает нужную (см. руководство пользователя, главу 6).

5.7. Ручное редактирование

В таблице привязки можно вручную править строки (если зайти через «Открыть»):

• Колонки кликабельны для редактирования на месте.
• Кнопка ✕ — удалить строку.
• Кнопка «+ Добавить» — новая строка с пустыми полями.

Сохранение — пополе. Изменения не пересчитывают уже посчитанные НР / СП — нужно повторно запустить «Рассчитать НР/СП» в карточке ФСНБ.

5.8. Привязка по умолчанию

При первом запуске системы привязка создаётся вручную (загрузить XLSX или попросить готовый файл от Минстроя). Значений по умолчанию нет.

5.9. Особенности 2.2.21

В 2.2.20+ добавлены коэффициенты 812/пр_2020_п.25 (НР × 0,9) и 774/пр_2020_п.16 (СП × 0,85), применяемые при капитальном ремонте через ГЭСН вместо ГЭСНр. Их не нужно включать в привязку — это отдельные обоснования (см. главу 8 «Справочник обоснований»). Они применяются сверх базовых ставок.

6. Индексы цен

«Индексы цен» (раньше называлось «Сплит-форма») — таблицы пересчёта базисных цен ресурсов в текущие. Каждая запись = ресурс × регион × квартал → текущая цена + индекс.

6.1. Открытие

Меню → «Индексы цен».

6.2. Список индексов

Колонки таблицы:

Действия:

6.3. Фильтры

6.4. Детали индекса

Поиск по коду или названию ресурса.

6.5. Импорт XLS вручную

Меню → «Импорт ИЦ».

Кнопка «Загрузить» — отправляет файл на сервер. После загрузки запускается фоновый процесс.

Прогресс обновляется автоматически. Показывает % выполнения и количество обработанных строк.

6.6. Стандартная форма XLSX

Файл от ФГИС ЦС: первая строка — заголовок региона + квартала, далее таблица:

6.7. Ограничения при импорте

• Дубли одного и того же региона+квартала запрещены — при повторной загрузке нужно деактивировать или удалить старую запись.
• Удаление при использовании: если на индекс цен ссылаются сметы, удаление блокируется. Решение — переключить статус на «Не активна» (сметы продолжают использовать архивные данные).

6.8. Активация

Активный индекс цен — это тот, который доступен в форме создания сметы пользователю. Деактивация делает его невидимым для новых смет, но не влияет на уже созданные.

В версии 2.2.21 пользователь явно выбирает «Регион + Квартал» (= конкретный индекс) при создании сметы, и это значение фиксируется навсегда (не обновляется при появлении новых индексов).

6.9. Связь с ФСНБ

Каждый ресурс в индексе цен ссылается на запись из ФСНБ по коду. Если в активной ФСНБ нет такого кода, цена применяется через справочную текущую цену (без индекса). Это нормальное поведение для не-ФСНБ ресурсов (например, перевозок «47-1», «47-2»).

7. Робот загрузки ИЦ

«Робот ИЦ» — автоматическая загрузка индексов цен по всем регионам России из ФГИС ЦС. Запускается ночью или вручную.

7.1. Открытие

Меню → «Робот ИЦ».

7.2. Таблица задач

Каждая задача — пара (регион + квартал), которая должна быть загружена.

Действия:

7.3. Создание задач для квартала

Кнопка «+ Создать задачи для квартала» открывает форму:

После выбора создаются по одной задаче для каждого региона (со статусом «Новая»). Это пакетная операция, после которой можно запустить робота.

7.4. Расписание

Робот настроен на автоматический запуск:

• Запуск ежедневно в 01:00 по часовому поясу сервера (обычно московское время).
• Алгоритм:
  1. Берёт одну задачу со статусом «Новая» или «Ошибка» (по очереди создания).
  2. Меняет статус на «В работе».
  3. Запускает загрузку и разбор файла из ФГИС ЦС.
  4. После успеха — «Успех». После ошибки — «Ошибка» с сохранением сообщения.
  5. Повторяет до 05:00 или пока есть задачи.

7.5. Обновление статусов

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

7.6. Журнал

Каждое действие робота записывается в журнал сервера. Формат:

[Робот] Взята задача id=42, регион=Московская область, квартал=4кв 2025
[Робот] Загрузка из ФГИС ЦС…
[Робот] Задача id=42, успех, импортировано 1234 ресурса

При ошибке — стек ошибки с пометкой «[Робот] ОШИБКА».

7.7. Известные ошибки

7.8. Ручной запуск

Кнопка «Запустить все задачи» вверху страницы — последовательно проходит по всем задачам со статусом «Новая» и «Ошибка». Используется для ручного восстановления после массовой ошибки.

7.9. Особенности на рабочем контуре

На рабочем контуре робот может работать несколько часов (если квартал свежий и нужно загрузить ~85 регионов). Это нормально. Систему он не перегружает — задачи выполняются последовательно по одной.

8. Справочники

В админке поддерживаются несколько справочников, влияющих на расчёты и интерфейс пользовательского приложения.

8.1. Кварталы

Справочник кварталов: год, номер (1–4), название, дополнительные поля.

Колонки таблицы

Действия

Поля формы (создание/редактирование)

• Год / Номер / Название (генерируется автоматически из года и номера, можно переопределить).
• Письмо Минстроя: название (полное), номер, дата (для отчёта «02 ФСНБ»).
• Код ФСНБ.

8.2. Страны

Простой справочник: ID, код (ISO), название.

8.3. Регионы

Список регионов России (и других стран при расширении).

В версии 2.0.0 справочник регионов России заполнен (с учётом многозонных — берётся первая зона).

Особенности

• Идентификатор ФГИС ЦС обязателен для работы робота (см. главу 7).
• Многозонные регионы (Якутия, Красноярский край, Иркутская область, Дальний Восток) — добавлены отдельные строки для каждой зоны.
• Удаление региона невозможно, если есть индексы цен; нужно сначала удалить их.

8.4. Единицы измерения

Конвертация единиц для подмены выбираемых материалов (см. руководство пользователя, главу 10).

Создание / редактирование / удаление через окна.

Используется системой при подмене абстрактного ресурса конкретным с другой единицей измерения.

8.5. Характеристики

Меню → «Характеристики» (раздел «Алгоритмы»).

Словарь характеристик объекта, сметы, раздела и работы (см. руководство пользователя, главу 11).

Для типа «Список» — отдельный справочник пар «код → название».

8.6. Обоснования коэффициентов

Меню → «Обоснования коэф.» (раздел «Алгоритмы»).

Справочник обоснований применения поправочных коэффициентов (см. руководство пользователя, главу 8). Используется в калькуляторе при выборе обоснования.

Колонки таблицы

Форма редактирования

Полная форма с вкладками:

• Основное: код, название, описание, нормативный документ, тип, сборники, активность, типы объектов, ссылка на раздел в PDF.
• Значения: какие элементы (ОТ / ЭМ / ОТм / МАТ / НР / СП) и как (множитель × N / по расчёту / по диапазону / процент от другого элемента) применяются.
• Режим объединения: как несколько применённых коэффициентов взаимодействуют (умножение / максимум / альтернатива).
• Альтернативная группа: код группы — внутри одной группы можно выбрать только один.
• Исключения: какие коэффициенты отменяет.
• Связи с характеристиками: какие характеристики делают этот коэффициент применимым.

Связь с характеристиками

В форме обоснования можно задать связи с характеристиками: «применимо, если тип объекта = ремонт» или «применимо, если высота над уровнем моря > 1500». При выборе обоснования в калькуляторе значение из диапазона может предвыбираться.

В версии 2.2.21 эта функциональность присутствует в схеме данных, но автозаполнение в интерфейсе ещё не активно.

8.7. Резервная копия перед массовым редактированием

Перед массовым обновлением справочников (особенно обоснований) рекомендуется бэкап базы данных. Изменения в справочнике обоснований сразу влияют на все будущие применения коэффициентов в калькуляторе.

9. Технологические группы

«Технологическая группа» — справочник, объединяющий конкретные ресурсы для замены абстрактных в работах. Например, ТГ «28.18.023» = «Плитки керамогранитные» содержит варианты разных производителей и размеров.

В админке доступен только просмотр (чтобы отлаживать выбор материалов в пользовательском приложении).

9.1. Доступ к технологическим группам

Отдельного пункта меню нет — список технологических групп доступен:

• из карточки ФСНБ (см. главу 3.2) — кнопка «Технологические группы»;
• из карточки работы (см. главу 3.6) — раздел «Технологические группы» внизу страницы — клик по конкретной группе открывает её содержимое.

Поиск по коду или названию.

9.2. Содержимое группы

Клик по строке ТГ — список конкретных ресурсов:

Используется для проверки: какие конкретные коды доступны для замены абстрактного ресурса в окне выбора материала пользовательского приложения.

9.3. Откуда берутся технологические группы

Загружаются вместе с ФСНБ при импорте ZIP (см. главу 4). В файлах ФСНБ есть отдельный лист с описанием технологических групп и их составом.

В админке группы только для просмотра — редактирование не предусмотрено (структура задаётся Минстроем).

9.4. Связь с абстрактными ресурсами

Каждый абстрактный ресурс работы имеет привязку к технологической группе (одной или нескольким). Например, для абстрактного ресурса «Плиты керамогранитные» в работе ГЭСН 11-01-047-01:

технологические группы: 28.18.023

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

9.5. Использование при отладке

Если в калькуляторе в выбираемых материалах выбран не тот материал (например, показывается «Дно колодца» вместо «Плитка керамогранитная») — проверьте:

1. Связь абстрактного ресурса с правильной технологической группой.
2. Содержимое группы в этом разделе — нужный ресурс есть в списке.
3. Если ресурс есть, но не выбирается — система выбирает по «первой попавшейся» цене. Решение — пользователь явно выбирает в окне выбора материала (выбор сохраняется в конкретной смете).

9.6. Известные особенности

• Один абстрактный ресурс может ссылаться на несколько технологических групп; система проверяет по очереди.
• Технологические группы привязаны к версии ФСНБ — при смене ФСНБ сметы тот же абстрактный ресурс может вести в другие группы.
• Один и тот же ресурс может входить в несколько групп (например, плитка одна и та же, но входит и в группу «Облицовка», и в группу «Полы»).

10. Шаблоны отчётов

«Шаблоны отчётов» — справочник доступных форматов экспорта сметы в Excel. Каждый шаблон имеет код (01, 02, …), название, описание и флаг активности.

10.1. Открытие

Меню → «Шаблоны отчётов».

10.2. Таблица

10.3. Действия

Важно: добавление новых шаблонов через интерфейс не реализовано — каждый шаблон требует кода в системе. Текущие шаблоны:

• 01 — стандартный отчёт ЛСР
• 02 — отчёт по Приложению №3 Приказа 421/пр

10.4. Шаблоны в системе

01 — Смета. Стандарт

Полная локальная смета: разделы → работы → ресурсы (ЗТ / ЭМ / МАТ / ВМ) → ФОТ → НР / СП → итоги. Формулы Excel во всех итоговых ячейках. См. руководство пользователя, главу 12.

02 — Смета. ФСНБ. Ресурсы и индексы

Формат по Приложению №3 Приказа 421/пр. Расширенная шапка, детализация по видам затрат и видам работ. См. руководство пользователя, главу 12.

10.5. Связь с пользовательским приложением

В пользовательском приложении выпадающий список «↓ Экспорт» в шапке сметы показывает только активные шаблоны.

Деактивация шаблона немедленно скрывает его из выпадающего списка (после обновления страницы у пользователя).

10.6. Известный недочёт

В версии 2.2.21 фильтр активности не применяется на сервере — список шаблонов возвращает все шаблоны. На тестовом контуре временно неактивные шаблоны включены принудительно. После исправления деактивация в админке должна сразу скрывать шаблон. Это будет в одном из ближайших релизов.

10.7. Прямой запрос экспорта

Если в адресе пользовательского приложения указан код шаблона напрямую, система всё равно выдаст файл (для сценариев и тестов). Если код невалидный (например, «99») — ответ с ошибкой.

10.8. Будущие шаблоны

Планируются:

• 03 — Смета по форме №2 Приказа Минстроя (расширенный для энергетики).
• 04 — Сводный сметный расчёт (ССР).
• 05 — Локальная смета по форме госконтракта.

Каждый новый шаблон требует:

1. Реализации логики в системе.
2. Добавления записи в справочник «Шаблоны отчётов».
3. Описания в этой главе.

11. НПА документы

«НПА» (нормативно-правовые акты) — справочник приказов Минстроя, методик, СП, МДС. Хранятся вместе с PDF-файлами.

11.1. Открытие

Меню → «НПА документы».

11.2. Таблица

11.3. Действия

11.4. Создание / редактирование

Кнопки: Отмена / Сохранить.

11.5. Привязка к объекту / смете

В будущих версиях (не реализовано в 2.2.21):

• Привязка НПА к конкретному объекту → отображение в шапке сметы пользователя.
• Привязка к ФСНБ → автоматическая ссылка из окна выбора обоснования коэффициента.

11.6. Хранение PDF

PDF хранится в базе данных. В версии 2.1.0 проведена миграция формата хранения, улучшившая производительность и упростившая создание резервных копий.

11.7. Размер

Стандартные приказы — 50–500 КБ. Большие (с приложениями и таблицами) — до 5 МБ. Лимит загрузки — 10 МБ.

11.8. Безопасность

• Загрузка только PDF.
• Имя файла очищается от опасных символов.
• Скачивание доступно для авторизованных пользователей системы.

11.9. Стандартные документы (рекомендуется загрузить)

После загрузки они появляются в окне «Методика» в пользовательском приложении (см. руководство пользователя, главу 13).

12. Обращения пользователей

«Обращения» — таблица сообщений от пользователей: ошибок и пожеланий.

12.1. Открытие

Меню → «Обращения».

12.2. Таблица

Действия в строке:

12.3. Окно просмотра

В версии 2.2.21 нет полей «Статус», «Ответ администратора», «История» — это запланировано.

12.4. Фильтры

12.5. Сортировка

По дате (по умолчанию — новые сверху). Клик по заголовку колонки переключает сортировку по этой колонке.

12.6. Уведомления администратору

При новом обращении:

• Email на адрес администратора.
• Telegram — сообщение в чат-канал.

12.7. Экспорт

Кнопка «Экспорт в CSV» — выгрузка списка обращений в CSV для отчётов.

12.8. Удаление

Удаление обращений не предусмотрено — все обращения хранятся в истории. Это сделано для аудита и анализа.

12.9. Что делать с обращением

После просмотра администратор должен:

1. Если ошибка — воспроизвести, завести задачу в трекере, исправить и сообщить пользователю по email.
2. Если предложение — оценить приоритет, добавить в бэклог, ответить пользователю с примерным сроком (если будет реализовано).

В будущих версиях планируется встроенное обсуждение обращения внутри приложения.

13. Пользователи

«Пользователи» — список зарегистрированных пользователей системы (только просмотр).

13.1. Открытие

Меню → «Пользователи».

13.2. Таблица

13.3. Фильтры

13.4. Действия

В версии 2.2.21 — только просмотр. Нет кнопок «Заблокировать», «Сбросить пароль», «Удалить пользователя» через интерфейс.

Эти операции выполняются через прямые запросы к базе данных.

Запланировано в будущих версиях:

• блокировка пользователя;
• просмотр обращений конкретного пользователя;
• сброс пароля по запросу администратора (отправка временного кода на email).

13.5. Просмотр объектов и смет пользователя

Клик по строке пользователя в будущих версиях откроет страницу с его объектами и сметами. Сейчас это не реализовано.

13.6. Лимит выгрузки

Максимум 1000 пользователей за один запрос. Для больших систем (более 1000) запланирована постраничная навигация.

13.7. Регистрация

Регистрация пользователей контролируется флагом в настройках сервера. Если флаг выключен, новые пользователи не могут регистрироваться сами — только через прямые операции с базой данных.

13.8. Подтверждение email

Новый пользователь после регистрации получает 6-значный код на email и должен ввести его в форме входа в калькуляторе. До подтверждения — статус «Не подтверждён».

В админке статус виден в колонке «Верификация».

13.9. Аналитика

Базовая аналитика по таблице пользователей:

• общее число — счётчик в верхнем виджете;
• активные за месяц — пользователи с входом за последние 30 дней;
• распределение по объёму смет (для платных тарифов в будущем).

В версии 2.2.21 расширенная аналитика не реализована.

14. Тестирование

«Тестирование» — запуск автоматических сценариев из админки. Доступно только на тестовом контуре (защита от случайного запуска на рабочем).

14.1. Открытие

Меню → «Тестирование».

14.2. Доступные сценарии

В версии 2.2.21 зарегистрированы:

В версии 2.2.21 сценарии 1, 2, 3 устарели по интерфейсу — требуют адаптации после изменений в калькуляторе. Их нужно переписать или удалить.

«Золотой» сценарий — основной критерий регрессии — пока запускается только из командной строки, не из админки. Подключение в раздел «Тестирование» запланировано.

14.3. Кнопки на странице

14.4. Таблица запусков

Действия: Открыть — детали запуска (ниже).

14.5. Детали запуска

Список шагов сценария:

14.6. Защита от запуска на рабочем контуре

Раздел «Тестирование» доступен только на тестовом контуре. На рабочем контуре пункт меню скрыт, попытка обратиться к нему завершается отказом в доступе.

14.7. Покрытие тестами

14.8. Автоматизированная сборка

Сейчас (2.2.21) автоматического CI нет — тесты запускаются вручную перед релизом. В планах автоматический прогон на каждое изменение в релизных ветках.

15. Документация

«Документация» — страница со ссылками на руководства пользователя и администратора, а также Release Notes.

15.1. Открытие

Меню → «Документация».

15.2. Структура страницы

Заголовок

«Документация» + подзаголовок «Руководства, инструкции и Release Notes — Версия 2.2.21».

Карточки руководств

Две большие карточки:

Каждая ссылка открывает соответствующий документ:

Карточки Release Notes

Под руководствами — карточки релизов с обратным хронологическим порядком:

🚀 v2.2.21      1 мая 2026
   <краткое описание>
   [HTML] [Markdown]

🚀 v2.1.0      16 апреля 2026
   <краткое описание>
   [HTML] [Markdown]

🚀 v2.0.0      11 апреля 2026
   ...

При новом релизе администратор добавляет новую карточку в начало секции «Release Notes».

15.3. Что нужно сделать после релиза

1. Обновить версию в шапке страницы документации.
2. Добавить карточку нового релиза в начало секции «Release Notes».
3. Пересобрать админку и развернуть.
4. Положить собранную документацию (HTML и PDF) внутрь архива админки перед сборкой — она разворачивается на сервере вместе с приложением.

15.4. Генерация документации

Для каждого руководства существует скрипт сборки (generate.sh):

• собирает HTML через MkDocs Material;
• собирает PDF через pandoc + xelatex.

Результат:

• <руководство>/index.html — многостраничный сайт.
• <руководство>.pdf — единый PDF.

15.5. Версионирование документов

Каждая большая версия (2.0, 2.1, 2.2, …) — отдельная подпапка docs/v2/, docs/v3/ и т. д.

Когда выходит новая мажорная версия:

1. Скопировать папку текущей версии в новую (docs/v2/ → docs/v3/).
2. Обновить содержимое.
3. На странице «Документация» переключить ссылки на новую версию.
4. Старые ссылки остаются работающими (для пользователей старой версии).

15.6. Скриншоты

В каждой главе руководств есть папка img/ со скриншотами интерфейса. Скриншоты создаются автоматически через сценарий, который пробегает по интерфейсу и снимает нужные экраны.

В версии 2.2.21 скриншоты руководства пользователя и администратора актуализированы для новой версии интерфейса.