Commit Graph

15 Commits

Author SHA1 Message Date
Pjandro 87b9288aaf docs(core): уточнение гэпа нумерации после зонда на 17.3.6+форке — suff=tab/space работает (docx4j:label-suffix + WordListItemLayoutManager), не реализуется только w:lvlJc
PR checks / web (pull_request) Successful in 44s
PR checks / java (pull_request) Successful in 1m41s
2026-11-08 22:09:52 +00:00
Pjandro b8d0e4433b docs: актуализация под docx4j 17.3.6 — правила 1–9, форк FOP 2.12, реаудит гэпов (framePr починен апстримом; distribute/lvlJc/кернинг без изменений), счётчики тестов
PR checks / web (pull_request) Successful in 40s
PR checks / java (pull_request) Failing after 1m29s
2026-11-08 21:26:32 +00:00
Pjandro 13ca7425a3 refactor(core): сужение уровней доступа — internal-нормализаторы, CfbReader и служебные методы валидатора в package-private
PR checks / web (pull_request) Successful in 33s
PR checks / java (pull_request) Successful in 1m16s
Main: tests, deploy, autotests / web (push) Successful in 30s
Main: tests, deploy, autotests / java (push) Successful in 1m18s
Main: tests, deploy, autotests / images-web (push) Successful in 37s
Main: tests, deploy, autotests / images-app (push) Successful in 42s
Main: tests, deploy, autotests / deploy (push) Successful in 1m58s
Main: tests, deploy, autotests / autotests (push) Successful in 40s
Main: tests, deploy, autotests / rollback (push) Has been skipped
- WordPdfValidator: isBinaryDoc/checkPageCount/checkPageCountDoc → package-private
  (наружу остаются checkInput/validate/maxImagePixels)
- CfbReader: класс и readStreams → package-private (все вызывающие в internal/doc)
- 9 STEP-нормализаторов + RubyNormalizer: класс, STEP и normalize → package-private;
  DocxRewritePipeline.normalize → package-private (STEP остаётся публичным)
- javadoc BundledFontMapper: {@link GlyphCoverageNormalizer} → {@code}
- контракты видимости синхронизированы: AGENTS.md, repo-map.md, doc-bridge.md, README.md
2026-11-08 20:34:43 +00:00
Pjandro af5d09e001 refactor(core,app): WordPdfSettings упразднён — лимиты входа обязательны в ConvertOptions, пороги производные, REST-параметры maxMb/maxPages
PR checks / web (pull_request) Successful in 33s
PR checks / java (pull_request) Successful in 1m18s
- WordPdfSettings удалён; ConvertOptions.defaults() удалён; 2-аргументный
  convert и безлимитные оверлоды валидатора сняты (options == null → 400)
- производные пороги (распаковка total/XML, пиксели растра, zip-записи)
  считаются из maxMb/maxPages формулами в WordPdfConverter/WordPdfValidator
- мост: DocToDocx.convert(+maxMb) → OfficeArt.read(+maxPixels)
- REST: свойства wordpdf.max-mb/max-pages — дефолт эндпоинта (литералы
  @Value 5/100), параметры запроса maxMb/maxPages переопределяют в обе
  стороны (≤ 0 → 400); верхний потолок отсутствует (решение пользователя)
