diff --git a/.dockerignore b/.dockerignore index 3089c6c..fa8567b 100644 --- a/.dockerignore +++ b/.dockerignore @@ -10,3 +10,7 @@ dependency-reduced-pom.xml wordpdf-web/node_modules wordpdf-web/dist .env +.venv/ +/.mise/ +__pycache__/ +.pytest_cache/ diff --git a/.gitea/workflows/main.yml b/.gitea/workflows/main.yml index 092faee..eed2a6b 100644 --- a/.gitea/workflows/main.yml +++ b/.gitea/workflows/main.yml @@ -210,6 +210,7 @@ jobs: REGISTRY_USER: ${{ secrets.REGISTRY_USER }} REGISTRY_PASSWORD: ${{ secrets.REGISTRY_PASSWORD }} WORDPDF_API_KEY: ${{ secrets.WORDPDF_API_KEY }} + DEPLOY_KNOWN_HOSTS: ${{ secrets.DEPLOY_KNOWN_HOSTS }} steps: - name: Check deploy vars and secrets run: | @@ -217,7 +218,7 @@ jobs: for v in DEPLOY_HOST DEPLOY_USER DEPLOY_DIR REGISTRY WORDPDF_MAX_MB WORDPDF_MAX_PAGES; do [ -n "${!v}" ] || { echo "Задайте Actions Variable $v — см. GITEA-vars.md" >&2; missing=1; } done - for s in DEPLOY_SSH_KEY REGISTRY_USER REGISTRY_PASSWORD WORDPDF_API_KEY; do + for s in DEPLOY_SSH_KEY REGISTRY_USER REGISTRY_PASSWORD WORDPDF_API_KEY DEPLOY_KNOWN_HOSTS; do [ -n "${!s}" ] || { echo "Задайте Actions Secret $s — см. GITEA-vars.md" >&2; missing=1; } done exit "$missing" @@ -230,6 +231,9 @@ jobs: # Ключ API в файл не пишется: compose интерполирует его из окружения деплоя. - name: Render prod stack files run: &render-stack-files | + set -euo pipefail + # (якорь общий с rollback; команды шага — heredoc'и в кавычках и + # ||-цепочка pip — pipefail-safe) cat > docker-compose.yml < "$HOME/.ssh/id_deploy" chmod 600 "$HOME/.ssh/id_deploy" - set -- -i "$HOME/.ssh/id_deploy" -o StrictHostKeyChecking=accept-new + # host-key pinning: пустой секрет → пустой known_hosts → ssh падает на + # StrictHostKeyChecking=yes ДО передачи секретов (fail-closed) + printf '%s\n' "$DEPLOY_KNOWN_HOSTS" > "$HOME/.ssh/known_hosts" + chmod 600 "$HOME/.ssh/known_hosts" + set -- -i "$HOME/.ssh/id_deploy" -o UserKnownHostsFile="$HOME/.ssh/known_hosts" -o StrictHostKeyChecking=yes D=$(printf '%q' "$DEPLOY_DIR") H="$DEPLOY_USER@$DEPLOY_HOST" ssh "$@" "$H" "umask 077; mkdir -p $D && cat > $D/docker-compose.yml" < docker-compose.yml @@ -435,6 +446,9 @@ jobs: WORDPDF_MAX_PAGES: ${{ vars.WORDPDF_MAX_PAGES }} DEPLOY_SSH_KEY: ${{ secrets.DEPLOY_SSH_KEY }} WORDPDF_API_KEY: ${{ secrets.WORDPDF_API_KEY }} + DEPLOY_KNOWN_HOSTS: ${{ secrets.DEPLOY_KNOWN_HOSTS }} + REGISTRY_USER: ${{ secrets.REGISTRY_USER }} + REGISTRY_PASSWORD: ${{ secrets.REGISTRY_PASSWORD }} steps: # Конфиг рендерится заново (тот же шаг, что у deploy) и перезаливается: откат # не зависит от того, что осталось на хосте после упавшего деплоя (рег. run 482: @@ -449,13 +463,16 @@ jobs: mkdir -p "$HOME/.ssh" && chmod 700 "$HOME/.ssh" printf '%s\n' "$DEPLOY_SSH_KEY" > "$HOME/.ssh/id_deploy" chmod 600 "$HOME/.ssh/id_deploy" - set -- -i "$HOME/.ssh/id_deploy" -o StrictHostKeyChecking=accept-new + # host-key pinning, как в deploy (fail-closed на пустом секрете) + printf '%s\n' "$DEPLOY_KNOWN_HOSTS" > "$HOME/.ssh/known_hosts" + chmod 600 "$HOME/.ssh/known_hosts" + set -- -i "$HOME/.ssh/id_deploy" -o UserKnownHostsFile="$HOME/.ssh/known_hosts" -o StrictHostKeyChecking=yes D=$(printf '%q' "$DEPLOY_DIR") H="$DEPLOY_USER@$DEPLOY_HOST" ssh "$@" "$H" "umask 077; mkdir -p $D && cat > $D/docker-compose.yml" < docker-compose.yml { - printf 'export DEPLOY_DIR=%q REGISTRY=%q WORDPDF_API_KEY=%q\n' \ - "$DEPLOY_DIR" "$REGISTRY" "$WORDPDF_API_KEY" + printf 'export DEPLOY_DIR=%q REGISTRY=%q REGISTRY_USER=%q REGISTRY_PASSWORD=%q WORDPDF_API_KEY=%q\n' \ + "$DEPLOY_DIR" "$REGISTRY" "$REGISTRY_USER" "$REGISTRY_PASSWORD" "$WORDPDF_API_KEY" cat <<'REMOTE' set -euo pipefail cd "$DEPLOY_DIR" @@ -466,6 +483,11 @@ jobs: . ./.rollback.env podman tag "$PREV_APP" "$REGISTRY/wordpdf-app:prod" podman tag "$PREV_WEB" "$REGISTRY/wordpdf-web:prod" + # реестр :prod обязан соответствовать откаченному ранящемуся образу: + # иначе ручной pull/пересборка стека вернёт битый билд + printf '%s' "$REGISTRY_PASSWORD" | podman login "$REGISTRY" --username "$REGISTRY_USER" --password-stdin + podman push "$REGISTRY/wordpdf-app:prod" + podman push "$REGISTRY/wordpdf-web:prod" timeout 90 podman-compose up -d --force-recreate app web for _ in $(seq 1 30); do [ "$(podman inspect -f '{{.State.Health.Status}}' wordpdf-prod-app-1)" = healthy ] && break diff --git a/.mvn/.gitkeep b/.mvn/.gitkeep new file mode 100644 index 0000000..e69de29 diff --git a/AGENTS.md b/AGENTS.md index 579f593..a1a8763 100644 --- a/AGENTS.md +++ b/AGENTS.md @@ -11,7 +11,7 @@ Наружу `WordPdfValidator.validate(docxBytes, options)` (размер → zip-подпись `PK\x03\x04` → контейнер (.docx-манифест + zip-бомба) → страницы) вызывается **до** приватного `convertToStream`; внутри `convertToStream`: 1. `new BundledFontMapper()` → `BundledFonts.init()` → `BundledFonts.restrictToBundled()`. Конструктор маппера каждый раз добавляет системные шрифты в реестр `PhysicalFonts`; ключ реестра — имя из name-таблицы TTF, `addPhysicalFont(URI)` не перезаписывает занятый → `init()` вызывает `dropNonBundled()` **до** регистрации и `load()` (иначе системный Calibri ломает em-dash-fallback). -2. Нормализация байтов docx до JAXB-загрузки — цепочка `List normalizers(options)` (`@FunctionalInterface internal/DocxNormalizer`: `byte[] normalize(byte[]) throws IOException`, контракт — нечего менять → **тот же массив**; каждый нормализатор выставляет константу `STEP`, порядок значим): `StrictOoxmlNormalizer` (strict-OOXML → transitional-байт: `a:`-проценты и `w14:fillToRect` → тысячные ×1000, текст `wp14:pctWidth`/`pctHeight`, элементы и атрибуты `w:start`/`w:end` → `w:left`/`w:right` (кроме `w:lvl/w:start` в numbering.xml), значения `start`/`end` у `w:jc`/`w:tab`; в `mc-preprocessor.xslt` docx4j ветка `%` закомментирована, start/end не маппятся; namespaces и `pt`-значения правит сам mc-preprocessor — собственный рерайт URI ломает его pt-конверсию) → `DocxOnOffNormalizer` (`w:val="off"/"on"` → `false`/`true`) → `SymbolFontNormalizer` (PUA U+F0xx Symbol/Wingdings/Webdings → Unicode + DejaVu Sans, переписывает и элементы ``, правит `w:lvl` в numbering.xml; 5 карт по 256 слотов, таблица `SymbolMapper` сгенерирована из docx4j 17.x) → `FieldNormalizer` (`fldChar` PAGE/NUMPAGES/SECTIONPAGES → `w:fldSimple`, вложенные/битые поля пропускает) → `InvisibleCharNormalizer` (вырезание из `w:t` U+0085/U+2028/U+2029/U+2060/U+FEFF/bidi-меток — FOP делает из них переносы/пустые строки, Arimo/Tinos рисуют боксы; U+00A0/U+00AD/U+200B–U+200D НЕ трогает) → `GlyphCoverageNormalizer` (режет ран по покрытию глифов, пишет семейство в `w:rFonts`, иначе FOP рисует «#»; покрытие — `GlyphFont` (fontbox, cmap) + BitSet-кэш, НЕ docx4j `GlyphCheck` — тот плодит INFO-лог, `java.awt.Font` требовал fontconfig на хосте; для serif-ран fallback ищется сначала в `SERIF_FAMILIES` (DejaVu Serif/Tinos/Caladea), затем в sans) → `OleObjectNormalizer` (принимает флаг `errorOnOle`: OLE-bin-части — детекция по `[Content_Types].xml`: тип `…oleObject` ИЛИ ложный `+xml`-тип у `.bin` (XML в bin не бывает; printerSettings не трогается) — удаляются вместе с rels-ссылками (TargetMode=External не трогается), элементами `` из `word/*.xml` и Override удалённых частей; при `errorOnOle=true` вместо удаления — `DrawingFoundException(OLE)`. Лечит оба механизма падения docx4j: JAXB-парсинг бинарника под ложным XML-типом («Content is not allowed in prolog» → NPE) и NPE `chunkType is null` в VML-сериализации `w:object` при честном типе; многочастный — публичный член только `normalize(byte[], boolean)`, `rewrite`-хука нет) → `WordprocessingMLPackage.load`. +2. Нормализация байтов docx до JAXB-загрузки — цепочка `List normalizers(options)` (`@FunctionalInterface internal/DocxNormalizer`: `byte[] normalize(byte[]) throws IOException`, контракт — нечего менять → **тот же массив**; каждый нормализатор выставляет константу `STEP`, порядок значим): `StrictOoxmlNormalizer` (strict-OOXML → transitional-байт: `a:`-проценты и `w14:fillToRect` → тысячные ×1000, текст `wp14:pctWidth`/`pctHeight`, элементы и атрибуты `w:start`/`w:end` → `w:left`/`w:right` (кроме `w:lvl/w:start` в numbering.xml), значения `start`/`end` у `w:jc`/`w:tab`; рерайт только strict-документов (содержат `purl.oclc.org`), а при уже присутствующем transitional-URI в документе — никакого рерайта (guard сосуществования форм — `transitionalCoexistReturnsOriginalArray`); в `mc-preprocessor.xslt` docx4j ветка `%` закомментирована, start/end не маппятся; namespaces и `pt`-значения правит сам mc-preprocessor — собственный рерайт URI ломает его pt-конверсию) → `DocxOnOffNormalizer` (`w:val="off"/"on"` → `false`/`true`, якорь по тегу — только атрибут `w:val`, текст между тегами не трогается) → `SymbolFontNormalizer` (PUA U+F0xx Symbol/Wingdings/Webdings → Unicode + DejaVu Sans, переписывает и элементы ``, правит `w:lvl` в numbering.xml; 5 карт по 256 слотов, таблица `SymbolMapper` сгенерирована из docx4j 17.x) → `FieldNormalizer` (`fldChar` PAGE/NUMPAGES/SECTIONPAGES → `w:fldSimple`, вложенные/битые поля пропускает) → `InvisibleCharNormalizer` (вырезание из `w:t` U+0085/U+2028/U+2029/U+2060/U+FEFF/bidi-меток — FOP делает из них переносы/пустые строки, Arimo/Tinos рисуют боксы; U+00A0/U+00AD/U+200B–U+200D НЕ трогает) → `GlyphCoverageNormalizer` (режет ран по покрытию глифов, пишет семейство в `w:rFonts`, иначе FOP рисует «#»; покрытие — `GlyphFont` (fontbox, cmap) + BitSet-кэш, НЕ docx4j `GlyphCheck` — тот плодит INFO-лог, `java.awt.Font` требовал fontconfig на хосте; для serif-ран fallback ищется сначала в `SERIF_FAMILIES` (DejaVu Serif/Tinos/Caladea), затем в sans) → `OleObjectNormalizer` (принимает флаг `errorOnOle`: OLE-bin-части — детекция по `[Content_Types].xml`: тип `…oleObject` ИЛИ ложный `+xml`-тип у `.bin` (XML в bin не бывает; printerSettings не трогается) — удаляются вместе с rels-ссылками (TargetMode=External не трогается), элементами `` из `word/*.xml` и Override удалённых частей; при `errorOnOle=true` вместо удаления — `DrawingFoundException(OLE)`. Лечит оба механизма падения docx4j: JAXB-парсинг бинарника под ложным XML-типом («Content is not allowed in prolog» → NPE) и NPE `chunkType is null` в VML-сериализации `w:object` при честном типе; многочастный — публичный член только `normalize(byte[], boolean)`, `rewrite`-хука нет) → `WordprocessingMLPackage.load`. 3. `WordPdfValidator.checkPageCount(docxBytes, maxPages)` — **до** рендера, lightweight (zip/StAX) по нормализованным байтам — тот же путь, что у приложения до очереди. 4. `pkg.setFontMapper(mapper)` → `DrawingPreRenderer.run(pkg, options)` (шаг 3.5: `c:chart`/`dgm:relIds` docx2fo.xslt не умеет — свой Java2D-движок `internal/chart/*` рендерит в PNG 300 dpi и подменяет на `pic:pic`; объекты конвертируются всегда, отказ только по error-флагу `ConvertOptions` — `DrawingFoundException`; упавший рендер — объект **удаляется** из docx (`gd.getAny().clear()`) + warn, деградация не падение). 5. `new FOSettings(pkg)` + `FopFallbackFonts.declare` (декларирует **все** бандл-семейства — FOP встраивает только задекларированные) → `FORendererApacheFOP`/`FOUserAgent` (непустой `title` → заголовок PDF) → `Docx4J.toFO(..., FLAG_EXPORT_PREFER_XSL)`. @@ -30,7 +30,7 @@ Нормативный источник любых правок/решений по диаграммам и SmartArt — ECMA-376 (`docs/standards/`: графики §21.2, diagram-разметка §21.4, пресет-геометрия Annex D + полные наборы XSD `schema/strict/`/`schema/transitional/`; соответствие фикстур схемам проверяет `docs/standards/validate-fixtures.py` — см. README; поведение Word — `ms-oi29500.md`, `ms-odrawxml.md`), а не догадки по исходникам LibreOffice/Word-эмпирике; эмпирические калибровки (камера, `PIE_DEPTH`) менять только вместе с пиксельными тестами. Формулировки из стандарта при ссылке — с номером секции (§21.2.2.132 и т.п.). Фикстуры могут быть невалидны — код под фикстуру не правится, правится фикстура (после проверки по XSD/секции). -Java2D → PNG 300 dpi (`ChartRenderer.DPI = 300`, `PADDING = 4.0`, растр × `DPI/72`, размеры — в пунктах, EMU→pt `cx/12700.0`). `ChartSpec.parse` (`enum Type`: PIE/PIE3D/DOUGHNUT/BAR/BAR_HORIZONTAL/LINE/AREA/SURFACE3D/SCATTER/BUBBLE/RADAR/STOCK/OF_PIE/SURFACE/BAR3D/AREA3D/LINE3D/UNSUPPORTED; пустой `c:title` + `autoTitleDeleted="0"` → у **круговых** имя первого ряда, у прочих — `AUTO_TITLE = "Название диаграммы"` (русская замена англ. плейсхолдеру Word); палитра `accent1..6` темы, легенда по умолчанию снизу (у SURFACE — полосы высот «0-1»…), позиция `t` поддержана, `overlay` (§21.2.2.132) → рисуется поверх области построения, место не резервирует (`ChartSpec.legendOverlay`, регрессия `ChartRendererTest#overlayLegend_drawnOverPlot`)) → `ChartRenderer` (осевые «круглые» шаги `niceUnit` 1/2/5·10ⁿ как Word; санитайзер `c:majorUnit` — `MAX_TICKS = 1000`: шаг ≤ 0/NaN/слишком мелкий в `axisBounds` заменяется niceUnit, иначе циклы делений вечные; общие кумулятивные хелперы stacked `isStacked`/`stackedCumulative`/`stackedRange`) → пейнтеры `CartesianPainter` (2-D line/bar/area; lineChart `c:grouping` stacked/percentStacked §21.2.2.76 — ряд рисуется на накопленной сумме через `ChartRenderer.stackedCumulative`, регрессии `stackedLine_seriesStackCumulatively`/`percentStackedLine_topSeriesFlatAtHundred`)/`PiePainter` (`PIE_DEPTH=0.22`, `PIE_FIT=0.865`)/`Surface3dPainter` (калибровка по эталону Word 300 dpi, камера — регрессия `cameraMatchesWordReference`: `DEPTH_RATIO=0.705`, `HEIGHT_RATIO=0.664`, `GUTTER_LEFT/RIGHT=0.1485`, `GUTTER_TOP=0.116`, `GUTTER_BOTTOM=0.146`, свет `LIGHT_X/Y/Z=0.83/0.48/0.28`, `c:rAngAx=true` во всех 3D-пейнтерах имеет приоритет над `c:perspective` (MS-OI29500 §2.1.1516(b)), `c:hPercent` сжимает глубину, `c:wireframe` §21.2.2.205 — только каркас без полос высот, bandFmt-полосы сортируются по глубине)/`ScatterPainter` (scatter/bubble: обе оси числовые, две `c:valAx`, X — первая; маркеры по `c:marker`, `c:scatterStyle` §21.2.2.136; радиус пузыря sqrt при `c:sizeRepresents="area"` §21.2.2.128 и линейно при «w», масштаб `c:bubbleScale`)/`RadarPainter` (спицы от 12 часов по часовой, `c:radarStyle` §21.2.2.119 standard/marker/filled, сетка — концентрические многоугольники)/`StockPainter` (high-low-close: `c:hiLowLines`/`c:upDownBars`/`c:dropLines`; цвета — дефолты UI Word, эмпирика запинена тестом)/`OfPiePainter` (главный пирог, замкнутый «Other»-сектором — MS-OI29500 §2.1.1507(a), обращён центром к 3 часам ко вторичной, цвет — следующая ротация палитры; пара пирогов центрирована, зазор `GAP_FIT=0.25·d1` — Word-эмпирика; вторичный пирог/стек, разбиение по `c:splitType` §21.2.2.155 (splitPos — MS-OI29500 §2.1.1554a/b), вторичный пирог стартует от конца «Other»-сектора; `c:serLines` — ровно две связи от границ «Other»-сектора к ободу вторичного на 270°±wedgeSweep / левым углам столбца — MS-OI29500 §2.1.1545(a))/`Surface2dPainter` (контурная карта §21.2.2.204: полосы высот между ломаными соседних рядов §21.2.2.13, передняя стенка — полоса значения переднего края; `c:wireframe` §21.2.2.230 — вид сверху (X=категории, Y=ряды, серия 0 внизу) без заливок: изолинии на границах полос высот `lo+k·unit` цветом нижней полосы (c:bandFmts §21.2.2.13/.14, без них — палитра), marching squares, седло — по среднему ячейки; сетка catAx/serAx, рамка plot; ось значений не рисуется)/`Cartesian3dPainter` (bar3D/line3D/area3D §21.2.2.19/.101/.122 — камера `Surface3dPainter.project`, ряды уходят в глубину; bar3D: `c:shape` box/cone/cylinder/pyramid + `*ToMax` §21.2.3.44 (per-series `c:shape` переопределяет диаграммный, горизонтальная ориентация — всегда box), `c:grouping` stacked/percentStacked §21.2.2.76 (одна полоса глубины на категорию, сегменты столбиком, percent — нормировка к 100%; area3D stacked — полосы на стене v=0, line3D grouping игнорирует), `c:gapDepth` — MS-OI29500 §2.1.1474, подписи serAx рисуются, `c:delete` осей учитывается); `SmartArtRenderer` рисует кэш разложенной схемы (relationship `…/office/2007/relationships/diagramDrawing`, фактически `word/diagrams/drawing1.xml`), формы строит `PresetGeometry` — ECMA-пресет-геометрия `a:prstGeom`: avLst/gdLst/pathLst семи пресетов (rect, roundRect, ellipse, gear6, gear9, circularArrow, leftCircularArrow) дословно из `presetShapeDefinitions.xml`, вычислитель префиксных формул; оператор `?:` = «if x > 0 then y else z» (ISO/IEC 29500-1, НЕ x != 0), углы в Arc2D передавать со знаком минус (математическая конвенция y вверх), неизвестный пресет → прямоугольник ячейки (синхрон таблицы со стандартом пинит `PresetGeometryTest#tableMatchesEcmaXml`); палитра темы — `DrawMlColor` (instance; без ThemePart — дефолтная Office-палитра `accent1=4472C4`…); текст — `DrawMlText` (шрифты — тот же бандл через `BundledFontMapper.bundledFamily`); утилиты `RgbHsl`. Калибровочные константы менять только вместе с `Surface3dPainterTest`/`PiePainterTest`. Защитные лимиты против враждебного chart-XML: `ChartSpec.MAX_POINTS` (`c:pt/@idx` §21.2.2.150/.151 и `c:ptCount` §21.2.2.152 — ST_UnsignedInt без верхней границы, отказ `IllegalArgumentException` до предвыделения списка) и `MAX_TICKS` (см. выше); бросок перехватывает catch `DrawingPreRenderer.renderChart` → штатная деградация «объект удалён + warn». Обход `pkg.getParts()` — только по **снимку** списка (`createImagePart` мутирует реестр → CME); rels частей — `part.getRelationshipsPart()`, НЕ `getOwningRelationshipPart()` (это rels ссылающегося); обход XML обязан раскрывать `JAXBElement`. +Java2D → PNG 300 dpi (`ChartRenderer.DPI = 300`, `PADDING = 4.0`, растр × `DPI/72`, размеры — в пунктах, EMU→pt `cx/12700.0`). `ChartSpec.parse` (`enum Type`: PIE/PIE3D/DOUGHNUT/BAR/BAR_HORIZONTAL/LINE/AREA/SURFACE3D/SCATTER/BUBBLE/RADAR/STOCK/OF_PIE/SURFACE/BAR3D/AREA3D/LINE3D/UNSUPPORTED; пустой `c:title` + `autoTitleDeleted="0"` → у **круговых** имя первого ряда, у прочих — `AUTO_TITLE = "Название диаграммы"` (русская замена англ. плейсхолдеру Word); палитра `accent1..6` темы, легенда по умолчанию снизу (у SURFACE — полосы высот «0-1»…), позиция `t` поддержана, `overlay` (§21.2.2.132) → рисуется поверх области построения, место не резервирует (`ChartSpec.legendOverlay`, регрессия `ChartRendererTest#overlayLegend_drawnOverPlot`)) → `ChartRenderer` (осевые «круглые» шаги `niceUnit` 1/2/5·10ⁿ как Word; санитайзер `c:majorUnit` — `MAX_TICKS = 1000`: шаг ≤ 0/NaN/слишком мелкий в `axisBounds` заменяется niceUnit, иначе циклы делений вечные; `axisBounds` также перебирает шаг при неконечном диапазоне и отбрасывает нечитаемый `majorUnit` при ±∞-осях scaling; общие кумулятивные хелперы stacked `isStacked`/`stackedCumulative`/`stackedRange`) → пейнтеры `CartesianPainter` (2-D line/bar/area; lineChart `c:grouping` stacked/percentStacked §21.2.2.76 — ряд рисуется на накопленной сумме через `ChartRenderer.stackedCumulative`, регрессии `stackedLine_seriesStackCumulatively`/`percentStackedLine_topSeriesFlatAtHundred`)/`PiePainter` (`PIE_DEPTH=0.22`, `PIE_FIT=0.865`)/`Surface3dPainter` (калибровка по эталону Word 300 dpi, камера — регрессия `cameraMatchesWordReference`: `DEPTH_RATIO=0.705`, `HEIGHT_RATIO=0.664`, `GUTTER_LEFT/RIGHT=0.1485`, `GUTTER_TOP=0.116`, `GUTTER_BOTTOM=0.146`, свет `LIGHT_X/Y/Z=0.83/0.48/0.28`, `c:rAngAx=true` во всех 3D-пейнтерах имеет приоритет над `c:perspective` (MS-OI29500 §2.1.1516(b)), `c:hPercent` сжимает глубину, `c:wireframe` §21.2.2.205 — только каркас без полос высот, bandFmt-полосы сортируются по глубине)/`ScatterPainter` (scatter/bubble: обе оси числовые, две `c:valAx`, X — первая; маркеры по `c:marker`, `c:scatterStyle` §21.2.2.136; радиус пузыря sqrt при `c:sizeRepresents="area"` §21.2.2.128 и линейно при «w», масштаб `c:bubbleScale`)/`RadarPainter` (спицы от 12 часов по часовой, `c:radarStyle` §21.2.2.119 standard/marker/filled, сетка — концентрические многоугольники)/`StockPainter` (high-low-close: `c:hiLowLines`/`c:upDownBars`/`c:dropLines`; цвета — дефолты UI Word, эмпирика запинена тестом)/`OfPiePainter` (главный пирог, замкнутый «Other»-сектором — MS-OI29500 §2.1.1507(a), обращён центром к 3 часам ко вторичной, цвет — следующая ротация палитры; пара пирогов центрирована, зазор `GAP_FIT=0.25·d1` — Word-эмпирика; вторичный пирог/стек, разбиение по `c:splitType` §21.2.2.155 (splitPos — MS-OI29500 §2.1.1554a/b), вторичный пирог стартует от конца «Other»-сектора; `c:serLines` — ровно две связи от границ «Other»-сектора к ободу вторичного на 270°±wedgeSweep / левым углам столбца — MS-OI29500 §2.1.1545(a))/`Surface2dPainter` (контурная карта §21.2.2.204: полосы высот между ломаными соседних рядов §21.2.2.13, передняя стенка — полоса значения переднего края; `c:wireframe` §21.2.2.230 — вид сверху (X=категории, Y=ряды, серия 0 внизу) без заливок: изолинии на границах полос высот `lo+k·unit` цветом нижней полосы (c:bandFmts §21.2.2.13/.14, без них — палитра), marching squares, седло — по среднему ячейки; сетка catAx/serAx, рамка plot; ось значений не рисуется)/`Cartesian3dPainter` (bar3D/line3D/area3D §21.2.2.19/.101/.122 — камера `Surface3dPainter.project`, ряды уходят в глубину; bar3D: `c:shape` box/cone/cylinder/pyramid + `*ToMax` §21.2.3.44 (per-series `c:shape` переопределяет диаграммный, горизонтальная ориентация — всегда box), `c:grouping` stacked/percentStacked §21.2.2.76 (одна полоса глубины на категорию, сегменты столбиком, percent — нормировка к 100%; area3D stacked — полосы на стене v=0, line3D grouping игнорирует), `c:gapDepth` — MS-OI29500 §2.1.1474, подписи serAx рисуются, `c:delete` осей учитывается); `SmartArtRenderer` рисует кэш разложенной схемы (relationship `…/office/2007/relationships/diagramDrawing`, фактически `word/diagrams/drawing1.xml`), формы строит `PresetGeometry` — ECMA-пресет-геометрия `a:prstGeom`: avLst/gdLst/pathLst семи пресетов (rect, roundRect, ellipse, gear6, gear9, circularArrow, leftCircularArrow) дословно из `presetShapeDefinitions.xml`, вычислитель префиксных формул; оператор `?:` = «if x > 0 then y else z» (ISO/IEC 29500-1, НЕ x != 0), углы в Arc2D передавать со знаком минус (математическая конвенция y вверх), неизвестный пресет → прямоугольник ячейки (синхрон таблицы со стандартом пинит `PresetGeometryTest#tableMatchesEcmaXml`); палитра темы — `DrawMlColor` (instance; без ThemePart — дефолтная Office-палитра `accent1=4472C4`…, битый `a:srgbClr/@val` — дефолт вместо падения); текст — `DrawMlText` (шрифты — тот же бандл через `BundledFontMapper.bundledFamily`; `fitCut` гарантирует прогресс реза на 1 символе — иначе `wrapLines` вечный цикл); утилиты `RgbHsl`. Калибровочные константы менять только вместе с `Surface3dPainterTest`/`PiePainterTest`. Защитные лимиты против враждебного chart-XML: `ChartSpec.MAX_POINTS` (`c:pt/@idx` §21.2.2.150/.151 и `c:ptCount` §21.2.2.152 — ST_UnsignedInt без верхней границы, отказ `IllegalArgumentException` до предвыделения списка), `MAX_TICKS` (см. выше) и `ChartSpec.MAX_EXTENT_EMU` (`a:ext`/`a:chExt` §21.2.2.62 — ST_PositiveSizeType без верхней границы, extent > 2^31 EMU заменяется размером якоря, иначе `BufferedImage` OOM); бросок перехватывает catch `DrawingPreRenderer.renderChart` → штатная деградация «объект удалён + warn» (`DrawingPreRenderer` log; подмена `graphic` на `pic:pic` — структурный обход `swapForPicture`, не toString-замена). Обход `pkg.getParts()` — только по **снимку** списка (`createImagePart` мутирует реестр → CME); rels частей — `part.getRelationshipsPart()`, НЕ `getOwningRelationshipPart()` (это rels ссылающегося); обход XML обязан раскрывать `JAXBElement`. ### Критические инварианты (нарушение = битый вывод) @@ -58,7 +58,7 @@ Java2D → PNG 300 dpi (`ChartRenderer.DPI = 300`, `PADDING = 4.0`, растр |`wordpdf-core/src/test/resources/geom/`|`presetShapeDefinitions.xml` — копия приложения ECMA-376, синхрон таблицы `PresetGeometry` (только в тестах, в jar не попадает)| |`wordpdf-app/src/main/java/ru/pjandro/wordpdf/app/`|REST API (10 классов): `WordPdfApplication` (единственный public), `ConvertController`, `ConversionService` (очередь), `ApiExceptionHandler`, `ApiKeyFilter`, `OpenApiConfig` (`@SecurityScheme` X-API-Key для springdoc) + 5 класса исключений| |`wordpdf-web/src/`|SPA (React 19 + TS + Vite + Tailwind): `api.ts` (вся сеть), `components/` (App, ApiKeyGate, PdfPreview, StatusMessage, DropZone, Logo)| -|корневые `Containerfile`, `compose.yml`, `compose.dev.yml`, `gateway/nginx.conf`|образ бэкенда (multi-stage maven:3.9-eclipse-temurin-17 → eclipse-temurin-**17-jre-alpine** (musl) — chart-движку нужен только модуль java.desktop (Graphics2D, он внутри JRE); fontconfig и системные шрифты рантайму не нужны — текст рисуется глифами fontbox, см. `fonts/GlyphFont` (проверено на musl-стенде без libfontconfig/`/etc/fonts`); HEALTHCHECK busybox `wget` (curl/apt не ставим), non-root uid 10001); compose app+web+gateway: web-образ со своим HEALTHCHECK (`wget /`), в обоих compose `depends_on web: condition: service_healthy`; прод-compose не в репо — его рендерит job `deploy` (лимиты запекаются из Variables); podman-специфика обоих compose: `x-podman.name_separator_compat` (docker-style имена), явные `healthcheck` app/web (дубли Containerfile-HEALTHCHECK — OCI-выгрузка его теряет; app-хелсчеки — `wget`, как в Containerfile), зафиксированная подсеть `10.113.0.0/24` gw `10.113.0.1` под резолвер aardvark-dns; два repo-стенда одновременно не поднять (общая подсеть). Комментарий в `wordpdf-web/Containerfile` «compose прод-запуска передаёт ARG VITE_BASE» устарел — repo-compose не передаёт, arg печёт CI| +|корневые `Containerfile`, `compose.yml`, `compose.dev.yml`, `gateway/nginx.conf`|образ бэкенда (multi-stage maven:3.9-eclipse-temurin-17 → eclipse-temurin-**17-jre-alpine** (musl) — chart-движку нужен только модуль java.desktop (Graphics2D, он внутри JRE); fontconfig и системные шрифты рантайму не нужны — текст рисуется глифами fontbox, см. `fonts/GlyphFont` (проверено на musl-стенде без libfontconfig/`/etc/fonts`); HEALTHCHECK busybox `wget` (curl/apt не ставим), non-root uid 10001, `JAVA_TOOL_OPTIONS=-Xmx1536m`); compose app+web+gateway: `mem_limit: 2g` app (в паре с `-Xmx1536m` — heap в лимите контейнера, JVM не OOM-киллится), web-образ со своим HEALTHCHECK (`wget /`), в обоих compose `depends_on web: condition: service_healthy`; прод-compose не в репо — его рендерит job `deploy` (лимиты запекаются из Variables, mem_limit литералом); podman-специфика обоих compose: `x-podman.name_separator_compat` (docker-style имена), явные `healthcheck` app/web (дубли Containerfile-HEALTHCHECK — OCI-выгрузка его теряет; app-хелсчеки — `wget`, как в Containerfile), зафиксированная подсеть `10.113.0.0/24` gw `10.113.0.1` под резолвер aardvark-dns; два repo-стенда одновременно не поднять (общая подсеть). Комментарий в `wordpdf-web/Containerfile` «compose прод-запуска передаёт ARG VITE_BASE» устарел — repo-compose не передаёт, arg печёт CI| |корневой `.env.example`|шаблон env для локальных/compose-стендов: `WORDPDF_API_KEY` (`openssl rand -hex 32`), закомментированные `WORDPDF_MAX_MB`/`WORDPDF_MAX_PAGES` (пустое значение ломает binding long/int); проду `.env` **не нужен**: ключ и лимиты подаёт job `deploy` из Gitea Secrets/Variables, legacy-`.env` на проде удаляется деплоем| |`.gitea/workflows/`|Gitea Actions: `pr.yml` (PR checks), `main.yml` (тесты + coverage-сводка и комментарий в PR → `images-app`/`images-web` (build+push в Nexus) → deploy (рендер прод-конфигов + pull) → autotests → rollback)| |корневой `GITEA-vars.md`|инструкция владельца: Secrets/Variables, защита ветки, перезапуск — только имена переменных, без значений| @@ -134,13 +134,13 @@ gateway). Кеш раннеров — сервер act_runner (серверна - `wordpdf-core/src/main/java/ru/pjandro/wordpdf/WordPdfConverter.java` — точка входа библиотеки + static-блок `gsubFeatures` + `normalizers(options)` (порядок цепочки). - `wordpdf-core/src/main/java/ru/pjandro/wordpdf/WordPdfSettings.java` — все дефолты ядра (`MAX_INPUT_MB` 5, `MAX_PAGES` 100, `ERROR_ON_*=false`); рантайм-конфигурации в ядре нет. -- `wordpdf-app/src/main/resources/application.properties` — multipart 100MB (`max-file-size`/`max-request-size` + `file-size-threshold=100MB`, держит файл в памяти; в тон gateway `client_max_body_size 100m`), `wordpdf.convert-timeout=2m`, пустой `wordpdf.api-key`, `server.forward-headers-strategy=framework` (префикс прод-прокси для springdoc) + `springdoc.swagger-ui.persist-authorization=true`; `wordpdf.max-mb`/`max-pages` здесь намеренно нет. +- `wordpdf-app/src/main/resources/application.properties` — multipart 100MB (`max-file-size`/`max-request-size` + `file-size-threshold=2MB` — части крупнее 2 МБ на диск, не в память; в тон gateway `client_max_body_size 100m`), `wordpdf.convert-timeout=2m`, пустой `wordpdf.api-key`, `server.forward-headers-strategy=framework` (префикс прод-прокси для springdoc) + `springdoc.swagger-ui.persist-authorization=true`; `wordpdf.max-mb`/`max-pages` здесь намеренно нет. - `wordpdf-app/pom.xml` — `spring-boot-maven-plugin` с **явной** execution `repackage` (в 4.1.1 сам не связывается, jar останется тонким); `slf4j-simple` исключён; `spring-boot-starter-webmvc` (Boot 4: переименован из starter-web) + `spring-boot-starter-actuator` (нужен HEALTHCHECK контейнера `/actuator/health`); тест-зависимости: `spring-boot-webmvc-test` (в Boot 4 автоконфиг MockMvc вынесен из starter-test), test-jar core. - `wordpdf-core/pom.xml` — `maven-jar-plugin` execution `test-jar` (публикует фикстуры для app); JaCoCo execution `check` переопределён (LINE 0.90 + BRANCH 0.85). - Корневой `pom.xml` — все версии зависимостей (в модулях версии не объявлять): docx4j `17.3.2`, slf4j `2.0.20`, JUnit `6.1.3`, PDFBox/fontbox `3.0.8` (`fontbox` — compile в core: глиф-движок `GlyphFont`; `pdfbox` — test в обоих модулях), POI `5.5.1` (test: генератор фикстур + in-memory документы в `WordPdfValidatorTest`), Spring Boot `4.1.1` (BOM-import), springdoc `3.1.1`; pluginManagement: compiler `3.16.0`, surefire `3.6.0` с `-Djava.awt.headless=true`, jar `3.5.1`, PMD plugin `3.28.0`, JaCoCo `0.8.15`; пустой дефолт `` (для `-Djacoco.skip=true`). - Корневой `pmd-ruleset.xml` — ruleset PMD (см. Testing & QA): `category/java/codestyle.xml` минус opinionated-правила, `MethodNamingConventions` с `junit5TestPattern` под underscore-имена регрессий, `TooManyStaticImports` до 12, XPath-правило `LiteralFirstInEquals`, unused-правила из `bestpractices.xml`, `ReturnEmptyCollectionRatherThanNull` (errorprone, priority 1), `AvoidLiteralsInIfCondition` (errorprone, дефолтная 3), `EmptyCatchBlock` (errorprone) и `ForLoopCanBeForeach` (bestpractices) — оба priority 2. - `wordpdf-core/src/main/resources/slf4j-simple.properties` — без него предупреждение лезет в PDF. -- `gateway/nginx.conf` — единственный вход: `/api/`, `/swagger-ui`, `/v3/api-docs`, `/actuator` → `app:8080`, остальное → `web:80`; `client_max_body_size 100m` (без директивы upload режется HTML-413 шлюза вместо JSON-ошибки API); `resolver 10.113.0.1` + `proxy_pass` через переменные (статический proxy_pass резолвит имя один раз при старте — gateway раньше app поднялся бы с 502 до перезапуска). `wordpdf-web/nginx.conf` — чистая статика с SPA-fallback, `/api` НЕ проксирует. +- `gateway/nginx.conf` — единственный вход: `/api/`, `/swagger-ui`, `/v3/api-docs`, `/actuator` → `app:8080`, остальное → `web:80`; `client_max_body_size 100m` (без директивы upload режется HTML-413 шлюза вместо JSON-ошибки API); `proxy_read_timeout`/`proxy_send_timeout 300s` (дефолтные 60s рвут 2-минутные конвертации 504 раньше app-ного 504); `resolver 10.113.0.1` + `proxy_pass` через переменные (статический proxy_pass резолвит имя один раз при старте — gateway раньше app поднялся бы с 502 до перезапуска). `wordpdf-web/nginx.conf` — чистая статика с SPA-fallback, `/api` НЕ проксирует. - `wordpdf-core/src/test/java/ru/pjandro/wordpdf/SampleDocxGenerator.java` — main()-утилита пересоздания фикстур. - `wordpdf-web/vite.local.config.ts` — легаси-одноразовщик (прокси `/api` → :8091), коммит против воли автора (`*.local` в gitignore не накрывает `.ts`-суффикс), в `tsconfig.node.json` не включён; кандидат на удаление, не тиражировать паттерн. Корневой `javac.*.args` — мусор пробной компиляции (gitignored), тоже кандидат на удаление. @@ -158,12 +158,12 @@ gateway). Кеш раннеров — сервер act_runner (серверна - Гейт `maven-pmd-plugin` 3.28.0 на `verify` для обоих модулей, ruleset `pmd-ruleset.xml` (codestyle без opinionated-правил + unused-правила + XPath `LiteralFirstInEquals` — строковый литерал слева в `equals`/`equalsIgnoreCase`; `junit5TestPattern` разрешает underscore-имена регрессий; `includeTests=true` — тесты сканируются; `failurePriority` не задан — на практике `verify` валят нарушения любой приоритетности, проверено на priority 3–4: строки `[WARNING] PMD Failure` = BUILD FAILURE). Версия PMD-движка в pom не пинится (тянется плагином). - Гейт JaCoCo `0.8.15`: `jacoco:check` (правило BUNDLE, LINE COVEREDRATIO `0.90` — обоих модулей; в `wordpdf-core/pom.xml` execution `check` переопределён и добавляет BRANCH COVEREDRATIO `0.85` — только для core, у app бранчи ниже порога) на `verify`; агент подключается в surefire через `argLine` = `@{argLine} -Djava.awt.headless=true` (свойство `argLine` в корневом pom по умолчанию пусто и перезаписывается `prepare-agent` — `mvn test -Djacoco.skip=true` без агента работоспособно); `report` и `check` оба на `verify`, report раньше — при провале порога отчёт уже на диске; отчёты `target/site/jacoco/` (html+xml, xml нужен CI-сводке). Плотность покрытия держат тесты, а не заглушки: промахи в основном недостижимые IOException/catch-ветки (`GlyphFont`, `BundledFonts`) и защитные ветви сканеров нормализаторов/валидатора, разобранные в комментариях к тестам. -- 34 тестовых класса / 462 `@Test` (core 28/422, app 6/40: ConvertController 20 + ApiKeyFilter 8 + ConversionService 5 + ApiExceptionHandler 4 + ConvertLimits 2 + ConversionTimeout 1). JUnit 6 (`org.junit.jupiter:junit-jupiter`), surefire 3.6.0 с `-Djava.awt.headless=true` в argLine; только `Assertions` (Mockito/AssertJ не использовать, несмотря на test-classpath Boot; в app-тестах допустим inline-Hamcrest `org.hamcrest.Matchers.containsString` в `andExpect`), тестовые классы package-private, зеркалят main-пакеты; только `@Test` (+ единственный `@BeforeAll` — warm-up шрифтов в `GlyphCoverageNormalizerTest`). +- 34 тестовых класса / 462 `@Test` (core 28/422, app 6/40: ConvertController 20 + ApiKeyFilter 8 + ConversionService 5 + ApiExceptionHandler 4 + ConvertLimits 2 + ConversionTimeout 1). JUnit 6 (`org.junit.jupiter:junit-jupiter`), surefire 3.6.0 с `-Djava.awt.headless=true` в argLine; только `Assertions` (Mockito/AssertJ не использовать, несмотря на test-classpath Boot; в app-тестах допустим inline-Hamcrest `org.hamcrest.Matchers.containsString` в `andExpect`), тестовые классы package-private, зеркалят main-пакеты; только `@Test` (+ два `@BeforeAll` — warm-up шрифтов в `GlyphCoverageNormalizerTest` и `BundledFonts.init()` в `BundledFontsTest`). - **PDF сравнивается текстом, не растеризацией**: PDFBox 3 (`Loader.loadPDF`) — `PDFTextStripper` для текста (пер-странично `setStartPage/setEndPage`), override `processTextPosition` для шрифта конкретного символа (`fontNameOf`), обход ресурсов страниц для встроенных шрифтов (`EAAAAA+Carlito-Bold`) и счётчик картинок (`imageCount`). Негативные маркеры — регрессии: `assertFalse(text.contains("#"))` (.notdef), `assertFalse(font.startsWith("Helvetica"))`. Текст нормализуется по пробелам (`norm`); в `tableImage_tableAndImage` — полное удаление пробелов (docx4j переносит слова в auto-fit таблицах). -- Пиксели (BufferedImage) — только в unit-тестах chart-пейнтеров: безразмерные отношения к эталону Word (экспорт 300 dpi, числа зашиты в тесты), допуски `assertRatio` <0.06 (`PiePainterTest`, `CartesianPainterTest`) / <0.10 (`Surface3dPainterTest`, + `assertRange` ±6 pt для центров силуэта); пороги залитых px, перцентильные коридоры яркости, «серый» px — разброс каналов `GRAY_MAX_SPREAD=25`. Эталонные файлы — `develop/`, вне git. +- Пиксели (BufferedImage) — только в unit-тестах chart-пейнтеров: безразмерные отношения к эталону Word (экспорт 300 dpi, числа зашиты в тесты), допуски `assertRatio` <0.06 (`PiePainterTest`, `CartesianPainterTest`) / <0.10 (`Surface3dPainterTest`, + `assertRange` ±6 pt для центров силуэта); пороги залитых px, перцентильные коридоры яркости, «серый» px — разброс каналов `GRAY_MAX_SPREAD=25`; исключение — структурная проверка чернил в `GlyphFontTest` (без сравнения с эталоном). Эталонные файлы — `develop/`, вне git. - `GlyphFont` (fontbox): метрики пиксельно-метрически эквивалентны AWT (ascent/descent/leading/advance совпадают до 4-го знака, кернинг-дрейф 0.0000 — DejaVu Sans, Carlito). Приёмочный стенд без-fontconfig: контейнер без `libfontconfig.so.1*` и `/etc/fonts`, `mvn verify` + `java -jar` (до перехода на GlyphFont там падали `GlyphCoverageNormalizerTest` 12 / `CartesianPainterTest` 3 / `PiePainterTest` 2 / chart-тесты `WordPdfConverterTest` 4, chart-рендер молча деградировал). `GlyphFontTest` написан без единого `java.awt.Font` — обязан проходить на хосте без fontconfig. - Фикстуры — закоммиченные `samples/*.docx` (13; в тестах не генерировать; все ECMA-conformant по `docs/standards/validate-fixtures.py` — фикстура невалидна, правится фикстура, не код): core грузит classpath-ресурсом → `byte[]`, PDF для PDFBox — временный файл; app читает `/samples/…` из **test-jar core** (classifier `tests`) → `mvn -pl wordpdf-app` без `-am` не соберётся. In-memory docx — `ZipOutputStream` из литеральных XML или POI в `byte[]`. Ключевые: `too-many-pages` (150 явных разрывов → 151), `stale-cache` (кэш `1` + 110 `lastRenderedPageBreak`), `charts-smartart` (4 растра; SmartArt-одиночка = ровно 2 Image XObject), `ole-embedded` (осиротевший bin с ложным `Default bin→footer+xml` + настоящий `w:object` с честным `Override → oleObject`; ручная, генератором не перезаписывать), `chart-types` (12 графиков + wireframe-поверхность = 13: 9 типов + ofPie pie-вариант (`c:ofPieType`="pie") + lineChart `c:grouping`=stacked + `c:wireframe` val="1"; пересоздание — `ChartTypesDocxGenerator`). -- Юниты нормализаторов работают строками (`rewrite`) + zip'ами из `ZipOutputStream`; обязательные контракты: «нечего менять → тот же массив» (`assertSame` покрыт тестами только у zip-нормализаторов `DocxOnOff`/`SymbolFont`/`StrictOoxml`; у `Field`/`GlyphCoverage`/`InvisibleChar` — `rewrite`→`null`) и неприкосновенность частей вне `word/*.xml` (`[Content_Types].xml`). Тесты бьют и в package-private API (`GlyphCoverageNormalizer.split(text, family)`, `ChartSpec.readTitle`). Исключение — `OleObjectNormalizerTest`: многочастный нормализатор без `rewrite`-хука, тесты только через `normalize` на in-memory zip. +- Юниты нормализаторов работают строками (`rewrite`) + zip'ами из `ZipOutputStream`; обязательные контракты: «нечего менять → тот же массив» (`assertSame` покрыт тестами у zip-нормализаторов `DocxOnOff`/`SymbolFont`/`StrictOoxml`/`InvisibleChar` и многочастного `OleObject`; у `Field`/`GlyphCoverage` — `rewrite`→`null`) и неприкосновенность частей вне `word/*.xml` (`[Content_Types].xml`). Тесты бьют и в package-private API (`GlyphCoverageNormalizer.split(text, family)`, `ChartSpec.readTitle`). Исключение — `OleObjectNormalizerTest`: многочастный нормализатор без `rewrite`-хука, тесты только через `normalize` на in-memory zip. - App-тесты: `@SpringBootTest` + `@AutoConfigureMockMvc` (Boot 4: `org.springframework.boot.webmvc.test.autoconfigure`); три контекста — `ConvertControllerTest` (пустой ключ), `ApiKeyFilterTest` (`properties = "wordpdf.api-key=…"`), `ConvertLimitsTest`/`ConversionTimeoutTest` (`@TestPropertySource` — отдельные классы, не `@Nested`). -- Регрессивные пары (фикс = нормализатор/pre-renderer + юнит + конвертер-тест с фикстурой): `StrictOoxmlNormalizerTest`↔`strictOoxml_convertsNotRejected` (+`pageCount_strictBreaksCountedLightweight` — lightweight против strict), `DocxOnOffNormalizerTest`↔`ruPlain_regularRunsUseRegularFont`, `SymbolFontNormalizerTest`↔`symbolFonts_bulletsAreNotHash`, `FieldNormalizerTest`↔`pageNumbers_recomputedNotCached`, `InvisibleCharNormalizerTest`↔`invisibleChars_noEmptyLines`, `GlyphCoverageNormalizerTest`↔`exoticGlyphs_drawnNotHash`, `OleObjectNormalizerTest`↔`oleObjects_removedAndConverted`/`drawingErrors_errorFlagRejectsOle` (+app `errorFlagOle_rejected`/`oleObjects_removedByDefault`), `WordPdfValidatorTest`↔`staleCachePageCountRejectedBeforeRender` (+`checkPageCount_limitBoundary` 99/100/101, `pageCount_breaksInsideTablesAreCounted`, `pageCount_continuousSectionsNotCountedLightweight`, `validate_notAZip`↔`inputNotAZip_rejectedBeforeRender`, `validate_plainZipRejected`/`validate_xlsxRenamedRejected`/`validate_zipBombRejected`/`validate_tooManyEntriesRejected`↔`plainZipNotDocx_rejected`/`inputNotDocx_rejectedBeforeRender` — контейнер и zip-бомба), `BundledFontsTest`↔`ruPlain_emDashEmbeddedNotHelvetica`, `ChartSpecTest`↔автозаголовки, `PresetGeometryTest`↔`chartsSmartArt_drawingsBecomeImages` (`tableMatchesEcmaXml` — синхрон таблицы пресетов с ECMA XML; кольцевые стрелки — семантика `?:` и знаки дуг Arc2D), chart-пейнтеры↔`chartsSmartArt_drawingsBecomeImages` (+`drawingErrors_*`↔app `errorFlagCharts_rejected`/`errorFlagSmartArt_rejected`), новые пейнтеры `ScatterPainterTest`/`RadarPainterTest`/`StockPainterTest`/`OfPiePainterTest`/`Surface2dPainterTest`/`Cartesian3dPainterTest`↔`chartTypes_allTypesRenderAsImages` (фикстура `chart-types`; ось X scatter/bubble и OF_PIE-заголовок — `ChartSpecTest`), lineChart stacked — `ChartSpecTest#lineGroupingParsed` + `ChartRendererTest#stackedCumulative_*`/`stackedRange_coversNegativeSums` + `CartesianPainterTest#stackedLine_seriesStackCumulatively`/`percentStackedLine_topSeriesFlatAtHundred`↔`chartTypes_allTypesRenderAsImages`; `noLoggingWarningInPdf` — регрессия `slf4j-simple`, `pdfTitle_comesFromParameter` — регрессия PDF-title (юнит-партнёра нет). App-регрессии: `requestLimitParams_areIgnored`, `nonPositiveLimits_failStartup`, `unknownPath_notFound`, `concurrentRequests_bothSucceed` (гонка реестра `PhysicalFonts`), `corruptNotAZip_rejected`, `plainZipNotDocx_rejected` (голый zip без манифеста → 400), `junkInsideValidZip_conversionError` (500 на валидном .docx-контейнере с мусором), `nonDocxFilename_rejected`, `oversizedOverCoreLimit_rejected`, `drawingsAlwaysRendered`, `cyrillicAndPathInFilename_sanitizedResponseName` (RFC 5987 + path-traversal), `docsOpenWithoutKey`/`forwardedPrefix_healthStaysOpen`/`forwardedPrefix_docsOpenWithoutKey` (открытая документация + матч фильтра без forwarded-contextPath), `dotSegmentOpenPrefix_rejected` (точечные сегменты `..`/`%2e` — не открытый путь), `errorFlagNotBoolean_rejected` (битый error-флаг → 400); DoS/корректность core: `ChartSpecTest#hugePointIndex_rejectedNotOom`/`hugePtCount_rejectedNotOom`/`hugeCategoryIndex_rejectedNotOom` (`MAX_POINTS`), `Surface3dPainterTest#axisBounds_tinyMajorUnit_fallsBackToNiceUnit`/`axisBounds_zeroMajorUnit_fallsBackToNiceUnit` (`MAX_TICKS`), `GlyphCoverageNormalizerTest#multipleTextNodes_runLeftUntouched` (guard составного рана)/`nestedRunInTextBox_innerSplit` + `SymbolFontNormalizerTest#nestedRunInTextBox_innerNormalized` (вложенные раны текстбоксов), `CartesianPainterTest#areaFill_closesToBaseline` (AREA к базовой линии), `ChartRendererTest#overlayLegend_drawnOverPlot` + `ChartSpecTest#overlayLegend_keepsPositionAndFlag` (overlay-легенда). +- Регрессивные пары (фикс = нормализатор/pre-renderer + юнит + конвертер-тест с фикстурой): `StrictOoxmlNormalizerTest`↔`strictOoxml_convertsNotRejected` (+`pageCount_strictBreaksCountedLightweight` — lightweight против strict; `indCoexistForms_convertsNotRejected` + юниты `indCoexistLeftStartUntouched`/`indStartOnlyRenamedTransitional`/`tcMarCoexistKept`/`tcMarStartOnlyRenamedTransitional`/`tcBordersElementsKeptTransitional`/`jcStartKeptTransitional`/`tabStartRenamedTransitional`/`transitionalCoexistReturnsOriginalArray` — guard сосуществования форм + strict-gating), `DocxOnOffNormalizerTest`↔`ruPlain_regularRunsUseRegularFont` (+`onOffInTextNotTouched` — `w:val` правится только внутри тега), `SymbolFontNormalizerTest`↔`symbolFonts_bulletsAreNotHash`, `FieldNormalizerTest`↔`pageNumbers_recomputedNotCached`, `InvisibleCharNormalizerTest`↔`invisibleChars_noEmptyLines`, `GlyphCoverageNormalizerTest`↔`exoticGlyphs_drawnNotHash`, `OleObjectNormalizerTest`↔`oleObjects_removedAndConverted`/`drawingErrors_errorFlagRejectsOle` (+app `errorFlagOle_rejected`/`oleObjects_removedByDefault`), `WordPdfValidatorTest`↔`staleCachePageCountRejectedBeforeRender` (+`checkPageCount_limitBoundary` 99/100/101, `cachedPagesUnreadableFallsBackToZero` — нечитаемый `` → 0, `pageCount_breaksInsideTablesAreCounted`, `pageCount_continuousSectionsNotCountedLightweight`, `validate_notAZip`↔`inputNotAZip_rejectedBeforeRender`, `validate_plainZipRejected`/`validate_xlsxRenamedRejected`/`validate_zipBombRejected`/`validate_tooManyEntriesRejected`↔`plainZipNotDocx_rejected`/`inputNotDocx_rejectedBeforeRender` — контейнер и zip-бомба), `BundledFontsTest`↔`ruPlain_emDashEmbeddedNotHelvetica`, `ChartSpecTest`↔автозаголовки, `PresetGeometryTest`↔`chartsSmartArt_drawingsBecomeImages` (`tableMatchesEcmaXml` — синхрон таблицы пресетов с ECMA XML; кольцевые стрелки — семантика `?:` и знаки дуг Arc2D), chart-пейнтеры↔`chartsSmartArt_drawingsBecomeImages` (+`drawingErrors_*`↔app `errorFlagCharts_rejected`/`errorFlagSmartArt_rejected`), новые пейнтеры `ScatterPainterTest`/`RadarPainterTest`/`StockPainterTest`/`OfPiePainterTest`/`Surface2dPainterTest`/`Cartesian3dPainterTest`↔`chartTypes_allTypesRenderAsImages` (фикстура `chart-types`; ось X scatter/bubble и OF_PIE-заголовок — `ChartSpecTest`), lineChart stacked — `ChartSpecTest#lineGroupingParsed` + `ChartRendererTest#stackedCumulative_*`/`stackedRange_coversNegativeSums` + `CartesianPainterTest#stackedLine_seriesStackCumulatively`/`percentStackedLine_topSeriesFlatAtHundred`↔`chartTypes_allTypesRenderAsImages`; `noLoggingWarningInPdf` — регрессия `slf4j-simple`, `pdfTitle_comesFromParameter` — регрессия PDF-title (юнит-партнёра нет). App-регрессии: `requestLimitParams_areIgnored`, `nonPositiveLimits_failStartup`, `unknownPath_notFound`, `concurrentRequests_bothSucceed` (гонка реестра `PhysicalFonts`), `corruptNotAZip_rejected`, `plainZipNotDocx_rejected` (голый zip без манифеста → 400), `junkInsideValidZip_conversionError` (500 на валидном .docx-контейнере с мусором), `nonDocxFilename_rejected`, `oversizedOverCoreLimit_rejected`, `drawingsAlwaysRendered`, `cyrillicAndPathInFilename_sanitizedResponseName` (RFC 5987 + path-traversal), `docsOpenWithoutKey`/`forwardedPrefix_healthStaysOpen`/`forwardedPrefix_docsOpenWithoutKey` (открытая документация + матч фильтра без forwarded-contextPath), `dotSegmentOpenPrefix_rejected` (точечные сегменты `..`/`%2e` — не открытый путь), `errorFlagNotBoolean_rejected` (битый error-флаг → 400), `methodNotSupportedReturns405`/`badContentTypeReturns415` (405/415 вместо catch-all 500); DoS/корректность core: `ChartSpecTest#hugePointIndex_rejectedNotOom`/`hugePtCount_rejectedNotOom`/`hugeCategoryIndex_rejectedNotOom` (`MAX_POINTS`), `Surface3dPainterTest#axisBounds_tinyMajorUnit_fallsBackToNiceUnit`/`axisBounds_zeroMajorUnit_fallsBackToNiceUnit` (`MAX_TICKS`), `ChartRendererTest#axisBounds_explicitHugeRange_reunitsToMaxTicks`/`axisBounds_infiniteSpan_fallsBackToData` (шаг при враждебном/неконечном диапазоне), `ChartSpecTest#nonFiniteScalingBounds_dropped` (±∞ scaling), `WordPdfConverterTest#hostileChartAxis_convertsNotHangs`/`hugeExtentChart_removedNotOom`/`chartWithoutExtent_errorFlagRejects` (`MAX_EXTENT_EMU`), `DrawMlTextTest#hugeWord_wrapsLinearly` (fitCut — прогресс реза), `DrawMlColorTest#invalidSrgbHexFallsBackToOfficeDefault` (битый hex темы — деградация), `GlyphCoverageNormalizerTest#multipleTextNodes_runLeftUntouched` (guard составного рана)/`nestedRunInTextBox_innerSplit` + `SymbolFontNormalizerTest#nestedRunInTextBox_innerNormalized` (вложенные раны текстбоксов), `CartesianPainterTest#areaFill_closesToBaseline` (AREA к базовой линии), `ChartRendererTest#overlayLegend_drawnOverPlot` + `ChartSpecTest#overlayLegend_keepsPositionAndFlag` (overlay-легенда). - UI-тестов нет; гейт SPA — `npm run build` (tsc -b) + `npm run lint` (oxlint, `.oxlintrc.json`: rules-of-hooks error, only-export-components warn). Прод-автотесты (pytest 9.1.1 + requests 2.34.2, 21 проверка — 17 под маркером `needs_key` (SKIP без ключа), 4 открытых: health/SPA-root/swagger/spec; env-конфиг, `mise exec -- python -m pytest -q .` из `prod-autotests/`) гоняются CI после deploy против живого прода. diff --git a/Containerfile b/Containerfile index 7ccb58c..7784050 100644 --- a/Containerfile +++ b/Containerfile @@ -25,5 +25,5 @@ USER app EXPOSE 8080 HEALTHCHECK --interval=10s --timeout=3s --start-period=10s --retries=5 \ CMD HTTP_PROXY= http_proxy= HTTPS_PROXY= https_proxy= wget -qO /dev/null http://127.0.0.1:8080/actuator/health || exit 1 -ENTRYPOINT ["java", "-Djava.awt.headless=true", "-jar", "/app/app.jar"] +ENTRYPOINT ["java", "-Djava.awt.headless=true", "-XX:MaxRAMPercentage=70", "-jar", "/app/app.jar"] diff --git a/GITEA-vars.md b/GITEA-vars.md index 09a060f..8c9f815 100644 --- a/GITEA-vars.md +++ b/GITEA-vars.md @@ -17,6 +17,7 @@ job'ах `deploy`/`autotests` с внятным сообщением, чего |`WORDPDF_API_KEY`|Прод-ключ API wordpdf|Единственный источник — этот Secret (прод `.env` выведен из эксплуатации, job `deploy` удаляет его как наследие); значение уже в Gitea| |`REGISTRY_USER`|Логин docker-реестра для CI-пуша (`ci-deploy`)|Nexus: Security → Users (роль `ci-deploy-role`, права на docker-hosted репозиторий)| |`REGISTRY_PASSWORD`|Пароль этого пользователя|Nexus: Security → Users → `ci-deploy` (Reset password)| +|`DEPLOY_KNOWN_HOSTS`|Строка known_hosts прод-хоста (host-key pinning: job `deploy` пишет её в `~/.ssh/known_hosts` и ставит `StrictHostKeyChecking=yes`)|`ssh-keyscan -t ed25519 ` с любой машины, знающей хост. Завести ДО мержа: без секрета деплой падает fail-closed (ssh отваливается до передачи ключей) и штатно отрабатывает `rollback`| ## Переменные (Settings → Actions → Variables) diff --git a/compose.dev.yml b/compose.dev.yml index a0138af..1147700 100644 --- a/compose.dev.yml +++ b/compose.dev.yml @@ -12,6 +12,8 @@ services: app: build: . restart: unless-stopped + # Паритет с compose.yml: heap вписан в лимит (-XX:MaxRAMPercentage=70). + mem_limit: 2g # Дублирует HEALTHCHECK из Containerfile: podman выгружает образы в OCI, # где поля healthcheck нет — без явного healthcheck depends_on # service_healthy ждал бы healthy вечно. Прокси обнуляем на команде. diff --git a/compose.yml b/compose.yml index fd075d3..27337e3 100644 --- a/compose.yml +++ b/compose.yml @@ -7,6 +7,9 @@ services: app: build: . restart: unless-stopped + # Heap вписываем в лимит контейнера (-XX:MaxRAMPercentage=70 в ENTRYPOINT); + # вход 16×5 МБ очередь + FOP-рендер в 2 ГБ помещаются. + mem_limit: 2g # Дублирует HEALTHCHECK из Containerfile: podman выгружает образы в OCI, # где поля healthcheck нет — без явного healthcheck depends_on # service_healthy ждал бы healthy вечно. Прокси обнуляем на команде. diff --git a/gateway/nginx.conf b/gateway/nginx.conf index 932ab85..4a44bdf 100644 --- a/gateway/nginx.conf +++ b/gateway/nginx.conf @@ -16,7 +16,14 @@ server { set $upstream_app http://app:8080; set $upstream_web http://web:80; - location /api/ { proxy_pass $upstream_app; } + location /api/ { + # в proxy_pass нет path-части, поэтому URI передаётся как есть + proxy_pass $upstream_app; + # wordpdf.convert-timeout=2m; дефолтный proxy_read_timeout 60s рвёт + # длинные конвертации (паритет с прод-рендером в main.yml) + proxy_read_timeout 300s; + proxy_send_timeout 300s; + } location /swagger-ui { proxy_pass $upstream_app; } location /v3/api-docs { proxy_pass $upstream_app; } # открыт фильтром приложения (wordpdf.api-key его не проверяет) — мониторинг/HEALTHCHECK снаружи diff --git a/wordpdf-app/src/main/java/ru/pjandro/wordpdf/app/ApiExceptionHandler.java b/wordpdf-app/src/main/java/ru/pjandro/wordpdf/app/ApiExceptionHandler.java index 8a2bc14..7c6fe87 100644 --- a/wordpdf-app/src/main/java/ru/pjandro/wordpdf/app/ApiExceptionHandler.java +++ b/wordpdf-app/src/main/java/ru/pjandro/wordpdf/app/ApiExceptionHandler.java @@ -5,6 +5,8 @@ import org.slf4j.LoggerFactory; import org.springframework.beans.factory.annotation.Value; import org.springframework.http.HttpStatus; import org.springframework.http.ResponseEntity; +import org.springframework.web.HttpMediaTypeNotSupportedException; +import org.springframework.web.HttpRequestMethodNotSupportedException; import org.springframework.web.bind.MissingServletRequestParameterException; import org.springframework.web.bind.annotation.ExceptionHandler; import org.springframework.web.bind.annotation.RestControllerAdvice; @@ -20,8 +22,9 @@ import ru.pjandro.wordpdf.ValidationException; *

