Pjandro 7016df5434
PR checks / web (pull_request) Successful in 9s
PR checks / macos-sim (pull_request) Successful in 1m44s
PR checks / java (pull_request) Successful in 3m31s
fix(core): находки ревью — капа глубины OMML, арифметика лимитов, тесты деградаций, доки
- M-2: MathModel — капа вложенности OMML MAX_DEPTH=64 (deeper() в MathCtx) + капа flatten MAX_TEXT_DEPTH; WordPdfConverter.convert — catch StackOverflowError; регрессии MathModelTest#deepNesting_*, WordPdfConverterTest#ommlDeepNesting_flattenedToText
- m-2: WordPdfValidator — multiplyExact для maxBytes/max* бюджетов, переполнение maxMb -> ValidationException (400)
- m-9: ChartSpec.parseDouble — non-finite (NaN/Infinity) -> null, как не-число
- M-1: DrawingPreRendererTest — 7 тестов деградаций run(): битая chart-часть, отказ рендера, wp:anchor, бюджет math-PNG, w:br в m:r, пустая формула, oMathPara jc=center
- m-7: тесты null-options (convert/validate) и краёв JPEG rasterArea
- m-3: удалены мёртвые normalize() у FieldNormalizer/GlyphCoverageNormalizer (конвейер использует rewrite)
- I-4: DocxRewritePipeline/OleObjectNormalizer — try-with-resources на in-memory zip-потоках
- I-5: OfficeArt (DIB) и Styles (STSH) — warn в молчаливых деградациях моста
- m-1/m-4/m-5/m-8/m-10/I-6: нумерация правил 1-11 в javadoc/xslt, Регрессия-ссылки (сироты исправлены), MS-OI29500 §2.1.44, ToggleOperand 0x80/0x81 §2.9.327, карта pieces §2.9.73, счётчики 1021 тест
2026-11-23 00:06:49 +03:00

java-word-pdf

Конвертация .docx/.doc → PDF на чистом Java: docx4j 17.3.2 + форк Apache FOP, без LibreOffice/Aspose. Бинарный .doc (Word 97–2003) читается собственным мостом [MS-DOC]/[MS-CFB] и переносится в .docx в памяти — дальше идёт тем же конвейером. Шрифты упакованы в jar — конвертация не зависит от шрифтов, установленных в системе (работает «из коробки» на голом сервере).

Структура

java-word-pdf/
├── wordpdf-core/   библиотека: конвертер, мост .doc, шрифты, диаграммы
├── wordpdf-app/    REST API: POST /api/v1/convert (Spring Boot 4.1.1, Swagger UI)
└── wordpdf-web/    веб-интерфейс (React + TypeScript + Vite + Tailwind, вне Maven)

Быстрый старт

Первая настройка — project-local mise (ставит temurin-17, maven 3.9.16, node 24, python 3.15 в кеш mise, в систему ничего не идёт) + npm ci SPA:

sh bootstrap.sh    # Linux / macOS
powershell -ExecutionPolicy Bypass -File .\bootstrap.ps1    # Windows

Дальше всё через обёртку ./mise.sh (Windows: .\mise.ps1):

./mise.sh run verify                       # полный гейт перед push: тесты + PMD + JaCoCo
./mise.sh run app-package && ./mise.sh run app-run   # бэкенд на :8080, ключ выключен
curl -F "file=@doc.docx" http://localhost:8080/api/v1/convert -o doc.pdf

Стенды на контейнерах (podman), наружный вход — только nginx-gateway:

cp .env.example .env                       # WORDPDF_API_KEY: openssl rand -hex 32
podman-compose up -d --build               # prod-like :9010 (fail-closed: без ключа не встанет)
podman-compose -f compose.dev.yml up -d --build --force-recreate   # dev :9011, без ключа

Задачи проекта (./mise.sh run <задача>)

Задача Содержание
verify mvn clean verify — тесты + PMD + JaCoCo
verify-nofontconfig тот же verify в контейнере без fontconfig (гейт CI; требует podman/docker)
mem-bench замер памяти конвейера (TSV пиков + JFR)
app-package / app-run исполняемый jar бэкенда / бэкенд на :8080
web-install / web-build / web-lint / web-dev SPA: npm ci / гейт tsc -b && vite build / oxlint / :5173
prod-tests прод-автотесты; обязателен WORDPDF_BASE_URL, факультативно WORDPDF_API_KEY
docs-install / docs-serve / docs-build сайт документации: venv+pip / preview :8000 / strict-сборка в site/
docs-javadoc / docs-deploy javadoc core / публикация сайта на rpi (:9012)

Альтернатива обёртке — активировать mise в шелле и работать напрямую (mvn, npm, python): eval "$(./.mise/bin/mise activate bash)".

Документация

  • Сайт документации (пользователю / REST API / библиотека / архитектура / разработчику / эксплуатация): http://192.168.88.23:9012/ — исходники в docs/, публикация ./mise.sh run docs-deploy, javadoc — там же по /apidocs/.
  • Веб-конвертер (прод): https://pjandro.ru/pdf-converter/.
  • Внутренние справочники для правки кода — docs/agent/ (pipeline, doc-bridge, chart, render-limitations, testing, ci-cd, repo-map), нормативные спецификации форматов — docs/standards/.
  • Правила репозитория — AGENTS.md.
S
Description
No description provided
Readme 99 MiB
Languages
Java 95.6%
XSLT 2%
Python 0.9%
TypeScript 0.9%
Shell 0.3%
Other 0.2%