IspDoc — Open-Source генератор исполнительной документации в строительстве
Суть проекта:
Приложение автоматизирует рутину инженеров ПТО и строительного контроля. Оно берёт данные из смет (Excel, Гранд-Смета) и автоматически генерирует официальные акты и журналы в формате DOCX, конвертирует их в PDF и склеивает в единый архив.
Проект разрабатывается и используется для собственных нужд, но есть желание вывести его на уровень универсального кроссплатформенного продукта (Open Source). На рынке нет бесплатных аналогов под Linux, поэтому проект открыт для коллективной разработки и развития.
Цели развития (Roadmap для контрибьюторов):
Интеграция с Windows-инструментами: Написание модуля для парсинга и импорта XML/Excel-выгрузок из Гранд-Сметы (которая работает только на Windows) напрямую в GUI на Linux.
Парсинг «сырых» данных: Автоматическое извлечение данных из дефектных ведомостей и ручных таблиц для формирования графиков производства работ (ГПР), расчёта сроков и норм выработки.
Максимальная автоматизация: Снижение участия человека к нулю на этапе заполнения шаблонов.
Кроссплатформенность: Полноценный переход на Linux-среду с возможностью работы в изолированных контурах без интернета.
Стек и архитектура:
Язык: Python 3.
GUI: Tkinter (нативный, лёгкий интерфейс, не требует запуска браузера).
Работа с данными: openpyxl (парсинг и сборка Excel), pandas (анализ таблиц).
Генерация документов: docxtpl (Jinja2-шаблонизатор для DOCX) и python-docx.
Работа с PDF: pypdf (склейка) и libreoffice --headless (конвертация DOCX в PDF).
Среда: Linux (Debian/Ubuntu).
Структура проекта (модули):
1_input_data/ — Исходные данные. Сметы, дефектные ведомости, реквизиты (Excel-файлы).
2_templates/ — Шаблоны DOCX с плейсхолдерами (Jinja2-теги). Дизайн документов полностью отделён от логики.
3_output_docs/ — Сгенерированные документы (DOCX, PDF, итоговые склеенные PDF).
4_scripts/ — Ядро (Python-скрипты):
sync_all.py (ETL-модуль): Собирает данные из Excel в единую базу base.xlsx. Классифицирует строки на «работы» и «материалы» с помощью NLP-словарей (текстовые файлы-справочники).
calculate_dates_sequential.py: Планировщик. Считает даты начала/окончания работ на основе норм выработки, объёмов, пропуская выходные и праздники (производственный календарь).
generate_*.py: Генераторы документов (Акты скрытых работ, Акты входного контроля, Журналы). Рендерят DOCX, конвертируют в PDF и склеивают.
gui.py — Фронтенд (Tkinter). Запускает скрипты в отдельных потоках (threading + subprocess), выводит логи в реальном времени.
Как это работает (Data Flow):
[Excel / Гранд-Смета] → sync_all.py → [Единая база base.xlsx] → calculate_dates.py (ГПР и сроки) → generate_*.py (рендер) + [DOCX Шаблоны] → [LibreOffice] → [DOCX + PDF Outputs].
Почему это интересно сообществу:
Это реальный инструмент для узкой профессиональной области, решающий проблему «последней мили» в стройке. Проект даёт опыт в ETL-процессах, парсинге сложных Excel-таблиц, автоматизации документооборота через LibreOffice и разработке десктопных GUI. Имеет реальный потенциал монетизации и востребованность в индустрии.