dxf-gen/kj
Nail Sagitov 34d3f5025e fix (kj): поиск титула для Романтик 2026-10-09 11:28:04 +05:00
..
archive fix: при генерации docx идёт автоматическая сковзная генерация для целых позиций. Дробная берётся из файла данных 2026-10-08 21:13:52 +05:00
README.md fix (kj): поиск титула для Романтик 2026-10-09 11:28:04 +05:00
alt-link_logo.svg Обновление шаблона и скрипта КЖ (вектор. логотип, пустые строки) 2026-10-07 16:48:33 +05:00
settings.toml Генерация СО ВО (версия 0.9) 2026-10-08 14:46:07 +05:00
Данные_ВО.xlsx fix: в mdr добавлены шкафы для Романтик и ЗИП, для правильной обработки 2026-10-08 20:20:45 +05:00
Данные_КЖ_сети.xlsx Генерация СО ВО (версия 0.8) 2026-10-08 13:44:54 +05:00
Данные_КЖ_электропроводки.xlsx Генерация СО ВО (версия 0.8) 2026-10-08 13:44:54 +05:00
Данные_СО.xlsx fix: при генерации docx идёт автоматическая сковзная генерация для целых позиций. Дробная берётся из файла данных 2026-10-08 21:13:52 +05:00
Шаблон_ВО.docx Генерация СО ВО (версия 0.8) 2026-10-08 13:44:54 +05:00
Шаблон_КЖ.docx Генерация СО ВО (версия 0.8) 2026-10-08 13:44:54 +05:00
Шаблон_СО.docx Генерация СО ВО (версия 0.8) 2026-10-08 13:44:54 +05:00

README.md

Обработка документов КЖ

Скрипт src/process_kj_docs.py формирует DOCX- и PDF-файлы кабельно-трубных журналов на основании данных из XLSX и шаблона Word.

Запуск

Запуск с параметрами по умолчанию:

python src\process_kj_docs.py --type электропроводки

По умолчанию используются:

Настройки:      kj\settings.toml
Шаблон DOCX:    kj\Шаблон_КЖ.docx
MDR:            ref\mdr_reference.md
Каталог вывода: output\kj

Обязательный параметр --type задает ключ типа из kj\settings.toml. В этом файле для каждого типа описаны:

Поле Назначение
type Ключ типа (значение --type)
data_file Имя файла данных XLSX
journal_name Название журнала (строка, с которой начинается наименование документа в MDR)
template Имя файла шаблона DOCX в каталоге kj (по умолчанию Шаблон_КЖ.docx)
section_rules Флаг true/false: правила оформления секций для типов ВО/СО (см. ниже). По умолчанию false

Глобальное поле revision задает суффикс ревизии: <номер>_<ревизия> (по умолчанию C).

Файл данных ищется как kj\<data_file>. Шаблон по умолчанию kj\Шаблон_КЖ.docx от типа не зависит и может быть переопределен через --template.

Для запуска необходимы Python, openpyxl, python-docx, pywin32 и установленный Microsoft Word. Word используется для экспорта DOCX в PDF.

Источник XLSX

Скрипт читает активный лист книги.

Структура используемых колонок:

Колонка Назначение
B–L Значения строк таблицы документа
M Дисциплина (код дисциплины, например СПД, КСБ)
N Шифр (шифр шкафа или номер документа)
O Этап (номер титула, например 110900)

По умолчанию обработка начинается со строки 4 (первые 3 строки — заголовки таблицы). Пустые строки пропускаются. Строки группируются по тройке:

(Дисциплина, Шифр, Этап)

Одна такая группа формирует один комплект DOCX/PDF.

Определение имени файла

Имя выходного документа (номер документа) определяется по колонке «Дисциплина»:

  1. Если «Дисциплина» пустая — номер документа берется из колонки «Шифр» (N) как есть.

  2. Если «Дисциплина» не пустая — в ней указана дисциплина, а в колонке «Шифр» указан шифр шкафа. Номер документа ищется в таблице «Список листов ОКРЧ из MDR» файла ref/mdr_reference.md:

    • из «Дисциплины» берется первое слово как дисциплина;
    • находится строка, в которой дисциплина совпадает, наименование документа начинается со строки journal_name из kj/settings.toml и заканчивается шифром шкафа из колонки «Шифр»;
    • если колонка «Этап» (O) заполнена, номер титула в строке MDR должен совпадать с ней;
    • номер документа берется из колонки «Номер документа» этой строки.

    Если такая строка не найдена, выводится предупреждение, и документ для группы не генерируется.

Диапазон строк

Параметр --rows задает строки XLSX для обработки:

python src\process_kj_docs.py --type электропроводки --rows 4

