Слияние docx4j 17.3.5 в wordpdf-core и форк FO-рендерера 2.11-docx4j.8 в реактор
PR checks / web (pull_request) Successful in 38s
PR checks / java (pull_request) Successful in 18m31s

- wordpdf-core/src/main/java впитаны исходники docx4j-core, -export-fo,
  -chart-render, -JAXB-ReferenceImpl, -copy, -generated-objects (17.3.5) +
  сгенерированная XJC JAXB-модель; ресурсы — тем же путём; артефакты группы
  org.docx4j из внешних репозиториев больше не подключаются
- vendor/fop: форк docx4j-fo-renderer 2.11-docx4j.8 (util/events/core/fop)
  собирается в реакторе вместо jar из Nexus
- docx2fo.xslt перевендорен со стилем 17.3.5, оба AUDIT-FIX-патча перенесены;
  дрейф-гейт vendoredXsltTracksJarCopy зелёный
- upstream-тесты docx4j перенесены в src/test/java/org (658 классов, вне гейта);
  execution upstream-docx4j-tests в профиле upstream-tests (./mise.sh run
  upstream-tests, в pr.yml non-blocking шаг): 3470 тестов, 3457 зелёных,
  13 красных — категории окружения/калибровки хоста и следствий слияния
  classpath задокументированы в docs/agent/testing.md
