# Спецификации — инструкция для пользователей

Раздел портала ГК Тепломонтаж: из PDF спецификации по ГОСТ 21.110—2013 получается таблица, которую можно поправить и выгрузить в Excel.

Адрес: **https://kp.24teplo.ru/spec/**

Из КП Generator туда ведёт пункт **Работа со спецификациями**.

Вход общий с КП Generator. Логин и пароль выдаёт администратор.

---

## 1. Вход

1. Откройте https://kp.24teplo.ru/ и войдите как обычно.
2. В шапке нажмите **Работа со спецификациями**.

Если открыть адрес спецификаций без сессии, портал сам покажет страницу входа КП и после входа вернёт обратно.

**Выйти** в спецификациях завершает сессию и в КП. **Сменить пароль** открывает восстановление пароля КП: укажите логин или почту, ссылка из письма действует 2 часа. **КП** в шапке возвращает в реестр коммерческих предложений.

---

## 2. Проекты

На странице **Проекты** видны ваши спецификации: имя файла, число строк и сколько строк ещё нужно проверить.

**Новый PDF** — загрузить следующую спецификацию.

Свой проект можно **удалить** в течение 24 часов после создания. Позже доступна только кнопка **Пометить на удаление**. Пометку можно снять кнопкой **Снять пометку**. Удаляет помеченный проект администратор.

Чужие проекты обычный пользователь не видит.

---

## 3. Загрузка PDF

1. **Загрузка** или **Новый PDF**.
2. Укажите название проекта — так он будет называться в списке.
3. Выберите файл PDF.
4. Нажмите **Создать и открыть**.

Внизу формы виден ход: создание проекта, процент загрузки, затем открытие распознавания.

Подходит PDF с текстовым слоем (выгрузка из CAD) и скан. Листы, на которых нет таблицы спецификации, пропускаются. Пустые код продукции, масса и позиция не заполняются сами: если ячейка не прочитана, она остаётся пустой.

Галочки про внешние сервисы и LLM не включайте. Распознавание идёт на сервере портала, файл никуда больше не отправляется.

---

## 4. Окно проекта

Сверху — страницы PDF, снизу — таблица. Границу между ними можно перетащить. Масштаб PDF: **−**, **По ширине**, **+**, либо Ctrl/Cmd и колесо мыши. Ширина колонок меняется за правый край заголовка, двойной щелчок по краю возвращает ширину. Масштаб, высота окна и ширины колонок запоминаются для вашего пользователя.

Вкладки: **Редактор**, **Проверка**, **Экспорт**, **История**.

Пока файл читается, сверху идёт статус по листам. Когда строки появились, их уже можно править. **Перераспознать** запускает чтение заново и заменяет таблицу.

Внизу окна: статус и счётчики «Строк» и «К проверке».

---

## 5. Таблица

Колонки формы 1 ГОСТ 21.110—2013: позиция, наименование и техническая характеристика, тип и марка, код продукции, поставщик, единица, количество, масса, примечание. Отдельная колонка **Раздел** показывает, к какому заголовку относится строка.

Заголовок раздела — строка на всю ширину. Позиции под ним идут до следующего заголовка.

Розовая строка — её нужно посмотреть. Справа, в блоке **Происхождение**, для выбранной ячейки видны страница, уверенность, исходный текст и пометка, правили ли ячейку вручную. Двойной щелчок по ячейке прокручивает PDF к этому месту.

Стрелки вверх и вниз переходят в ту же колонку соседней строки.

Кнопки над таблицей:

- **Добавить строку** — пустая позиция под текущей.
- **Добавить заголовок** — пустой заголовок под текущей строкой.
- **Переделать в заголовок** — текущая строка становится заголовком. Если отмечены флажки, переделываются все отмеченные. Текст ячеек склеивается в заголовок через пробел.
- **Удалить строку** — удаляет отмеченные строки, а если ничего не отмечено — текущую.
- **Объединить строки** — склеивает отмеченные строки.
- **Разделить строки** — режет текст активной ячейки в том месте, где стоит курсор. Часть до курсора остаётся, часть после уходит в новую строку ниже, в ту же колонку. Курсор в начале или в конце ячейки строку не делит.
- **Выше** и **Ниже** — меняют порядок.
- **Отменить** — возвращает предыдущее состояние таблицы в этом окне.
- **Найти**, **Заменить**, **Заменить все** — правка текста по таблице.

