Commit Graph

21 Commits

Author SHA1 Message Date
Pjandro 07028d1509 core: reduce peak memory of conversion (single page-count scan, early input/stream release, streamed document.xml, eager raster flush); app: reject oversized upload before getBytes()
PR checks / web (pull_request) Successful in 35s
PR checks / java (pull_request) Successful in 1m11s
Main: tests, deploy, autotests / web (push) Successful in 41s
Main: tests, deploy, autotests / java (push) Successful in 1m16s
Main: tests, deploy, autotests / images-web (push) Successful in 28s
Main: tests, deploy, autotests / images-app (push) Successful in 39s
Main: tests, deploy, autotests / deploy (push) Failing after 4m59s
Main: tests, deploy, autotests / autotests (push) Has been skipped
Main: tests, deploy, autotests / rollback (push) Failing after 2m29s
2026-11-01 03:44:35 +00:00
Pjandro ef3feaa94d Мост .doc → .docx: конвертация бинарного Word 97-2003 (MS-DOC/MS-CFB/MS-OLEPS/MS-ODRAW)
PR checks / java (pull_request) Successful in 1m17s
PR checks / web (pull_request) Successful in 16m43s
- internal/doc: CfbReader, FibHeader, PieceTable, Grpprl, ChpxIndex, PapxIndex,
  Sections, FontTable, SummaryInfo, Headers, OfficeArt, DocFile, DocxWriter,
  DocToDocx — разбор бинарного .doc и сборка in-memory .docx (прямые свойства,
  колонтитуки с PAGE/NUMPAGES → fldSimple, BLIP-картинки PNG/JPEG/DIB)
- роутинг WordPdfConverter по сигнатуре CFB; валидация страниц .doc по сырым
  байтам (SummaryInfo PageCount + 0x0C + pageBreakBefore) до конвертации
- .docx/.doc: ConvertController, safeBaseName, фронт (DropZone accept)
- фикстуры: 12 .doc (11 эталонов заказчика + doc-formats); doc-пары тестов
- тесты: 13 классов internal/doc (98 @Test) + пары в конвертере/валидаторе/app;
  гейт mvn clean verify зелёный (core BRANCH 0.852, LINE 0.947)
