v0.5.2

Что то сделал

PROJECT.md

@@ -14,7 +14,7 @@
 - оформляет DOCX стилями Times New Roman, полями 30/10/20/20 мм, интервалом 1.5;
 - нумерует рисунки, таблицы, листинги, формулы;
 - собирает содержание и список источников;
-- рисует UML / C4 / BPMN / Mermaid;
+- рисует UML / C4 / Mermaid;
 - проверяет структуру по ТЗ (`--check`);
 - при необходимости режет длинные таблицы и листинги через Microsoft Word и пишет «Продолжение…».
 
@@ -29,6 +29,7 @@
 | **md2gost** | `python -m md2gost` / `md2gost-gui` | `.docx` | основной путь, Word |
 | **md2fodt** | `python -m md2fodt` | `.fodt` | LibreOffice, без Word |
 | **md2latex** | `python -m md2latex` | каталог XeLaTeX (+ `--pdf`) | PDF через шаблон МИРЭА |
+| **word2md** | `python -m word2md` / `md2gost файл.docx` | `.md` | импорт DOCX → диалект md2gost |
 
 Общий диалект разметки: спецразделы `# *ВВЕДЕНИЕ`, метки `%id`, ссылки `@Рисунок:id`, таблицы с `^`/`>`, формулы `$$`, библиография `[n]: …`.
 
@@ -37,6 +38,7 @@
 - **md2gost** — полный конвейер (стили, профили, диаграммы, checker, GUI, Word COM).
 - **md2fodt** — v1: текст, заголовки, списки, таблицы с merge, картинки, листинги, простые ссылки, библиография. Нет PlantUML, нет «Продолжение таблицы», нет полного паритета PIS/АПИД.
 - **md2latex** — тот же диалект → `content.tex` + копия `latex/mirea/`. Таблицы идут в `longtable` с настоящим «Продолжение таблицы N» (это умеет LaTeX, не Word).
+- **word2md** — эвристический DOCX → диалект md2gost (стили Caption/Heading, подписи, таблицы, Code, формулы OMML). Не восстанавливает UML/Mermaid и исходные `%id`.
 
 ---
 
@@ -46,11 +48,12 @@
 pip install -e .
 python -m md2gost                          # GUI
 python -m md2gost report.md -o report.docx --type coursework --check
+python -m word2md report.docx -o report.md
 python -m md2fodt report.md -o report.fodt
 python -m md2latex report.md -o report_latex --pdf
 ```
 
-Windows exe: `build-exe.bat` → `dist\md2gost.exe` (двойной клик — GUI; из консоли работает как CLI).  
+Windows exe: `build-exe.bat` → `dist\md2gost.exe` (двойной клик — GUI; из консоли работает как CLI; перед сборкой тянет plantuml.jar и portable Graphviz).  
 Быстрая сборка: `build-exe-fast.bat` + `md2gost.fast.spec`.
 
 Для режима продолжения таблиц/листингов `word` (по умолчанию): Windows + Microsoft Word + `pip install pywin32` (опциональная группа `[word]`).
@@ -126,6 +129,10 @@ Windows exe: `build-exe.bat` → `dist\md2gost.exe` (двойной клик —
 | `--emdash-to-hyphen` | выкл. | «—» → «-» |
 | `--hr-pagebreak` | выкл. | `---` / `***` / `___` → разрыв страницы |
 | `--title` / `--assignment` | | DOCX титула и бланка задания (склейка через docxcompose) |
+| `--auto-title` / `--no-auto-title` | | автотитул из yaml/` ```title ` (по умолчанию выкл.) |
+| `--student` / `--group` | | ФИО и группа для автотитула (иначе `md2gost.user.json`) |
+| `--doc-author-from` / `--doc-author` | `os` / профиль | автор в свойствах DOCX: `os` (имя ОС), `student`, `custom` |
+| `--doc-title` / `--doc-subject` / `--doc-keywords` / `--doc-comments` / `--doc-category` / `--doc-last-modified-by` | см. профиль | остальные поля File → сведения; пустые comments — без штампа md2gost |
 | `--check` / `--check-only` / `--strict` | | проверка ТЗ; `--strict` → код выхода 1 при ошибках |
 | `--check-pages` | | полупустые страницы через Word COM (эвристика, не влияет на `--strict`) |
 | `--syntax-highlighting` | | Pygments в листингах |