- surefire: провайдер SLF4J фиксируется коротким slf4j.provider по execution;
  перенесён upstream logback.xml (root=DEBUG без конфига ломает visitor-экспорт
  VML); upstream-форки пинят JDK JAXP-фабрики; PMD/JaCoCo исключают org/**
- wordpdf-app: без изменений кода (зависит от слитого ядра); тесты 44/44
- документация синхронизирована (AGENTS.md, README, docs/agent/*), mise task
  upstream-tests
This commit is contained in:
Pjandro
2026-11-08 02:54:49 +00:00
parent f41ac54072
commit 8529b6877b
10191 changed files with 1694473 additions and 75 deletions
+4 -2
View File
@@ -2,7 +2,9 @@
### Счётчики (2026-11)
- 59 тестовых классов / 898 тестов: core 53/849 (`internal/doc/` 17/225, `internal/chart/` 17/271, `WordPdfConverterTest` 77), app 6/49 (ConvertController 23, ApiKeyFilter 8, ConversionService 5, ApiExceptionHandler 5, ConvertLimits 5, ConversionTimeout 3). Обновлять при изменении набора.
- 59 тестовых классов / 898 тестов гейта `verify`: core 53/849 (`internal/doc/` 17/225, `internal/chart/` 17/271, `WordPdfConverterTest` 77), app 6/49 (ConvertController 23, ApiKeyFilter 8, ConversionService 5, ApiExceptionHandler 5, ConvertLimits 5, ConversionTimeout 3). Обновлять при изменении набора.
- Перенесённый upstream-набор docx4j (`src/test/java/org`, ~660 классов) — вне гейта: execution `default-test` ограничен includes `ru/pjandro/wordpdf[/**]/*Test.java`, execution `upstream-docx4j-tests` (профиль `upstream-tests`, `./mise.sh run upstream-tests`) берёт `org/{docx4j,pptx4j,xlsx4j}[/**]/*Test(s).java` (кроме `**/samples/**`, `AbstractNumberingTest` — абстрактный базовый класс, и `Docx4jPropertiesFoFileTest` — читает `docx4j.properties` из корня classpath). Провайдер SLF4J фиксируется коротким `-Dslf4j.provider` в `argLine` каждого execution (simple / logback): длинный ключ `org.slf4j.provider` SLF4J 2.x не читает, фиксация молча игнорируется и побеждает service-discovery; часть upstream-тестов (`IntegerRangeReportTest`, `FontReportLogTest`, `CssLengthRangeWarnTest`, `ChartExDefectsTest`, `InspectRangesTest`) кастует логгер к logback — без пина они падали в simple-форке, и наоборот. Порта upstream-овского `logback.xml` (`src/test/resources/logback.xml`, из core-tests) обязателен: без конфига root logback = DEBUG, и DEBUG-only путь ломает visitor-экспорт VML textbox (`CTTextbox` marshal без `@XmlRootElement`); на тесты проекта конфиг не действует (пин simple), в test-jar не попадает (includes `ru/pjandro|samples|geom`). JAXP-фабрики upstream-форки пинят JDK-реализациями (как upstream `docx4j.properties`, который намеренно не портирован — он менял бы поведение всем тестам модуля): иначе `xercesImpl` из test-classpath перехватывает `DocumentBuilderFactory.newInstance()` и `ExtractionConformanceTest` падает на неподдерживаемом standalone-Xerces свойстве `accessExternalDTD`. **Ловушка plexus-паттернов: `**` не матчит ноль каталогов** — классы пакетов `ru/pjandro/wordpdf`, `org.docx4j`, `org.pptx4j`, `org.xlsx4j` добавлены отдельными паттернами; молчаливое исчезновение классов из прогона проверять диффом «`*Test.java` в дереве ↔ `in <класс>` в логе surefire» (так терялись `WordPdfConverterTest`/`WordPdfValidatorTest`).
- Триаж upstream-прогона (2026-11): 3470 тестов, 3457 зелёных, 54 skipped, 13 красных — гейтом не считаются (в CI `continue-on-error`, прогон отчётный). Категории: **окружение/калибровка хоста** — `ChartRenderGateTest#gate` (пиксельные метрики против эталонов Office на машине автора), `ChartAnchorSizeTest` ×3 и `ChartImagesTest` ×2 (размеры якорей из xlsx через метрики Calibri; на хосте подстановка Carlito/DejaVu), `FopConfigFamilyTripletTest#noFaceIsDeclaredUnderAnotherFacesFamily` (инвариант по системным шрифтам, ломает `wqy-zenhei.ttc`), `Phase3ProbeWordTest#wordsShapeSurvivesTheUpdaterWithoutPages`; **следствия слияния classpath** — `TocUpdateFacadeTest#pageNumbersWithoutAPaginator` (ждёт TocException «нет docx4j-export-fo», после слияния стилист всегда в ядре), `ChartCreatorHostTest#workbookAuthorAndTimes` и `ChartBoxTest#pptxSvgKeepsTheChartsFrame` (ждут `docx4j.dc.write=true`/`docx4j.DPI=96` из неперенесённого `docx4j.properties`), `MetafileHtmlTest#aDataUriHandlerEmbedsAPng` и `VmlObjectHtmlTest#aMetafilePreviewIsDrawn` (data-URI-рейстеризация metafile в HTML-экспорте, путь проектом не используется; файловый image-handler тот же metafile рейстеризует — соседние методы зелёные). Метод-уровневые `#`-исключения surefire запрещает POM («Method filter prohibited»), поэтому точечные красные методы остаются в отчёте.
### Пиксели, метрики шрифтов, стенд без fontconfig
@@ -29,7 +31,7 @@
Остальные пары `XxxNormalizerTest`↔`тест-в-конвейере` и юнит-перечисления воспроизводятся грепом по javadoc-ссылкам «Регрессия — Test#имя, фикстура …» (конвенция в AGENTS.md) и удалены отсюда намеренно. Здесь — только записи без javadoc-якорей:
- `lineRuleAuto_wordSingleLinePitch` — пинит метрический шаг «single» (13.4277pt) от псевдофиксов раскладки; `carlitoAutoBlock_untouched` — блок без явного `w:line` не трогается.
- `vendoredXsltTracksJarCopy` — дрейф-гейт: вне AUDIT-FIX-регионов вендорный `docx2fo.xslt` обязан быть побайтно равен стилисту из jar'а docx4j-export-fo (при апгрейде docx4j — перевендорить и перенести патчи).
- `vendoredXsltTracksJarCopy` — дрейф-гейт: вне AUDIT-FIX-регионов вендорный `docx2fo.xslt` обязан быть побайтно равен стилисту слитого export-fo (`org/docx4j/convert/out/fo/docx2fo.xslt` из classpath ядра; при апгрейде docx4j — перевендорить и перенести патчи).
- Крафт POIFS (закоммиченных фикстур нет, крафт продублирован в `WordPdfConverterTest`): `ListsTest`+`DocToDocxFormattingTest#list*`↔`docLists_numberingAndBulletsRendered` (синтетический .doc со списками → PDF: `1.` `2.` `a)` `b)` `•`, ни одного `#`; фикстур со списками нет — крафт POIFS продублирован в `WordPdfConverterTest`), `PrcDataTest`+`DocToDocxFormattingTest#hugePapxRowMark_closesRowWithGridFromPrcData` (TTP-абзац с grpprl в PrcData Data-потока → `w:tbl`/`w:tr`/сетка из цепочки; фикстуры нет — `docTest.doc` заказчика не коммитим, крафт POIFS продублирован), `SectionsTest`+`HeadersTest`+`DocToDocxFormattingTest#twoSections*/sectionBreakInTable*`↔`docMultiSection_perSectionHeaders` (двухсекционный .doc → PDF: стр. 1 — ШАПКА-1+ПОДВАЛ-1, стр. 2 — ШАПКА-2 + унаследованный ПОДВАЛ-1, ни одной `#`; крафт POIFS продублирован в `WordPdfConverterTest`), `ChpxIndexTest#zeroOffset_defaultPropsBoundaryKept`+`DocToDocxFormattingTest#runFlags_*/keepNextKeepLines_*/sectLandscapePgNumCols_*/sectUnevenCols_*/cellVertAlign_*/drawnObject_*`+`SectionsTest#orientationPgNumColumns_applied/unevenColumns_perIndexWidths/restartWithoutStart_clampsToOne`+`TablesTest#vertAlign_*`↔`WordPdfConverterTest#docClassD_landscapeHiddenDelCaps/#docClassD_pageNumberRestartLowerRoman/#docClassD_twoColumnsBreak/#docClassD_drawnObjectBecomesImage` (закрытие пробелов класса D: vanish-фильтр/правки/caps/position/keep, landscape+pgNumType, колонки+column break, vAlign, 0x08→inline-картинка; фикстур нет — крафт POIFS продублирован в обоих тестовых классах).
- Синтетика через общий хелпер `docx(docXmlns, body, sect, rels, overrides, parts)`: AUDIT-FIX-2↔`movedRevision_textPrinted`/`bdoDir_textPrinted` (фикстур нет — синтетический docx через общий хелпер `docx(docXmlns, body, sect, rels, overrides, parts)`); пиннинг аудита .docx↔`footnote_rendersAtPageBottom`, `endnote_rendersAtDocumentEnd`, `docxHyperlink_uriAnnotation`, `pageRefField_liveNotCached` (кэш 9001/7777 заменён живым номером), `dateField_notStaleCache` (кэш 01.02.2003 заменён текущей датой), `titlePg_firstPageHeader`, `vMergeCell_spansRows`, `sdtContent_rendered`, `drawingTextBox_textPrinted`, `ommlMath_drawnAsVectors` (пиксели: +150 тёмных px@150dpi сверх текста), `highlightAndShading_backgroundDrawn` (жёлтые px >0 против baseline 0), аудит [MS-DOC] моста 2026-11: `GrpprlTest#tInsertOperand_skippedBySpra`/`tInsertOperand_truncated_aborts` (sprmTInsert — 4 байта, хвост TAP не рассинхронизирован), `TablesTest#cellPadding_*` + `DocToDocxFormattingTest#cellMargins_becomeTcMar` ↔ `WordPdfConverterTest#tableTcMar_textInsetLikeWord` (CSSA→w:tcMar, пайплайн красит поля ячейки как tblCellMar — текст на margin+padding), `StylesTest#characterStyle_stk3_chainViaCharChain`/`charChain_nonCharacterStk_empty` + `DocToDocxFormattingTest#charStyle_viaIstd_mergesUnderDirect` (sprmCIstd: символьная chpx-цепочка между стилевой и прямыми, direct wins), `DocToDocxFormattingTest#runHighlightAndShading_inRPr`/`runShadingPattern_degradesToBackFill`/`paraShd_inPPrBeforeJc` ↔ `docHighlightAndShading_yellowPixels` (Ico→ST_HighlightColor; w:shd в форме FOP val="clear"+fill; паттерн→cvBack), `SectionsTest#titlePage_flagFromSepx` + `DocToDocxFormattingTest#titlePage_emittedAfterCols` ↔ `docTitlePage_firstHeaderOnlyFirstPage` (sprmSFTitlePage + first-слоты Plcfhdd → headerReference type="first", первая страница — только first-шапка)..
- App-регрессии: `requestLimitParams_areIgnored`, `nonPositiveLimits_failStartup`, `unknownPath_notFound`, `concurrentRequests_bothSucceed`, `corruptNotAZip_rejected`, `plainZipNotDocx_rejected`, `junkInsideValidZip_conversionError` (500 на валидном .docx-контейнере с мусором), `nonDocxFilename_rejected`, `oversizedOverCoreLimit_rejected`, `drawingsAlwaysRendered`, `cyrillicAndPathInFilename_sanitizedResponseName`, `docsOpenWithoutKey`/`forwardedPrefix_healthStaysOpen`/`forwardedPrefix_docsOpenWithoutKey`, `dotSegmentOpenPrefix_rejected`, `errorFlagNotBoolean_rejected`, `methodNotSupportedReturns405`/`badContentTypeReturns415`.