- HTTP-контексты тестов пиныт wordpdf.api-key= (mise подмешивает .env)
- доки/README/autotests-формулировки синхронизированы
2026-11-08 20:16:52 +00:00
Pjandro 8a8e8a9f84 fix(core): бюджет распаковки docx — параметром валидатора из maxMb/maxPages
PR checks / web (pull_request) Successful in 33s
PR checks / java (pull_request) Successful in 1m20s
checkDocxContainer получает бюджеты параметром; validate считает их из
ConvertOptions.maxMb()/maxPages(): clamp(maxMb×10MiB + maxPages×64KiB, 16MiB,
MAX_DECOMPRESSED_MB) и clamp(maxMb×4MiB + maxPages×32KiB, 4MiB,
MAX_DECOMPRESSED_XML_MB) (коэффициенты/полы — package-private константы
WordPdfConverter, compile-time инлайн — WordPdfValidator по-прежнему без
зависимости от docx4j). Константы WordPdfSettings — жёсткие крышки (публичный
API, защита JAXB DOM). Сообщения печатают вычисленный бюджет. Тесты: пол
(16 МБ при maxMb=1), масштабирование и крышка (64 МБ при maxMb=10); доки
синхронизированы.
2026-11-08 19:13:38 +00:00
Pjandro 41b4f89e74 docs: синхронизация AGENTS/repo-map с аудиторскими фиксами
PR checks / web (pull_request) Successful in 38s
PR checks / java (pull_request) Successful in 1m27s
2026-11-08 16:41:06 +00:00
Pjandro 2116ec43a4 fix(core): сериализация конвертаций монитором класса WordPdfConverter
PR checks / web (pull_request) Successful in 35s
PR checks / java (pull_request) Successful in 1m19s
Публичный convert() теперь безопасен из нескольких потоков: секция после
валидации (мост .doc + convertToStream) выполняется под монитором класса —
общая FopFactory (per-render disableFontCache, имиджевые кеши) и её сброс в
finally больше не могут пересечься с параллельным рендером. warmup()
синхронизирован тем же монитором (реентельно). WordPdfValidator остаётся
до монитора: stateless, вызывается параллельно HTTP-потоками.
Регрессия — WordPdfConverterTest#concurrentConversions_twoThreadsBothSucceed.
Комментарии ConversionService/AGENTS/repo-map приведены к новому контракту.
2026-11-08 14:22:56 +00:00
Pjandro 8061a2fbe7 perf(core): срез декода растра, стримовый OLE-детект; heap -Xms2g -Xmx2g
PR checks / web (pull_request) Successful in 48s
PR checks / java (pull_request) Successful in 1m44s
ChartImageHandler: для не-JPEG без кропа с ppi <= threshold (или без
размера в макете) PictureCompression.compress всегда возвращает null,
но сначала декодирует полный растр ImageIO — решение принимается по
26 байтам заголовка (PNG/GIF/BMP), растр не декодируется вовсе; JPEG
остаётся на штатном пути CR-029 (перекодировка «для размера» сохранена).