@@ -150,6 +157,8 @@ Windowed exe: `_argv_needs_console()` + `_enable_windows_console()` — конс
 - зона Drop: перетаскивание `.md` (tkinterdnd2, иначе Win32 `WM_DROPFILES`, иначе клик → диалог);
 - основные параметры: тип, нумерация заголовков, TOC, continuation таблиц/листингов, тире, `---` → разрыв, проверки ТЗ, вёрстка, открыть после сборки;
 - **Настройки → Файлы**: шаблон, титул, задание, стили JSON, выходной путь;
+- **Настройки → Студент…**: ФИО и группа (первый запуск);
+- **Настройки → Метаданные…**: свойства DOCX (автор, название, тема, теги, примечание) в `md2gost.user.json`;
 - **Настройки → Диаграммы**: jar, Kroki, fallback, формат, масштаб, статус движка, скачать PlantUML, сброс кэша includes;
 - **Шаблоны UML**: CRUD схем (`md2gost.schemes.json`) — добавить / дублировать / удалить / сохранить / открыть JSON;
 - **Справка**: Инструкция, Документация (вшитые `docs/*.md`), Схемы, Промпт для ИИ (каталог `prompts/` + кнопки схем);
@@ -170,7 +179,7 @@ Windowed exe: `_argv_needs_console()` + `_enable_windows_console()` — конс
 | Таблица | `%id Подпись` перед таблицей | подпись «Таблица N — …» |
 | Merge ячеек | `^` rowspan, `>` colspan | OOXML `vMerge` / `gridSpan`; через разрыв страницы merge не переносится |
 | Листинг | `%id` + code fence | Courier New, опционально Pygments |
-| Диаграмма | `%id` + ` ```uml ` / `uml-c4` / `bpmn` / `mermaid` | Рисунок; флаги `+listing`, `+landscape` |
+| Диаграмма | `%id` + ` ```uml ` / `uml-c4` / `mermaid` / `idef0` / `dfd` | Рисунок; флаги `+listing`, `+landscape` |
 | Формула | `%eq1` + `$$…$$` + `@Формула:eq1` | номер только если есть ссылка |
 | Инлайн-формула | `$…$` | OMML в абзаце |
 | Ссылка на объект | `@Рисунок:id`, `@Таблица:id`, `@Листинг:id`, `@Формула:id` | подстановка номера |
@@ -187,7 +196,7 @@ Windowed exe: `_argv_needs_console()` + `_enable_windows_console()` — конс
 
 ### 5.5. Схемы и диаграммы
 
-Встроенные id (`md2gost/diagrams/schemes.json`): `c4`, `c4context`, `c4component`, `usecase`, `bpmn`.
+Встроенные id (`md2gost/diagrams/schemes.json`): `c4`, `c4context`, `c4component`, `usecase`.
 
 Слои загрузки (позже побеждает): встроенный шаблон → `md2gost.schemes.json` рядом с приложением (создаётся при первом запуске, не перезаписывается) → рядом с `.md` → `--schemes`.
 
@@ -197,7 +206,7 @@ Windowed exe: `_argv_needs_console()` + `_enable_windows_console()` — конс
 2. локальный Kroki (`KROKI_URL` / `--kroki-url`);
 3. `https://kroki.io` при `--diagram-fallback remote`.
 