Флажок в шапке таблицы выделяет или снимает выделение со всех строк, которые сейчас видны с учётом поиска.

Перед уходом нажмите **Сохранить**.

---

## 6. Проверка

Кнопка **Проверить** открывает вкладку **Проверка**: список строк с предупреждениями. **Показать на PDF** возвращает в редактор к этой строке.

Повторы номеров позиций ищутся внутри одного заголовка: от заголовка до следующего. Если заголовков в спецификации нет, номера проверяются по всему файлу.

Кнопка **Игнорировать предупреждение «Код продукции содержит не только цифры»** убирает это замечание. Так бывает у марок вроде `ВВГнг(А)-LS`: латинские и русские буквы в типе и марке — нормальный текст, а не ошибка распознавания. Остальные замечания остаются.

Символ диаметра в наименовании должен быть ⌀. Если вместо него цифра или случайный знак перед размером (например, перед 125, 160, 200), исправьте ячейку или нажмите **Перераспознать** после обновления портала.

---

## 7. Выгрузка

Три файла. Перед скачиванием таблица сохраняется.

**Экспорт XLSX** — спецификация для работы и архива.

- Лист «Спецификация»: порядок строк, разделы, переносы.
- Лист «Контроль»: исходный файл, дата, число строк и предупреждения.
- Количество записывается числом. В русской Excel дробная часть показывается через запятую.

**Экспорт в XLSX для КП** — заготовка для импорта в коммерческое предложение.

- Колонки: Тип, Материал / услуга, Коммент., Ед., Кол-во.
- Тип — «раздел» или «позиция».
- В «Материал / услуга» склеиваются наименование, тип и марка, код продукции и поставщик. Повтор одной и той же фразы в ячейку не пишется второй раз.
- Примечание попадает в «Коммент.».
- Пустые строки и примечания без позиции не выгружаются.

В КП Generator этот файл подключается через **Импорт XLS** при подготовке КП. Колонки сопоставляются по заголовкам. Цены в файле нет — их задают уже в КП.

**Выгрузить XLSX для поставщиков** — сводка для запроса цен.

- Заголовки разделов убираются.
- Строки с одинаковыми наименованием, типом/маркой и кодом продукции сливаются в одну, количество суммируется.
- Колонка «Поз.» — просто порядковый номер 1, 2, 3…
- Если у одинаковых позиций разные поставщик, единица или примечание, значения перечисляются через точку с запятой.
- В шапке листа включён фильтр.

---

## 8. Документы компании

Пункт **Документы** открывает реквизиты, выписки СРО и МЧС и налоговые декларации. У каждого файла видны название, дата загрузки и первая страница. **Скачать** отдаёт исходный PDF или Word.

Налоговые декларации лежат в папках: ИП Ребрик, ИП Шевцов, Тепломонтаж, ГК Тепломонтаж, ВПО, Красвент. Реквизиты и декларации загружает администратор. Выписки загружает администратор или сотрудник, которому в этом разделе выдано право загрузки.

---

## 9. Если что-то не так

- Не открывается раздел — войдите на https://kp.24teplo.ru/ и нажмите **Работа со спецификациями**.
- Долго висит «Распознавание» — смотрите полосу статуса: там номер листа. Большой PDF читается несколько минут. Страницу не закрывайте, пока статус не закончится.
- В таблице пусто — в файле не нашлась форма спецификации, либо распознавание ещё идёт. Нажмите **Перераспознать**.
- Строка съехала (поставщик в единице, единица в массе) — поправьте ячейки вручную и нажмите **Сохранить**.
- Розовых строк много из‑за кода продукции с буквами — на вкладке **Проверка** нажмите кнопку игнорирования этого предупреждения.
- Нет кнопки **Удалить** — проекту больше 24 часов. Пометьте его на удаление и напишите администратору.
- Нет пункта **Пользователи** — вы вошли как обычный пользователь. Учётные записи создаёт администратор в КП Generator.

---

## 10. Администратору

Пункт **Пользователи** в шапке спецификаций открывает пользователей КП Generator. Отдельного списка учётных записей у спецификаций нет: один вход, одни роли.

Администратор видит проекты всех пользователей, в карточке указан владелец. Проекты с пометкой «На удаление» подсвечены, их может удалить администратор.