- AGENTS.md: секция «Мост .doc → .docx», обновлены счётчики и каталоги
2026-10-29 23:51:42 +00:00
Pjandro 9082d2624d fix: switch-выражение из super() вынесено в статический message()
PR checks / web (pull_request) Successful in 30s
PR checks / java (pull_request) Successful in 1m5s
Main: tests, deploy, autotests / web (push) Successful in 31s
Main: tests, deploy, autotests / java (push) Successful in 1m4s
Main: tests, deploy, autotests / images-web (push) Successful in 30s
Main: tests, deploy, autotests / images-app (push) Successful in 47s
Main: tests, deploy, autotests / deploy (push) Successful in 1m31s
Main: tests, deploy, autotests / autotests (push) Successful in 40s
Main: tests, deploy, autotests / rollback (push) Has been skipped
Парсер PMD 7.17 (движок maven-pmd-plugin 3.28.0) не разбирает
switch-выражение в аргументе super (pmd/pmd#6234) — при verify каждый
модуль давал PMD processing error (warning). Сообщения не меняются:
текст 422-контракта и ядра дословно прежние.
2026-10-26 23:45:58 +00:00
Pjandro ab8ea495a8 fix(app): 405/415 вместо catch-all 500; multipart-части на диске; heap в лимит контейнера
- ApiExceptionHandler: HttpRequestMethodNotSupportedException → 405,
  HttpMediaTypeNotSupportedException → 415 (JSON-контракт {error: …})
- file-size-threshold 100MB→2MB: части > 2 МБ на диск Tomcat, heap держит
  только getBytes() одной сериализованной конвертации (раньше каждая
  параллельная загрузка буферизовалась в heap до валидации размера)
- Containerfile ENTRYPOINT: -XX:MaxRAMPercentage=70; compose/compose.dev/
  прод-рендер: mem_limit: 2g у app
- ConvertController javadoc: ссылки на несуществующий ConversionService#validate нет
- Регрессии — ConvertControllerTest#methodNotSupportedReturns405/badContentTypeReturns415
2026-10-26 00:09:16 +00:00
Pjandro 153ae17d5d app: детерминированная сатурация очереди в ConversionServiceTest
PR checks / web (pull_request) Successful in 34s
PR checks / java (pull_request) Successful in 1m26s
Main: tests, deploy, autotests / web (push) Successful in 43s
Main: tests, deploy, autotests / java (push) Successful in 1m0s
Main: tests, deploy, autotests / images-app (push) Successful in 45s
Main: tests, deploy, autotests / images-web (push) Successful in 1m14s
Main: tests, deploy, autotests / deploy (push) Successful in 1m42s
Main: tests, deploy, autotests / autotests (push) Successful in 41s
Main: tests, deploy, autotests / rollback (push) Has been skipped
saturatedQueue_rejectsImmediately синхронизировался опросом снимка
getActiveCount() (аппроксимация w.isLocked()) с 5-секундным окном — на
загруженном CI-раннере воркер-поток не доходил до w.lock() вовремя
(«воркер не занят» expected 1 but was 0). Теперь первый filler-task
сигналит о старте из воркер-потока через CountDownLatch (10 с), размер
очереди после 17 submit точный (task1 — firstTask, не в очереди) —
опрос удалён.
2026-10-25 13:22:41 +00:00
Pjandro f4b92f2140 Надёжность: ConcurrentHashMap покрытия, volatile cmap, ApiKeyFilter против точечных сегментов, 413/400 из конфигурации, deleteOnExit TTF 2026-10-24 21:42:29 +00:00
Pjandro 8a07597d4c JaCoCo: гейт покрытия 90% строк + сводка/артефакты репортов в CI
PR checks / web (pull_request) Successful in 54s
PR checks / java (pull_request) Failing after 1m9s
Корневой pom: jacoco-maven-plugin 0.8.15 (prepare-agent, report+check на
verify, report раньше check — отчёт готов даже при провале гейта), surefire
argLine через @{argLine}. pr.yml/main.yml job java: Coverage summary в
step summary + артефакт jacoco-html (оба шага if: always()).

Тесты ради гейта (23 класса / 218 @Test): app ConversionService/
ApiExceptionHandler/ConversionTimeout +1 в ConvertController; core
DrawMlColor/DrawMlText + инкременты ChartSpec/PresetGeometry.
Покрытие: core 91,0%, app 92,9% строк.
2026-10-24 18:39:44 +00:00
Pjandro 93ec325aa6 OLE-объекты: переключатель errorOnOle + тихое удаление из docx
PR checks / java (pull_request) Successful in 47s
PR checks / web (pull_request) Successful in 1m6s
docx4j падает на внедрённых OLE-объектах двумя путями: JAXB-парсинг
бинарника под ложным XML-типом в [Content_Types] («Content is not
allowed in prolog» → NPE) и NPE chunkType is null в VML-сериализации
w:object. Новый OleObjectNormalizer (шестой в цепочке, после
GlyphCoverageNormalizer) удаляет OLE-bin-части, rels-ссылки, элементы
w:object и Override удалённых частей; при errorOnOle=true вместо
удаления — DrawingFoundException(OLE) → 422 «Конвертация отменена: в
документе найдены OLE-объекты».

- ядро: Kind.OLE, ConvertOptions.errorOnOle, WordPdfSettings.ERROR_ON_OLE,
  фикстура samples/ole-embedded.docx (ручная, оба механизма)
- app: параметр errorOnOle, 422-контракт, тесты errorFlagOle_rejected /
  oleObjects_removedByDefault
- SPA: третий переключатель «OLE-объекты»
- прод-автотесты: +2 проверки (21)
- регрессии: OleObjectNormalizerTest ↔ oleObjects_removedAndConverted /
  drawingErrors_errorFlagRejectsOle; E2E: notConverted.docx 500 → 200
2026-10-22 21:08:18 +00:00
Pjandro 6b2715f1c2 Убрать render-флаги диаграмм/SmartArt; автозаголовок — «Название диаграммы»
PR checks / java (pull_request) Successful in 45s
PR checks / web (pull_request) Successful in 1m20s
ConvertOptions: renderCharts/renderSmartArt удалены (ядро, REST, SPA,
прод-автотесты) — диаграммы/SmartArt конвертируются всегда, отказ только
по error-флагам (DrawingFoundException → 422). Дефолт SPA-галок — false.
ChartSpec.AUTO_TITLE русифицирован: «Название диаграммы».
AGENTS.md приведён в соответствие.
2026-10-22 17:50:17 +00:00
Pjandro 6f57c8a80f feat: валидация контейнера .docx и защита от zip-бомбы в WordPdfValidator.validate
PR checks / java (pull_request) Successful in 1m24s
PR checks / web (pull_request) Successful in 48s
- checkDocxContainer: потоковый проход по zip — декларация wordprocessingml.document
  в [Content_Types].xml (голый zip / переименованный .xlsx → 400, а не 500 на docx4j)
  + лимиты MAX_DECOMPRESSED_MB (200) / MAX_ZIP_ENTRIES (8192) — бомба отсекается
  до readAllBytes в checkPageCount; пороги константные, не ConvertOptions
- регрессии: validate_plainZipRejected/xlsxRenamedRejected/zipBombRejected/
  tooManyEntriesRejected, inputNotDocx_rejectedBeforeRender, plainZipNotDocx_rejected;
  junkInsideValidZip_conversionError — на валидном контейнере с мусором (500)
- прод-автест test_plain_zip_not_docx_rejected; AGENTS.md синхронизирован
2026-10-20 21:14:28 +00:00
Pjandro 1e20949a98 refactor: лимит размера входа во всех слоях — MAX_MB (МБ=MiB), байты вычисляются в checkInput
PR checks / java (pull_request) Successful in 1m7s
PR checks / web (pull_request) Successful in 43s
Ядро: WordPdfSettings.MAX_INPUT_MB=5, ConvertOptions.maxMb,
WordPdfValidator.checkInput(byte[], long maxMb) — единственная точка
пересчёта МБ→байты, сообщение «Файл больше N МБ: X байт > Y байт».
Приложение: свойство wordpdf.max-mb (env WORDPDF_MAX_MB, relaxed binding).
CI/конфиг/автотесты/доки: WORDPDF_MAX_BYTES → WORDPDF_MAX_MB (значение 5).
2026-10-20 20:34:01 +00:00
Pjandro 5f0cabd8e2 fix: устранить все предупреждения PMD (codestyle/unused/LiteralFirstInEquals)
Литерал слева в equals/equalsIgnoreCase (NPE-safe), удаление неиспользуемых
параметров/локальных/импортов/полей, логгеры log→LOG (конвенция UPPER_SNAKE),
UselessParentheses/UnnecessaryCast/UseShortArrayInitializer, record без явного
static, пустой конструктор ChartSpec удалён. Семантика не меняется.
2026-10-19 22:55:16 +00:00
Pjandro 5482bfac60 core: перенос валидации входа из ConversionService в WordPdfValidator.validate 2026-10-19 21:49:34 +00:00
Pjandro 45b78f7fc9 core,app,web: дефолты лимитов входа 5 MiB / 100 страниц 2026-10-19 21:30:45 +00:00
Pjandro f09b629270 core: ValidationException вместо ConversionException; удаление pkg-API и переименование checkPageCountLightweight в checkPageCount 2026-10-19 21:30:45 +00:00
Pjandro 65746db9d2 Migrate repo from docker to podman
- git mv docker-compose*.yml -> compose*.yml, Dockerfile -> Containerfile
  (podman-compose picks compose.yml; buildah finds Containerfile first)
- compose/compose.dev: x-podman.name_separator_compat (dash container
  names), explicit app/web healthchecks (OCI export drops image
  HEALTHCHECK, depends_on service_healthy would hang forever), fixed
  subnet 10.113.0.0/24 gw 10.113.0.1 for the aardvark-dns resolver
- gateway/nginx.conf: resolver + proxy_pass via variables (static
  proxy_pass resolves once at start; podman-restart.service brings
  gateway up before app -> dead upstream, 502 until manual restart)
- Containerfiles: pin base images to docker.io/library/* (no
  unqualified-search-registries on hosts), truthful buildah proxy comments
- comments/docs: Docker HEALTHCHECK -> container HEALTHCHECK; READMEs,
  AGENTS.md updated for podman/podman-compose

Verified on dev (podman 5.7.0, podman-compose 1.5.0): stack up with
dash names, app/web healthy, conversion through gateway returns PDF,
gateway survives app container restart without restart (resolver).
2026-10-19 00:13:52 +00:00
Pjandro 307afc0678 feat: errorOnCharts/errorOnSmartArt — отказ конвертации при находке диаграмм/SmartArt 2026-10-15 22:03:14 +00:00
Pjandro f83703286c Fix: @SecurityScheme in=HEADER — Swagger UI не клал ключ в заголовок
При правке apiKeyName→paramName строка in = SecuritySchemeIn.HEADER была
срезана; в спеке apiKey-схема осталась без обязательного in — Swagger UI
не знал, куда положить ключ, и «Try it out» слал запросы без X-API-Key
(401; обнаружено браузерным E2E на проде после мержа #4). Тест
docsOpenWithoutKey теперь пинит in == header (прежних assert type+name
не хватало ровно на это). Локальный E2E (jar + браузер): запрос с
x-api-key, ответ 200.
2026-10-15 21:25:36 +00:00
Pjandro c7dec86b54 Fix: Swagger UI/OpenAPI под префиксом /pdf-converter, документация открыта без ключа
Прод (наружный nginx срезает /pdf-converter/): springdoc генерировал
абсолютные URL от корня хоста — пути до /v3/api-docs и swagger-ui битые.
server.forward-headers-strategy=framework + X-Forwarded-* (добавляет
наружный nginx) дают server https://pjandro.ru/pdf-converter и configUrl
с префиксом; 'native'-клапан Tomcat X-Forwarded-Prefix не понимает.

ApiKeyFilter: матч по пути без forwarded-contextPath (под префиксным
заголовком getRequestURI() включает префикс — HEALTHCHECK получил бы 401)
+ открытые без ключа /swagger-ui* и /v3/api-docs* (браузер не может
положить ключ в заголовок при загрузке UI; /api/** под ключом).
OpenApiConfig: @SecurityScheme X-API-Key — кнопка Authorize в UI,
@SecurityRequirement на convert — «Try it out» с ключом.
springdoc.swagger-ui.persist-authorization=true.

Регрессии: ApiKeyFilterTest#docsOpenWithoutKey,
#forwardedPrefix_healthStaysOpen, #forwardedPrefix_docsOpenWithoutKey
(вместо удалённого openApiRequiresKey). AGENTS.md синхронизирован.
2026-10-15 21:13:42 +00:00
Pjandro 25ed56bf20 API: ключ доступа X-API-Key и серверные лимиты входа
ApiKeyFilter — единственная граница доступа: сверяет X-API-Key со
свойством wordpdf.api-key (env WORDPDF_API_KEY, MessageDigest.isEqual);
пустое свойство = аутентификация выключена; /actuator/** открыт для
HEALTHCHECK; 401 отдаёт сам фильтр. Лимиты входа задаёт только
конфигурация сервера (wordpdf.max-bytes/max-pages, env
WORDPDF_MAX_BYTES/WORDPDF_MAX_PAGES, @Value с дефолтом-SpEL из констант
ядра; <=0 — падение на старте), параметрами запроса не переопределяются
(регрессии requestLimitParams_areIgnored, nonPositiveLimits_failStartup).
Конвертация — байты насквозь; опции рисования из запроса → ConvertOptions.
2026-10-14 01:50:35 +00:00
Pjandro 8c390104d2 Замена wordpdf-cli на Spring Boot REST API: wordpdf-app, SPA wordpdf-web, docker-compose 2026-10-13 16:38:18 +00:00