Обработать только строку 4.

python src\process_kj_docs.py --type электропроводки --rows 4-30

Обработать строки с 4 по 30 включительно.

Если параметр не указан, обрабатываются строки с 4-й до последней.

Фильтр по дисциплинам

Параметр --codes позволяет обрабатывать только заданные коды из колонки M («Дисциплина»). Значения перечисляются через запятую:

python src\process_kj_docs.py --type электропроводки --codes КСБ,СПД

Совместно с диапазоном строк:

python src\process_kj_docs.py --type электропроводки --rows 4-30 --codes КСБ,СПД

Сравнение кодов выполняется без учета регистра. Если --codes не указан, обрабатываются все дисциплины.

Фильтр по документу

Параметр --doc позволяет обрабатывать только один документ с заданным номером из колонки N («Шифр»):

python src\process_kj_docs.py --type электропроводки --doc 01_B590.110900.1.6-СПД-КЖ08

Совместно с диапазоном строк:

python src\process_kj_docs.py --type электропроводки --rows 4-30 --doc 01_B590.110900.1.6-СПД-КЖ08

Если документ не найден, скрипт выводит ошибку. Если --doc не указан, обрабатываются все документы.

Поддерживаемые параметры командной строки

Параметр Назначение
--type TYPE Ключ типа из kj/settings.toml (обязательный)
--source PATH Путь к исходному XLSX, по умолчанию файл данных из настроек для типа
--template PATH Путь к шаблону DOCX, по умолчанию kj\Шаблон_КЖ.docx
--output-root PATH Корневой каталог результатов
--mdr PATH Путь к mdr_reference.md
--rows N Обработать одну строку XLSX
--rows N-M Обработать диапазон строк XLSX
--codes CODE,... Обрабатывать только указанные дисциплины (через запятую)
--doc NUMBER Обрабатывать только один документ (колонка N, «Шифр»)
--dry-run Показать план без создания DOCX/PDF
--extract Извлечь данные из docx файлов input/ в Excel (только типы во/со)
--input PATH Каталог с входными docx для --extract (по умолчанию input)

Пример предварительной проверки:

python src\process_kj_docs.py --type электропроводки --rows 4-30 --codes КСБ,СПД --dry-run

Извлечение данных из DOCX (--extract)

Режим извлекает строки из таблиц docx файлов каталога input/ и сохраняет их в Excel-таблицу по аналогии с Данные_КЖ_электропроводки.xlsx:

python src\process_kj_docs.py --type во --extract --dry-run
python src\process_kj_docs.py --type во --extract
python src\process_kj_docs.py --type со --extract

Поддерживаются только типы во и со (файлы Данные_ВО.xlsx, Данные_СО.xlsx из settings.toml). Параметр --source задает выходной файл, --input — каталог с входными docx.

По имени файла определяется шифр, дисциплина и этап: имя вида 01_B590.110900.1.6-СПД-ВО01_C.docx преобразуется в номер документа 01/B590.110900.1.6-СПД-ВО01, который ищется в таблице «Список листов ОКРЧ из MDR». Оттуда берутся дисциплина (колонка 3) и этап — номер титула (колонка 1). В Excel первая строка каждого документа несет M (дисциплина), N (полный номер документа), O (этап).

Пустые строки пропускаются. Строка, в которой есть наименование, но нет номера позиции (например, Оборудование), помечается спецзначением ЗАГ в колонке позиции (B). При генерации по шаблону такие строки отделяются пустыми строками и выводятся без нумерации.

Если номер документа из имени файла не найден в MDR, файл пропускается и выводится предупреждение. Строки с / в колонке N при генерации сопоставляются с MDR напрямую по полному номеру.

Заполнение таблицы DOCX

Используется первая таблица шаблона Шаблон_КЖ.docx.

Заполнение начинается с четвертой строки таблицы шаблона. Если таблица в шаблоне начинается с пустой строки (все ячейки пусты), эта строка пропускается — данные пишутся с первой непустой строки. Если таблица заканчивается пустой строкой, она сохраняется: новые строки вставляются перед ней, а очистка лишних строк её не затрагивает:

Столбец таблицы Источник
1 Порядковый номер строки
2–12 Колонки B–L XLSX