OleObjectNormalizer: детект <w:object — потоковым поиском окном 8 KiB
с перекрытием, без readAllBytes()+new String на каждую word/*.xml.

Heap: ENTRYPOINT -Xms2g -Xmx2g (вместо -XX:MaxRAMPercentage=70),
mem_limit 2g -> 3g (compose.yml, compose.dev.yml, прод-heredoc
main.yml) — фиксированный heap + запас под metaspace/native.

Отменённая ветка: переиспользование общей FopFactory между прогонами
копит шрифтовые данные форка FOP на каждый render (замер 2026-11:
после 30 конвертаций ~1,4 ГБ живых byte[] против 17 МБ при
per-conversion сборке, рост live-кучи, Full GC) — фабрика остаётся
per-conversion, инвариант зафиксирован комментарием.

GC-замер (java -jar, -Xms2g -Xmx2g, 30 конвертаций фикстур): young
5 против 7 на main, паузы 12,2 мс против 18,7 мс, Full GC нет на обоих.

Тесты: ChartImageHandlerTest +5 (PNG/GIF/BMP/JPEG/выше порога),
OleObjectNormalizerTest +1 (маркер через границу окна).
2026-11-08 13:17:34 +00:00
Pjandro f41ac54072 docs(AGENTS): сжать до роутера без дублей, счётчики — в testing.md
PR checks / web (pull_request) Successful in 35s
PR checks / java (pull_request) Successful in 1m15s
Main: tests, deploy, autotests / web (push) Successful in 31s
Main: tests, deploy, autotests / java (push) Successful in 1m15s
Main: tests, deploy, autotests / images-web (push) Successful in 34s
Main: tests, deploy, autotests / images-app (push) Successful in 43s
Main: tests, deploy, autotests / deploy (push) Successful in 1m41s
Main: tests, deploy, autotests / autotests (push) Successful in 35s
Main: tests, deploy, autotests / rollback (push) Has been skipped
2026-11-08 00:57:53 +00:00
Pjandro 3dd770c542 docs: AGENTS.md — сводный репозиторный гайд по фактам дерева
PR checks / web (pull_request) Successful in 38s
PR checks / java (pull_request) Failing after 1m56s
Пересобран корневой AGENTS.md по результатам параллельного исследования
(core src, tests, build/config, app/web/docs). Сохранены все разделы и
инварианты, добавлены точные счётчики и недостающие детали, полезные
AI-ассистенту (идиомы загрузки фикстур по модулям, жизненный цикл тестов,
правила PMD/JaCoCo, карта HTTP-контракта).

Исправлен фактический дрейф в соседних справках (docs/agent/* объявлены
авторитетными наравне с AGENTS.md):
- счётчики тестов: 891 → 893 (core 848 → 849, app 43 → 44; ApiExceptionHandlerTest = 5);
- internal/chart: 17 → 18 классов, public ещё и ChartImageHandler;
- wordpdf-app: 10 → 11 классов (5 классов исключений);
- константа STEP: 8 → 9 из 10 rewrite-нормализаторов (есть у HiddenTextNormalizer);
- docs/standards: шесть → восемь каталогов; в перечне docs/agent добавлен repo-map.

Проверено: mvn clean verify — 893 теста, PMD (includeTests) и гейты JaCoCo
(LINE 0.90 обоих модулей, BRANCH 0.85 core) зелёные.
2026-11-07 03:19:01 +00:00
Pjandro ba755e8ac0 refactor: ValidationException — исключительная собственность WordPdfValidator
PR checks / web (pull_request) Successful in 37s
PR checks / java (pull_request) Successful in 1m24s
Main: tests, deploy, autotests / web (push) Successful in 32s
Main: tests, deploy, autotests / java (push) Successful in 1m8s
Main: tests, deploy, autotests / images-web (push) Successful in 32s
Main: tests, deploy, autotests / images-app (push) Successful in 49s
Main: tests, deploy, autotests / deploy (push) Successful in 3m58s
Main: tests, deploy, autotests / autotests (push) Successful in 41s
Main: tests, deploy, autotests / rollback (push) Has been skipped
Мост .doc → .docx (internal/doc) и javadoc-контракты переводятся на
ConversionException; WordPdfValidator.checkPageCountDoc оборачивает отказ
моста в ValidationException с сохранением текста (вердикт «вход
некорректен» выносит только валидатор; глубина, ловимая лишь при
конвертации, становится 500 — как у .docx). Проверки ConvertController
переезжают на новый app-класс BadRequestException (400 с теми же
текстами), ApiExceptionHandler получает хендлер. Тесты моста доказывают
ровно тип (assertSame(ConversionException.class, ...)); новый регрессивный
WordPdfValidatorTest#checkPageCountDoc_brokenBridge_wrappedAsValidation.
Документация (AGENTS.md, docs/agent/doc-bridge.md) синхронизирована.
2026-11-03 23:10:16 +00:00
Pjandro 1ecaa9e959 docs: warmup + отключение discovery в инвариантах, pipeline и счётчиках
PR checks / web (pull_request) Successful in 45s
PR checks / java (pull_request) Successful in 1m53s
Main: tests, deploy, autotests / web (push) Successful in 34s
Main: tests, deploy, autotests / java (push) Successful in 1m7s
Main: tests, deploy, autotests / images-web (push) Successful in 31s
Main: tests, deploy, autotests / images-app (push) Successful in 51s
Main: tests, deploy, autotests / deploy (push) Successful in 2m30s
Main: tests, deploy, autotests / autotests (push) Successful in 1m48s
Main: tests, deploy, autotests / rollback (push) Has been skipped
- инвариант: гейт-свойства discoverPhysicalFonts/discoverJarFonts в
  static-блоке WordPdfConverter (замер реестра 114 → 0+7 symbol);
- pipeline.md: шаг 1 (constructor больше не сканирует систему/jar'ы) +
  раздел warmup() с A/B-числами (0,13 с против 1,74 с);
- очередь app: warmup головой очереди;
- счётчики тестов: 59/891 (core 53/848, WordPdfConverterTest 77).
2026-11-03 20:37:53 +00:00
Pjandro eabc2b0e0d docs(standards): restructure into ooxml/binary, add MS-XLS/MS-XLSX for .xls/.xlsx
PR checks / web (pull_request) Successful in 38s
PR checks / java (pull_request) Successful in 1m31s
Main: tests, deploy, autotests / web (push) Successful in 33s
Main: tests, deploy, autotests / java (push) Successful in 1m7s
Main: tests, deploy, autotests / images-web (push) Successful in 32s
Main: tests, deploy, autotests / images-app (push) Successful in 43s
Main: tests, deploy, autotests / deploy (push) Failing after 2m55s
Main: tests, deploy, autotests / autotests (push) Has been skipped
Main: tests, deploy, autotests / rollback (push) Failing after 3m4s
2026-11-02 22:21:23 +00:00
Pjandro de9995bba3 core: chart-PNG без docx4j-декода и без пересжатия CR-029 (−23% alloc chart-документов)
PR checks / web (pull_request) Successful in 43s
PR checks / java (pull_request) Successful in 1m51s
Main: tests, deploy, autotests / web (push) Successful in 58s
Main: tests, deploy, autotests / images-web (push) Successful in 31s
Main: tests, deploy, autotests / java (push) Successful in 1m38s
Main: tests, deploy, autotests / images-app (push) Successful in 49s
Main: tests, deploy, autotests / deploy (push) Failing after 2m46s
Main: tests, deploy, autotests / autotests (push) Has been skipped
Main: tests, deploy, autotests / rollback (push) Successful in 2m20s
DrawingPreRenderer.swapForPicture вставляет media-часть вручную
(newPartForContentType → setBinaryData → rels.addPart, имена
/word/media/chart-*): createImagePart писал temp-файл и декодировал
PNG обратно ради mime/размеров, которые нам и так известны.
ChartImageHandler (foSettings.setImageHandler) возвращает null из
compressedVariant для chart-* — «Compress Pictures» не ресемплит и не
декодирует наши 300-dpi растры; медиа документов остаются в штатном
docx4j-режиме. Замер (25 фикстур × 6 прогонов): chart-types.docx
657→507 МБ alloc (тёплый), суммарно 11640→10604 МБ, прочие 23 файла
±0%; ретеншн не изменился (144 MiB после GC), temp-файлов 0.
Регрессии: chartMedia_notDownsampled, DrawingPreRendererTest,
ChartImageHandlerTest.
2026-11-02 21:36:10 +00:00
Pjandro 0a08d12b33 docs(AGENTS): сплит — роутер + docs/agent/*; удаление исторического нарратива
PR checks / web (pull_request) Successful in 41s
PR checks / java (pull_request) Successful in 1m28s
Main: tests, deploy, autotests / web (push) Successful in 32s
Main: tests, deploy, autotests / images-web (push) Successful in 29s
Main: tests, deploy, autotests / java (push) Successful in 1m20s
Main: tests, deploy, autotests / images-app (push) Successful in 45s
Main: tests, deploy, autotests / deploy (push) Successful in 2m16s
Main: tests, deploy, autotests / autotests (push) Successful in 45s
Main: tests, deploy, autotests / rollback (push) Has been skipped
2026-11-02 19:30:41 +00:00