{@link ValidationException} ядра доходит сюда напрямую — валидатор * бросает его сам; в {@link ConversionFailedException} превращается только * прочий {@code ru.pjandro.wordpdf.ConversionException} рендер-стадии. - * Случайная утечка прочего исключения попадёт в обработчик {@link Exception} - * (500).

+ * Метод/тип содержимого не по контракту — 405/415 (иначе утонули бы в + * catch-all 500). Случайная утечка прочего исключения попадёт в обработчик + * {@link Exception} (500).

*/ @RestControllerAdvice final class ApiExceptionHandler { @@ -113,6 +116,20 @@ final class ApiExceptionHandler { .body(new ApiError("Некорректное значение параметра «" + e.getName() + "»")); } + /** Метод не поддерживается (единственный эндпоинт — POST /api/v1/convert). */ + @ExceptionHandler(HttpRequestMethodNotSupportedException.class) + ResponseEntity methodNotSupported(HttpRequestMethodNotSupportedException e) { + return ResponseEntity.status(HttpStatus.METHOD_NOT_ALLOWED) + .body(new ApiError("Метод не поддерживается")); + } + + /** Не multipart-тело запроса (application/json и т.п.). */ + @ExceptionHandler(HttpMediaTypeNotSupportedException.class) + ResponseEntity badContentType(HttpMediaTypeNotSupportedException e) { + return ResponseEntity.status(HttpStatus.UNSUPPORTED_MEDIA_TYPE) + .body(new ApiError("Неподдерживаемый тип содержимого")); + } + /** Прочее — внутренняя ошибка; подробность только в лог, не в ответ. */ @ExceptionHandler(Exception.class) ResponseEntity unexpected(Exception e) { diff --git a/wordpdf-app/src/main/java/ru/pjandro/wordpdf/app/ConvertController.java b/wordpdf-app/src/main/java/ru/pjandro/wordpdf/app/ConvertController.java index 6f73706..c6488aa 100644 --- a/wordpdf-app/src/main/java/ru/pjandro/wordpdf/app/ConvertController.java +++ b/wordpdf-app/src/main/java/ru/pjandro/wordpdf/app/ConvertController.java @@ -25,7 +25,7 @@ import java.util.Locale; * *

Здесь только HTTP-слой: проверка presence/расширения и формирование * {@code Content-Disposition}; проверка содержимого (zip, размер, страницы) — - * зона {@link ConversionService#validate}. Ошибки в JSON-ответ переводит + * зона {@link ConversionService}. Ошибки в JSON-ответ переводит * {@link ApiExceptionHandler}. Лимиты входа — только конфигурация сервера * (свойства {@code wordpdf.max-mb}/{@code wordpdf.max-pages}, env * {@code WORDPDF_MAX_MB}/{@code WORDPDF_MAX_PAGES}); параметрами запроса diff --git a/wordpdf-app/src/main/resources/application.properties b/wordpdf-app/src/main/resources/application.properties index 8b271a4..5b201fa 100644 --- a/wordpdf-app/src/main/resources/application.properties +++ b/wordpdf-app/src/main/resources/application.properties @@ -7,10 +7,13 @@ spring.application.name=wordpdf-app # дефолты — константы ядра (5 / 100), задаются ConvertController. # Значение <= 0 — падение на старте. Сами ключи здесь не объявлены: # пустое значение затенит SpEL-дефолт @Value. -# file-size-threshold=100MB держит файл в памяти (ядро и так читает всё в RAM). +# file-size-threshold=2MB: части больше 2 МБ сбрасываются на диск Tomcat, heap +# держит только копию getBytes() одной сериализованной конвертации (порог 100MB +# буферизовал в heap каждую параллельную загрузку до валидации размера — OOM-килл +# контейнера). spring.servlet.multipart.max-file-size=100MB spring.servlet.multipart.max-request-size=100MB -spring.servlet.multipart.file-size-threshold=100MB +spring.servlet.multipart.file-size-threshold=2MB # Таймаут одной конвертации (binding Duration в ConversionService) wordpdf.convert-timeout=2m diff --git a/wordpdf-app/src/test/java/ru/pjandro/wordpdf/app/ConvertControllerTest.java b/wordpdf-app/src/test/java/ru/pjandro/wordpdf/app/ConvertControllerTest.java index 65a542b..06d58f9 100644 --- a/wordpdf-app/src/test/java/ru/pjandro/wordpdf/app/ConvertControllerTest.java +++ b/wordpdf-app/src/test/java/ru/pjandro/wordpdf/app/ConvertControllerTest.java @@ -33,6 +33,7 @@ import static org.junit.jupiter.api.Assertions.assertThrows; import static org.junit.jupiter.api.Assertions.assertNotNull; import static org.junit.jupiter.api.Assertions.assertTrue; import static org.springframework.test.web.servlet.request.MockMvcRequestBuilders.get; +import static org.springframework.test.web.servlet.request.MockMvcRequestBuilders.post; import static org.springframework.test.web.servlet.request.MockMvcRequestBuilders.multipart; import static org.springframework.test.web.servlet.result.MockMvcResultMatchers.content; import static org.springframework.test.web.servlet.result.MockMvcResultMatchers.header; @@ -417,6 +418,32 @@ class ConvertControllerTest { org.hamcrest.Matchers.containsString("Не найдено"))); } + /** + * GET на единственный POST-эндпоинт — 405 с JSON-текстом от + * {@code ApiExceptionHandler}, а не 500 от catch-all. + * Регрессия — ConvertControllerTest#methodNotSupportedReturns405. + */ + @Test + void methodNotSupportedReturns405() throws Exception { + mockMvc.perform(get("/api/v1/convert")) + .andExpect(status().isMethodNotAllowed()) + .andExpect(jsonPath("$.error").value("Метод не поддерживается")); + } + + /** + * POST с не-multipart телом (application/json) — 415 с JSON-текстом, + * не 500 от catch-all. + * Регрессия — ConvertControllerTest#badContentTypeReturns415. + */ + @Test + void badContentTypeReturns415() throws Exception { + mockMvc.perform(post("/api/v1/convert") + .contentType(MediaType.APPLICATION_JSON) + .content("{}")) + .andExpect(status().isUnsupportedMediaType()) + .andExpect(jsonPath("$.error").value("Неподдерживаемый тип содержимого")); + } + /** * Отказ чтения партиты контейнером ({@code IOException} из * {@code getBytes}) — {@link ValidationException} (400-смысл: вход не diff --git a/wordpdf-core/src/main/java/ru/pjandro/wordpdf/WordPdfValidator.java b/wordpdf-core/src/main/java/ru/pjandro/wordpdf/WordPdfValidator.java index 59b326e..9837131 100644 --- a/wordpdf-core/src/main/java/ru/pjandro/wordpdf/WordPdfValidator.java +++ b/wordpdf-core/src/main/java/ru/pjandro/wordpdf/WordPdfValidator.java @@ -324,7 +324,11 @@ public final class WordPdfValidator { } } return 0; - } catch (XMLStreamException | NumberFormatException e) { + } catch (XMLStreamException | NumberFormatException | IllegalStateException e) { + // getElementText() на с дочерним элементом бросает + // IllegalStateException (не XMLStreamException) — кэш просто + // нечитаем, нижняя оценка считается по разрывам. + // Регрессия — WordPdfValidatorTest#cachedPagesUnreadableFallsBackToZero. return 0; } finally { in.close(); diff --git a/wordpdf-core/src/main/java/ru/pjandro/wordpdf/internal/DocxOnOffNormalizer.java b/wordpdf-core/src/main/java/ru/pjandro/wordpdf/internal/DocxOnOffNormalizer.java index 96a8273..8015028 100644 --- a/wordpdf-core/src/main/java/ru/pjandro/wordpdf/internal/DocxOnOffNormalizer.java +++ b/wordpdf-core/src/main/java/ru/pjandro/wordpdf/internal/DocxOnOffNormalizer.java @@ -26,8 +26,15 @@ import java.util.regex.Pattern; */ public final class DocxOnOffNormalizer { + /** + * {@code w:val="on"/"off"} только внутри открывающего тега: group 1 — от + * {@code <} до {@code w:val=} в пределах одного тега ({@code [^<>]} не + * пересекает границу тега), литеральный {@code w:val="on"} в тексте + * {@code w:t} не правится. Регрессия — DocxOnOffNormalizerTest#onOffInTextNotTouched. + */ private static final Pattern ON_OFF = Pattern.compile( - "w:val=([\"'])(on|off)\\1", Pattern.CASE_INSENSITIVE); + "(<[A-Za-z][A-Za-z0-9:]*(?:\\s[^<>]*)?)w:val=([\"'])(on|off)\\2", + Pattern.CASE_INSENSITIVE); private DocxOnOffNormalizer() { } @@ -82,9 +89,9 @@ public final class DocxOnOffNormalizer { m.reset(); StringBuilder sb = new StringBuilder(xml.length()); while (m.find()) { - String value = "on".equalsIgnoreCase(m.group(2)) ? "true" : "false"; + String value = "on".equalsIgnoreCase(m.group(3)) ? "true" : "false"; m.appendReplacement(sb, Matcher.quoteReplacement( - "w:val=" + m.group(1) + value + m.group(1))); + m.group(1) + "w:val=" + m.group(2) + value + m.group(2))); } m.appendTail(sb); return sb.toString(); diff --git a/wordpdf-core/src/main/java/ru/pjandro/wordpdf/internal/StrictOoxmlNormalizer.java b/wordpdf-core/src/main/java/ru/pjandro/wordpdf/internal/StrictOoxmlNormalizer.java index ffc731e..88f9956 100644 --- a/wordpdf-core/src/main/java/ru/pjandro/wordpdf/internal/StrictOoxmlNormalizer.java +++ b/wordpdf-core/src/main/java/ru/pjandro/wordpdf/internal/StrictOoxmlNormalizer.java @@ -30,8 +30,10 @@ import java.util.zip.ZipOutputStream; * (в transitional они называются {@code w:left}/{@code w:right}) — * JAXB сообщает «unexpected element» и границы теряются; *

  • атрибуты {@code w:start}/{@code w:end} у {@code w:ind} и значения - * {@code start}/{@code end} у {@code w:jc}/{@code w:tab} — в - * transitional таких имён/значений нет, JAXB их отбрасывает.
  • + * {@code start}/{@code end} у {@code w:jc}/{@code w:tab} — в strict-модели + * это единственные имена, а transitional-модель docx4j их не принимает + * (значения {@code w:tab} — и подавно: enum {@code STTabJc} в docx4j + * 17.3.2 содержит только left/right). * * *

    Полный strict→transitional рерайт не делается: mc-preprocessor уже @@ -45,9 +47,27 @@ import java.util.zip.ZipOutputStream; * пропускается: там {@code w:lvl/w:start} — легитимный transitional-элемент * (стартовое значение счётчика), регрессия — StrictOoxmlNormalizerTest. * - *

    Transitional-документы (Word пишет {@code a:}-проценты целыми, {@code - * w:start} вне numbering.xml и {@code w:jc val="start"} не бывает) проходят - * без изменений: если правок не было, возвращается исходный массив. + *

    Правила применяются с учётом направления документа (часть strict, только + * если содержит URI {@code http://purl.oclc.org}): + *

      + *
    • атрибуты {@code w:start}/{@code w:end} переименовываются только внутри + * открывающего тега и только когда в том же теге нет {@code w:left}/ + * {@code w:right}: transitional {@code CT_Ind} допускает сосуществование + * (Word пишет обе пары), слепая глобальная замена порождала дубль + * атрибута — не well-formed XML (регрессия — + * StrictOoxmlNormalizerTest#indCoexistLeftStartUntouched, + * WordPdfConverterTest#indCoexistForms_convertsNotRejected);
    • + *
    • элементы {@code w:start}/{@code w:end} переименовываются глобально + * только в strict-частях; в transitional — лишь внутри {@code w:tcMar}/ + * {@code w:tblCellMar} и лишь при отсутствии одноимённого {@code w:left}/ + * {@code w:right}-ребёнка (transitional-схема допускает обе пары детей, + * {@code maxOccurs=1} на left — дубль ломает JAXB);
    • + *
    • значения {@code start}/{@code end} у {@code w:jc} правятся только в + * strict: transitional {@code JcEnumeration} docx4j их содержит, экспортёр + * пишет {@code fo:text-align} как есть, а FOP разрешает start/end по + * направлению абзаца (FO 1.1) — замена на left ломала RTL; значения + * {@code w:tab} правятся всегда (enum без start/end).
    • + *
    * * Регрессия — WordPdfConverterTest#strictOoxml_convertsNotRejected. */ @@ -71,9 +91,27 @@ public final class StrictOoxmlNormalizer { private static final Pattern START_ELEMENT = Pattern.compile("])"); private static final Pattern END_ELEMENT = Pattern.compile("])"); - /** Значения {@code start}/{@code end} у {@code w:jc}/{@code w:tab}. */ - private static final Pattern JC_TAB_VALUE = Pattern.compile( - "(]*?w:val=\")(start|end)\""); + /** URI strict-пакета (ECMA-376 1-е изд.); его наличие в части — признак strict. */ + private static final String STRICT_NS = "http://purl.oclc.org"; + + /** Открывающий тег любого элемента — носитель атрибутов для точечного рерайта. */ + private static final Pattern OPEN_TAG = Pattern.compile("<[A-Za-z][A-Za-z0-9:]*\\b[^>]*>"); + + /** + * Блок {@code w:tcMar}/{@code w:tblCellMar}: единственное место transitional, + * где элементы {@code w:start}/{@code w:end} легальны (CT_TcMar допускает их + * наравне с {@code w:left}/{@code w:right}). + */ + private static final Pattern MAR_BLOCK = Pattern.compile( + "<(w:tcMar|w:tblCellMar)\\b[^>]*>.*?", Pattern.DOTALL); + + /** Значения {@code start}/{@code end} у {@code w:jc} (правятся только в strict). */ + private static final Pattern JC_VALUE = Pattern.compile( + "(]*?w:val=\")(start|end)\""); + + /** Значения {@code start}/{@code end} у {@code w:tab} (правятся всегда). */ + private static final Pattern TAB_VALUE = Pattern.compile( + "(]*?w:val=\")(start|end)\""); private StrictOoxmlNormalizer() { } @@ -99,9 +137,11 @@ public final class StrictOoxmlNormalizer { String name = entry.getName(); if (name.startsWith("word/") && name.endsWith(".xml")) { // в numbering.xml w:start — элемент стартового значения - // счётчика, его не переименовываем - String fixed = rewrite(new String(data, StandardCharsets.UTF_8), - !"word/numbering.xml".equals(name)); + // счётчика, его не переименовываем; направление части — по + // наличию strict-URI (transitional-правила мягче) + String xml = new String(data, StandardCharsets.UTF_8); + String fixed = rewrite(xml, !"word/numbering.xml".equals(name), + xml.contains(STRICT_NS)); if (fixed != null) { changed = true; data = fixed.getBytes(StandardCharsets.UTF_8); @@ -116,43 +156,122 @@ public final class StrictOoxmlNormalizer { } /** - * Применяет к XML-строке все правила, включая переименование элементов - * {@code w:start}/{@code w:end}. + * Применяет к XML-строке все правила в strict-режиме, включая переименование + * элементов {@code w:start}/{@code w:end} (хук юнит-тестов). * * @return новая строка либо null, если правок не было */ static String rewrite(String xml) { - return rewrite(xml, true); + return rewrite(xml, true, true); } /** - * Правила нормализации strict-OOXML. + * Правила нормализации (javadoc класса). * * @param renameStartEnd переименовывать ли элементы {@code w:start}/ * {@code w:end} (false для word/numbering.xml) + * @param strict strict-часть (URI {@code http://purl.oclc.org}): + * глобальный рерайт элементов и значений {@code w:jc}; + * в transitional — только guard-правила * @return новая строка либо null, если правок не было */ - private static String rewrite(String xml, boolean renameStartEnd) { + static String rewrite(String xml, boolean renameStartEnd, boolean strict) { String r = xml; if (r.indexOf('%') >= 0) { r = percentTags(r, A_TAG); r = percentTags(r, FILL_TO_RECT_TAG); r = percentText(r); } - if (renameStartEnd - && (r.contains("") - || r.contains(""))) { - r = renameStartEndElements(r); + if (strict) { + if (renameStartEnd + && (r.contains("") + || r.contains(""))) { + r = renameStartEndElements(r); + } + } else { + r = renameMarBlockElements(r); } if (r.contains(" w:start=\"") || r.contains(" w:end=\"")) { - r = r.replace(" w:start=\"", " w:left=\"").replace(" w:end=\"", " w:right=\""); + r = renameStartEndAttrs(r); } if (r.contains("w:val=\"start\"") || r.contains("w:val=\"end\"")) { - r = jcTabValues(r); + if (strict) { + r = renameValues(r, JC_VALUE); + } + r = renameValues(r, TAB_VALUE); } return r.equals(xml) ? null : r; } + /** + * Атрибуты {@code w:start→w:left}/{@code w:end→w:right} только внутри + * открывающего тега и только при отсутствии в нём {@code w:left}/{@code + * w:right}: CT_Ind (transitional) допускает обе пары, дубль атрибута — + * не well-formed XML; литеральный текст {@code w:val}-вида в {@code w:t} + * не затрагивается. + */ + private static String renameStartEndAttrs(String xml) { + Matcher tags = OPEN_TAG.matcher(xml); + StringBuilder sb = null; + while (tags.find()) { + String tag = tags.group(); + String fixed = tag; + if (fixed.contains(" w:start=\"") && !fixed.contains(" w:left=\"")) { + fixed = fixed.replace(" w:start=\"", " w:left=\""); + } + if (fixed.contains(" w:end=\"") && !fixed.contains(" w:right=\"")) { + fixed = fixed.replace(" w:end=\"", " w:right=\""); + } + if (!fixed.equals(tag)) { + if (sb == null) { + sb = new StringBuilder(xml.length()); + } + tags.appendReplacement(sb, Matcher.quoteReplacement(fixed)); + } + } + if (sb == null) { + return xml; + } + tags.appendTail(sb); + return sb.toString(); + } + + /** + * Transitional-частичный рерайт элементов: только внутри {@code w:tcMar}/ + * {@code w:tblCellMar} и только когда одноимённого {@code w:left}/{@code + * w:right}-ребёнка в блоке нет (иначе дубль с maxOccurs=1 ломает JAXB). + */ + private static String renameMarBlockElements(String xml) { + if (!xml.contains("", ""); + } + if (fixed.contains("", ""); + } + if (!fixed.equals(block)) { + if (sb == null) { + sb = new StringBuilder(xml.length()); + } + blocks.appendReplacement(sb, Matcher.quoteReplacement(fixed)); + } + } + if (sb == null) { + return xml; + } + blocks.appendTail(sb); + return sb.toString(); + } + /** * Переименование элементов {@code w:start}/{@code w:end} в * {@code w:left}/{@code w:right} только с границей имени: @@ -219,9 +338,9 @@ public final class StrictOoxmlNormalizer { return sb.toString(); } - /** Значения {@code start}/{@code end} у {@code w:jc}/{@code w:tab} → {@code left}/{@code right}. */ - private static String jcTabValues(String xml) { - Matcher m = JC_TAB_VALUE.matcher(xml); + /** Значения {@code start}/{@code end} по паттерну тега → {@code left}/{@code right}. */ + private static String renameValues(String xml, Pattern tagValue) { + Matcher m = tagValue.matcher(xml); if (!m.find()) { return xml; } diff --git a/wordpdf-core/src/main/java/ru/pjandro/wordpdf/internal/chart/ChartRenderer.java b/wordpdf-core/src/main/java/ru/pjandro/wordpdf/internal/chart/ChartRenderer.java index 31da4dd..30282ad 100644 --- a/wordpdf-core/src/main/java/ru/pjandro/wordpdf/internal/chart/ChartRenderer.java +++ b/wordpdf-core/src/main/java/ru/pjandro/wordpdf/internal/chart/ChartRenderer.java @@ -14,6 +14,8 @@ import java.awt.geom.RoundRectangle2D; import java.awt.image.BufferedImage; import java.util.ArrayList; import java.util.List; +import org.slf4j.Logger; +import org.slf4j.LoggerFactory; /** * Рендер графика DrawingML в растр. Кадрирование (рамка chartSpace), @@ -26,6 +28,8 @@ import java.util.List; */ final class ChartRenderer { + private static final Logger LOG = LoggerFactory.getLogger(ChartRenderer.class); + /** Разрешение растра: 300 dpi, чтобы подписи не мылились при печати. */ static final int DPI = 300; @@ -113,7 +117,7 @@ final class ChartRenderer { Surface2dPainter.paint(g, spec, box, palette); case AREA3D, LINE3D, BAR3D -> Cartesian3dPainter.paint(g, spec, box, palette); - default -> { /* UNSUPPORTED: вызывающий не должен сюда доходить */ } + default -> LOG.warn("тип графика {} не поддерживается — пустой PNG", spec.type); } if (legend != null && spec.legendOverlay) { double y = "t".equals(spec.legendPos) @@ -405,6 +409,14 @@ final class ChartRenderer { } /** + * Границы оси + шаг. Враждебные {@code c:min}/{@code c:max} (размах до 1e300, + * не-конечные границы, переполнение stacked-сумм в Infinity) не должны давать + * вечные циклы делений: шаг пересчитывается по ФАКТИЧЕСКОМУ интервалу, так что + * {@code (hi - lo) / unit <= MAX_TICKS + 1} при любых входах — все циклы + * {@code for (v = lo; v <= hi + unit/2; v += unit)} у художников завершаются. + * Регрессия — ChartRendererTest#axisBounds_explicitHugeRange_reunitsToMaxTicks, + * WordPdfConverterTest#hostileChartAxis_convertsNotHangs. + * * @param padMax для декартовых осей Word поднимает верхнюю границу за * максимум данных: «первое деление выше Ymax + (Ymax − Ymin)/20» * (KB101939). Без этого линия упёрта в верхнюю границу области @@ -414,6 +426,12 @@ final class ChartRenderer { */ static double[] axisBounds(ChartSpec.AxisSpec axis, double dataMin, double dataMax, boolean padMax) { + if (!Double.isFinite(dataMin)) { + dataMin = 0; + } + if (!Double.isFinite(dataMax)) { + dataMax = 0; + } double unit = axis != null && axis.majorUnit != null && usableMajorUnit(axis.majorUnit, dataMax - dataMin) ? axis.majorUnit @@ -433,6 +451,21 @@ final class ChartRenderer { if (hi <= lo) { hi = lo + unit; } + double span = hi - lo; + if (!Double.isFinite(span)) { + // Явные min/max дали не-конечный размах — откат к границам данных. + lo = Math.min(0, dataMin); + hi = Math.max(0, dataMax); + if (!(hi > lo)) { + lo = 0; + hi = 1; + } + unit = niceUnit((hi - lo) / 5.0); + } else if (span / unit > MAX_TICKS) { + // Явные min/max конечны, но интервал гигантский при мелком шаге — + // укрупняем шаг до приемлемого числа делений. + unit = niceUnit(span / MAX_TICKS); + } return new double[]{lo, hi, unit}; } diff --git a/wordpdf-core/src/main/java/ru/pjandro/wordpdf/internal/chart/ChartSpec.java b/wordpdf-core/src/main/java/ru/pjandro/wordpdf/internal/chart/ChartSpec.java index 0aeab98..36f7cb5 100644 --- a/wordpdf-core/src/main/java/ru/pjandro/wordpdf/internal/chart/ChartSpec.java +++ b/wordpdf-core/src/main/java/ru/pjandro/wordpdf/internal/chart/ChartSpec.java @@ -807,7 +807,7 @@ final class ChartSpec { spPr = c.getSpPr(); numFmt = c.getNumFmt() != null ? c.getNumFmt().getFormatCode() : "General"; if (c.getMajorUnit() != null) { - a.majorUnit = c.getMajorUnit().getVal(); + a.majorUnit = finite(c.getMajorUnit().getVal()); } } else if (ax instanceof CTSerAx c) { scaling = c.getScaling(); @@ -833,10 +833,10 @@ final class ChartSpec { a.numFmt = numFmt; if (scaling != null) { if (scaling.getMin() != null) { - a.min = scaling.getMin().getVal(); + a.min = finite(scaling.getMin().getVal()); } if (scaling.getMax() != null) { - a.max = scaling.getMax().getVal(); + a.max = finite(scaling.getMax().getVal()); } if (scaling.getOrientation() != null && scaling.getOrientation().getVal() != null) { a.reversed = scaling.getOrientation().getVal() == STOrientation.MAX_MIN; @@ -868,6 +868,16 @@ final class ChartSpec { return a; } + /** + * Не-конечные {@code c:min}/{@code c:max}/{@code c:majorUnit} (NaN/Infinity — + * ST_Double допускает их литерально) отбрасываются до предвыделения циклов + * делений: враждебный chart-XML не должен доходить до осевых циклов + * художников. Регрессия — ChartSpecTest#nonFiniteScalingBounds_dropped. + */ + private static Double finite(Double v) { + return v != null && Double.isFinite(v) ? v : null; + } + private static String seriesName(CTSerTx tx) { if (tx == null) { return null; diff --git a/wordpdf-core/src/main/java/ru/pjandro/wordpdf/internal/chart/DrawMlColor.java b/wordpdf-core/src/main/java/ru/pjandro/wordpdf/internal/chart/DrawMlColor.java index a3bb1fa..b19e297 100644 --- a/wordpdf-core/src/main/java/ru/pjandro/wordpdf/internal/chart/DrawMlColor.java +++ b/wordpdf-core/src/main/java/ru/pjandro/wordpdf/internal/chart/DrawMlColor.java @@ -695,8 +695,23 @@ final class DrawMlColor { return Math.max(0.0, Math.min(1.0, v)); } + /** + * Hex-RGB из {@code a:srgbClr/@val}. Не-конечный вход (null) и битое + * значение (враждебная тема: {@code val="zzzz"}) — null: вызывающие + * (baseOf → put/resolve) пропускают базу и держат office-дефолт, битая + * тема не валит всю конвертацию. + * Регрессия — DrawMlColorTest#invalidSrgbHexFallsBackToOfficeDefault. + */ static Color decodeHex(String hex) { - long v = Long.parseLong(hex, 16); - return new Color((int) ((v >> 16) & 0xFF), (int) ((v >> 8) & 0xFF), (int) (v & 0xFF)); + if (hex == null) { + return null; + } + try { + long v = Long.parseLong(hex, 16); + return new Color((int) ((v >> 16) & 0xFF), (int) ((v >> 8) & 0xFF), + (int) (v & 0xFF)); + } catch (NumberFormatException e) { + return null; + } } } diff --git a/wordpdf-core/src/main/java/ru/pjandro/wordpdf/internal/chart/DrawMlText.java b/wordpdf-core/src/main/java/ru/pjandro/wordpdf/internal/chart/DrawMlText.java index eb0c532..fe3f88a 100644 --- a/wordpdf-core/src/main/java/ru/pjandro/wordpdf/internal/chart/DrawMlText.java +++ b/wordpdf-core/src/main/java/ru/pjandro/wordpdf/internal/chart/DrawMlText.java @@ -48,6 +48,9 @@ final class DrawMlText { private static final String ALIGN_CTR = "ctr"; private static final String VALIGN_BOTTOM = "b"; + /** Длина строки, дальше которую рез не идёт (прогресс гарантирован 1 символом). */ + private static final int SINGLE_CHAR = 1; + private DrawMlText() { } @@ -218,38 +221,44 @@ final class DrawMlText { } } - /** Жадный перенос по пробелам; длинные слова режутся по символам. */ - private static List wrapLines(String text, GlyphFont f, double sizePt, - double maxWidth) { + /** + * Жадный перенос по пробелам; длинные слова режутся по символам. + * Ширина набирается инкрементально ({@link GlyphFont#advance} аддитивен — + * сумма ширин глифов без кернинга), а рез слова ищет границу экспоненциальным + * удвоением с бинарным сужением — O(L log L) на строку вместо кубической + * деградации на гигантских словах. Регрессия — DrawMlTextTest#hugeWord_wrapsLinearly. + */ + static List wrapLines(String text, GlyphFont f, double sizePt, double maxWidth) { List out = new ArrayList<>(); double limit = Math.max(1, maxWidth); + double spaceW = f.advance(" ", sizePt); for (String hard : text.split("\\n")) { if (hard.isEmpty()) { out.add(""); continue; } StringBuilder cur = new StringBuilder(); - double curWidth; + double curWidth = 0; for (String word : hard.split(" ")) { if (word.isEmpty()) { continue; } - String candidate = cur.length() == 0 ? word : cur + " " + word; - double w = f.advance(candidate, sizePt); - if (w <= limit || cur.length() == 0) { + double wordW = f.advance(word, sizePt); + if (cur.length() > 0 && curWidth + spaceW + wordW > limit) { + out.add(cur.toString()); cur.setLength(0); - cur.append(candidate); - continue; + curWidth = 0; + } + if (cur.length() > 0) { + cur.append(' '); + curWidth += spaceW; } - out.add(cur.toString()); - cur.setLength(0); cur.append(word); - curWidth = f.advance(word, sizePt); + curWidth += wordW; + // Слово шире лимита — режется по символам (в т.ч. первое в + // абзаце: иначе гигантское слово переполняло бокс). while (curWidth > limit && cur.length() > 1) { - int cut = cur.length() - 1; - while (cut > 1 && f.advance(cur.substring(0, cut), sizePt) > limit) { - cut--; - } + int cut = fitCut(cur, f, sizePt, limit); out.add(cur.substring(0, cut)); cur.delete(0, cut); curWidth = f.advance(cur.toString(), sizePt); @@ -262,6 +271,37 @@ final class DrawMlText { return out; } + /** + * Макс. k ∈ [1, s.length()], что advance(s[0,k)) ≤ limit; иначе 1 (прогресс + * гарантирован). Экспоненциальный поиск останавливается на первом переборе, + * поэтому окно поиска ограничено размером вписывающегося префикса, а не + * длиной строки. + */ + private static int fitCut(CharSequence s, GlyphFont f, double sizePt, double limit) { + int n = s.length(); + if (n <= SINGLE_CHAR) { + return n; + } + int lo = 1; + int hi = 2; + while (hi < n && f.advance(s.subSequence(0, hi).toString(), sizePt) <= limit) { + lo = hi; + hi = Math.min(n, hi * 2); + } + if (hi == n && f.advance(s.subSequence(0, n).toString(), sizePt) <= limit) { + return n; + } + while (hi - lo > 1) { + int mid = (lo + hi) >>> 1; + if (f.advance(s.subSequence(0, mid).toString(), sizePt) <= limit) { + lo = mid; + } else { + hi = mid; + } + } + return lo; + } + /** Ширина строки в тех же единицах, что и размер шрифта. */ static double textWidth(String text, Style style) { return fontFor(style).advance(text, style.sizePt()); diff --git a/wordpdf-core/src/main/java/ru/pjandro/wordpdf/internal/chart/DrawingPreRenderer.java b/wordpdf-core/src/main/java/ru/pjandro/wordpdf/internal/chart/DrawingPreRenderer.java index 8000a4d..1fc6983 100644 --- a/wordpdf-core/src/main/java/ru/pjandro/wordpdf/internal/chart/DrawingPreRenderer.java +++ b/wordpdf-core/src/main/java/ru/pjandro/wordpdf/internal/chart/DrawingPreRenderer.java @@ -74,6 +74,14 @@ public final class DrawingPreRenderer { private static final String DIAGRAM_DRAWING_REL = "http://schemas.microsoft.com/office/2007/relationships/diagramDrawing"; + /** + * Верхняя граница {@code wp:extent} в EMU: максимальная страница Word — + * 22″ (≈20.1M EMU), берём 24″ с запасом. Больше — враждебный docx: растр при + * 300 dpi дал бы десятки тысяч пикселей в стороне (OOM при BufferedImage и + * ImageIO). Регрессия — WordPdfConverterTest#hugeExtentChart_removedNotOom. + */ + private static final long MAX_EXTENT_EMU = 22_000_000L; + private DrawingPreRenderer() { } @@ -182,36 +190,38 @@ public final class DrawingPreRenderer { if (graphic == null || graphic.getGraphicData() == null) { continue; } - if (cx <= 0 || cy <= 0) { - LOG.warn("drawing без wp:extent — оставлен как есть"); + GraphicData gd = graphic.getGraphicData(); + if (PICTURE_URI.equals(gd.getUri()) || gd.getAny().isEmpty()) { + continue; // уже картинка / пусто + } + // Детект payload и проверка error-флагов — ДО extent-guard'а: + // error-флаг обязан сработать и для drawing без/с враждебным extent. + Object payload = gd.getAny().get(0); + String name = payload instanceof JAXBElement el && el.getName() != null + ? el.getName().toString() : ""; + boolean isChart = CHART_ELEMENT.equals(name); + boolean isDiagram = DIAGRAM_ELEMENT.equals(name); + if (isChart && options.errorOnCharts()) { + throw new DrawingFoundException(DrawingFoundException.Kind.CHARTS); + } + if (isDiagram && options.errorOnSmartArt()) { + throw new DrawingFoundException(DrawingFoundException.Kind.SMARTART); + } + if (cx <= 0 || cy <= 0 || cx > MAX_EXTENT_EMU || cy > MAX_EXTENT_EMU) { + LOG.warn("drawing вне допустимого wp:extent (cx={}, cy={}) — объект оставлен как есть", + cx, cy); continue; } - GraphicData gd = graphic.getGraphicData(); - String uri = gd.getUri(); BufferedImage img = null; String label = null; - if (PICTURE_URI.equals(uri)) { - continue; // уже картинка - } - if (gd.getAny().isEmpty()) { - continue; - } - Object payload = gd.getAny().get(0); - if (payload instanceof JAXBElement el) { - String name = el.getName() == null ? "" : el.getName().toString(); - if (CHART_ELEMENT.equals(name)) { - if (options.errorOnCharts()) { - throw new DrawingFoundException(DrawingFoundException.Kind.CHARTS); - } - img = renderChart(part, (CTRelId) el.getValue(), colors, cx, cy); - label = "график"; - } else if (DIAGRAM_ELEMENT.equals(name)) { - if (options.errorOnSmartArt()) { - throw new DrawingFoundException(DrawingFoundException.Kind.SMARTART); - } - img = renderDiagram(part, (CTRelIds) el.getValue(), colors, cx, cy); - label = "SmartArt"; - } + if (isChart) { + img = renderChart(part, (CTRelId) ((JAXBElement) payload).getValue(), + colors, cx, cy); + label = "график"; + } else if (isDiagram) { + img = renderDiagram(part, (CTRelIds) ((JAXBElement) payload).getValue(), + colors, cx, cy); + label = "SmartArt"; } if (img == null) { if (label != null) { @@ -234,7 +244,9 @@ public final class DrawingPreRenderer { try { ChartSpec spec = ChartSpec.parse(space, colors); return ChartRenderer.render(spec, cx / 12700.0, cy / 12700.0, colors); - } catch (RuntimeException e) { + } catch (RuntimeException | OutOfMemoryError e) { + // OOM — второй эшелон после MAX_EXTENT_EMU/MAX_POINTS: враждебный + // chart-XML не должен валить всю конвертацию, деградация = объект удалён. LOG.warn("рендер графика r:id={} упал: {}", ref.getId(), e.toString()); return null; } @@ -255,7 +267,7 @@ public final class DrawingPreRenderer { } try { return SmartArtRenderer.render(drawing, data, colors, cx / 12700.0, cy / 12700.0); - } catch (RuntimeException e) { + } catch (RuntimeException | OutOfMemoryError e) { LOG.warn("рендер SmartArt упал: {}", e.toString()); return null; } @@ -299,6 +311,7 @@ public final class DrawingPreRenderer { png = bos.toByteArray(); } catch (Exception e) { LOG.warn("PNG не собран: {}", e.toString()); + gd.getAny().clear(); // контракт: упавший рендер — объект удалён return; } BinaryPartAbstractImage imagePart; @@ -306,11 +319,13 @@ public final class DrawingPreRenderer { imagePart = BinaryPartAbstractImage.createImagePart(pkg, part, png); } catch (Exception e) { LOG.warn("ImagePart не создан: {}", e.toString()); + gd.getAny().clear(); return; } String relId = relIdFor(part, imagePart); if (relId == null) { LOG.warn("r:id для ImagePart {} не найден", imagePart.getPartName()); + gd.getAny().clear(); return; } diff --git a/wordpdf-core/src/test/java/ru/pjandro/wordpdf/WordPdfConverterTest.java b/wordpdf-core/src/test/java/ru/pjandro/wordpdf/WordPdfConverterTest.java index e598fe9..7f07250 100644 --- a/wordpdf-core/src/test/java/ru/pjandro/wordpdf/WordPdfConverterTest.java +++ b/wordpdf-core/src/test/java/ru/pjandro/wordpdf/WordPdfConverterTest.java @@ -619,6 +619,21 @@ class WordPdfConverterTest { assertTrue(text.contains("таблица"), "текст PDF: " + text); } + /** + * Transitional-документ с обеими формами отступа (Word пишет + * {@code w:ind w:left w:start} одновременно): до guard'а глобальная замена + * {@code w:start→w:left} порождала дубль атрибута — не well-formed XML, + * конвертация падала (500). Регрессия — StrictOoxmlNormalizer. + */ + @Test + void indCoexistForms_convertsNotRejected() throws Exception { + byte[] docx = minimalDocx( + "" + + "СОСУЩЕСТВОВАНИЕ"); + Path pdf = convertPdf(docx, "coexist"); + assertTrue(norm(pdfText(pdf)).contains("СОСУЩЕСТВОВАНИЕ"), "текст пропал"); + } + /** * Абзац только из невидимых символов (U+0085/U+2028/U+2029/U+2060/U+FEFF) * не раздувает PDF: FOP превращает первые три в принудительные переносы @@ -743,4 +758,132 @@ class WordPdfConverterTest { zos.write(xml.getBytes(StandardCharsets.UTF_8)); zos.closeEntry(); } + + /** Штатный c:valAx для in-memory chart-фикстур (без явных min/max). */ + private static final String PLAIN_VALAX = + "" + + ""; + + /** + * Минимальный in-memory docx: абзац-маркер + один линейный график (ряд 0..100) + * с указанным {@code wp:extent} и полным содержимым {@code c:valAx} + * (valAxXml — дети c:valAx в порядке ECMA-376 §21.2.2.219). Конвенция + * враждебного XML in-memory — WordPdfValidatorTest. + */ + private static byte[] chartDocx(long cx, long cy, String valAxXml) throws IOException { + String w = "http://schemas.openxmlformats.org/wordprocessingml/2006/main"; + String c = "http://schemas.openxmlformats.org/drawingml/2006/chart"; + StringBuilder pts = new StringBuilder(); + for (int i = 0; i <= 10; i++) { + pts.append("") + .append(i * 10).append(""); + } + ByteArrayOutputStream out = new ByteArrayOutputStream(); + try (ZipOutputStream zos = new ZipOutputStream(out)) { + putZip(zos, "[Content_Types].xml", + "" + + "" + + "" + + "" + + "" + + "" + + ""); + putZip(zos, "_rels/.rels", + "" + + "" + + "" + + ""); + putZip(zos, "word/document.xml", + "" + + "" + + "" + + "ГРАФИКМАРКЕР" + + "" + + "" + + "" + + "" + + "" + + "" + + "" + + "" + + "" + + ""); + putZip(zos, "word/_rels/document.xml.rels", + "" + + "" + + "" + + ""); + putZip(zos, "word/charts/chart1.xml", + "" + + "" + + "" + + "" + + "" + + "General" + + "" + pts + "" + + "" + + "" + + "" + + "" + + "" + + "" + + "" + valAxXml + "" + + ""); + } + return out.toByteArray(); + } + + /** + * Враждебные c:min/c:max (размах 2e300) при явном c:majorUnit=1: шаг делений + * пересчитывается по фактическому интервалу — конвертация завершается за + * секунды, график становится растром (до фикса — вечный цикл делений оси). + * Регрессия — ChartRenderer#axisBounds. + */ + @Test + void hostileChartAxis_convertsNotHangs() throws Exception { + byte[] docx = chartDocx(4_000_000L, 3_000_000L, + "" + + "" + + "" + + "" + + ""); + Path pdf = convertPdf(docx, "hostile-axis"); + assertTrue(norm(pdfText(pdf)).contains("ГРАФИКМАРКЕР"), "пропал текст"); + assertTrue(imageCount(pdf) >= 1, "график должен стать растром"); + } + + /** + * Враждебный wp:extent (122M EMU ≈ 133″): график не рендерится (кап + * MAX_EXTENT_EMU), документ конвертируется без OOM (до фикса — + * BufferedImage на десятки тысяч пикселей в стороне). + * Регрессия — DrawingPreRenderer#MAX_EXTENT_EMU. + */ + @Test + void hugeExtentChart_removedNotOom() throws Exception { + byte[] docx = chartDocx(122_000_000L, 122_000_000L, PLAIN_VALAX); + Path pdf = convertPdf(docx, "huge-extent"); + assertTrue(norm(pdfText(pdf)).contains("ГРАФИКМАРКЕР"), "пропал текст"); + assertEquals(0, imageCount(pdf), "график вне extent-капа не должен рендериться"); + } + + /** + * Error-флаг обязан сработать и для drawing без wp:extent: детект payload + * идёт до extent-guard'а (иначе обход — DrawingFoundException(CHARTS)). + * Регрессия — DrawingPreRenderer#replaceDrawing. + */ + @Test + void chartWithoutExtent_errorFlagRejects() throws Exception { + byte[] docx = chartDocx(0, 0, PLAIN_VALAX); + ConversionException ex = assertThrows(ConversionException.class, () -> + convertPdf(docx, "no-extent", + new ConvertOptions(true, false, false, + WordPdfSettings.MAX_INPUT_MB, WordPdfSettings.MAX_PAGES))); + assertTrue(ex instanceof DrawingFoundException dfe + && dfe.kind() == DrawingFoundException.Kind.CHARTS, + "ожидался DrawingFoundException(CHARTS), получено: " + ex); + } } diff --git a/wordpdf-core/src/test/java/ru/pjandro/wordpdf/WordPdfValidatorTest.java b/wordpdf-core/src/test/java/ru/pjandro/wordpdf/WordPdfValidatorTest.java index 6fce498..aa78a97 100644 --- a/wordpdf-core/src/test/java/ru/pjandro/wordpdf/WordPdfValidatorTest.java +++ b/wordpdf-core/src/test/java/ru/pjandro/wordpdf/WordPdfValidatorTest.java @@ -485,6 +485,30 @@ class WordPdfValidatorTest { assertTrue(ex.getMessage().contains("не менее 5"), ex.getMessage()); } + /** + * Нечитаемый кэш: {@code } с дочерним элементом — + * {@code getElementText()} бросает {@code IllegalStateException} (не + * {@code XMLStreamException}): до фикса валидатор давал 400 на валидном + * .docx. Кэш считается отсутствующим, нижняя оценка — по разрывам. + * Регрессия — WordPdfValidatorTest#cachedPagesUnreadableFallsBackToZero. + */ + @Test + void cachedPagesUnreadableFallsBackToZero() throws Exception { + String app = "" + + "" + + "x"; + String body = "" + + ""; + byte[] docx = rawDocx(java.util.Map.of( + DOCUMENT_PART, docPart(body), + "docProps/app.xml", app)); + assertDoesNotThrow(() -> WordPdfValidator.checkPageCount(docx, 100)); + ValidationException ex = assertThrows(ValidationException.class, + () -> WordPdfValidator.checkPageCount(docx, 2)); + assertTrue(ex.getMessage().contains("не менее 3"), + "оценка по разрывам потеряна: " + ex.getMessage()); + } + /** Колонтитулы считаются, .rels колонтитула — нет; записи-каталоги не пугают сканер. */ @Test void pageCount_headerCountedRelsAndDirsNot() throws Exception { diff --git a/wordpdf-core/src/test/java/ru/pjandro/wordpdf/fonts/BundledFontsTest.java b/wordpdf-core/src/test/java/ru/pjandro/wordpdf/fonts/BundledFontsTest.java index 3041732..39a2217 100644 --- a/wordpdf-core/src/test/java/ru/pjandro/wordpdf/fonts/BundledFontsTest.java +++ b/wordpdf-core/src/test/java/ru/pjandro/wordpdf/fonts/BundledFontsTest.java @@ -1,6 +1,7 @@ package ru.pjandro.wordpdf.fonts; import org.docx4j.fonts.PhysicalFont; +import org.junit.jupiter.api.BeforeAll; import org.junit.jupiter.api.Test; import java.io.IOException; @@ -28,6 +29,18 @@ import static org.junit.jupiter.api.Assertions.*; */ class BundledFontsTest { + /** + * Тесты читают реестр начертаний ({@code BundledFonts.regular(...)}), + * который наполняет {@code init()}; без него {@code VARIANTS} пуста и + * {@code allFamiliesHaveAllVariants} падал при запуске класса отдельно. + * {@code init()} идемпотентен — {@code mapperMapsCommonMsFontsToBundledOnes} + * со своим порядком («маппер → init») остаётся зелёным. + */ + @BeforeAll + static void initBundledFonts() { + BundledFonts.init(); + } + /** Все файлы из списка должны присутствовать в classpath (resources/fonts/). * Путь — абсолютный (через classloader), не относительный к пакету класса. */ @Test diff --git a/wordpdf-core/src/test/java/ru/pjandro/wordpdf/internal/DocxOnOffNormalizerTest.java b/wordpdf-core/src/test/java/ru/pjandro/wordpdf/internal/DocxOnOffNormalizerTest.java index 8f68162..7c600a8 100644 --- a/wordpdf-core/src/test/java/ru/pjandro/wordpdf/internal/DocxOnOffNormalizerTest.java +++ b/wordpdf-core/src/test/java/ru/pjandro/wordpdf/internal/DocxOnOffNormalizerTest.java @@ -98,4 +98,21 @@ class DocxOnOffNormalizerTest { assertNull(DocxOnOffNormalizer.rewrite("")); assertNull(DocxOnOffNormalizer.rewrite("без атрибутов")); } + + /** + * Литеральный {@code w:val="on"} в тексте {@code w:t} — не атрибут: + * паттерн заякорен на открывающий тег, текст не правится. + * Регрессия — DocxOnOffNormalizerTest#onOffInTextNotTouched. + */ + @Test + void onOffInTextNotTouched() { + assertNull(DocxOnOffNormalizer.rewrite( + "флаг w:val=\"on\" выключен")); + String r = DocxOnOffNormalizer.rewrite( + "" + + "текст w:val=\"on\""); + assertNotNull(r); + assertTrue(r.contains(""), r); + assertTrue(r.contains("текст w:val=\"on\""), r); + } } diff --git a/wordpdf-core/src/test/java/ru/pjandro/wordpdf/internal/StrictOoxmlNormalizerTest.java b/wordpdf-core/src/test/java/ru/pjandro/wordpdf/internal/StrictOoxmlNormalizerTest.java index 4f4c267..a668930 100644 --- a/wordpdf-core/src/test/java/ru/pjandro/wordpdf/internal/StrictOoxmlNormalizerTest.java +++ b/wordpdf-core/src/test/java/ru/pjandro/wordpdf/internal/StrictOoxmlNormalizerTest.java @@ -238,4 +238,83 @@ class StrictOoxmlNormalizerTest { assertNull(StrictOoxmlNormalizer.rewrite("")); assertNull(StrictOoxmlNormalizer.rewrite("")); } + + /** + * Transitional CT_Ind допускает сосуществование w:left+w:start (Word пишет + * обе пары): глобальная замена порождала дубль атрибута — не well-formed + * XML. Регрессия — WordPdfConverterTest#indCoexistForms_convertsNotRejected. + */ + @Test + void indCoexistLeftStartUntouched() { + assertNull(StrictOoxmlNormalizer.rewrite( + "", true, true)); + assertNull(StrictOoxmlNormalizer.rewrite( + "", true, false)); + assertNull(StrictOoxmlNormalizer.rewrite( + "", true, false)); + } + + /** Только w:start (без w:left) — рерайт и в transitional (иначе отступ теряется). */ + @Test + void indStartOnlyRenamedTransitional() { + String r = StrictOoxmlNormalizer.rewrite("", true, false); + assertNotNull(r); + assertTrue(r.contains("w:left=\"720\""), r); + } + + /** CT_TcMar transitional допускает одновременных start+left детей — блок как есть. */ + @Test + void tcMarCoexistKept() { + assertNull(StrictOoxmlNormalizer.rewrite( + "" + + "", true, false)); + } + + /** Только start/end в блоке tcMar — рерайт и в transitional. */ + @Test + void tcMarStartOnlyRenamedTransitional() { + String r = StrictOoxmlNormalizer.rewrite( + "" + + "", true, false); + assertNotNull(r); + assertTrue(r.contains("", true, false)); + } + + /** + * w:jc val="start" в transitional — JcEnumeration docx4j содержит START/END, + * FOP разрешает их по направлению (FO 1.1): рерайт ломал RTL, значение + * остаётся как есть. + */ + @Test + void jcStartKeptTransitional() { + assertNull(StrictOoxmlNormalizer.rewrite("", true, false)); + } + + /** А w:tab val="start" правится всегда: STTabJc docx4j 17.3.2 — только left/right. */ + @Test + void tabStartRenamedTransitional() { + String r = StrictOoxmlNormalizer.rewrite( + "", true, false); + assertNotNull(r); + assertTrue(r.contains(""), r); + } + + /** Transitional-документ с обеими формами атрибута — исходный массив байтов. */ + @Test + void transitionalCoexistReturnsOriginalArray() throws Exception { + byte[] docx = makeDocx( + "[Content_Types].xml", "", + "word/document.xml", + "" + + ""); + assertSame(docx, StrictOoxmlNormalizer.normalize(docx)); + } } diff --git a/wordpdf-core/src/test/java/ru/pjandro/wordpdf/internal/chart/ChartRendererTest.java b/wordpdf-core/src/test/java/ru/pjandro/wordpdf/internal/chart/ChartRendererTest.java index a876f90..84935d4 100644 --- a/wordpdf-core/src/test/java/ru/pjandro/wordpdf/internal/chart/ChartRendererTest.java +++ b/wordpdf-core/src/test/java/ru/pjandro/wordpdf/internal/chart/ChartRendererTest.java @@ -217,6 +217,36 @@ class ChartRendererTest { assertEquals(12.0, b[1], 0.001, "hi<=lo — поднимаем до lo+unit"); } + /** + * Враждебные явные c:min/c:max (размах 2e300 при явном шаге 1): шаг + * пересчитывается по фактическому интервалу — число делений ≤ MAX_TICKS+1, + * все циклы делений у художников завершаются. + * Регрессия — ChartRendererTest#axisBounds_explicitHugeRange_reunitsToMaxTicks. + */ + @Test + void axisBounds_explicitHugeRange_reunitsToMaxTicks() { + ChartSpec.AxisSpec ax = new ChartSpec.AxisSpec(); + ax.min = -1e300; + ax.max = 1e300; + ax.majorUnit = 1.0; + double[] r = ChartRenderer.axisBounds(ax, 0, 10); + assertTrue(Double.isFinite(r[0]) && Double.isFinite(r[1]) && Double.isFinite(r[2]), + "границы/шаг обязаны остаться конечными"); + assertTrue((r[1] - r[0]) / r[2] <= 1001, + "слишком много делений: " + (r[1] - r[0]) / r[2]); + } + + /** Не-конечные границы (переполнение размаха) — откат к границам данных. */ + @Test + void axisBounds_infiniteSpan_fallsBackToData() { + ChartSpec.AxisSpec ax = new ChartSpec.AxisSpec(); + ax.min = -1e308; + ax.max = 1e308; + double[] r = ChartRenderer.axisBounds(ax, 0, 10); + assertTrue(r[0] >= 0 && r[1] <= 12 && (r[1] - r[0]) / r[2] <= 1001, + "ожидаем откат к данным: " + r[0] + ".." + r[1] + " шаг " + r[2]); + } + /** formatValue: 0.00/0.0/General/null. */ @Test void formatValueFormats() { diff --git a/wordpdf-core/src/test/java/ru/pjandro/wordpdf/internal/chart/ChartSpecTest.java b/wordpdf-core/src/test/java/ru/pjandro/wordpdf/internal/chart/ChartSpecTest.java index 4ad1ede..91c8a7b 100644 --- a/wordpdf-core/src/test/java/ru/pjandro/wordpdf/internal/chart/ChartSpecTest.java +++ b/wordpdf-core/src/test/java/ru/pjandro/wordpdf/internal/chart/ChartSpecTest.java @@ -636,6 +636,35 @@ class ChartSpecTest { assertEquals("General", spec.serAxis.numFmt); } + /** + * Не-конечные c:min/c:max/c:majorUnit (NaN/Infinity — ST_Double допускает) + * отбрасываются на разборе: враждебный chart-XML не должен протаскивать + * их в циклы делений. Регрессия — ChartSpecTest#nonFiniteScalingBounds_dropped. + */ + @Test + void nonFiniteScalingBounds_dropped() { + CTChart chart = new CTChart(); + CTPlotArea pa = new CTPlotArea(); + CTValAx val = new CTValAx(); + CTScaling scaling = new CTScaling(); + CTDouble min = new CTDouble(); + min.setVal(Double.NaN); + CTDouble max = new CTDouble(); + max.setVal(Double.POSITIVE_INFINITY); + scaling.setMin(min); + scaling.setMax(max); + val.setScaling(scaling); + CTAxisUnit unit = new CTAxisUnit(); + unit.setVal(Double.NaN); + val.setMajorUnit(unit); + pa.getValAxOrCatAxOrDateAx().add(val); + chart.setPlotArea(pa); + ChartSpec spec = ChartSpec.parse(spaceWith(chart), new DrawMlColor(null)); + assertNull(spec.valAxis.min, "NaN c:min должен быть отброшен"); + assertNull(spec.valAxis.max, "Infinity c:max должен быть отброшен"); + assertNull(spec.valAxis.majorUnit, "NaN c:majorUnit должен быть отброшен"); + } + @Test void numericCategoriesSparsePadded() { CTBarChart bar = new CTBarChart(); diff --git a/wordpdf-core/src/test/java/ru/pjandro/wordpdf/internal/chart/DrawMlColorTest.java b/wordpdf-core/src/test/java/ru/pjandro/wordpdf/internal/chart/DrawMlColorTest.java index 1691fda..0759626 100644 --- a/wordpdf-core/src/test/java/ru/pjandro/wordpdf/internal/chart/DrawMlColorTest.java +++ b/wordpdf-core/src/test/java/ru/pjandro/wordpdf/internal/chart/DrawMlColorTest.java @@ -126,6 +126,26 @@ class DrawMlColorTest { assertEquals("Calibri Light", colors.majorFontName()); } + /** + * Битая тема: {@code a:srgbClr val="zzzz"} в accent1 — decodeHex отдаёт + * null, put пропускает, схема держит office-дефолт (битая тема не валит + * всю конвертацию). Регрессия — DrawMlColorTest#invalidSrgbHexFallsBackToOfficeDefault. + */ + @Test + void invalidSrgbHexFallsBackToOfficeDefault() { + Theme theme = new Theme(); + BaseStyles el = new BaseStyles(); + CTColorScheme cs = new CTColorScheme(); + cs.setAccent1(srgb("zzzz")); + el.setClrScheme(cs); + theme.setThemeElements(el); + DrawMlColor colors = new DrawMlColor(theme); + assertEquals(OFFICE_ACCENT1, colors.schemeColor("accent1"), + "битый hex должен деградировать к office-дефолту"); + assertNull(colors.resolve(srgb("не-шестнадцатеричное")), + "resolve битой базы — null (вызывающий берёт дефолт)"); + } + @Test void schemeColorNullAndUnknownFallBackToBlack() { DrawMlColor colors = new DrawMlColor(null); diff --git a/wordpdf-core/src/test/java/ru/pjandro/wordpdf/internal/chart/DrawMlTextTest.java b/wordpdf-core/src/test/java/ru/pjandro/wordpdf/internal/chart/DrawMlTextTest.java index ddb865e..b3d010a 100644 --- a/wordpdf-core/src/test/java/ru/pjandro/wordpdf/internal/chart/DrawMlTextTest.java +++ b/wordpdf-core/src/test/java/ru/pjandro/wordpdf/internal/chart/DrawMlTextTest.java @@ -286,4 +286,23 @@ class DrawMlTextTest { assertEquals(3, DrawMlText.lineCount( "альфа бета гамма дельта эпсилон зета эта йота капа лямбда", s, 100)); } + + /** + * Слово из 50 000 символов: перенос завершается за O(L log L) (инкрементальная + * ширина + экспоненциальный поиск границы реза) и каждая строка влезает в + * лимит ширины. Регрессия — DrawMlTextTest#hugeWord_wrapsLinearly. + */ + @Test + void hugeWord_wrapsLinearly() { + BundledFonts.init(); + var f = DrawMlText.fontFor(style("Carlito", false, false)); + String huge = "A".repeat(50_000); + double limit = 120; + List lines = DrawMlText.wrapLines(huge, f, 12, limit); + assertTrue(lines.size() > 1, "гигантское слово должно быть порезано"); + for (String line : lines) { + assertTrue(line.length() == 1 || f.advance(line, 12) <= limit, + "строка шире лимита: " + line.length() + " симв."); + } + } } diff --git a/wordpdf-web/src/api.ts b/wordpdf-web/src/api.ts index 3a2ec86..6c1852d 100644 --- a/wordpdf-web/src/api.ts +++ b/wordpdf-web/src/api.ts @@ -60,7 +60,7 @@ export async function convertDocx( const json = (await resp.json().catch(() => null)) as { error?: string } | null throw new ApiError(json?.error ?? `HTTP ${resp.status}`) } - // Framework 7 отдаёт `filename*=UTF-8''…` (charset в верхнем регистре) — + // Spring отдаёт `filename*=UTF-8''…` (charset в верхнем регистре) — // флаг i обязателен; фолбэк — имя исходника с заменой расширения const cd = resp.headers.get('Content-Disposition') ?? '' const m = /filename\*=utf-8''([^;]+)/i.exec(cd) @@ -72,7 +72,7 @@ export async function convertDocx( /** * Требует ли сервер ключ: GET /api/v1/convert (эндпоинт POST-only) — * 401 пишет ApiKeyFilter при требуемом и непринятом ключе; при выключенной - * аутентификации (dev) до фильтра дело не доходит — 405 от Spring. + * аутентификации (dev) до фильтра дело не доходит — 405 от ApiExceptionHandler. * Сетевая ошибка — 'open': не блокировать UI, конвертация сама покажет ошибку. */ export async function probeApiKey(): Promise<'open' | 'required'> { diff --git a/wordpdf-web/src/components/App.tsx b/wordpdf-web/src/components/App.tsx index ec06290..38a5e5c 100644 --- a/wordpdf-web/src/components/App.tsx +++ b/wordpdf-web/src/components/App.tsx @@ -130,8 +130,8 @@ export default function App() {

    Word → PDF

    - docx → PDF на docx4j + Apache FOP. Лимиты (файл ≤ 5 МБ, - ≤ 100 страниц) задаёт сервер; переопределение из формы убрано. + docx → PDF на docx4j + Apache FOP. Лимиты задаёт сервер; + переопределение из формы убрано.