From dfdcb5124d720de1e42c31c6c958e3e9933f34fd Mon Sep 17 00:00:00 2001 From: Pjandro Date: Wed, 14 Oct 2026 17:30:36 +0000 Subject: [PATCH] =?UTF-8?q?Chore:=20=D1=80=D0=B0=D0=B1=D0=BE=D1=87=D0=B8?= =?UTF-8?q?=D0=B5=20=D0=BC=D0=B0=D1=82=D0=B5=D1=80=D0=B8=D0=B0=D0=BB=D1=8B?= =?UTF-8?q?=20=D0=B8=20=D1=8D=D1=82=D0=B0=D0=BB=D0=BE=D0=BD=D1=8B=20?= =?UTF-8?q?=E2=80=94=20=D0=B2=20develop/=20(=D0=B2=D0=BD=D0=B5=20git);=20.?= =?UTF-8?q?gitignore=20=D0=B1=D0=B5=D0=B7=20=D1=83=D0=BF=D0=BE=D0=BC=D0=B8?= =?UTF-8?q?=D0=BD=D0=B0=D0=BD=D0=B8=D0=B9=20=D0=BB=D0=BE=D0=BA=D0=B0=D0=BB?= =?UTF-8?q?=D1=8C=D0=BD=D1=8B=D1=85=20=D0=B0=D1=80=D1=82=D0=B5=D1=84=D0=B0?= =?UTF-8?q?=D0=BA=D1=82=D0=BE=D0=B2?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit --- .dockerignore | 1 + .gitignore | 7 ++----- AGENTS.md | 5 ++--- README.md | 2 +- .../java/ru/pjandro/wordpdf/internal/FieldNormalizer.java | 2 +- .../ru/pjandro/wordpdf/internal/SymbolFontNormalizer.java | 2 +- .../test/java/ru/pjandro/wordpdf/WordPdfConverterTest.java | 2 +- .../pjandro/wordpdf/internal/SymbolFontNormalizerTest.java | 2 +- 8 files changed, 10 insertions(+), 13 deletions(-) diff --git a/.dockerignore b/.dockerignore index eebbf13..3089c6c 100644 --- a/.dockerignore +++ b/.dockerignore @@ -3,6 +3,7 @@ target/ .git/ .codegraph/ diff/ +/develop/ .idea/ *.iml dependency-reduced-pom.xml diff --git a/.gitignore b/.gitignore index 3f695f0..f2768c4 100644 --- a/.gitignore +++ b/.gitignore @@ -18,10 +18,8 @@ wordpdf-web/dist/ .DS_Store Thumbs.db -# Локальные примеры и выгрузки в корне - -# Артефакты ручной калибровки диаграмм -/diff/ +# Рабочие материалы и эталоны разработки (вне git) +/develop/ # Секреты деплоя .env @@ -29,4 +27,3 @@ Thumbs.db # Индекс CodeGraph .codegraph/ -# Выход конвертера из references/ (артефакт ручной проверки, не эталон) diff --git a/AGENTS.md b/AGENTS.md index 28c210d..f14b4a0 100644 --- a/AGENTS.md +++ b/AGENTS.md @@ -49,7 +49,7 @@ ### Chart-движок (`internal/chart`, package-private кроме `DrawingPreRenderer.run`) -Свой Java2D-рендер DrawingML. Калибровка surface3D зафиксирована тестами, эталон — стр. 3 gitignored `word-export.pdf` (экспорт Word, `pdftoppm -r 300`): `CAMERA_DISTANCE = 2.36` (`perspective` — НЕ угол FOV; fov≈49°), `DEPTH_RATIO = 0.705`, `HEIGHT_RATIO = 0.664`, поля `0.1485/0.116/0.146` от области построения, `rotY` берётся как `-Math.toRadians(...)` (знак обратный правому правилу), Lambert `0.92 + 0.88·dot` кламп `[0.80; 1.25]`, свет `(0.83, 0.48, 0.28)`. Цели: силуэт 314,9×65,3 pt центр (227,3; 82,3), уклон передней кромки 0.1282, аспект 0.207, шаги осей 0.0504/0.1176. Триангуляция ячейки — диагональ с большей суммой значений (седло; фиксированная диагональ даёт невидимую щепку); клиппинг полос — по треугольникам. `w01 = z[r+1][c]`, `w10 = z[r][c+1]` — перестановка закручивает квад в бабочку. `ChartRenderer.axisBounds` без явного `c:min` поднимает нижнюю границу до 0. Пустой `c:title` + `autoTitleDeleted val="0"` → автозаголовок `Chart Title` (для pie/pie3D/doughnut — имя ряда). Границы калибровки менять только вместе с тестами `Surface3dPainterTest`/`PiePainterTest`. +Свой Java2D-рендер DrawingML. Калибровка surface3D зафиксирована тестами, эталон — стр. 3 `develop/word-export.pdf` (ручной экспорт Word, `pdftoppm -r 300`): `CAMERA_DISTANCE = 2.36` (`perspective` — НЕ угол FOV; fov≈49°), `DEPTH_RATIO = 0.705`, `HEIGHT_RATIO = 0.664`, поля `0.1485/0.116/0.146` от области построения, `rotY` берётся как `-Math.toRadians(...)` (знак обратный правому правилу), Lambert `0.92 + 0.88·dot` кламп `[0.80; 1.25]`, свет `(0.83, 0.48, 0.28)`. Цели: силуэт 314,9×65,3 pt центр (227,3; 82,3), уклон передней кромки 0.1282, аспект 0.207, шаги осей 0.0504/0.1176. Триангуляция ячейки — диагональ с большей суммой значений (седло; фиксированная диагональ даёт невидимую щепку); клиппинг полос — по треугольникам. `w01 = z[r+1][c]`, `w10 = z[r][c+1]` — перестановка закручивает квад в бабочку. `ChartRenderer.axisBounds` без явного `c:min` поднимает нижнюю границу до 0. Пустой `c:title` + `autoTitleDeleted val="0"` → автозаголовок `Chart Title` (для pie/pie3D/doughnut — имя ряда). Границы калибровки менять только вместе с тестами `Surface3dPainterTest`/`PiePainterTest`. В `DrawingPreRenderer` rels части берутся через `part.getRelationshipsPart()` (`Base`), а **не** `getOwningRelationshipPart()` — у `document.xml` последнее указывает на пакетный `.rels`. Обход `pkg.getParts()` — только по снимку списка: `createImagePart` докидывает части в тот же реестр (живой обход → `ConcurrentModificationException`). @@ -69,8 +69,7 @@ | корневой `docker-compose.dev.yml` | dev-стенд без ключа: проект `wordpdf-dev`, вход http://127.0.0.1:9011, springdoc включён | | корневой `.env.example` | шаблон env деплоя: ключ (`WORDPDF_API_KEY`) и лимиты входа (`WORDPDF_MAX_BYTES`/`WORDPDF_MAX_PAGES`); реальный прод `.env` живёт в `PROD-DIR/`, в репо его нет | | `wordpdf-web/Dockerfile`, `wordpdf-web/nginx.conf` | образ SPA (node→nginx); только статика (прокси — в шлюзе); base сборки — `ARG VITE_BASE` (prod `/pdf-converter/`, дефолт `/`) | -| `references/` | эталон Word 365 (`word.docx` + `word.pdf`) — **ручное сравнение, не фикстуры**, в тесты/jar не подключать | -| `diff/`, корневые `word-export.*` | gitignored артефакты ручной калибровки | +| `develop/` (вне git) | рабочие материалы и эталон Word 365 (`word.docx` + `word.pdf`), артефакты ручной калибровки — **ручное сравнение, не фикстуры**, в тесты/jar не подключать | ## Development Commands diff --git a/README.md b/README.md index e43f162..de35bd0 100644 --- a/README.md +++ b/README.md @@ -160,7 +160,7 @@ docx ──> нормализация байтов ──> docx4j (Wordprocessin - Символы U+2000–U+2EFF (em-dash и т.п.) берутся из шрифта ранa, если в нём есть глиф, иначе — из fallback-семейства DejaVu. - Знаков, которых нет ни в одном шрифте бандла, это не касается: вместо них - остаётся `.notdef`. В эталонном `references/word.docx` таких два — U+2188 (ↈ) + остаётся `.notdef`. В эталонном экспорте Word (`develop/`, вне git) таких два — U+2188 (ↈ) и U+218A (↊), они есть только в GNU FreeSerif под GPL, а бандл держится целиком на SIL OFL. - Поддержка таблиц/изображений — базовая (через docx4j/FOP). diff --git a/wordpdf-core/src/main/java/ru/pjandro/wordpdf/internal/FieldNormalizer.java b/wordpdf-core/src/main/java/ru/pjandro/wordpdf/internal/FieldNormalizer.java index b0edc6f..58827a2 100644 --- a/wordpdf-core/src/main/java/ru/pjandro/wordpdf/internal/FieldNormalizer.java +++ b/wordpdf-core/src/main/java/ru/pjandro/wordpdf/internal/FieldNormalizer.java @@ -18,7 +18,7 @@ import java.util.zip.ZipOutputStream; * → закэшированный результат → {@code fldChar end}. Экспорт docx4j в XSL-FO * игнорирует {@code w:instrText} внутри такого поля и печатает кэш из docx, * поэтому в колонтитулах всех страниц стоит одно и то же число - * (в references/word.docx — «2» вместо 1, 2, 3 …). + * (в эталонном экспорте Word — «2» вместо 1, 2, 3 …). * * Собственно поле docx4j умеет: {@code w:fldSimple} обрабатывает * {@code FldSimpleWriter} из docx4j-export-fo, у которого есть обработчики diff --git a/wordpdf-core/src/main/java/ru/pjandro/wordpdf/internal/SymbolFontNormalizer.java b/wordpdf-core/src/main/java/ru/pjandro/wordpdf/internal/SymbolFontNormalizer.java index d9cd810..8a83f5e 100644 --- a/wordpdf-core/src/main/java/ru/pjandro/wordpdf/internal/SymbolFontNormalizer.java +++ b/wordpdf-core/src/main/java/ru/pjandro/wordpdf/internal/SymbolFontNormalizer.java @@ -29,7 +29,7 @@ import java.util.zip.ZipOutputStream; * а имя шрифта — на fallback-семейство (в нём этих глифов достаточно). * Таблица кодов — из {@code org.docx4j.convert.out.common.writer.SymbolMapper} * (docx4j 17.x), отфильтрована по наличию глифа в DejaVu Sans; она же - * сверяется с эталоном Word (references/word.pdf). + * сверяется с эталоном Word (develop/, вне git). * * Обрабатываются оба места, где встречается символный шрифт: *