Chore: рабочие материалы и эталоны — в develop/ (вне git); .gitignore без упоминаний локальных артефактов

This commit is contained in:
Pjandro
2026-10-14 17:30:36 +00:00
parent c8a45d84c5
commit dfdcb5124d
8 changed files with 10 additions and 13 deletions
+1
View File
@@ -3,6 +3,7 @@ target/
.git/ .git/
.codegraph/ .codegraph/
diff/ diff/
/develop/
.idea/ .idea/
*.iml *.iml
dependency-reduced-pom.xml dependency-reduced-pom.xml
+2 -5
View File
@@ -18,10 +18,8 @@ wordpdf-web/dist/
.DS_Store .DS_Store
Thumbs.db Thumbs.db
# Локальные примеры и выгрузки в корне # Рабочие материалы и эталоны разработки (вне git)
/develop/
# Артефакты ручной калибровки диаграмм
/diff/
# Секреты деплоя # Секреты деплоя
.env .env
@@ -29,4 +27,3 @@ Thumbs.db
# Индекс CodeGraph # Индекс CodeGraph
.codegraph/ .codegraph/
# Выход конвертера из references/ (артефакт ручной проверки, не эталон)
+2 -3
View File
@@ -49,7 +49,7 @@
### Chart-движок (`internal/chart`, package-private кроме `DrawingPreRenderer.run`) ### 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`). В `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 включён | | корневой `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/`, в репо его нет | | корневой `.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/`, дефолт `/`) | | `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 не подключать | | `develop/` (вне git) | рабочие материалы и эталон Word 365 (`word.docx` + `word.pdf`), артефакты ручной калибровки — **ручное сравнение, не фикстуры**, в тесты/jar не подключать |
| `diff/`, корневые `word-export.*` | gitignored артефакты ручной калибровки |
## Development Commands ## Development Commands
+1 -1
View File
@@ -160,7 +160,7 @@ docx ──> нормализация байтов ──> docx4j (Wordprocessin
- Символы U+2000–U+2EFF (em-dash и т.п.) берутся из шрифта ранa, если в нём - Символы U+2000–U+2EFF (em-dash и т.п.) берутся из шрифта ранa, если в нём
есть глиф, иначе — из fallback-семейства DejaVu. есть глиф, иначе — из fallback-семейства DejaVu.
- Знаков, которых нет ни в одном шрифте бандла, это не касается: вместо них - Знаков, которых нет ни в одном шрифте бандла, это не касается: вместо них
остаётся `.notdef`. В эталонном `references/word.docx` таких два — U+2188 (ↈ) остаётся `.notdef`. В эталонном экспорте Word (`develop/`, вне git) таких два — U+2188 (ↈ)
и U+218A (↊), они есть только в GNU FreeSerif под GPL, а бандл держится и U+218A (↊), они есть только в GNU FreeSerif под GPL, а бандл держится
целиком на SIL OFL. целиком на SIL OFL.
- Поддержка таблиц/изображений — базовая (через docx4j/FOP). - Поддержка таблиц/изображений — базовая (через docx4j/FOP).
@@ -18,7 +18,7 @@ import java.util.zip.ZipOutputStream;
* → закэшированный результат → {@code fldChar end}. Экспорт docx4j в XSL-FO * → закэшированный результат → {@code fldChar end}. Экспорт docx4j в XSL-FO
* игнорирует {@code w:instrText} внутри такого поля и печатает кэш из docx, * игнорирует {@code w:instrText} внутри такого поля и печатает кэш из docx,
* поэтому в колонтитулах всех страниц стоит одно и то же число * поэтому в колонтитулах всех страниц стоит одно и то же число
* (в references/word.docx — «2» вместо 1, 2, 3 …). * (в эталонном экспорте Word — «2» вместо 1, 2, 3 …).
* *
* Собственно поле docx4j умеет: {@code w:fldSimple} обрабатывает * Собственно поле docx4j умеет: {@code w:fldSimple} обрабатывает
* {@code FldSimpleWriter} из docx4j-export-fo, у которого есть обработчики * {@code FldSimpleWriter} из docx4j-export-fo, у которого есть обработчики
@@ -29,7 +29,7 @@ import java.util.zip.ZipOutputStream;
* а имя шрифта — на fallback-семейство (в нём этих глифов достаточно). * а имя шрифта — на fallback-семейство (в нём этих глифов достаточно).
* Таблица кодов — из {@code org.docx4j.convert.out.common.writer.SymbolMapper} * Таблица кодов — из {@code org.docx4j.convert.out.common.writer.SymbolMapper}
* (docx4j 17.x), отфильтрована по наличию глифа в DejaVu Sans; она же * (docx4j 17.x), отфильтрована по наличию глифа в DejaVu Sans; она же
* сверяется с эталоном Word (references/word.pdf). * сверяется с эталоном Word (develop/, вне git).
* *
* Обрабатываются оба места, где встречается символный шрифт: * Обрабатываются оба места, где встречается символный шрифт:
* <ul> * <ul>
@@ -298,7 +298,7 @@ class WordPdfConverterTest {
// Em-dash рисуется вшитым в PDF шрифтом, а не базовым неembedded // Em-dash рисуется вшитым в PDF шрифтом, а не базовым неembedded
// Helvetica. Какой именно это шрифт — решает docx4j: если в шрифте // Helvetica. Какой именно это шрифт — решает docx4j: если в шрифте
// ранa есть глиф U+2014, остаётся он (так же делает Word: в // ранa есть глиф U+2014, остаётся он (так же делает Word: в
// references/word.pdf em-dash нарисовано Calibri/Times, DejaVu там // эталонном word.pdf (develop/) em-dash нарисовано Calibri/Times, DejaVu
// нет вообще), иначе — fallback-семейство. // нет вообще), иначе — fallback-семейство.
String font = fontNameOf(pdf, '—'); String font = fontNameOf(pdf, '—');
assertFalse(font.startsWith("Helvetica"), assertFalse(font.startsWith("Helvetica"),
@@ -14,7 +14,7 @@ import static org.junit.jupiter.api.Assertions.*;
/** /**
* Замена символьных шрифтов Symbol/Wingdings на Unicode + бандл-шрифт * Замена символьных шрифтов Symbol/Wingdings на Unicode + бандл-шрифт
* (см. SymbolFontNormalizer). Коды берутся из SymbolMapper docx4j 17.x и * (см. SymbolFontNormalizer). Коды берутся из SymbolMapper docx4j 17.x и
* сверяются с экспортом Word (references/word.pdf). * сверяются с экспортом Word (develop/, вне git).
*/ */
class SymbolFontNormalizerTest { class SymbolFontNormalizerTest {