Для шаблонов ВО/СО (узкая таблица до 9 колонок) при section_rules = true:

  • целые позиции нумеруются сквозным счётчиком в рамках одного документа: неправильные целые заменяются нашими (6, 7, 8 → 11, 12, 13);
  • в дробных позициях целая часть заменяется на текущий счётчик, дробная берётся из данных как есть (5.5 при счётчике 6 → 6.5); дробная до первой целой оставляется как есть;
  • строки с ЗАГ выводятся без номера (только наименование, по центру с подчеркиванием) и отделяются пустыми строками сверху и снизу, в том числе пустая строка ставится перед первым заголовком таблицы;
  • перед строкой с целой позицией (1, 2, ...), идущей после дробной (2.3, ...), вставляется пустая строка;
  • строка-раздел (целая позиция с пустыми «Ед. изм.» и «Кол-во», за которой следуют дробные позиции) подчеркивается без центрирования;
  • таблица всегда заканчивается ровно одной пустой строкой.

Каждая замена позиции при генерации выводится предупреждением вида <номер документа>: позиция '6' заменена на '11' (видны и в --dry-run). Строки ЗАГ счётчик не сдвигают.

При section_rules = false (все типы КЖ) действует legacy-поведение: сквозная нумерация первой колонки, cells[j] = values[j-1], без особых правил пустых строк.

В режиме --extract для типов с section_rules = true действует правило перенумерации: если предыдущая строка — целая позиция с заполненными «Ед. изм.» и «Кол-во», а текущая — дробная (3.1), позиция заменяется на prev + 1 (3.1 → 4), цепочки перенумеровываются последовательно (3, 3.1, 3.2 → 3, 4, 5). Каждая замена выводится предупреждением вида <файл>: позиция '3.1' заменена на '4' (видны и в --dry-run). Строки ЗАГ и пустые строки сбрасывают отслеживание.

Если строк в шаблоне недостаточно, скрипт добавляет строки копированием оформленной строки шаблона.

При заполнении сохраняются свойства оформления ячеек и текста, в том числе:

  • шрифт;
  • размер шрифта;
  • жирность, курсив и подчеркивание;
  • цвет и другие свойства текста;
  • выравнивание;
  • границы и свойства ячейки;
  • параметры абзаца.

Для числовых ячеек XLSX учитывается формат числа. Например, формат 0.0 переносит значения в DOCX как 1,8 и 2,0.

Подстановки в шаблоне

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

Подстановка Значение
{{ DISCIPLINE }} Полное название дисциплины
{{ DOC_NUM }} Номер документа из MDR
{{ D }} Дата/значение 07.2026
{{ LOCAL_TITUL }} Название объекта из MDR
{{ DOC_NAME }} Название документа из MDR
{{ NAME_TITUL }} Наименование титула из MDR

Примеры без пробелов также поддерживаются:

{{DISCIPLINE}}
{{DOC_NUM}}
{{D}}
{{LOCAL_TITUL}}
{{DOC_NAME}}
{{NAME_TITUL}}

Замены выполняются в основном тексте, таблицах, верхних и нижних колонтитулах, а также в XML-частях DOCX и пользовательских свойствах документа.

Получение LOCAL_TITUL, DOC_NAME и NAME_TITUL из MDR

Используются два раздела файла ref/mdr_reference.md:

## Список листов ОКРЧ из MDR
## Список шкафов

Для каждого DOC_NUM:

  1. В разделе Список листов ОКРЧ из MDR ищется строка с номером документа в 7-й колонке.
  2. Наименование титула берется из 2-й колонки и подставляется в NAME_TITUL.
  3. Название документа берется из 8-й колонки и подставляется в DOC_NAME.
  4. Последнее слово названия документа считается кодом шкафа.
  5. В разделе Список шкафов код шкафа ищется во 2-й колонке.
  6. Если код не найден, последнее слово считается словом, которое содержится в титуле в таблице шкафов (пунктуация игнорируется, регистр не важен), и строка ищется по нему.
  7. Название объекта берется из 5-й колонки и подставляется в LOCAL_TITUL.

Если соответствующая запись в MDR не найдена, скрипт выводит выделенное предупреждение и продолжает обработку. В этом случае значения DOC_NAME, LOCAL_TITUL и NAME_TITUL остаются пустыми.

Выходные файлы

Для каждого документа создается структура:

output\kj\<корень документа>\
├── SRC\
│   └── <номер документа>_A.docx
└── PDF\
    └── <номер документа>_A3.pdf

Например:

output\kj\01_B590.110900.1.6-СПД\SRC\01_B590.110900.1.6-СПД-КЖ08_A.docx
output\kj\01_B590.110900.1.6-СПД\PDF\01_B590.110900.1.6-СПД-КЖ08_A3.pdf

Проверка перед генерацией

Для просмотра списка документов без записи файлов:

python src\process_kj_docs.py --type электропроводки --rows 4-30 --dry-run

Для проверки только СПД и КСБ:

python src\process_kj_docs.py --type электропроводки --rows 4-30 --codes СПД,КСБ --dry-run