-Mermaid — только Kroki. **IDEF0 / DFD конвертер не рисует** — только готовый PNG.
+Mermaid — локально (браузер / QuickJS) или Kroki. **IDEF0** — оградка ` ```idef0 `, локальный Pillow (рамка NIST). **DFD** — оградка ` ```dfd `, пакет [data-flow-diagram](https://github.com/pbauermeister/dfd) → вшитый/кэш/PATH Graphviz (`scripts/fetch_graphviz.py`, GUI «Скачать Graphviz») или Kroki.
 
 Кэш картинок: `{каталог_md}/.md2gost-cache/`.  
 Кэш `!include` URL: `md2gost.include-cache.json` + `include-cache/`.
@@ -252,6 +261,10 @@ DOCX сам не умеет писать «Продолжение Таблицы
 
 Если в документе нет TOC — номер ставится на единственную секцию.
 
+**Автотитул** (по умолчанию **выкл.**; CLI `--auto-title` / галочка в GUI; явный `--title` отключает генератор): см. [`docs/title.md`](docs/title.md). Кратко: `md2gost/title_page.py` заполняет bundled `TitleTemplate.docx` из `info_conv.yaml` и/или блока ` ```title `, ФИО/группа — `md2gost.user.json` или `--student`/`--group`. GUI: первый запуск и **Настройки → Студент…**.
+
+**Свойства DOCX** (после склейки титула, перед save): `doc_metadata.apply_document_metadata`. По умолчанию автор = `getuser()`, примечание «Создано при помощи md2gost (ТЗ МИРЭА)», created/modified = сейчас, revision = 1. GUI **Настройки → Метаданные…** / флаги `--doc-*`. Профиль — блок `metadata` в `md2gost.user.json`.
+
 ### 5.10. Приложения
 
 - Буквы: А Б В Г Д Е Ж И К … (без Ё З Й О Ч Ь Ы Ъ) — `APPENDIX_LETTERS` в `numberer.py`.
@@ -265,14 +278,16 @@ DOCX сам не умеет писать «Продолжение Таблицы
 | `prompts/generate-md.md` | диалект md2gost vs обычный MD |
 | `prompts/generate-mirea-report.md` | полный отчёт ГОСТ / МИРЭА |
 | `prompts/generate-pis-custom-report.md` | итоговый отчёт ПИС |
+| `prompts/emulate-student.md` | голос: человечный текст, не отчёт ИИ |
 
 В GUI: выбор промпта + чекбоксы схем → в конец дописываются `ai-prompt` и макросы из `md2gost.schemes.json` (`compose_prompt()`).
 
 ### 5.12. Сборка и поставка
 
 - `pyproject.toml`: hatchling, пакеты `md2gost`, `md2latex`, `md2fodt`; в wheel вшиваются Template.docx, mml2omml, diagrams, latex/mirea, prompts, docs.
-- `md2gost.spec` / `md2gost.fast.spec` — PyInstaller.
+- `md2gost.spec` / `md2gost.fast.spec` — PyInstaller (вшивают `plantuml.jar` и при наличии `vendor/graphviz`).
 - `scripts/fetch_plantuml.py` — скачать jar.
+- `scripts/fetch_graphviz.py` — скачать portable Graphviz в `md2gost/vendor/graphviz` (для DFD в exe).
 - `scripts/md2gost_exe.py` — обёртка exe.
 - `scripts/pyi_rth_mplbackend.py` — runtime hook matplotlib для PyInstaller.
 - `scripts/check_page_fill.bas` — макрос Word для той же эвристики вёрстки.
@@ -304,10 +319,21 @@ DOCX сам не умеет писать «Продолжение Таблицы
 - `default_output_path(filename)`, `timestamped_output_path(path)`, `default_template_path()`.
 - `open_document(path)` — macOS `open` / Windows `startfile` / `xdg-open`.
 - `_fix_front_matter_after_compose(...)` — сброс PAGE на титуле/задании, сквозная нумерация.
-- `convert(req, log=None)` — весь конвейер, ошибки в `ConvertResult`, не пробрасывает исключение наружу.
+- `convert(req, log=None)` — весь конвейер, ошибки в `ConvertResult`, не пробрасывает исключение наружу. Перед save — `apply_document_metadata`.
 - `should_launch_gui(filename, gui_flag)`.
 - `_CallbackLogHandler` — логи md2gost в GUI/CLI.
 
+**`md2gost/doc_metadata.py`**
+
+- `DocumentMetadata`, `DEFAULT_DOC_COMMENTS`, `AUTHOR_SOURCES`.
+- `os_user()`, `clip_core()` (лимит 255 символов python-docx).
+- `resolve_document_metadata(...)` — профиль + CLI/request.
+- `apply_document_metadata(document, meta)` — core properties + даты + revision=1.
+
+**`md2gost/user_profile.py`**
+
+- `UserProfile` (student, group, metadata), `load_user_profile` / `save_user_profile` → `md2gost.user.json`.
+
 **`md2gost/converter.py`**
 
 - класс `Converter`: читает md, применяет стили, парсит, нумерует, рендерит.
@@ -481,8 +507,13 @@ DOCX сам не умеет писать «Продолжение Таблицы
 - `prepare_source`, `render_diagram`.
 - `resolve_plantuml_jar`, `fetch_plantuml_jar`, `iter_plantuml_candidates`, `diagram_engine_status`.
 - рендер jar / Kroki / пара png+svg; масштаб `scale` в исходник PlantUML.
+- локальные типы `LOCAL_ONLY_TYPES` (`idef0`, `dfd`): Pillow, без jar/Kroki.
 
-**`md2gost/diagrams/`** — `schemes.json`, `BPMN.puml`, C4 `*.puml`.
+**`md2gost/idef0.py`** — DSL IDEF0 + Pillow/SVG.
+
+**`md2gost/dfd.py`** — обёртка [pbauermeister/dfd](https://github.com/pbauermeister/dfd): DSL → DOT → vendor/system Graphviz / Kroki (`write_dfd_outputs`, `fetch_graphviz`).
+
+**`md2gost/diagrams/`** — `schemes.json`, C4 `*.puml`.
 
 ### 6.8. Word COM и вёрстка
 
@@ -514,7 +545,7 @@ DOCX сам не умеет писать «Продолжение Таблицы
 **`md2gost/gui.py`**
 
 - `_make_root`, `_combo_values/_combo_key/_display`, `_Tooltip`, `_tip`.
-- `Md2GostApp`: меню, окна файлов/диаграмм/схем/справки, браузер docs, сборка промпта, DnD, `_collect()` → `ConvertRequest`, `_convert`.
+- `Md2GostApp`: меню, окна файлов/студента/метаданных/диаграмм/схем/справки, браузер docs, сборка промпта, DnD, `_collect()` → `ConvertRequest`, `_convert`.
 - `run_gui(initial)`, `main()`.
 
 **`md2gost/dnd.py`**
@@ -561,6 +592,27 @@ DOCX сам не умеет писать «Продолжение Таблицы
 
 ---
 
+## 8.1. word2md — импорт DOCX
+
+Пакет `word2md/`. Эвристика: стили md2gost, иначе ГОСТ-текст подписей/заголовков.
+
+| Файл | Роль |
+|------|------|
+| `__main__.py` | CLI: `.docx`, `-o`, `--media-dir`, `--keep-toc-pages`, `--pagebreaks` |
+| `pipeline.py` | `ImportRequest` / `ImportResult` / `convert_docx()` |
+| `walker.py` | обход body, склейка Code/списков, `postprocess_blocks` (продолжения) |
+| `classify.py` | Heading / Caption / Code / библио / спецразделы |
+| `captions.py` | `Рисунок` / `Таблица` / `Листинг` + `parse_caption_text` из md2gost |
+| `tables.py` | merge → `^`/`>`, детект формульной таблицы |
+| `omml.py` | OMML → читаемая формула |
+| `media.py` | выгрузка `word/media` |
+| `emit.py` | IR → диалект md2gost |
+| `refs.py` | `Рисунок 1.1` → `@Рисунок:fig1_1` |
+
+Точки входа также: `python -m md2gost report.docx`, GUI «Импорт DOCX→MD».
+
+---
+
 ## 9. Тесты — что покрыто
 
 Каталог `tests/`, CI гоняет `pytest`.
@@ -575,9 +627,12 @@ DOCX сам не умеет писать «Продолжение Таблицы
 | `test_landscape.py` | геометрия альбома, секции, картинки/таблицы/листинги, один section break |
 | `test_layout_tracker.py` | страницы и остаток высоты |
 | `test_paragraph.py` / `test_paragraph_sizer.py` | абзацы и измерение шрифта |
-| `test_diagram_renderer.py` | схемы, BPMN, кэш, mermaid, svg, jar, `+listing`/`+landscape` |
+| `test_diagram_renderer.py` | схемы, кэш, mermaid, svg, jar, `+listing`/`+landscape` |
+| `test_idef0.py` | DSL IDEF0, PNG/SVG, интеграция `render_diagram` |
+| `test_dfd.py` | DFD data-flow-diagram, mock Graphviz/Kroki, интеграция `render_diagram` |
 | `test_md2fodt.py` | escape, каркас FODT, запись файла |
 | `test_md2latex.py` | longtable continuation, генерация проекта |
+| `test_word2md.py` | подписи, спецзаголовки, @ссылки, продолжения таблиц, DOCX→MD, round-trip |
 | `extended_mardown/formula.py` | формулы (unittest) |
 
 Нет полного e2e «открыть Word и сравнить каждую страницу» в Linux CI (шрифты ставятся, Word COM — нет).
@@ -594,11 +649,12 @@ DOCX сам не умеет писать «Продолжение Таблицы
 | `docs/README.md` | оглавление docs |
 | `docs/quickstart.md` | установка, exe, типы |
 | `docs/markdown.md` | диалект |
-| `docs/schemes.md` | UML/Mermaid/BPMN, JSON схем |
+| `docs/schemes.md` | UML/Mermaid, JSON схем |
 | `docs/types.md` | профили работ |
 | `docs/cli-gui.md` | флаги ↔ GUI |
 | `docs/styles.md` | JSON стилей |
 | `docs/prompts.md` | ИИ-промпты |
+| `docs/word2md.md` | импорт DOCX → Markdown |
 | `md2gost/README.md` | справка пакета (подробнее про continuation и диаграммы) |
 | `prompts/README.md` | как копировать промпты |
 | `examples/example.md`, `examples/pis_custom.md` | образцы |
@@ -612,7 +668,7 @@ DOCX сам не умеет писать «Продолжение Таблицы
 
 Опционально: pywin32 (Word COM), matplotlib (сборка exe / отладка), tkinterdnd2 (удобный DnD в GUI).
 
-Внешние рантаймы: Java + plantuml.jar **или** Kroki; для PDF — XeLaTeX / latexmk и шрифт Times New Roman.
+Внешние рантаймы: Java + plantuml.jar **или** Kroki; Graphviz (вшитый/кэш/PATH) для DFD; для PDF — XeLaTeX / latexmk и шрифт Times New Roman.
 
 ---
 
@@ -626,13 +682,13 @@ DOCX сам не умеет писать «Продолжение Таблицы
 - `Other_Code/` — справка OOXML, docx-js, скрипты pack/unpack/validate (не импортируется md2gost);
 - артефакты сборки `build-fast/`, кэши диаграмм.
 
-`todo.txt` сейчас: «ожидаем BPMN в mermaid» и «оценки с текстом через сам Word, а не предугадывание» — второе частично закрыто режимом `word`.
+`todo.txt` сейчас: «оценки с текстом через сам Word, а не предугадывание» — частично закрыто режимом `word`.
 
 ---
 
 ## 13. Чего нет / ограничения (честно)
 
-- IDEF0 и DFD конвертер не рисует.
+- DFD: пакет `data-flow-diagram` в зависимостях; картинка — вшитый/кэш/PATH Graphviz или Kroki; балансировка уровней не проверяется.
 - FODT и LaTeX не догоняют md2gost по GUI, checker, схемам, профилям PIS/АПИД, Word COM.
 - «Продолжение таблицы» в чистом DOCX без Word невозможно точно (нет longtable). Без Word — `off` или неточный `legacy`/`caption`.
 - `--check-pages` даёт ложные срабатывания; это эвристика.
@@ -649,7 +705,7 @@ DOCX сам не умеет писать «Продолжение Таблицы
 2. **ВКР:** раздельный список, ссылки `[1.5]`, приложение «Графический материал».
 3. **ПИС:** `# Практическая работа №1. …` → `--type PIS_custom`, сквозные Рисунок 1, 2, 3.
 4. **АПИД:** обязательные 2 главы и 2.1–2.4, источники 7–20.
-5. **UML в отчёте:** `%id Подпись` + ` ```uml-c4 ` / ` ```bpmn ` — PNG/SVG в Word, опционально `+listing` и `+landscape`.
+5. **UML в отчёте:** `%id Подпись` + ` ```uml-c4 ` — PNG/SVG в Word, опционально `+listing` и `+landscape`.
 6. **Широкая таблица:** `%id … +landscape`.
 7. **Длинная таблица на Windows:** режим `word` → COM режет и пишет «Продолжение Таблицы N».
 8. **Свой вуз/кафедра:** `md2gost.styles.json` меняет поля и H1 без правки кода.