- 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
28 KiB
Repository Guidelines
Роутер: правила, инварианты и команды — здесь; глубокие детали —
docs/agent/*.md, нормативные форматы —docs/standards/(ссылка с номером секции обязательна), пользовательская документация —README.md.
Project Overview
Конвертер .docx/.doc → .pdf на чистом Java: docx4j 17.3.5 (исходники слиты в ядро, пакет org.docx4j.*) → XSL-FO → форк Apache FOP (vendor/fop, 2.11-docx4j.8, собирается из исходников), без LibreOffice/Aspose; Maven Central для группы org.docx4j не используется. Бинарный .doc (Word 97-2003) переносится мостом MS-DOC/MS-CFB (internal/doc) в in-memory .docx и идёт тем же конвейером. Java 17, только Maven.
| Модуль | Содержимое |
|---|---|
wordpdf-core |
библиотека: 4375 Java-файлов — наш код 62 (7 — публичный API, 16 internal/, 18 internal/doc/, 18 internal/chart/, 3 fonts/) + слитый docx4j 17.3.5 в org.docx4j.*/org.pptx4j.*/org.xlsx4j.*/org.glox4j.*/org.opendope.* (≈2.9 тыс. handwritten + ≈2.7 тыс. сгенерированная JAXB-модель); тесты: 53 проекта в ядре (+6 в app) + ≈660 перенесённых upstream-классов |
vendor/fop |
форк FO-рендерера org.docx4j:docx4j-fo-renderer{,-core,-events,-util}:2.11-docx4j.8 (plutext/xmlgraphics-fop), собирается из исходников; JAI 1.1.3 (compile-only) — бинарно в vendor/fop/lib/, ставится в локальный репозиторий родителем |
wordpdf-app |
REST API на Spring Boot 4.1.1: 11 классов, единственный public — WordPdfApplication |
wordpdf-web |
SPA (React 19 + TS + Vite + Tailwind), вне Maven-реактора, отдельный образ |
Единственный вход стека — gateway-контейнер nginx (:9010 prod-like compose.yml, :9011 dev compose.dev.yml), не 8080. Авторитетны этот файл, docs/agent/ и код. Полный путеводитель по каталогам, ключевым файлам и командам — docs/agent/repo-map.md.
Пайплайн WordPdfConverter.convert(byte[], String[, ConvertOptions])
Порядок шагов 0–7 фиксирован (convertToStream), местами менять нельзя. Вход роутируется по сигнатуре: PK\x03\x04 → docx-путь; D0 CF 11 E0 A1 B1 1A E1 (CFB, MS-CFB §2.2) → DocToDocx.convert → in-memory .docx → тот же конвейер (предикат — WordPdfValidator.isBinaryDoc). Валидация — до convertToStream: WordPdfValidator.validate(bytes, options) (размер → подпись zip/CFB → контейнер → страницы); для .doc — checkPageCountDoc по сырым байтам.
Порядок: шрифты (BundledFontMapper → BundledFonts.init → restrictToBundled) и правила 1–10 (DocxRewritePipeline.STEP) + OleObjectNormalizer — до WordprocessingMLPackage.load; FOSettings/FopFallbackFonts/LayoutPostRenderer — до setCustomXsltTemplates(VendoredXslt.TEMPLATES); Docx4J.toFO(…, FLAG_EXPORT_PREFER_XSL) — последним; finally → deleteEmbeddedFontTempFiles(). Полная таблица шагов и подсчёт страниц — docs/agent/pipeline.md.
Нормализаторы (internal/DocxNormalizer)
Контракт: byte[] normalize(byte[]) throws IOException; нечего менять → вернуть тот же массив (assertSame). Порядок фиксирован: Strict→OnOff→Symbol→Field→Invisible→GlyphCoverage→TableIndent→NumberingSuffix→Hidden→Ruby. Правила 1–10 применяет DocxRewritePipeline.STEP одним zip-проходом (неизменённые записи копируются raw-сжатыми байтами); OleObjectNormalizer (правило 11) — лямбдой в WordPdfConverter.normalizers(). STEP выставляют 9 из 10 rewrite-нормализаторов (нет у RubyNormalizer), у OleObjectNormalizer её нет. Правила 1–11, guard'ы, номера секций и инвариант mc-preprocessor.xslt (собственный рерайт strict-URI ломать нельзя) — docs/agent/pipeline.md.
Мост .doc → .docx (internal/doc)
18 классов, 16 package-private; наружу — DocToDocx (convert/countPages) и CfbReader. Общий разбор — DocFile: CFB → потоки WordDocument / 0Table|1Table / Data + FIB + piece table. Новых runtime-зависимостей нет (POI/POIFS — test-scope). Источники: [MS-DOC] (docs/standards/doc/), [MS-CFB]/[MS-OLEPS]/[MS-ODRAW] (docs/standards/binary/). Байтовые раскладки по классам — docs/agent/doc-bridge.md.
REST API (wordpdf-app, всё package-private кроме WordPdfApplication)
POST /api/v1/convert: multipart-поле file (.docx/.doc) + query/form-параметры errorOnCharts/errorOnSmartArt/errorOnOle (дефолты — WordPdfSettings.ERROR_ON_*). Ответ — application/pdf, Content-Disposition: attachment; filename*=UTF-8''…; имя — ConversionService.safeBaseName. Тело ошибки — {"error": …}. Error-флаги на .doc не срабатывают (BLIP-плейсхолдеры → картинки). ApiExceptionHandler не видит ошибок фильтров — 401 пишет сам ApiKeyFilter.
- Коды: 400 —
ValidationException/BadRequestException/битые параметры; 401 —ApiKeyFilter; 404/405/415 — путь/метод/content-type; 413 — multipart; 422 —DrawingRejectedException(core-DrawingFoundException,Kind {CHARTS, SMARTART, OLE}); 500/503/504 —ConversionFailedException/ConversionRejectedException/ConversionTimeoutException. Полная карта —docs/agent/repo-map.md. - Текст 422 — контракт с фронтом: «Конвертация отменена: в документе найдены диаграммы/найден SmartArt/найдены OLE-объекты».
- Ключ:
X-API-Key↔wordpdf.api-key(пустое = выключено); без ключа открыты толькоOPEN_PREFIXES(/actuator/,/swagger-ui,/v3/api-docs), пути с точечными сегментами — никогда. - Очередь и лимиты: конвертации сериализованы однопоточным
ThreadPoolExecutor(QUEUE_CAPACITY = 16, переполнение → 503) — ядро не потокобезопасно; головой очереди на старте стоитwarmup(). Лимиты входа — только конфигурация сервера (wordpdf.max-mb/max-pages, дефолты изWordPdfSettings; ≤ 0 →IllegalStateException; параметрами запроса не переопределяются). - SPA: вся сеть в
wordpdf-web/src/api.ts; ключ вlocalStorage(wordpdf.api.key);ApiKeyGate— только еслиprobeApiKey()подтвердил требование ключа (признак открытого сервера — 405); base —VITE_BASE; DropZone.docx,.doc.
Chart/SmartArt-движок (internal/chart, 18 классов)
Нормативный источник — ECMA-376 (docs/standards/ooxml/: графики §21.2, diagram-разметка §21.4, пресет-геометрия Annex D, XSD); поведение Word — ms-oi29500.md, ms-odrawxml.md. Калибровки (камера, PIE_DEPTH) меняются только с пиксельными тестами; невалидная фикстура правится, не код.
Java2D → PNG: ChartRenderer.DPI = 300, потолок MAX_PIXELS = 16_777_216 (fitDpi); лимиты ChartSpec.MAX_POINTS = 100_000, ChartRenderer.MAX_TICKS = 1000, DrawingPreRenderer.MAX_EXTENT_EMU = 22_000_000 — деградация «объект как есть / удалён + warn», не OOM. Chart-PNG вставляются media-частями вручную (addChartMedia, /word/media/chart-*, без createImagePart); ChartImageHandler отключает «Compress Pictures» (CR-029) только для них. Пейнтеры, autoTitleDeleted, Combo, обходы JAXB — docs/agent/chart.md.
Критические инварианты (нарушение = битый вывод, не исключение)
docx4j.convert.out.fo.gsubFeatures=false— static-блокWordPdfConverter; иначе FO невалиден →WordLayoutFixupsмолча отказывает всем фиксам → FOP падает наdocx4j-baseline.docx4j.fonts.discoverPhysicalFonts.enabled=falseиdiscoverJarFonts.enabled=false— static-блок: иначеBestMatchingMapperсканирует системные шрифты и jar'ы classpath'а, аrestrictToBundled()всё найденное выбрасывает (~100–140 мс впустую на JVM).discoverJarFonts("fonts-symbol")свойством не гейтится — символ-шрифт регистрируется и снимается restrict'ом как раньше.- Единственный XSL-FO-стилист — вендорный
xslt/docx2fo.xslt(копия из слитого docx4j-export-fo 17.3.5 — базаwordpdf-core/src/main/java/org/docx4j/convert/out/fo/docx2fo.xslt+ два AUDIT-FIX-патча:w:rPr/w:position→baseline-shift, Part 1 §17.3.2.24; AUDIT-FIX-2 —w:moveFrom/w:moveTo/w:bdo/w:dir, иначе их ловит catch-allmatch="*"и текст теряется). Дрейф-гейтvendoredXsltTracksJarCopy: вне AUDIT-FIX-регионов копия побайтно равна стилю из classpath (org/docx4j/convert/out/fo/docx2fo.xslt).setCustomXsltTemplatesпринимает предкомпилированныйTemplates. slf4j-simpleобязателен в ядре: без SLF4J-провайдера docx4j пишет «TO HIDE THESE MESSAGES» прямо в PDF (регрессияnoLoggingWarningInPdf); приложение исключает его — логи ведёт logback.- FOP — форк
org.docx4j:docx4j-fo-renderer*2.11-docx4j.8 (reactor-модульvendor/fop, собирается из исходников; версия пинится свойствомdocx4j.fo.renderer.versionв корневом pom; пакетыorg.apache.fop.*).FopFallbackFontsберётw:rendererс mimeapplication/pdf, иначе первый со шрифтами. BundledFonts.init()идемпотентен иsynchronized, распаковывает TTF вwordpdf-fonts-*(deleteOnExit);dropNonBundled()чиститPhysicalFontsот всего, что вне бандла.PhysicalFonts— глобальный и мутируемый → ядро не потокобезопасно; приложение сериализует конвертации одним воркером;warmup()идёт тем же потоком.- Страницы в валидаторе =
max(кэш docProps/app.xml, явные разрывы, lastRenderedPageBreak+1); правила StAX-подсчёта —docs/agent/pipeline.md. - Не чинить:
jc="distribute",suff="tab"/lvlJc, метрика «single», кернинг,framePr,REF/SEQ/TOC-кэш, руби-надстрочница, U+2188/U+218A — доказательства вdocs/agent/render-limitations.md. - Комментарии в
WordPdfConverter/DocxOnOffNormalizerговорят «docx4j 11.x» — устаревшее число, фактически 17.3.5 (описанное поведение верно). - PMD и JaCoCo ядра исключают
org/docx4j/**(иorg/pptx4j|org/xlsx4j/**) — слитый чужой код не линтеруется и не входит в порог покрытия.BundledFontsTest#listedFilesCoverAllTtfInResourcesберёт каталогfonts/от корня классов модуля, а не первым из classloader'а: после слиянияfonts/есть и в test-classes (upstream-шрифты тестов).
Шрифты (30 TTF + 3 лицензии, SIL OFL, wordpdf-core/src/main/resources/fonts/)
9 семейств: 7 × 4 начертания (Carlito/Caladea/Arimo/Tinos/Cousine/DejaVu Sans/DejaVu Serif) + Noto Naskh Arabic / Noto Sans Armenian (только regular). BundledFontMapper.ALIASES: Calibri→Carlito, Calibri Light→Carlito, Cambria→Caladea, Arial→Arimo, Times New Roman→Tinos, Courier New→Cousine; self-map всех бандл-семейств, включая Noto; fallback — DejaVu Sans; виртуальный SYMBOL_FONT «Segoe UI Symbol» (U+2000–U+2EFF) → fallback до основного цикла. Новый шрифт = файл + запись в BundledFonts.ENTRIES (синхрон проверяет BundledFontsTest). GlyphFont читает TTF напрямую с classpath через fontbox, без java.awt.Font (нужен fontconfig на хосте). Публичный API и детали — docs/agent/repo-map.md.
Команды
Бутстрап: sh bootstrap.sh (Windows: powershell -ExecutionPolicy Bypass -File .\bootstrap.ps1) — project-local mise в ./.mise/, дальше — ./mise.sh / .\mise.ps1.
./mise.sh run verify # = mvn clean verify: тесты + PMD + JaCoCo (гейт перед push)
mvn clean verify # то же; mvnw НЕТ — только системный Maven
mvn -pl wordpdf-core test -Dtest=WordPdfConverterTest#pageNumbers_recomputedNotCached # один тест
mvn -pl wordpdf-app -am test -Dtest=ConvertControllerTest#convertSample_returnsPdf # -am: core test-jar
mvn -pl wordpdf-app -am package # исполняемый jar бэкенда
java -jar wordpdf-app/target/wordpdf-app-1.0.0.jar # :8080, ключ выключен
curl -F "file=@doc.docx" http://localhost:8080/api/v1/convert -o doc.pdf
./mise.sh run upstream-tests # mvn -pl wordpdf-core -am test -Pupstream-tests (upstream-набор, не гейт; десятки минут)
./mise.sh run web-install|web-build|web-lint|web-dev # npm ci | tsc -b && vite build | oxlint | vite :5173
podman-compose -f compose.dev.yml up -d --build --force-recreate # dev-стенд :9011, без ключа
./mise.sh run prod-tests # прод-автотесты в prod-autotests/
python3 docs/standards/docx/validate-fixtures.py wordpdf-core/src/test/resources/samples/*.docx # XSD (lxml)
Задачи mise (9): verify, upstream-tests, app-package, app-run, web-install, web-build, web-lint, web-dev, prod-tests.
«Запусти тестовый сервер» (термин пользователя) = полный dev-стенд, НЕ java -jar: podman-compose -f compose.dev.yml up -d --build --force-recreate, вход http://<LAN-IP хоста>:9011 без API-ключа; гейт — контейнеры healthy + корень SPA отвечает 200. --force-recreate обязателен: без него контейнеры остаются на старом образе.
Пересоздание фикстур и перевендоривание стилиста — docs/agent/repo-map.md. Деплой: прод — на пользовательском LAN-сервере; перед деплоем/перезапуском прочитать /home/pjandro/prod/java-word-pdf/DEPLOY.md; пуск — push в main или Run workflow, ручных скриптов нет (детали — docs/agent/ci-cd.md).
Code Conventions & Common Patterns
- Классы
final, приватный конструктор, толькоstatic(stateless, DI нет; конфигурация —Docx4jProperties+ classpath-ресурсы). Исключения — экземпляры по природе:BundledFontMapper,DrawMlColor, Spring-компонентыwordpdf-app. - В
internal/**классыpublic(иначе родительский пакет не вызвал бы), но публичные члены наружу ограничены:normalize/STEP/declare/run/check/register;rewrite-хуки — package-private. Вwordpdf-appвсё package-private кромеWordPdfApplication; вinternal/docпубличны толькоDocToDocxиCfbReader. - Нормализаторы — единый контракт
internal/DocxNormalizer+ константаSTEP; порядок цепочки — см. «Нормализаторы», правятся толькоword/*.xml. - Ошибки публичного API — только
ConversionException extends RuntimeException(unchecked); внутренние исключения оборачиваются на границе. В chart — деградация вместо падения.ValidationException— собственностьWordPdfValidator; не оборачивать в общийConversionException. - DI в
wordpdf-app— конструкторная инъекция Spring; состояние сервисовprivate final. SPA: единственный источник состояния —useStateвApp.tsx, вся сеть — вapi.ts. - Javadoc на русском, объясняет «почему» и ссылается на регрессию и фикстуру (формат:
Регрессия — WordPdfConverterTest#имя, фикстура samples/….docx). - Константы UPPER_SNAKE с эталонными значениями (
PIE_DEPTH,MAX_PAGES); начертанияV_REGULAR/V_BOLD/V_ITALIC/V_BOLD_ITALIC; модели —record; размеры в chart — в пунктах, растр ×DPI/72. - Логирование:
java.util.logging.Loggerв корневом пакете иinternal/, SLF4J — вinternal/chartиwordpdf-app. - Тестовые методы: регрессионные —
объект_условиечерез underscore (ruPlain_cyrillicAndStyles), юниты — camelCase (pageFieldBecomesFldSimple); оба стиля разрешает PMD-паттернjunit5TestPattern(^[a-z][a-zA-Z0-9]*(_[a-zA-Z0-9]+)*$). - PMD (
pmd-ruleset.xml, executionpmd-checkнаverifyв обоих модулях,includeTests=true, валится нарушение любой приоритетности): полные исключения категории, кастомное XPath-правилоLiteralFirstInEqualsи настройки — в самом ruleset.
Runtime & Tooling
- Java 17 + Maven (обязательны; wrapper
mvnwНЕТ); UTF-8; только Maven — никаких Gradle/Ant. Инструменты (Java/Maven/Node/Python) ставит project-local mise (бинарь в.mise/, вне системы), версии пинятся в корневомmise.toml; ежедневный запуск —./mise.sh. - Версии зависимостей — только в корневом
pom.xml(properties + dependencyManagement), новые — latest stable; закреплённый список —docs/agent/repo-map.md. Maven-зависимости — через Nexusmaven-central: локально~/.m2/settings.xml(файл вне репо), CI/Containerfile —.ci/maven-settings.xml+MAVEN_MIRROR_URL(в Containerfile ARG пуст по умолчанию → settings не ставится, прямой Central; форк FOP и слитое ядро — reactor из дерева, из репозитория не тянутся). - Фронт: Node из engines vite/oxlint,
npm ciс закоммиченнымpackage-lock.json, TSstrictнигде не включён. Контейнеры (podman/buildah):FROMтолько FQDN, хостовые прокси-переменные обнулять на самой команде (RUN/HEALTHCHECK),DOCKER_BUILDKIT=0обязателен, fontconfig рантайму не нужен (глифы — fontbox). - Локальная проверка одна:
mvn clean verify(тесты + PMD + JaCoCo). Форматтеров и checkstyle для Java нет; статический линтер — PMD. Исполняемый jar проверять толькоjava -jar; нюансBundledFontsTest(file:-протокол classpath) —docs/agent/repo-map.md. - Git: origin
git.pjandro.ru:pjandro/java-word-pdf; защищённые ветки —main,master,dev. Все правки — через PR в дефолтную ветку; push — завершающим шагом задачи, только после./mise.sh run verify. - Прод-координаты и креды в коммитимые файлы не попадают (ни IP, ни хостов, ни пользователей, ни ключей): стенд — Gitea Actions Variables, креды — Secrets; workflow-файлы ссылаются только на
${{ vars.* }}/${{ secrets.* }}(список —GITEA-vars.md). Локальный.env(gitignored) — только дляcompose.yml.
CI/CD (Gitea Actions)
pr.yml (PR checks): job java (mvn -B -s .ci/maven-settings.xml clean verify через Nexus, затем non-blocking шаг upstream-набора -Pupstream-tests — отчёт, не гейт) + coverage-сводка и комментарий в PR, job web (npm ci → build → lint). main.yml: java/web → images-app/images-web (build+push в Nexus, теги prod + sha-<7>) → deploy (SSH, рендер прод-конфигов, гейты healthy) → autotests → rollback при провале. Нарратив — docs/agent/ci-cd.md.
Защита ветки main: required-контексты — PR checks / java (pull_request), PR checks / web (pull_request) (deploy/autotests в список не включать — на PR не бегут). Смена лимитов стенда = правка Variables, PR не нужен.
Testing & QA
- Гейты: PMD
maven-pmd-plugin3.28.0 (includeTests=true) и JaCoCo0.8.15(jacoco:checkнаverify) — LINE0.90(оба модуля), BRANCH0.85(только core); отчётreportраньшеcheck(target/site/jacoco/). В ядре оба гейта исключают слитый код<excludes>по пакетамorg/docx4j|glox4j|merlin|opendope|pptx4j|xlsx4j/**. Механика —docs/agent/repo-map.md. Плотность покрытия держат тесты, а не заглушки. - Перенесённые upstream-тесты docx4j (
src/test/java/org) в гейтverifyне входят: default-execution surefire ограничен includesru/pjandro/wordpdf/*Test.java+ru/pjandro/wordpdf/**/*Test.java(у plexus-паттернов**не матчит ноль каталогов — root-пакеты всегда отдельным паттерном, иначе классы корневого пакета молча выпадают из прогона); отдельный executionupstream-docx4j-testsв профилеupstream-tests(./mise.sh run upstream-tests). Провайдер SLF4J фиксируется системным свойствомslf4j.provider(неorg.slf4j.provider: SLF4J читает короткий ключ, с длинным фиксация молча игнорируется и побеждает service-discovery) вargLineкаждого execution (проекные тесты —slf4j-simple, upstream —logback, он test-зависимость для их 6 лого-тестов): иначе выбор провайдера в classpath непредсказуем иnoLoggingWarningInPdfнестабилен. Upstream-форки дополнительно пинят перенесённыйsrc/test/resources/logback.xml(без конфига root=DEBUG и этот путь ломает visitor-экспорт VML textbox) и JDK-реализации JAXP-фабрик (иначе standalonexercesImplс test-classpath перехватывает парсинг) — категории красных upstream-прогона и ловушки:docs/agent/testing.md. - Стек: JUnit 6 (
org.junit.jupiter), толькоAssertions— Mockito/AssertJ не использовать; в app-тестах допустим inline-HamcrestcontainsStringвandExpect; тестовые классы package-private, зеркалят main-пакеты. Счётчики —docs/agent/testing.md. - PDF сравнивается текстом, не растеризацией: PDFBox 3,
PDFTextStripper; негативные маркеры —.notdef(#) иHelvetica; текст нормализуется по пробелам (norm). Пиксельные проверки — только в юнитах chart-пейнтеров (допускиassertRatio< 0.06 / < 0.10). Детали —docs/agent/repo-map.md. - Регрессивная конвенция: фикс = нормализатор/рендерер + юнит + конвертер-тест; в javadoc фикса — ссылка «Регрессия — Test#имя, фикстура samples/…». Пары
XxxNormalizerTest↔тест-в-конвейеревоспроизводятся грепом по этим ссылкам; исключения —docs/agent/testing.md. - Фикстуры — только закоммиченные
samples/*.docx(13) +samples/*.doc(12), в тестах не генерировать; контракт нормализаторов «нечего менять → тот же массив» (assertSame) + неприкосновенность частей внеword/*.xml. - App-тесты:
@SpringBootTest+@AutoConfigureMockMvc(Boot 4:org.springframework.boot.webmvc.test.autoconfigure); четыре набора свойств = четыре контекста (отдельные классы, не@Nested);ConversionServiceTest/ApiExceptionHandlerTest— без Spring. Core-юниты Spring не поднимают; app-тесты проверяют только HTTP-код/заголовки/текст ошибки. Детали —docs/agent/testing.md. - Жизненный цикл: только
@Test; исключения — два@BeforeAll(прогрев шрифтов) и@AfterEach drainWorkerвConversionTimeoutTest. Ни@Nested, ни@ParameterizedTest, ни@Disabled, ниassertAll. - Идиомы загрузки фикстур: core — classloader без ведущего слэша, app — class-relative со слэшем (core test-jar). Синтетика: docx —
ZipOutputStream,.doc— крафтPOIFSFileSystem. - Сообщения ассертов — по-русски и с наблюдаемым значением; сравнение строк литерал-слева (
"%PDF".equals(...), PMDLiteralFirstInEquals); контракт идентичности —assertSame/assertNotSame. Общих test-util-классов нет: хелперы (norm,pdfText,assertRatio) намеренно продублированы. - Прод-автотесты: pytest + requests; под маркером
needs_keyбез ключа SKIP; конфигурация стенда только env (WORDPDF_BASE_URLобязателен). mvn testне запускает PMD и JaCoCo-гейты (оба наverify) — «зелёное» состояние проверяетсяmvn clean verify.mvn -pl wordpdf-appбез-amпадает: app зависит от core test-jar.